NAME

Net::ACME2::Challenge::http_01

SYNOPSIS

    #e.g., “/.well-known/acme-challenge/12341243sdafdewrsvfd”
    my $path = $challenge->path();

    {
        my $handler = $challenge->create_handler( ... );

        $acme->accept_challenge($challenge);

        sleep 1 while !$acme->poll_authorization();
    }

DESCRIPTION

This module is instantiated by Net::ACME2::Authorization and is a subclass of Net::ACME2::Challenge.

METHODS

OBJ->create_handler( KEY_AUTHZ, DOCROOT )

Creates a file in the given DOCROOT that will, if served up normally, satisfy ACME’s requirements for this challenge. The return value is an object that, when DESTROYed, will remove that file.

(KEY_AUTHZ is the return of the Net::ACME2 instance’s make_key_authorization() method.)

This can simplify the authorization process if you’re on the same server as all of the authorization object’s identifiers’ HTTP document roots.

OBJ->path()

Returns the URL path that needs to serve up the key authorization. This is useful if, for whatever reason, you’re not using create_handler() to satisfy this challenge.

Example:

    /.well-known/acme-challenge/LoqXcYV8q5ONbJQxbmR7SCTNo3tiAXDfowyjxAjEuX0