blob: c66f9f810b653aa54182a7c6326924ea25c27a11 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
.\" 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 SEE ALSO
.Xr acme.conf 5 ,
.Xr domains.conf 5 ,
.Xr lfacme-renew 8
|
