System Recovery
The following sections explain how to recover the ActivID AS system following a critical error.
ActivID AS applications use an internal system user to authenticate to the ActivID AS server. This user uses PKI credentials stored in the software keystore, <ACTIVID_HOME>/ActivID_AS/config/SYSUSERS.keystore.
There is one system user per Security Domain and node.
At installation, this system user is created by the ActivID ftinit user with the following characteristics:
-
User group − ActivID Setup (FTINIT)
-
Authentication record − System Static Login (AT_SYSLOG)
The system users are listed in the <ACTIVID_HOME>/ActivID_AS/applications/resources/common/activid.properties file.
Recover the Node System Users
The following procedure can be used to either recover the node system user (for example, if accidentally deleted) or to renew the user's self-signed certificate and keys using the following scripts located in the <ACTIVID_HOME>/ActivID_AS/bin folder:
-
recoverAdministratorUser.sh
-
configureSytemUser.sh
-
If the ActivID AS administrator and/or setup users (ftadmin, ftinit) have been deleted, first recreate similar users using the following command as ftadmin:
CopyrecoverAdministratorUser.sh -d <security domain>
-
As ftadmin, execute following command to create the keys in the software keystore:
CopyconfigureSytemUser.sh -c createkeyscerts -d <Security Domain> -v <validity period (years)>
-
Restart the ActivID AS Instance.
-
As ftadmin, execute following command to import the corresponding user’s credentials into the ActivID AS database (ActivID AS must be up and running):
CopyconfigureSytemUser.sh -c importsysusers -d <Security Domain>
-
When prompted, enter the credentials for the setup user (ftinit).
Recover the ActivID AS Application Configuration
The configureIDPData.sh script located in the <ACTIVID_HOME>/ActivID_AS/bin/ folder (re)configures the ActivID Authentication Portal (SAML IDP) and the Management Console or Self-Service Portal (SAML service providers).
This procedure can be used to either recover the SAML configuration or to renew the SAML IDP certificates and keys.
-
If the ftinit user has been deleted, first recreate it.
-
As ftadmin, execute the following command to create the SAML configuration in the ActivID AS database (ActivID AS must be up and running):
CopyconfigureIDPData.sh -c importdata -d <Security Domain>
-
When prompted, enter the credentials for the setup user (ftinit).
Recover the ActivID AS Administrators
If the ActivID AS administrators that are used to administer the ActivID AS system are blocked or deleted, the recoverAdministratorUser.sh script located in the <ACTIVID_HOME>/ActivID_AS/bin/ folder allows recreating the ftadmin and ftinit users in the ActivID AS database for a domain.
You know the domain database password (required by the script).
The ActivID AS server is running and operational.
-
As ftadmin , use following command to recover the ActivID AS administrators:
CopyrecoverAdministratorUser.sh -d <Domain Name>
Where <Domain Name> is the name of security domain.
-
When prompted, enter the administrator user/password for ftadmin.
-
When prompted, enter the administrator user/password for ftinit.
-
When prompted, enter the domain database password.
Recover an ActivID AS Node
With the exception of the <ACTIVID_HOME>/ActivID_AS/config/ActivID.keystore file (the ActivID AS software keystore), the ActivID AS applications installations can easily be recreated by running the setup and customizing the applications either manually or using a customization package.
-
If ActivID AS is configured to use a software keystore for database data encryption/signing, it is critical that you always have a backup of the latest version of the ActivID.keystore stored in a safe place in order to recover a node.
-
If ActivID AS is configured with an HSM, this is less critical as the ActivID.keystore only contains the SAML IDP certificates, but not the encryption/signing keys. To restore your system, you will have to reconfigure every service provider with the new SAML IDP metadata and certificates.
To recover a node:
-
Install and configure the ActivID AS applications (refer to the ActivID AS installation guide for your application server available from the ActivID Customer Portal).
-
When asked if it is the first Authentication Services installation, enter n and then enter the path of the backup of the ActivID.keystore file. Then, enter the keystore password when prompted.
-
If necessary, apply the customization package.
-
Start the application server.
-
Perform the post-installation steps (refer to the ActivID AS installation guide for your application server available from the ActivID Customer Portal).