smallstep_full_white

step ca policy acme x509 allow email

Name

step ca policy acme x509 allow email -- add or remove email addresses

Usage

step ca policy acme x509 allow email <email> [--remove] [--provisioner=<name>]
[--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 email command manages email addresses and domains in policies

Options

--provisioner=name The provisioner name

--remove removes the provided emails 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 all email addresses for the example.com domain in X.509 certificates on authority level

$ step ca policy authority x509 allow email @example.com

Remove the email addresses for the example.com domain in X.509 certificates on authority level

$ step ca policy authority x509 allow email @example.com --remove

Deny badmail@example.com in X.509 certificates on authority level

$ step ca policy authority x509 deny email badmail@example.com

Allow all email addresses for the example.com domain in X.509 certificates on provisioner level

$ step ca policy provisioner x509 allow email @example.com --provisioner my_provisioner

Allow all local parts for the example.com domain in SSH user certificates on provisioner level

$ step ca policy provisioner ssh user allow email @example.com --provisioner my_provisioner

Deny root@example.com domain in SSH user certificates on provisioner level

$ step ca policy provisioner ssh user deny email @example.com --provisioner my_provisioner