mirror of
https://github.com/caddyserver/website.git
synced 2025-04-20 12:15:08 -04:00
acme_server: add docs of challenges
and allow/deny policy
This commit is contained in:
parent
a823fbf393
commit
1dfddb9d70
1 changed files with 22 additions and 3 deletions
|
@ -21,6 +21,16 @@ acme_server [<matcher>] {
|
||||||
ca <id>
|
ca <id>
|
||||||
lifetime <duration>
|
lifetime <duration>
|
||||||
resolvers <resolvers...>
|
resolvers <resolvers...>
|
||||||
|
challenges <challenges...>
|
||||||
|
allow_wildcard_names
|
||||||
|
allow {
|
||||||
|
domains <domains...>
|
||||||
|
ip_ranges <addresses...>
|
||||||
|
}
|
||||||
|
deny {
|
||||||
|
domains <domains...>
|
||||||
|
ip_ranges <addresses...>
|
||||||
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -30,6 +40,15 @@ acme_server [<matcher>] {
|
||||||
|
|
||||||
- **resolvers** are the addresses of DNS resolvers to use when looking up the TXT records for solving ACME DNS challenges. Accepts [network addresses](/docs/conventions#network-addresses) defaulting to UDP and port 53 unless specified. If the host is an IP address, it will be dialed directly to resolve the upstream server. If the hot is not an IP address, the addresses are resolved using the [name resolution convention](https://golang.org/pkg/net/#hdr-Name_Resolution) of the Go standard library. If multiple resolvers are specified, then one is chosen at random.
|
- **resolvers** are the addresses of DNS resolvers to use when looking up the TXT records for solving ACME DNS challenges. Accepts [network addresses](/docs/conventions#network-addresses) defaulting to UDP and port 53 unless specified. If the host is an IP address, it will be dialed directly to resolve the upstream server. If the hot is not an IP address, the addresses are resolved using the [name resolution convention](https://golang.org/pkg/net/#hdr-Name_Resolution) of the Go standard library. If multiple resolvers are specified, then one is chosen at random.
|
||||||
|
|
||||||
|
- **challenges** sets the enabled challenge types. If not set or the directive is used without values, then all challenge types are enabled. Accepted values are: http-01, tls-alpn-01, dns-01.
|
||||||
|
|
||||||
|
- **allow_wildcard_names** enables issuing of certificates with wildcard SAN (Subject Alternative Name)
|
||||||
|
|
||||||
|
- **allow**, **deny** configure the operational policy of the `acme_server`. The policy evaluation follows the criteria described by Step-CA [here](https://smallstep.com/docs/step-ca/policies/#policy-evaluation).
|
||||||
|
|
||||||
|
- **domains** sets the subject domain names to be allowed or denied per the policy evaluation criteria.
|
||||||
|
|
||||||
|
- **ip_ranges** sets the subject IP ranges to be allowed or denied per the policy evaluation criteria.
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue