Skip to content

Commit 02bcdf5

Browse files
clarify x509 rotation doc (#2485)
Signed-off-by: stormshield-gt <tudy.gourmelen@stormshield.eu>
1 parent ffbe137 commit 02bcdf5

File tree

1 file changed

+14
-16
lines changed

1 file changed

+14
-16
lines changed

website/content/docs/secrets/pki/rotation-primitives.mdx

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -472,22 +472,20 @@ automation level and operational awareness of the organization.
472472
manually and proactively. This step takes time, and depends on the
473473
types of certificates issued (e.g., server certs, code signing, or client
474474
auth).
475-
476-
4. Once _all_ chains have been updated, new systems can be brought online
477-
with only the new root certificate, and connect to all existing systems.
478-
479-
5. Existing systems can now be migrated with a one-shot root switch: the
480-
new root can be added and the old root can be removed at the same time.
481-
Assuming the above step 3 can be achieved in a reasonable amount of time,
482-
this decreases the time it takes to move the majority of systems over to
483-
fully using the new root and no longer trusting the old root. This step
484-
also takes time, depending on how quickly the organization can migrate
485-
roots and ensure all such systems are migrated. If some systems are
486-
offline and only infrequently online (or, if they have hard-coded
487-
certificate stores and need to reach obsolescence first), the organization
488-
might not be ready to move on to future steps.
489-
490-
6. At this point, since all systems now use the new root, it is safe to remove
475+
4. Once _all_ chains have been updated:
476+
- New systems can be brought online
477+
with only the new root certificate, and connect to all existing systems.
478+
- Existing systems can now be migrated with a one-shot root switch: the
479+
new root can be added and the old root can be removed at the same time.
480+
Assuming the above step 3 can be achieved in a reasonable amount of time,
481+
this decreases the time it takes to move the majority of systems over to
482+
fully using the new root and no longer trusting the old root. This step
483+
also takes time, depending on how quickly the organization can migrate
484+
roots and ensure all such systems are migrated. If some systems are
485+
offline and only infrequently online (or, if they have hard-coded
486+
certificate stores and need to reach obsolescence first), the organization
487+
might not be ready to move on to future steps.
488+
5. At this point, since all systems now use the new root, it is safe to remove
491489
or archive the old root and intermediates, updating the manual chain to
492490
point strictly to the new intermediate+root.
493491

0 commit comments

Comments
 (0)