Skip to content

Docs: External CA/PKI: clarify intermediate CA cross-signing options #10392

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 21 additions & 3 deletions doc/06-distributed-monitoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -3270,9 +3270,27 @@ Intermediate CA restrictions:

* Each side has to provide its intermediate CAs along with the leaf certificate
in `/var/lib/icinga2/certs/NODENAME.crt`, ordered from leaf to root.
* Intermediate CAs may not be used directly as root CAs. To trust only specific
intermediate CAs, cross-sign them with themselves, so that you get equal
certificates except that they're self-signed. Use them as root CAs in Icinga.
* Intermediate CAs may not be used directly as root CAs.

##### Using an intermediate CA as Icinga root CA

For Icinga to trust only its own intermediate CA,
do either of the following:

###### Icinga itself issues leaf certificates

1. Setup Icinga as usual, with its own CA issuing leaf certificates.
2. Cross-sign that CA with the desired parent CA, to create an intermediate CA.
3. Add that new intermediate CA to your trusted root CAs where needed
to have an uninterrupted chain from your root CA to Icinga leaf certificates.

###### Leaf certificates are issued externally

1. Create your intermediate CA for Icinga.
2. Cross-sign it with itself, to create a root CA.
3. Use that self-signed CA as Icinga root CA.
4. Deploy leaf certificates manually,
each with its intermediate CA(s) as described in the parent section.

## Automation <a id="distributed-monitoring-automation"></a>

Expand Down
Loading