Skip to content

Emphasize the use of --expand-commands when using encrypted private key#3011

Open
renetapopova wants to merge 3 commits into
neo4j:devfrom
renetapopova:dev-ssl-encrypted-private-key
Open

Emphasize the use of --expand-commands when using encrypted private key#3011
renetapopova wants to merge 3 commits into
neo4j:devfrom
renetapopova:dev-ssl-encrypted-private-key

Conversation

@renetapopova
Copy link
Copy Markdown
Collaborator

@@ -1087,12 +1093,6 @@ To adjust paths to cert and encrypted password file, use full paths:
dbms.ssl.policy.bolt.private_key_password=$(base64 -w 0 certificate.crt | openssl aes-256-cbc -a -d -in password.enc -pass stdin)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two things:

  1. I think it should be like this for command expansion to work:

dbms.ssl.policy.bolt.private_key_password=$(bash -lc 'base64 -w 0 /path/to/certificate.crt | openssl aes-256-cbc -a -d -in /path/to/password.enc -pass stdin'

  1. In this example we call out "bolt" in dbms.ssl.policy.bolt.private_key_password specifically but depending on what the user is trying to do it could be either of bolt, https, cluster, backup

Copy link
Copy Markdown

@JoakimBulow JoakimBulow Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

and actually "certificate.crt" does not need to be a certificate, just anything random enough will do.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @JoakimBulow. I added your suggestion. Unfortunately, I don't know enough to comment on what you're suggesting.

Copy link
Copy Markdown
Collaborator Author

@renetapopova renetapopova Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you think the steps can be simplified or changed to say that a certificate can be anything, could you please make the suggestions in line? Thanks

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@JoakimBulow, could you take a look at my comment above? Thanks!

Comment thread modules/ROOT/pages/security/ssl-framework.adoc Outdated
Comment thread modules/ROOT/pages/security/ssl-framework.adoc Outdated
@renetapopova renetapopova force-pushed the dev-ssl-encrypted-private-key branch from 29bacb9 to 6dc494e Compare May 14, 2026 12:18
@neo4j-docops-agent
Copy link
Copy Markdown
Collaborator

This PR includes documentation updates
View the updated docs at https://neo4j-docs-operations-3011.surge.sh

Updated pages:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants