acme-lite

Crates.ioacme-lite
lib.rsacme-lite
version0.0.2
sourcesrc
created_at2023-08-29 21:06:41.626494
updated_at2023-09-03 23:47:40.390715
descriptionRequest certificates from an ACME provider
homepage
repositoryhttps://github.com/x52dev/acme-lite
max_upload_size
id958466
size150,857
Rob Ede (robjtede)

documentation

README

acme-lite

acme-lite is a fork of acme-micro and acme-lib and facilitates provisioning certificates from ACME (Automatic Certificate Management Environment) services such as Let's Encrypt.

It follows the RFC 8555 spec, using ACME v2 to issue/renew certificates.

Domain ownership

Most website TLS certificates tries to prove ownership/control over the domain they are issued for. For ACME, this means proving you control either a web server answering HTTP requests to the domain, or the DNS server answering name lookups against the domain.

To use this library, there are points in the flow where you would need to modify either the web server or DNS server before progressing to get the certificate.

See http_challenge and dns_challenge.

Multiple domains

When creating a new order, it's possible to provide multiple alt-names that will also be part of the certificate. The ACME API requires you to prove ownership of each such domain. See authorizations.

Rate limits

The ACME API provider Let's Encrypt uses rate limits to ensure the API I not being abused. It might be tempting to put the delay really low in some of this libraries' polling calls, but balance this against the real risk of having access cut off.

Use staging for development!

Especially take care to use the Let's Encrypt staging environment for development where the rate limits are more relaxed. See DirectoryUrl::LetsEncryptStaging.

Commit count: 131

cargo fmt