![]() |
||
---|---|---|
acme4j-client | ||
acme4j-example | ||
acme4j-it | ||
acme4j-utils | ||
src/site | ||
.gitignore | ||
.gitlab-ci.yml | ||
.project | ||
LICENSE-APL.txt | ||
README.md | ||
pom.xml |
README.md
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
- Fully supports the ACME v2 protocol
- 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 and integration tests
Current Status
This branch implements the ACME v2 protocol.
It is not meant for production yet! There are no servers that fully cover the ACME v2 API at the moment. For this reason, some of the functions are also untested.
Use the master branch for production purposes.
Known issues:
- Only implements ACME v2 up to draft 07.
- The API is still subject to change, if required by future drafts.
- Integration tests do not fully cover all functions. The standard methods for creating an account, ordering, and downloading a certificate are tested. Other methods are not tested yet, and may not work as expected.
Usage
- See the online documentation about how to use acme4j.
- For a quick start, have a look at the source code of an example.
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.