File: pebble-challtestsrv.1

package info (click to toggle)
pebble 2.6.0%2Bds1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 476 kB
  • sloc: python: 159; makefile: 4
file content (50 lines) | stat: -rw-r--r-- 1,702 bytes parent folder | download | duplicates (3)
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
44
45
46
47
48
49
50
.TH PEBBLE-CHALLTESTSRV 1
.SH NAME
pebble\-challtestsrv \- ACME challenge mock server
.SH SYNOPSIS
.B pebble
[\fB\-defaultIPv4\fR \fIstring\fR]
[\fB\-defaultIPv6\fR \fIstring\fR]
[\fB\-dns01\fR \fIstring\fR]
[\fB\-http01\fR \fIstring\fR]
[\fB\-https01\fR \fIstring\fR]
[\fB\-management\fR \fIstring\fR]
[\fB\-tlsalpn01\fR \fIstring\fR]
.SH DESCRIPTION
.B pebble-challtestsrv
is a utility that responds to HTTP-01,
DNS-01, and TLS-ALPN-01 ACME challenges.  It can also be used as a
mock DNS server letting developers mock `A`, `AAAA`, `CNAME`, and
`CAA` DNS data for specific hostnames.
.PP
Important note: The `pebble-challtestsrv` utility is for TEST USAGE
ONLY.  It is trivially insecure, offering no authentication
whatsoever.  Only use this library in a controlled test environment.
.SH OPTIONS
.TP
.BR \-defaultIPv4\ \fIstring\fR
Default IPv4 address for mock DNS responses to A queries (default
"127.0.0.1")
.TP
.BR \-defaultIPv6\ \fIstring\fR
Default IPv6 address for mock DNS responses to AAAA queries (default
"::1")
.TP
.BR \-dns01\ \fIstring\fR
Comma separated bind addresses/ports for DNS-01 challenges and fake
DNS data. Set empty to disable. (default ":8053")
.TP
.BR \-http01\ \fIstring\fR
Comma separated bind addresses/ports for HTTP-01 challenges. Set empty
to disable. (default ":5002")
.TP
.BR \-https01\ \fIstring\fR
Comma separated bind addresses/ports for HTTPS HTTP-01 challenges. Set
empty to disable. (default ":5003")
.TP
.BR \-management\ \fIstring\fR
Bind address/port for management HTTP interface (default ":8055")
.TP
.BR -tlsalpn01\ \fIstring\fR
Comma separated bind addresses/ports for TLS-ALPN-01 and HTTPS HTTP-01
challenges. Set empty to disable. (default ":5001")