@@ -3270,9 +3270,27 @@ Intermediate CA restrictions:
3270
3270
3271
3271
* Each side has to provide its intermediate CAs along with the leaf certificate
3272
3272
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.
3276
3294
3277
3295
## Automation <a id =" distributed-monitoring-automation " ></a >
3278
3296
0 commit comments