Skip to content

Commit d2cd804

Browse files
authored
Merge pull request #414 from smallstep/herman/step-ca-proxy-dns-name
Add proxy domain as CA DNS name requirement to proxy production considerations
2 parents 3cc1f07 + 180535a commit d2cd804

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

step-ca/certificate-authority-server-production.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -554,6 +554,12 @@ There's a few things you should know before you deploy this setup:
554554
(or set `STEP_MTLS` to `false`).
555555
This will trigger an alternative renewal flow that employs authentication tokens.
556556
(See `step ca renew --help` for more details.)
557+
- The authentication token is a JWT that contains the CA URL in its audience claim.
558+
The CA expects the audience to match one of its configured DNS names.
559+
If your proxy server is available on a different domain than your CA,
560+
your CA needs to be configured to have the domain of your proxy server
561+
as one of its DNS names in the `dnsNames` property in `ca.json`.
562+
(See [configuration options](./configuration.mdx#basic-configuration-options) for more details.)
557563
- By design, `step-ca` does not have an option to run in HTTP only.
558564
Philosophically, we value perimeterless security
559565
and we believe people should use encryption everywhere.

0 commit comments

Comments
 (0)