Create release tag for Apache release 1.2.0.
POM project name should contain "Apache" prefix
1 file changed
tree: c329c031cceba0f92db010db1e45d773df4881bc
  1. .github/
  2. lib/
  3. src/
  4. .gitattributes
  5. .gitignore
  6. BUILDING.txt
  7. checkstyle.xml
  8. CODE_OF_CONDUCT.md
  9. CONTRIBUTING.md
  10. LICENSE.txt
  11. Makefile
  12. Makefile.common
  13. NOTICE.txt
  14. pom.xml
  15. PROPOSAL.html
  16. README.md
  17. RELEASE-NOTES.txt
  18. SECURITY.md
README.md

Apache Commons Crypto

GitHub Actions Status Coverage Status Maven Central Javadocs CodeQL OpenSSF Scorecard

Apache Commons Crypto is a cryptographic library optimized with AES-NI (Advanced Encryption Standard New Instructions). It provides Java API for both cipher level and Java stream level. Developers can use it to implement high performance AES encryption/decryption with the minimum code and effort. Please note that Crypto doesn't implement the cryptographic algorithm such as AES directly. It wraps to OpenSSL or JCE which implement the algorithms.

Features

  1. Cipher API for low level cryptographic operations.
  2. Java stream API (CryptoInputStream/CryptoOutputStream) for high level stream encryption/decryption.
  3. Both optimized with high performance AES encryption/decryption. (1400 MB/s - 1700 MB/s throughput in modern Xeon processors).
  4. JNI-based implementation to achieve comparable performance to the native C/C++ version based on OpenSsl.
  5. Portable across various operating systems (currently only Linux/MacOSX/Windows); Apache Commons Crypto loads the library according to your machine environment (it checks system properties, os.name and os.arch).
  6. Simple usage. Add the commons-crypto-(version).jar file to your classpath.

Export restrictions

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software:

Documentation

More information can be found on the Apache Commons Crypto homepage. The Javadoc can be browsed. Questions related to the usage of Apache Commons Crypto should be posted to the [user mailing list][ml].

Where can I get the latest release?

You can download source and binaries from our download page.

Alternatively you can pull it from the central Maven repositories:

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-crypto</artifactId>
  <version>1.2.0</version>
</dependency>

Contributing

We accept Pull Requests via GitHub. The developer mailing list is the main channel of communication for contributors. There are some guidelines which will make applying PRs easier for us:

  • No tabs! Please use spaces for indentation.
  • Respect the code style.
  • Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
  • Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running mvn.

If you plan to contribute on a regular basis, please consider filing a contributor license agreement. You can learn more about contributing via GitHub in our contribution guidelines.

License

This code is under the Apache Licence v2.

See the NOTICE.txt file for required notices and attributions.

Donations

You like Apache Commons Crypto? Then donate back to the ASF to support the development.

Additional Resources

Apache Commons Components

ComponentGitHub RepositoryApache Homepage
Apache Commons BCELcommons-bcelcommons-bcel
Apache Commons Beanutilscommons-beanutilscommons-beanutils
Apache Commons BSFcommons-bsfcommons-bsf
Apache Commons Build-plugincommons-build-plugincommons-build-plugin
Apache Commons Chaincommons-chaincommons-chain
Apache Commons CLIcommons-clicommons-cli
Apache Commons Codeccommons-codeccommons-codec
Apache Commons Collectionscommons-collectionscommons-collections
Apache Commons Compresscommons-compresscommons-compress
Apache Commons Configurationcommons-configurationcommons-configuration
Apache Commons Cryptocommons-cryptocommons-crypto
Apache Commons CSVcommons-csvcommons-csv
Apache Commons Daemoncommons-daemoncommons-daemon
Apache Commons DBCPcommons-dbcpcommons-dbcp
Apache Commons Dbutilscommons-dbutilscommons-dbutils
Apache Commons Digestercommons-digestercommons-digester
Apache Commons Emailcommons-emailcommons-email
Apache Commons Execcommons-execcommons-exec
Apache Commons Fileuploadcommons-fileuploadcommons-fileupload
Apache Commons Functorcommons-functorcommons-functor
Apache Commons Geometrycommons-geometrycommons-geometry
Apache Commons Graphcommons-graphcommons-graph
Apache Commons Imagingcommons-imagingcommons-imaging
Apache Commons IOcommons-iocommons-io
Apache Commons JCIcommons-jcicommons-jci
Apache Commons JCScommons-jcscommons-jcs
Apache Commons Jellycommons-jellycommons-jelly
Apache Commons Jexlcommons-jexlcommons-jexl
Apache Commons Jxpathcommons-jxpathcommons-jxpath
Apache Commons Langcommons-langcommons-lang
Apache Commons Loggingcommons-loggingcommons-logging
Apache Commons Mathcommons-mathcommons-math
Apache Commons Netcommons-netcommons-net
Apache Commons Numberscommons-numberscommons-numbers
Apache Commons Parentcommons-parentcommons-parent
Apache Commons Poolcommons-poolcommons-pool
Apache Commons Proxycommons-proxycommons-proxy
Apache Commons RDFcommons-rdfcommons-rdf
Apache Commons Release-plugincommons-release-plugincommons-release-plugin
Apache Commons Rngcommons-rngcommons-rng
Apache Commons Scxmlcommons-scxmlcommons-scxml
Apache Commons Signingcommons-signingcommons-signing
Apache Commons Skincommons-skincommons-skin
Apache Commons Statisticscommons-statisticscommons-statistics
Apache Commons Testingcommons-testingcommons-testing
Apache Commons Textcommons-textcommons-text
Apache Commons Validatorcommons-validatorcommons-validator
Apache Commons VFScommons-vfscommons-vfs
Apache Commons Weavercommons-weavercommons-weaver