Skip to content
Snippets Groups Projects
Unverified Commit 492d3ff4 authored by Luis Paolini's avatar Luis Paolini Committed by GitHub
Browse files

Try making the encryption clearer (#20661)


* Try making the encryption clearer

Got the question a few times, so I thought we had to make it more explicit

* Update docs/operations-guide/encrypting-database-details-at-rest.md

Co-authored-by: default avatarJeff Bruemmer <jeff@metabase.com>

Co-authored-by: default avatarJeff Bruemmer <jeff@metabase.com>
parent da6d6f87
No related branches found
No related tags found
No related merge requests found
......@@ -12,14 +12,14 @@ This gives you a cryptographically-secure, randomly-generated 32-character key t
start Metabase as usual:
MB_ENCRYPTION_SECRET_KEY="IYqrSi5QDthvFWe4/WdAxhnra5DZC3RKx3ZSrOJDKsM=" java -jar metabase.jar
**Note** Some versions of Linux interpret single-quotes (`'`) and double-quotes (`"`) differently for environment variable values, so if you upgrade to a newer version of Linux, and the key originally used single-quotes, you might need to wrap the key in double-quotes, so that the single-quotes are interpreted literally. For example, `MB_ENCRYPTION_SECRET_KEY='IYq...sM='` would be `MB_ENCRYPTION_SECRET_KEY="'IYq...sM='"`
Metabase will securely encrypt and store the connection details for any new Databases you add. (Connection details for existing databases will be encrypted as well if you save them in the admin panel).
Existing databases with unencrypted details will continue to work normally.
>Take care not to lose this key because you can't decrypt connection details without it. If you lose (or change) the key, you'll have to reset all of the connection details that have been encrypted with it in the Admin Panel.
Once you set the `MB_ENCRYPTION_SECRET_KEY` value, Metabase will securely encrypt and store the connection details for each new database that you add.
If you added databases before setting the `MB_ENCRYPTION_SECRET_KEY` value, you can encrypt the connection details by going to each one of those databases in **Admin settings** > **Databases** and clicking on the **Save** button. Existing databases with unencrypted details will continue to work normally.
# Key rotation
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment