diff options
Diffstat (limited to 'docs/reference/plugins/validation/dns')
| -rw-r--r-- | docs/reference/plugins/validation/dns/acme-dns.md | 3 | ||||
| -rw-r--r-- | docs/reference/plugins/validation/dns/index.md | 4 | ||||
| -rw-r--r-- | docs/reference/plugins/validation/dns/script.md | 22 |
3 files changed, 16 insertions, 13 deletions
diff --git a/docs/reference/plugins/validation/dns/acme-dns.md b/docs/reference/plugins/validation/dns/acme-dns.md index 9688fe7..8856cda 100644 --- a/docs/reference/plugins/validation/dns/acme-dns.md +++ b/docs/reference/plugins/validation/dns/acme-dns.md @@ -6,7 +6,8 @@ sidebar: reference Use an [acme-dns](https://github.com/joohoi/acme-dns) server to handle the validation records. The plugin will ask you to choose an endpoint to use. For testing the `https://auth.acme-dns.io/` endpoint is useful, but it is a security concern. As the readme of that project clearly states: -"You are encouraged to run your own acme-dns instance." + +> "You are encouraged to run your own acme-dns instance." ## Unattended Not supported, unless there is a pre-existing acme-dns registration for all the domains. diff --git a/docs/reference/plugins/validation/dns/index.md b/docs/reference/plugins/validation/dns/index.md index 16403f8..84251f5 100644 --- a/docs/reference/plugins/validation/dns/index.md +++ b/docs/reference/plugins/validation/dns/index.md @@ -5,8 +5,8 @@ sidebar: reference # DNS validation DNS validation works as follows: - For each domain, e.g. `sub.example.com`, the ACME server provides a -challenge consisting of an `x` and `y` value (it's a little more complicated than that, -but for the sake of this explanation it will suffice). +challenge consisting of an `x` and `y` value. The truth is actually a little +more complicated than that, but for the sake of this explanation it will suffice. - The client has to make sure that when the ACME server requests the TXT records for `_acme-challenge.sub.example.com`, there should be at least one record called `x` with content `"y"`. diff --git a/docs/reference/plugins/validation/dns/script.md b/docs/reference/plugins/validation/dns/script.md index f241d32..8e85f1f 100644 --- a/docs/reference/plugins/validation/dns/script.md +++ b/docs/reference/plugins/validation/dns/script.md @@ -7,19 +7,21 @@ Run an external script or program to create or update the validation records. ## Create A script to create the DNS record must be provided. The arguments passed to the -script will be `create {Identifier} {RecordName} {Token}` by default, with: +script will be `create {Identifier} {RecordName} {Token}` by default, where the +following replacements are made by win-acme: -- `create` - fixed value -- `{Identifier}` - host name that's being validated, e.g. `sub.example.com` -- `{RecordName}` - full name of the TXT record that is being expected, e.g. `_acme-challenge.sub.example.com` -- `{Token}` - content of the TXT record, e.g. `DGyRejmCefe7v4NfDGDKfA` +| Value | Replaced with | +|----------------|----------------| +| `{Identifier}` | host name that's being validated, e.g. `sub.example.com` | +| `{RecordName}` | full name of the TXT record that is being expected, e.g. `_acme-challenge.sub.example.com` | +| `{Token}` | content of the TXT record, e.g. `DGyRejmCefe7v4NfDGDKfA` | The order and format of arguments may be customized by providing a diffent argument string. -For example if your script needs arguments like... +For example if your script needs arguments like: `--host _acme-challenge.example.com --token DGyRejmCefe7v4NfDGDKfA` -...your argument string should be +...your argument string should like like this: `--host {RecordName} --token {Token}` @@ -35,9 +37,9 @@ A lot of good example scripts are available from the project. ## Unattended -- Create script only: +- ### Create script only `-validationmode dns-01 --validation dnsscript --dnscreatescript c:\create.ps1 [--dnscreatescriptarguments {args}]` -- Create and delete scripts seperate: +- ### Create and delete scripts seperate `-validationmode dns-01 --validation dnsscript --dnscreatescript c:\create.ps1 --dnsdeletescript c:\delete.ps1 [--dnscreatescriptarguments {args}] [--dnsdeletescriptarguments {args}]` -- Create and delete script (integrated): +- ### Create-delete script (integrated) `-validationmode dns-01 --validation dnsscript --dnsscript c:\create-and-delete.ps1 [--dnscreatescriptarguments {args}] [--dnsdeletescriptarguments {args}]`
\ No newline at end of file |