![]() |
||
---|---|---|
.github | ||
acme4j-client | ||
acme4j-example | ||
acme4j-utils | ||
src/site | ||
.gitignore | ||
.gitlab-ci.yml | ||
.project | ||
CONTRIBUTING.md | ||
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.
ACME v1
This acme4j branch implements the deprecated ACME v1 protocol. Let's Encrypt has announced an End of Life Plan for ACME v1. According to this plan, access to the ACME v1 servers will be limited starting November 2019, and completely stopped in June 2021.
For this reason, development of acme4j v1 has been terminated since November 1st, 2019. Please migrate your code to acme4j v2.5 or higher!
There will be no more updates or security fixes for acme4j v1. Bug reports related to acme4j v1 will be closed without comment.
Features
- Supports the "ACME v1" protocol that is used by Let's Encrypt
- Easy to use Java API
- Requires JRE 8u101 or higher
- Built with maven, packages available at Maven Central
- Small:
acme4j-client
only requires jose4j and slf4j as dependencies - Only the optional
acme4j-utils
module requires Bouncy Castle - 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.
Contribute
- Fork the Source code at GitHub. Feel free to send pull requests. However, work on this branch is discontinued in favor of the ACMEv2 implementation in the master branch. We will only accept bug fixes and security related patches.
- Found a bug? File a bug report. Please add a note that you are referring to the old ACMEv1 implementation!
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.