32.1 Using the Wizard to Install Self Service Password Request

The following procedure describes how to install SSPR on a Linux or Windows platform using an installation wizard, either in the GUI format or from the console. To perform a silent, unattended installation, see Silently Installing Self Service Password Reset. To prepare for the installation, review the prerequisites and system requirements listed in Checklist for Installing Password Management Components.

  1. Log in as root or an administrator to the server where you want to install SSPR.

  2. Stop the Tomcat server.

  3. (Conditional) If you have the .iso image file for the Identity Manager installation package, navigate to the directory containing the SSPR installation files, located by default in the products/rbpm/sspr_install directory.

  4. (Conditional) If you downloaded the SSPR installation files, complete the following steps:

    1. Navigate to the .tgz or win.zip file for the downloaded image.

    2. Extract the contents of the file to a directory on the local computer.

  5. From the directory that contains the installation files, complete one of the following actions:

    • Linux (GUI): Enter ./sspr-install-linux.bin

    • Windows: Run sspr-install.exe

  6. Read and accept the license agreement, and then click Next.

  7. Specify a path for the installed files.

  8. Complete the guided process, using the following parameters:

    • Tomcat details

      Represents the home directory for the Tomcat server. For example, /opt/netiq/idm/apps/tomcat. The installation process adds some files for SSPR to this folder.

    • Tomcat connection

      Represents the settings of the URL that users need to connect to SSPR on the Tomcat server. For example, https://myserver.mycompany.com:8080.

      NOTE:You must also select Connect to an external authentication server and specify values for the external server if the following considerations are true:

      • You are installing SSPR.

      • OSP runs on a different instance of the supported application server than SSPR does.

      Protocol

      Specifies whether you want to use http or https. To use Secure Sockets Layer (SSL) for communications, specify https.

      Host Name

      Specifies the DNS name or IP address of the server where you are installing SSPR. Do not use localhost.

      Port

      Specifies the port that you want the server to use for communication with client computers.

      Connect to an external authentication server

      Specifies whether a different instance of Tomcat hosts the authentication server (OSP). The authentication server contains the list of users who can log in to SSPR.

      If you select this setting, also specify values for the authentication server’s Protocol, Host name, and Port.

    • Tomcat Java home

      Represents the home directory for Java on the Tomcat server. For example, /opt/netiq/idm/jre. The installation process adds some files for OSP to the directory.

    • Authentication details

      Represents the requirements for connecting to the authentication server which contains the list of users who can log in to the application. For more information about the authentication server, see Understanding Authentication with One SSO Provider.

      LDAP host

      Specifies the DNS name or IP address of the LDAP authentication server. Do not use localhost.

      LDAP port

      Specifies the port that you want the LDAP authentication server to use for communication with Identity Manager. For example, specify 389 for a non-secure port or 636 for SSL connections.

      Use SSL

      Specifies whether you want to use Secure Sockets Layer protocol for connections between the Identity Vault and the authentication server.

      JRE Trust store (cacerts) file

      Applies only when you want to use SSL for the LDAP connection.

      Specifies the path to the certificate. For example, C:\netiq\idm\apps\jre\lib\security\cacerts.

      JRE Trust store password

      Applies only when you want to use SSL for the LDAP connection.

      Specifies the password for the cacerts file.

      Admin DN

      Applies only when installing a new authentication server.

      Specifies the DN for an administrator account of the LDAP authentication server. For example, cn=admin,ou=sa,o=system.

      Admin password

      Applies only when installing a new authentication server.

      Specifies the password for the administrator account of the LDAP authentication server.

      User container

      Applies only when installing a new authentication server.

      Specifies the container in the LDAP authentication server where you store the user accounts that can log in to Access Review. For example, o=data.

      Admin container

      Applies only when installing a new authentication server.

      Specifies the container in the LDAP authentication server where you store the administrator accounts for Access Review. For example, ou=sa,o=system.

      Keystore Password

      Applies only when installing a new authentication server.

      Specifies the password that you want to create for the new keystore for the LDAP authentication server.

      The password must be a minimum of six characters.

    • SSPR details

      Represents the settings required for configuring SSPR.

      Configuration password

      Specifies the password that you want to create for an administrator to use to configure SSPR.

      By default, SSPR does not have a configuration password. Without the password, any user who can log in to SSPR can also modify the configuration settings.

      SSPR redirect URL

      Specifies the absolute URL to which the client will redirect when actions such as password changes or challenge questions have been completed in SSPR. For example, forward to the Dashboard.

      Use the following format: protocol://server:port/path. For example, http://idm_userapp_server_ip:port_no/idmdash/#/landing.

    • Authentication server details

      Represents the password that you want to create for the SSPR service to use when connecting to the OSP client on the server. Also referred to as the client secret.

      To modify this password after installation, use the RBPM Configuration utility.

    • Auditing details (SSPR)

      Represents the settings for auditing SSPR events that occur in the authentication server.

      (Conditional) Enable auditing for SSPR

      Specifies whether you want to send SSPR events to an auditing server.

      If you select this setting, also specify the settings for the syslog server.

      Syslog host name

      Applies only when you enable auditing for SSPR.

      Specifies the DNS or IP address of the server that hosts the syslog server. Do not use localhost.

      Syslog port

      Applies only when you enable auditing for SSPR.

      Specifies the port of the server that hosts the syslog server.

  9. To configure the identity applications and Identity Reporting to use SSPR, continue to Section XII, Installing the Identity Applications.

  10. In Configuration Update Utility, update the SSO clients Parameters. For more information see, Self Service Password Reset.

    For more information about configuring forgotten password management, see Configuring Forgotten Password Management.