diff options
| author | Lexi Winter <ivy@FreeBSD.org> | 2025-06-04 10:29:47 +0100 |
|---|---|---|
| committer | Lexi Winter <ivy@FreeBSD.org> | 2025-06-04 10:29:47 +0100 |
| commit | 09aa3870070960d37d7bdbb724f4ac7b68395fdf (patch) | |
| tree | 602574d74c739002614afd6956b96f093ee398ae /lfacme-http.5 | |
| parent | 07e2dff0f3f9b1007b26e28a932b5bc2dc6d5a20 (diff) | |
| download | lfacme-09aa3870070960d37d7bdbb724f4ac7b68395fdf.tar.gz lfacme-09aa3870070960d37d7bdbb724f4ac7b68395fdf.tar.bz2 | |
documentation improvements
Diffstat (limited to 'lfacme-http.5')
| -rw-r--r-- | lfacme-http.5 | 56 |
1 files changed, 0 insertions, 56 deletions
diff --git a/lfacme-http.5 b/lfacme-http.5 deleted file mode 100644 index ed5ca8e..0000000 --- a/lfacme-http.5 +++ /dev/null @@ -1,56 +0,0 @@ -.\" This source code is released into the public domain. -.Dd June 4, 2025 -.Dt LFACME-HTTP 5 -.Os -.Sh NAME -.Nm lfacme-http -.Nd validate an ACME challenge via HTTP -.Sh SYNOPSIS -In -.Xr domains.conf 5 : -.Bd -ragged -offset indent -.Ar domain -challenge=http -.Ed -.Sh DESCRIPTION -The -.Nm -challenge hook will respond to an ACME domain validation using an HTTP-based -.Dq http-01 -authorization. -To use this challenge hook, configure one or more domains with -.Dq challenge=http -in -.Xr domains.conf 5 . -.Pp -The -.Dq http-01 -challenge expects the authorization token to be served via HTTP at the path -.Dq /.well-known/acme-challenge/ Ns Ar token -on the domain to be validated. -When -.Nm -responds to the challenge, it will place the token in the directory configured -by -.Ar ACME_HTTP_CHALLENGE_DIR -in -.Xr acme.conf 5 . -This directory must be mapped to the appropriate path on the web server for -the challenge to succeed. -.Sh CONFIGURATION -The -.Nm -challenge hook supports the following configuration options in -.Xr acme.conf 5 : -.Bl -tag -width indent -.It Va ACME_HTTP_CHALLENGE_DIR -(Required.) -The directory to place the challenge tokens in. -The contents of this directory should be served at the path -.Dq /.well-known/acme-challenge -on the web server for the domain to be validated. -.El -.Sh SEE ALSO -.Xr acme.conf 5 , -.Xr domains.conf 5 , -.Xr lfacme-renew 8 |
