NAME

Net::ACME - Client for the ACME protocol (e.g., Let’s Encrypt)

SYNOPSIS

package MyACME::SomeService;

sub _HOST { }   #return the name of the ACME host

#See the examples/ directory in the distribution for usage.

DESCRIPTION

This module implements client logic for the ACME protocol, the system for automated issuance of SSL certificates used by Let’s Encrypt.

The methods of this class return objects that correspond to the respective ACME resource:

  • register(): Net::ACME::Registration

  • start_domain_authz(): Net::ACME::Authorization::Pending

  • get_certificate(): Net::ACME::Certificate or Net::ACME::Certificate::Pending

EXAMPLES

See the examples directory in the distribution.

TODO

  • Improve documentation

  • Port tests from original cPanel module. (The meaningful ones are highly dependent on cPanel’s testing framework.)

  • Support EC keys.

  • Test and support ACME v2 features (pending server support).

THANKS

  • cPanel, Inc. for permission to adapt their ACME framework for public consumption.

  • Stephen Ludin for developing and maintaining Protocol::ACME, from which this module took its inspiration.

REPOSITORY

https://github.com/FGasper/p5-Net-ACME

AUTHOR

Felipe Gasper (FELIPE)