MFA Server Key Backup
  • 19 Dec 2022
  • 2 Minutes to read
  • Contributors
  • Dark
    Light

MFA Server Key Backup

  • Dark
    Light

Article summary

Creating a backup of your MFA server's encryption keys is imperative to the upgrade and/or migration process. When RapidIdentity MFA Server is installed, random encryption keys are generated. Those keys are used to communicate securely with clients and store protected data in the system. Because of how this data is encrypted and decrypted, each database will be tied to its corresponding server sey.

For MFA Server deployments where multiple applications IIS Servers are (to be) deployed to communicate with a single SQL instance or farm, each MFA Server must utilize the same encryption key in order to access encrypted data stored in the database.

The following steps will help walk you through the backup and restoration processes. These steps should be performed for each subsequent MFA Server before any server operation is performed.

Server Key Backup

  1. Navigate to your MFA server’s respective installation folder and go into the “Tools” folder.
    4.9.4.6 or lower:
    C:\Program Files\2FA\ONE Server\Tools\KeyBackup

    4.9.5.1 or higher:
    C:\Program Files\Identity Automation\RapidIdentity MFA\Tools\KeyBackup

Upgrading Your MFA Server

If your MFA server is not up to version 4.9.5.1 or later, it is strongly recommended to upgrade. Please see our server upgrade information page for more information.


  1. Right-click the application “KeyBackup” > Run as administrator.
    1.png

  2. Select the Backup option.
    2.png

  3. Choose to save your backup as a File.
    3.png

  4. Click the ellipsis button (...) to name and save your backup file. You can create a password for this file if you ever need to go through the key restoration process here, but it is not required.
    5.png

  5. Once you’ve completed Step 5, hit “Finish”. You should receive a "successful" pop-up notification box.
    6.png


Server Key Restoration

In the even that you need to restore the key backup that you created:

  1. Click on the Restore option in the Key Backup Tool.
    restore.png

  2. Select File.

  3. Click the ellipsis button (...) to navigate and select your key backup file.

  4. Click Finish. You should receive the same "Operation was successful" pop-up message as in the backup steps.


Troubleshooting

If you receive a failure when you go to save the key, it may be a permissions issue. This should be quickly resolved by adding the right account to the software folder's security.

  1. Navigate to C:\Program Files.
  2. Right-click on the Identity Automation ("2FA" if you are v4.9.4.6 or lower) folder and select Properties.
  3. Under the Security tab, click on Edit...
  4. Click Add...
  5. Add the Network Service account and click OK.
    8.png

By default, the software's app pool identity is the NetworkService account. If you have a different service account for the oneAppPool40, it's recommended to add that account instead of Network Service like in this example.

10.png

  1. Highlight the newly added account and check (✓) the Full Control and Modify boxes. Click OK.
    9.png

  2. Re-try the key backup steps and you should be greeted with a "success" message.


Was this article helpful?