Basic database password encryption

To add extra security to your Bamboo instance, you can encrypt the database password that is stored in the configuration file used by Bamboo to access your database. This method uses a Base64 cipher, which is a simple obfuscation. It’s recommended for users who don’t want to store passwords in plain text, or have to meet specific requirements to encode them. 

To encrypt your database password:

Step 1: Encrypt your password:

1. Go to <Bamboo-installation-directory>/tools/atlassian-password.

2. Run the following command to encrypt your password. Additionally, you can use optional arguments described below. 
   

   java -cp "./*" com.atlassian.db.config.password.tools.CipherTool

   Optional arguments...

   • -- silent -s: limits logging to minimum

   • -- help -h: prints a help message with all parameters

   • -- mode -m: defines what to do with the password, either encrypt or decrypt. If omitted, 'encrypt' will be used.

   • -- password -p: plain text password. If omitted, you'll be asked to enter it. We recommend that you omit this parameter so your password is not stored in the history.

   Sample output...

   main DEBUG [db.config.password.DefaultCipherProvider] Initiate cipher provider class: com.atlassian.db.config.password.ciphers.base64.Base64Cipher
   main DEBUG [password.ciphers.base64.Base64Cipher] Initiate Base64Cipher
   main DEBUG [password.ciphers.base64.Base64Cipher] Encrypting data...
   main DEBUG [password.ciphers.base64.Base64Cipher] Encryption done. 
   Success!
   For Jira (...)
   
   For Bamboo, set the following properties in bamboo.cfg.xml:
   
   <property name="jdbc.password.decrypter.classname">com.atlassian.db.config.password.ciphers.base64.Base64Cipher</property>
   <property name="hibernate.connection.password">YmFtYm9v</property>
   
   and restart then instance.

Step 2: Add the encrypted password to bamboo.cfg.xml:

1. Go to Bamboo home directory and back up the bamboo.cfg.xml file. Move the backup to a safe place outside of your Bamboo server.

2. Edit the bamboo.cfg.xml by adding the following tag:

   <property name="jdbc.password.decrypter.classname">com.atlassian.db.config.password.ciphers.base64.Base64Cipher</property>

3. Replace content of the <property name="hibernate.connection.password">  tag with the password encrypted by CLI. For example:

   <property name="hibernate.connection.password">YmFtYm9v</property>

4. Restart Bamboo.

To decrypt your database password:

To decrypt the password, extend the command with the -m decrypt parameter:

java -cp "./*" com.atlassian.db.config.password.tools.CipherTool -m decrypt

When asked for a password, provide the encrypted one from your bamboo.cfg.xml file.