Password Manager 5.12.1 - Administration Guide (AD LDS Edition)

The following sections describe Password Manager components and third-party applications.

Password Manager Secure Token Server (STS) is installed with Password Manager version 5.10.0. You can configure STS to use internal or external providers with optional Multi-Factor Authentication (MFA).

This feature can only be used on the new PM Self-Service Site to authenticate users in a workflow. It is installed as a service called Password Manager Secure Token Server (STS). It has a configuration and user login interface.

How to use Password Manager STS features

To use the Password Manager STS feature, drag "Authenticate with external provider" activity into any workflow.

• If you have not set up Secure Token Server connection or did not have valid providers configured in authentication providers, you cannot use this activity.

• If you set up at least one provider, you can start using it.

• If you set up more than one, you can select a provider for each activity used in workflows.

Authenticate with external provider on Self Service site

When authenticate with external provider is the current activity in a workflow, the user is presented with a login form, where they need to provide the credentials for the configured authentication provider. If the configured provider is using MFA, the user will be prompted for the next step.

This login interface uses the browser's language. The supported languages are the following:

• Argentinean (ar)

• Chinese (zh)

• Dutch (nl)

• English (en)

• French (fr)

• German (de)

• Italian (it)

• Japanese (ja)

• Korean (ko)

• Russian (ru)

• Spanish (es)

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="rstsConfigSource" type="Rsts.Config.RstsConfigSource, Rsts"/>
  </configSections>
  <rstsConfigSource xmlns="urn:Rsts.Config"> 
   <source type="FileConfigProvider">
      <fileConfigProvider fileName="rstsConfig.bin">
        <protection type="RsaDataProtection">
          <rsaDataProtection certificateStore="LocalMachine" certificateLookupType="FindByThumbprint" certificateLookupValue="b23655f8ac0b81c5b00bac0bc0a15e7e1d2b78be"/>
        </protection>
      </fileConfigProvider>
    </source>
  </rstsConfigSource>
</configuration>

Before the first visit of STS settings, you need to have a binding for your Password Manager site in IIS with the same port that is present in the <Password Manager installation folder>\One Identity\Password Manager\Service\QPM.Service.Host.exe.config under the StsHttpsPort key. By default 20000 is used.

To start using Password Manager STS,

1. Open the IIS manager and create an HTTPS binding with this port for Password Manager sites.

2. On the home page of the Administration site, click General Settings > Secure Token Server. The Secure Token Server page is displayed.

3. To change the Password Manager STS settings, if you are prompted to enter RSTS client secret, provide the password. The default password is admin.

   CAUTION: For security reasons, you must change the password immediately after you have logged in to the configuration interface the first time.

   To change the password, go to Server settings > Administration Password.

To configure the port used by Password Manager STS,

1. On the home page of the Administration site, navigate to General Settings > Secure Token Server. The Secure Token Server page is displayed.

2. To change the Password Manager STS settings, if you are prompted to enter RSTS client secret, provide the password.

3. Navigate to Server Settings > Listening Ports.

4. In the HTTPS Port field, enter the port that is the same as the HTTPS port of the website binding in IIS.

5. In the SSL Certificate section, select the certificate that is the same as the HTTPS certificate of the website binding in IIS.

6. To save your settings, click Save.

7. Refresh the page.

8. Follow the instructions in the Secure Token Server error popup window.

9. Enter your modified port number in the text field. To create or modify a firewall rule, select Create firewall rules for the port automatically.

10. To save your settings, click Save.

11. Open the Registry Editor and modify the Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\PasswordManagerSTS@ImagePath key value. At the end of the string, change the value of https-port to the modified port number.

12. Modify the port number of the HTTPS binding in IIS for your Password Manager site.

13. Restart the Password Manager service and the Password Manager STS service.

To set authentication providers,

1. On the home page of the Administration site, click General Settings > Secure Token Server. The Secure Token Server page is displayed.

2. To change the Password Manager STS settings, if you are prompted to enter RSTS client secret, provide the password.

3. Navigate to Authentication Providers, then click Add Authentication Provider, or select an existing one to edit by clicking on its name.

4. In the Display Name field, enter the name of the current provider. It is only displayed on the administration site.

5. Follow the instructions of this page to specify the Directory Type, the Connection Information and the Authentication Schemes for the current authentication provider.

6. Follow the instructions of this page to specify the Two Factor Authentication Settings for the current authentication provider. Your options are the following:

   • None

   • OneLogin MFA

   • RADIUS

   • FIDO2/WebAuthn

   • Duo Web iFrame

   To validate and save your settings, click Finish.

To configure STS Server Settings,

1. On the home page of the Administration site, navigate to General Settings > Secure Token Server. The Secure Token Server page is displayed.

2. To change the Password Manager STS settings, if you are prompted to enter RSTS client secret, provide the password.

3. Navigate to Server Settings.

4. You can edit the Issuer Name that will be used by the STS server to identify itself to relying party applications.

5. You can change the Administration Password for STS settings. Note: Every time you change this password, you need to revisit General Settings > Secure Token Server page and provide the new password in the popup window.

6. You can edit general STS server wide settings in General Settings.

7. You can set the HTTPS port that the STS service will use to accept incoming requests from relying party applications in Listening Ports. Also, choose an available SSL certificate to be used for HTTPS requests.

   NOTE: Every time you change the port and/or the certificate, you need to revisit General Settings > Secure Token Server page and follow the instructions on the popup window.

8. You do not need to specify any login page image under Login Page Images, it will not be displayed.

9. If you have an authentication provider which uses OneLogin you can set a proxy server in Proxy Settings to be used with OneLogin communication.

Provider-specific informations: Duo

In the Duo admin interface you need to create a Web SDK type application to connect with Password Manager STS.

Using the unregister feature, users registered to the Password Manager can be removed. Note that the user is removed only from the Password Manager and not Active Directory.

To unregister a user from the Password Manager

1. On the home page of the Administration site, click General Settings | Unregister Users.

2. On the Unregister Users page:

   • If you want to unregister individual users, expand the Select Users tree, click Add, manually search for the individual user, select the required user from the results, and click Save.
   • If you want to select a user group, expand the Select Groups tree, click Add, manually search for the individual groups, select the required group from the results, and click Save.
   • If you want to select the entire organization unit (OU), expand the Select Organizational Units tree, click Add, manually search for the individual OU, select the required OU from the results, and click Add.

3. Click Unregister User to unregister the users.