8.7 Configuring Self Service Password Reset for Single Sign-On Clients

Self Service Password Reset can integrate with different systems to provide a single sign-on (SSO) experience for your users. Self Service Password Reset supports basic authentication (basic auth), HTTP SSO, and OAuth.

8.7.1 Configuring Basic Authentication for Single Sign-On

Self Service Password Reset allows you to use HTTP basic authentication for a single sign-on experience for your users. By default, Self Service Password Reset uses basic authentication.

To configure basic authentication:

  1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

  2. In the toolbar, click your name.

  3. Click Configuration Editor.

  4. Click Settings > Single Sign On (SSO) Client > Basic Authentication.

  5. Configure the following settings:

    Enable Basic Authentication

    Enable this option to enable basic authentication for Self Service Password Reset. By default, this option is enabled.

    Force Basic Authentication

    Enable this options to force basic authentication. If false, then the system presents the form page for unauthenticated users, however, if a basic auth header is present, the system always uses it.

  6. In the toolbar, click Save changes.

8.7.2 Configure HTTP for Single Sign-On

Self Service Password Reset allows you to create a single sign-on experience using an HTTP header. Self Service Password Reset uses the HTTP header to automatically log users into an application with a user name only.

To configure the HTTP header for single sign-on:

  1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

  2. In the toolbar, click your name.

  3. Click Configuration Editor.

  4. Click Settings > Single Sign On (SSO) Client > HTTP SSO.

  5. Configure the following setting:

    SSO Authentication Header Name

    Specify the name of the HTTP header that configures Self Service Password Reset to use an upstream server to allow automatic logins with only a user name, a password is not required. This setting controls the name of the HTTP header. When used, Self Service Password Reset prompts users for their passwords to access certain functionality.

  6. In the toolbar, click Save changes.

8.7.3 Configuring OAuth Single Sign-On

Self Service Password Reset allows you to create a single sign-on experience for your users using OAuth. You must have a basic understanding of OAuth to complete the configuration because you must obtain OAuth-specific information from the application to complete the configuration. For more information, see https://oauth.net/2/.

Use the following information to create an OAuth single sign-on experience for your users. You must gather information from the OAuth Identity Server of your application.

To configure OAuth SSO:

  1. Log in to Self Service Password Reset at https://dns-name/sspr as an administrator.

  2. In the toolbar, click your name.

  3. Click Configuration Editor.

  4. Click Settings > Single Sign On (SSO) Client > OAuth.

  5. Configure the following settings:

    OAuth Login URL

    Specify the URL for OAuth server login. This is the URL to redirect the users to for authentication.

    OAuth Code Resolve Service URL

    Specify the URL for OAuth Code Resolve Service. Self Service Password Reset uses this web service URL for resolving the artifact that the OAuth identity server returns.

    OAuth Profile Service URL

    Specify the URL for the web service that the Identity Server provides to return attribute data about the user.

    OAUTH Web Service Server Certificate

    Import a certificate for the OAuth web service server.

    OAuth Client ID

    Specify the client ID of the OAuth client. The OAuth Identity Service provider gives you this identity.

    OAuth Shared Secret

    Specify a password for the OAuth shared secret. The OAuth Identity Service provider gives you this value.

    OAuth User Name/DN Login Attribute

    Specify the attribute that you want the OAuth server to identify as the user name for local authentication. Self Service Password Reset then resolves this value as the same password that the users type at the local authentication page.

  6. In the toolbar, click Save changes.