Skip to content

Commit 8846465

Browse files
committed
Docs: External CA/PKI: clarify intermediate CA cross-signing options
1 parent 0613381 commit 8846465

File tree

1 file changed

+21
-3
lines changed

1 file changed

+21
-3
lines changed

doc/06-distributed-monitoring.md

+21-3
Original file line numberDiff line numberDiff line change
@@ -3270,9 +3270,27 @@ Intermediate CA restrictions:
32703270

32713271
* Each side has to provide its intermediate CAs along with the leaf certificate
32723272
in `/var/lib/icinga2/certs/NODENAME.crt`, ordered from leaf to root.
3273-
* Intermediate CAs may not be used directly as root CAs. To trust only specific
3274-
intermediate CAs, cross-sign them with themselves, so that you get equal
3275-
certificates except that they're self-signed. Use them as root CAs in Icinga.
3273+
* Intermediate CAs may not be used directly as root CAs.
3274+
3275+
##### Using an intermediate CA as Icinga root CA
3276+
3277+
For Icinga to trust only its own intermediate CA,
3278+
do either of the following:
3279+
3280+
###### Icinga itself issues leaf certificates
3281+
3282+
1. Setup Icinga as usual, with its own CA issuing leaf certificates.
3283+
2. Cross-sign that CA with the desired parent CA, to create an intermediate CA.
3284+
3. Add that new intermediate CA to your trusted root CAs where needed
3285+
to have an uninterrupted chain from your root CA to Icinga leaf certificates.
3286+
3287+
###### Leaf certificates are issued externally
3288+
3289+
1. Create your intermediate CA for Icinga.
3290+
2. Cross-sign it with itself, to create a root CA.
3291+
3. Use that self-signed CA as Icinga root CA.
3292+
4. Deploy leaf certificates manually,
3293+
each with its intermediate CA(s) as described in the parent section.
32763294

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

0 commit comments

Comments
 (0)