https://github.com/akrantz01/lers

An async, user-friendly Let's Encrypt/ACMEv2 library written in Rust
https://github.com/akrantz01/lers

acme letsencrypt rust

Last synced: over 1 year ago
JSON representation

An async, user-friendly Let's Encrypt/ACMEv2 library written in Rust

• Host: GitHub
• URL: https://github.com/akrantz01/lers
• Owner: akrantz01
• License: mit
• Created: 2023-03-23T23:11:00.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-02-26T02:24:18.000Z (over 1 year ago)
• Last Synced: 2025-03-24T09:16:36.008Z (over 1 year ago)
• Topics: acme, letsencrypt, rust
• Language: Rust
• Homepage: https://docs.rs/lers
• Size: 213 KB
• Stars: 30
• Watchers: 1
• Forks: 0
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# lers

[![Crates.io](https://img.shields.io/crates/v/lers)](https://crates.io/crates/lers)

[![docs.rs](https://img.shields.io/docsrs/lers/latest)](https://docs.rs/lers/latest/lers)

An async, user-friendly Let's Encrypt/ACMEv2 library written in Rust.

The API and implementation were inspired by [acme2][], [acme-micro][], and [lego][].

## Features

- ACME v2 ([RFC 8555][])

- Register with CA

- Obtain certificates

- Renew certificates

- Revoke certificates

- Robust implementation of ACME challenges

  - [HTTP][] (http-01)

  - [DNS][] (dns-01)

  - [TLS][] (tls-alpn-01)

- SAN certificate support

- Custom challenge solvers ([`Solver` trait][])

- [External account bindings][]

### Missing features

- [ ] Certificate bundling

Contributions are welcome for any of the above features.

### Supported DNS-01 Providers

Currently, the following providers are supported:

- [Cloudflare](https://www.cloudflare.com): [`CloudflareDns01Solver`][]

[acme2]: https://github.com/lucacasonato/acme2

[acme-micro]: https://github.com/kpcyrd/acme-micro

[lego]: https://github.com/go-acme/lego

[RFC 8555]: https://www.rfc-editor.org/rfc/rfc8555.html

[HTTP]: https://docs.rs/lers/latest/lers/solver/struct.Http01Solver.html

[DNS]: https://docs.rs/lers/latest/lers/solver/dns/index.html

[TLS]: https://docs.rs/lers/latest/lers/solver/struct.TlsAlpn01Solver.html

[`Solver` trait]: https://docs.rs/lers/latest/lers/solver/trait.Solver.html

[External account bindings]: https://www.rfc-editor.org/rfc/rfc8555.html#page-38

[`CloudflareDns01Solver`]: https://docs.rs/lers/latest/lers/solver/dns/struct.CloudflareDns01Solver.html