Master Password

Introduction

In FNZ Studio, you can set a master password to encrypt all other passwords and increase the security of your platform. This article explains how to manage the master password and describes its impact on the FNZ Studio Platform startup procedure.

Master Password and Startup

The Platform startup procedure (System Startup and Shutdown) consists of two phases. The execution of these phases depends on whether you have configured the Platform to use a master password:

  1. If a master password is not configured, both phases are executed sequentially until the system starts up completely.

  2. If a master password is configured, the system requires the master password after phase one completes.

The master password can be provided in the following ways:

  • As a context attribute: nm.master.password
  • As a context init parameter:nm.master.password
  • As a system property: nm.master.password
  • As an environment variable: NM_MASTER_PASSWORD
  • By setting configuration property nm.master.password in the default.properties file

The system uses the first master password it finds.

If the master password is provided in one of the above ways described above and is correct, the Platform starts without any interruption.

Setting the Master Password

The administrator can set the master password when the Platform is running by running the following code in the Interactive Script Editor (ISE):

Copy 
ChangeMasterPassword('oldPassword', 'newPassword') 

The function ChangeMasterPassword replaces the old master password with a new one. The first parameter states the current master password (if you are setting the master password for the first time, enter an empty string), the second parameter defines the new password.

The ChangeMasterPassword function is only available by installing the ChangeMasterPassword Extension.