Skip to content

apache/commons-crypto

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date
Aug 2, 2024
Jul 9, 2016
Jul 29, 2024
Feb 3, 2023
Jul 7, 2016
Aug 27, 2020
Nov 24, 2023
May 16, 2021
Sep 1, 2022
Nov 24, 2023
Mar 27, 2015
Nov 4, 2023
Jul 23, 2024
Dec 25, 2023
Nov 1, 2023
Jun 29, 2024
Nov 28, 2023
Oct 30, 2020
Nov 29, 2023
Aug 1, 2024

Repository files navigation

Apache Commons Crypto

Java CI 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.

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 License 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

Please see the list of components