semtle / 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 8 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

This version of acme4j is tailor-made for Let's Encrypt and other CAs that use the Boulder server. Boulder diverges from the ACME specifications, so acme4j cannot yet be used against other servers that fully comply to the ACME specifications.

The latest ACME specifications are being implemented in the "draft" branch of acme4j.

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.
• I also like to thank everyone who contributed to acme4j.