step ca policy acme x509 allow dns
Name
step ca policy acme x509 allow dns -- add or remove DNS domains
Usage
step ca policy acme x509 allow dns <domain> [--remove]
[--provisioner=<name>] [--eab-key-id=<eab-key-id>] [--eab-key-reference=<eab-key-reference>]
[--admin-cert=<file>] [--admin-key=<file>] [--admin-subject=<subject>]
[--admin-provisioner=<name>] [--admin-password-file=<file>]
[--ca-url=<uri>] [--root=<file>] [--context=<name>]
Description
step ca policy acme x509 allow dns command manages DNS domains in policies
Options
--provisioner=name
The provisioner name
--eab-key-id=value
An ACME EAB Key ID.
--eab-key-reference=value
An ACME EAB Key Reference.
--remove removes the provided DNS names from the policy instead of adding them
--admin-cert=chain
Admin certificate (chain
) in PEM format to store in the 'x5c' header of a JWT.
--admin-key=file
Private key file
, used to sign a JWT, corresponding to the admin certificate that will
be stored in the 'x5c' header.
--admin-subject=subject
, --admin-name=subject
The admin subject
to use for generating admin credentials.
--admin-provisioner=name
, --admin-issuer=name
The provisioner name
to use for generating admin credentials.
--admin-password-file=file
, --password-file=file
The path to the file
containing the password to decrypt the one-time token
generating key.
--ca-url=URI
URI
of the targeted Step Certificate Authority.
--root=file
The path to the PEM file
used as the root certificate authority.
--context=name
The context name
to apply for the given command.
Examples
Allow www.example.com DNS in X.509 certificates on authority level
$ step ca policy authority x509 allow dns www.example.com
Allow all DNS subdomains of "local" in X.509 certificates on authority level
$ step ca policy authority x509 allow dns "*local"
Deny DNS badhost.local in X.509 certificates on authority level
$ step ca policy authority x509 deny dns "badhost.local"
Remove badhost.local from denied DNS names in X.509 certificates on authority level
$ step ca policy authority x509 deny dns "badhost.local" --remove
Allow all DNS subdomains of "example.com" in X.509 certificates on provisioner level
$ step ca policy provisioner x509 allow dns "*example.com" --provisioner my_provisioner
Allow all DNS subdomains of "account1.acme.example.com" in X.509 certificates on ACME Account level
$ step ca policy acme x509 allow dns "*account1.acme.example.com" --provisioner my_acme_provisioner --reference account1
Allow all DNS subdomains of "local" in SSH host certificates on authority level
$ step ca policy authority ssh host allow dns "*local"
Deny badsshhost.local in SSH host certificates on authority level
$ step ca policy authority ssh host allow dns "badsshhost.local"