Provisioners authenticate certificate requests. Certificate lifetimes, access control policies, renewal, templates, and many other options are configurable per-provisioner.
By setting claims on a provisioner, you can control minimum, maximum, and default certificate lifetimes. Let's take a look at the provisioner claims on the authority-admin
provisioner that's automatically created with your Authority.
Claims are enabled with a maximum duration of 8784 hours or 366 days. A default duration is not set, so it uses the authority default value of 24 hours.
step beta ca provisioner get authority-admin
No admin credentials found. You must login to execute admin commands.
✔ Please enter admin name/subject (e.g., name@example.com):
✔ Provisioner: authority-admin (OIDC)
Your default web browser has been opened to visit:
<https://auth.smallstep.com/oidc/>
{
"id": "2e8b84fa-5af6-4635-a3c2-f852f8011834",
"authorityId": "f09f83fd-7e58-418d-9a30-ef4885336873",
"type": "OIDC",
"name": "authority-admin",
"details": {
"OIDC": {
"clientId": "380d0a5a-7263-4e4365",
"clientSecret": "fab9df242449bf96",
"configurationEndpoint": "<https://auth.smallstep.com/oidc/beta/.well-known/openid-configuration>",
"admins": [
"TeamAdmins@yourco.com"
],
"listenAddress": "127.0.0.1:10000"
}
},
"claims": {
"x509": {
"enabled": true,
"durations": {
"max": "8784h0m0s"
}
}
}
Here, we'll update the claims on the provisioner to produce a 7-day (168h) default certificate. We will also set the minimum lifetime to 5 minutes and the maximum lifetime to 500 days (12000h):
step beta ca provisioner update authority-admin \\
--x509-default-dur=168h --x509-min-dur=5m --x509-max-dur=12000h \\
...
},
"claims": {
"x509": {
"enabled": true,
"durations": {
"default": "168h",
"min": "5m",
"max": "12000h"
}
}
}
},
Issue and inspect a certificate to test the new 7-day default expiry:
step ca certificate newdefault newdefault.crt newdefault.key
✔ Provisioner: authority-admin (OIDC)
✔ CA: <https://production.yourco.ca.smallstep.com>
✔ Certificate: newdefault.crt
✔ Private Key: newdefault.key
step certificate inspect newdefault.crt --shortX.509v3 TLS Certificate (ECDSA P-256) [Serial: 2046...1094]
Subject: newdefault
Issuer: Production Intermediate CA
Provisioner: authority-admin [ID: 380d...c5c0]
Valid from: 2021-10-29T00:18:43Z
to: 2021-11-05T00:19:43Z
PLEASE NOTE: The claims section on ANY Provisioner can be defined or modified with certificate minimum and maximum lifetimes and default certificate expiry. A single Authority can support many provisioners that unlock various automated workflows. Click to learn more about provisioners and claims.