Skip to content

Commit 3f3c304

Browse files
committed
Added detail for certificate rotation feature
1 parent 0bcc0d4 commit 3f3c304

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

modules/ROOT/pages/security/ssl-framework.adoc

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1108,6 +1108,31 @@ Beware that the SSL debug option logs a new statement every time a client connec
11081108
To avoid that scenario, make sure this setting is only enabled for a short term duration.
11091109
====
11101110
1111+
[[certificate-rotation]]
1112+
== Certificate Rotation
1113+
It is considered best practice to use certificates with reasonably short duration. This, however, requires the periodic rotation of certificates whereby old certificates are removed and the new ones installed. Previous versions of Neo4j required a the restart of a database instance for changes to be applied. New certificates can now be rotated in and SSL configuration changed without a restart being required. This reduces undesirable effects of transient loss of cluster members.
1114+
1115+
. Enable the dynamic reloading of certificates on all cluster members. It is best to do this when the cluster is deployed as changing this configuration requires a restart:
1116+
1117+
[source, properties]
1118+
----
1119+
dbms.security.tls_reload=true (default is false)
1120+
----
1121+
1122+
. Make necessary changes to any of the SSL configuration and/or replace certificates for desired scopes. New certificates will need to be copied to all cluster members as required.
1123+
1124+
. Connect to each cluster member in turn using Cypher Shell using a bolt scheme and run the reload procedure:
1125+
1126+
[source]
1127+
----
1128+
dbms.reloadTLSCertificates()
1129+
----
1130+
1131+
. New settings will take effect immediately, however existing connections will not be pre-emptively terminated.
1132+
1133+
. Verify that the intra-cluster communication is still encrypted using external tooling, such as Nmap, described above.
1134+
1135+
11111136
[[ssl-terminology]]
11121137
== Terminology
11131138

0 commit comments

Comments
 (0)