Knowledge Base

Support Policies

Renaming a SecureAuth Realm

SecureAuth IdP Version - All
 
 
Description:
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.
 
Resolution: 
 
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:
 
%windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/OriginalAppName" -path:/NewAppName
 
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

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.