Skip to content
The latest version of DbVisualizer was released 2024-03-11DOWNLOAD HERE ->

Setting a Master Password

When you use Save Between Sessions for database passwords and SSH passwords or pass-phrases, they are by default encrypted using a static key. The same is true for the Proxy password if you have specified one. For better security, you can specify a Master Password that is then used instead of the static key to encrypt all passwords and pass-phrases. This way, only you know the information needed to decrypt the data. The algorithms used for encryption with a Master Password are also more advanced, minimizing the risk that the data can be decrypted by brute force.

Using a Master Password does, however, mean that if you forget it, there is no way to retrieve it and therefore no way to decrypt the saved passwords. It also means that the encrypted passwords cannot be read by a DbVisualizer version earlier than 9.2.

If you forget the Master Password, it cannot be recovered. The only way forward is to reset the Master Password, which also clears all passwords encrypted with it.

Passwords encrypted with a Master Passwords cannot be used in DbVisualizer version earlier than 9.2. If you set a Master Password in 9.2 and then use an earlier version, you will get "invalid password" errors when trying to connect with a saved password. You must enter the database or SSH password again in the earlier version, or go back to using DbVisualizer version 9.2 or later.

Specifying a Master Password

To use a Master Password for encoding of passwords saved between sessions:

  1. Open Tools->Tool Properties and select the General/Master Password category,
  2. Enter a password matching the described rules in both the New Password and Confirm New Password fields,
  3. Click Apply and then confirm that you want to do this after reading the warning about what it implies.

Master Password setup in DbVisualizer

The passwords for all connections with Save Between Sessions chosen for the password are now encrypted with the Master Password. The same goes for the SSH passwords/pass-phrases if you have selected to have them saved between sessions, as well as the proxy password, if any.

Changing a Master Password

If you want to change the Master Password:

  1. Open Tools->Tool Properties and select the General/Master Password category,
  2. Enter the current password in the Current Password field and the new password in both the New Password and Confirm New Password fields,
  3. Click Apply.

Changing Master Password in DbVisualizer

The saved passwords are then decrypted with the current Master Password and re-encrypted with the new.

Resetting the Master Password

If you have forgotten the Master Password, or simply no longer want to use one, you can reset it:

  1. Open Tools->Tool Properties and select the General/Master Password category,
  2. Click the Reset Master Password button and confirm that you want to do this.

Note that all passwords encoded with the Master Password are then immediately cleared and there is no way to recover them.

Prompted for Master Password

When you have a Master Password specified, you will be prompted for it whenever DbVisualizer needs you to authenticate. This happens for example when connecting to a database or modifying credentials. From then on, you can make other connections with saved passwords without being prompted until you restart DbVisualizer.

Manually Requesting the Master Password for New Connections

You can manually require being prompted for the Master Password again after entering it once within a DbVisualizer session:

  • Select Help->Ask for Master Password when Next Needed

Showing the Encrypted Password in Cleartext

When you have specified a Master Password, you can view the saved database password or SSH password/pass-phrase in cleartext.

  1. Right-click on the password field label and select Show Password,
  2. Enter the Master Password when prompted.

Declaring a Master Password Rule

A Master Password must have at least eight characters of any kind by default, but you can declare your own rule using a regular expression in an installation configuration file:

  1. Open the DBVIS-HOME/resources/dbvis-custom.prefs file,
  2. Enter a regular expression as the value of the dbvis.-MasterPasswordRule property,
  3. Enter a description of the rule for showing the user in Tool Properties as the value of the dbvis.-MasterPasswordRuleDescr property.

The regular expression for the default rule is .{8,}. It is easy to change the number in this expression to any number you want. There are regular expressions that can describe pretty much any rule you can come up with. For instance, this rule requires at least nine characters, with at least one symbol, one digit, one uppercase character, and one lowercase character:


If you cannot adopt these examples to your own policy, you can search the Internet for other examples of "regular expressions for password validations".