ACME Java Client

This is a Java client for the Automatic Certificate Management Environment (ACME) protocol as specified in RFC 8555.

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 to connect to an ACME server, and performing all necessary steps to manage certificates.

Features

• Mature and stable code base. First release was in December 2015!
• Fully RFC 8555 compliant
• Supports the http-01, dns-01, and tls-alpn-01 (RFC 8737) challenges
• Supports RFC 8738 IP identifier validation
• Supports RFC 8739 short-term automatic certificate renewal (experimental)
• Supports RFC 8823 for S/MIME certificates (experimental)
• Supports RFC 9444 for subdomain validation
• Supports RFC 9773 for renewal information
• Supports draft-ietf-acme-profiles-01 for certificate profiles (experimental)
• Supports draft-ietf-acme-dns-account-label-02 for DNS labeled with ACME account ID challenges (experimental)
• Supports draft-ietf-acme-dns-persist-01 for dns-persist-01 challenges (experimental)
• Easy to use Java API
• Requires JRE 17 or higher
• Supports Actalis, Google Trust Services, Let's Encrypt, SSL.com, ZeroSSL, and all other CAs that comply with the ACME protocol (RFC 8555). Note that acme4j is an independent project that is not supported or endorsed by any of the CAs.
• Built with maven, packages available at Maven Central
• Extensive unit and integration tests
• Adheres to Semantic Versioning

Dependencies

• Bouncy Castle
• jose4j
• slf4j
• For acme4j-smime: Jakarta Mail, Bouncy Castle

Usage

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

Announcements

Follow our Mastodon feed for release notes and other acme4j related news.

• Mastodon: @acme4j@foojay.social
• RSS: https://foojay.social/@acme4j.rss

Contribute

• Fork the Source code at Codeberg or GitHub. Feel free to send pull requests (see Contributing for the rules).
• Found a bug? File a bug report! (GitHub)

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.
• Thanks to Daniel McCarney for his help with the ACME protocol, Pebble, and Boulder.
• Ulrich Krause for his help to make acme4j run on IBM Java VMs.
• I also like to thank everyone who contributed to acme4j.
• The Mastodon account is hosted by foojay.io.