dianw / acme4j

Java client for ACME (Let's Encrypt)

ACME Java Client

This is a Java client for the Automatic Certificate Management Environment (ACME) protocol.

ACME is a protocol that a certificate authority (CA) and an applicant can use to automate the process of verification and certificate issuance.

This Java client helps connecting to an ACME server, and performing all necessary steps to manage certificates.

It is an independent open source implementation that is not affiliated with or endorsed by Let's Encrypt.

Features

• Supports ACME protocol up to draft 02, with a few parts of draft 03 and draft 04
• Easy to use Java API
• Requires JRE 7 or higher
• Built with maven, packages available at Maven Central
• Small, only requires jose4j and slf4j as dependencies
• Extensive unit tests

Usage

• See the online documentation about how to use acme4j.
• For a quick start, have a look at the source code of an example.

Compatibility

acme4j supports all CAs that implement the ACME protocol up to draft 02. draft 03 and draft 04 are partially supported. The missing parts are likely to be removed in the next draft, or are not yet supported by the Let's Encrypt server.

The most prominent ACME CA, Let's Encrypt, diverges from the specifications. Some parts of the acme4j API may not work with Let's Encrypt. Also, the usage of deprecated API parts may be required.

The acme4j API may change as features are added to, and other features removed from the ACME specifications, because they are still work in progress. Also see the acme4j bug tracker for missing and untested features.

Contribute

• Fork the Source code at GitHub. Feel free to send pull requests.
• Found a bug? File a bug report!

License

acme4j is open source software. The source code is distributed under the terms of Apache License 2.0.

Acknowledgements

• I would like to thank Brian Campbell and all the other jose4j developers. acme4j would not exist without your excellent work.