Renaming a SecureAuth Realm

SecureAuth IdP Version - All

 

 

When a SecureAuth Realm is created, it is given the name SecureAuth plus a sequential number (e.g. SecureAuth3). Some customers prefer to use their own naming scheme to make it easier for users to locate resources. The instructions below discuss how to change the name of a SecureAuth IdP realm.

 

 

1. Open a command prompt with elevated user rights (Run as administrator)

 

2. Backup the IIS configuration by entering the following command into the command prompt:

 

%windir%\system32\inetsrv\appcmd.exe add backup "PreRenameBackup"

 

press Enter

 

 

3. Change a realm's name by entering the following command into the command prompt:

 

 

press Enter

information:

Change OriginalAppName to the SecureAuth Realm name to change (e.g. SecureAuth3)

Change NewAppName to the preferred name for the realm

4. Repeat step 3 for each realm that requires a name change

5. Restart the World Wide Web publishing service by entering the following command into the command prompt; iisrest and press Enter

Note: 

Should an error occur during the rename process, the configuration can be reverted to the previous settings by restoring the backup made at the beginning of the process. Follow the instructions below to recover from the backup.

1.  Open a command prompt with elevated user rights (Run as administrator)

2. Restore the IIS configuration by entering the following command into the command prompt, 

%windir%\system32\inetsrv\appcmd.exe restore backup "PreRenameBackup"

3. Restart the World Wide Web publishing service by entering the following command into the command prompt, iisreset and press Enter

Warning - Once a realm name is changed, the previous realm name (e.g. SecureAuth3) becomes unavailable to access, please ensure that a proper migration plan is in place before making the change