Chat now with support
Chat with Support

One Identity Safeguard for Privileged Passwords 2.5 - Administration Guide

Introduction System requirements Installing the One Identity Safeguard for Privileged Passwords desktop client Setting up Safeguard for Privileged Passwords for the first time Getting acquainted with the console Privileged access requests Toolbox Accounts Account Groups Assets Asset Groups Directories Entitlements Partitions Settings
Access Request settings Appliance settings Asset Management settings Backup and Retention settings Certificate settings Cluster settings External Integration settings Messaging settings Profile settings Access settings Sessions settings
Users User Groups Disaster recovery and clusters Administrator permissions Preparing systems for management Troubleshooting Frequently asked questions
How do I access the API How do I audit transaction activity How do I configure external federation authentication How do I manage accounts on unsupported platforms How do I modify the appliance configuration settings How do I prevent Safeguard for Privileged Passwords messages when making RDP connections How do I see which assets and/or accounts are governed by a profile How do I set the appliance system time How do I setup discovery jobs How do Safeguard for Privileged Passwords database servers use SSL What are the access request states What do I do when an appliance goes into quarantine What is required for One Identity Safeguard for Privileged Passwords, embedded sessions module What is required to integrate with Starling Identity Analytics & Risk Intelligence What needs to be set up to use Application to Application What role-based email notifications are generated by default When does the rules engine run for dynamic grouping and tagging Why did the password change during an open request Why join Safeguard for Privileged Passwords to One Identity Starling
Safeguard Desktop Player Appendix: Safeguard ports

How do I create a relying party trust for the STS

The process for creating the relying party trust in your STS will differ between applications and services. However, as stated earlier, you can download a copy of Safeguard for Privileged Passwords's federation metadata by clicking the link when you entered the STS information in Safeguard for Privileged Passwords. You can also download the Safeguard for Privileged Passwords federation metadata at any time using one of the following methods:

  • Click Settings | External Integration |Identity and Authentication. Click Download Safeguard Federation Metadata.
  • Download the file from the following URL:
https://<Safeguard for Privileged Passwords server>/RSTS/Saml2FedMetadata

If the STS does not support importing federation metadata, but instead requires you to manually input values, you will typically need an App ID and Login or Redirect URL. Both of these values can be copied from the Safeguard for Privileged Passwords federation metadata XML file you downloaded.

  • The App ID for Safeguard for Privileged Passwords will come from the entityID attribute of the <EntityDescriptor> element in the XML file.
  • The Login or Redirect URL will come from the Location attribute of the <AssertionConsumerService> element within the <SPSSODescriptor> element.

    NOTE: Only the HTTP-POST binding is supported for this end point.

You must then configure or ensure that the STS returns the authenticated user's email address as a SAML attribute claim. The email address must appear in either the standard SAML email address claim or name claim:

  • http://schemas.xmlsoap.org/ws/2005/05/idenity/claims/emailaddress
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name

NOTE: Any other attributes or claims will be ignored.

The SAML Response or Assertion must be signed, but not encrypted. When the signing certificate used by your STS expires, you must update the metadata in Safeguard for Privileged Passwords by uploading a new copy of your STS's metadata file. Safeguard for Privileged Passwords will not automatically attempt to refresh the metadata.

NOTE: Your STS's metadata can contain more than one signing certificate to allow for a grace period between an expiring certificate and a new one.

For further details regarding specific STS servers, see the following knowledge base articles on the One Identity support site:

  • Configuring Microsoft's AD FS Relying Party Trust for Safeguard for Privileged Passwords: KB Article 233669
  • Configuring Microsoft's Azure AD for Safeguard for Privileged Passwords: KB Article 233671

How do I add an external federation user account

It is the responsibility of either the Authorizer Administrator or the User Administrator to add an associated external federation Safeguard for Privileged Passwords user.

NOTE: You must add external federation service providers to Safeguard for Privileged Passwords before you can add external federation user accounts.

NOTE: No user information, such as first name, last name, phone number, email address, is ever imported from the STS claims token. You must enter that information manually when creating the user in Safeguard for Privileged Passwords if you need it.

To add a user

  1. Navigate to Administrative Tools | Users.
  2. In Users, click Add User from the toolbar.
  3. In the User dialog, provide information in each of the tabs:

    Identity tab

    Where you define the identity provider and the user's contact information.

    Authentication tab

    Where you define the authentication provider, login name and password, if necessary.

    Location tab Where you set the user's time zone.
    Permissions tab Where you set the user's administrator permissions.

How do I manage accounts on unsupported platforms

Safeguard for Privileged Passwords makes it possible for you to manage passwords for accounts on unsupported platforms by using a profile with a manual change password setting. For example, you might have an asset that is not on the network. The manual change password setting allows you to comply with your company policies to change account passwords on a regular schedule without using the Safeguard for Privileged Passwords automatic change password settings. Safeguard for Privileged Passwords notifies you by email, toast notification, or both on a set schedule to change account passwords manually. You can then reset the password yourself, or allow Safeguard for Privileged Passwords to generate a random password according to the password rule selected in the profile.

Important: After you change the password in Safeguard for Privileged Passwords you must remember to change the password on the account; Safeguard for Privileged Passwords does not do that automatically for you.

The following summarizes the general workflow for managing accounts on unsupported platforms.

To manage account passwords manually

  1. Configure a profile with a manual change password setting and assign asset accounts to it. For more information, see Adding change password settings.
  2. Ensure toast notifications or email notifications are properly configured. For more information, see Console Settings or Enabling email notifications.
  3. When notified to change an account password, choose the Set Password option you prefer:
    1. Generate Password - to have Safeguard for Privileged Passwords generate a new random password, that complies with the password rule that is set in the account's profile.
      1. Click Generate Password to display the Password Change dialog.
      2. Click Show Password to reveal the new password.
      3. Click  Copy to place the value into your copy buffer.

        • Log into your device, using the old password, and change it to the password in your copy buffer.
      4. Click Success to change the password in the Safeguard for Privileged Passwords database.
    2. Manual Password - to manually set the account password in the Safeguard for Privileged Passwords database.
      1. Click Manual Password to display the Set Password dialog.
      2. Enter and save a new password.

        OK updates the Safeguard for Privileged Passwords database.

      3. Set the account password on the physical device to synchronize it with Safeguard for Privileged Passwords.

How do I modify the appliance configuration settings

You can modify the appliance configuration settings using the Web client or Windows desktop client (Administrative Tools | Settings | Appliance).

Note: This topic assumes you have already performed the initial appliance installation and configuration steps in the One Identity Safeguard for Privileged Passwords Appliance Setup Guide provided in the box with your hardware equipment.

To modify the appliance configuration settings (web client)

  1. Log into the Safeguard for Privileged Passwords Web client using the Appliance Administrator account.
  2. Select ; then, click a to open the Appliance Settings pane.
  3. In the Application Settings pane, select Appliance Configuration.
  4. On the Appliance Configuration page, configure the following:

    NOTE: Click the Edit icon to modify these settings. After editing a setting, you must save that individual setting before editing an additional setting.

    • Time: Enable Network Time Protocol (NTP) and set the primary and secondary NTP servers, if desired.
    • Network (X0): Enter the DNS Server address information for your primary interface.
    • Sessions (X1): Configure the sessions interface. If one or more Safeguard Sessions Appliances are joined to Safeguard for Privileged Passwords, X1 is not available in Safeguard for Privileged Passwords.

To modify the appliance configuration settings (Windows desktop client)

  1. Log in using the Appliance Administrator account.
  2. Navigate to Administrative Tools | Settings | Appliance.
  3. Expand the Time pane to enable NTP and set the primary and secondary NTP servers. Click OK.
  4. Expand the Appliance Information pane to change the appliance name.

    1. To change the appliance's name, click Edit next to the Appliance Name.

  5. Expand the Networking pane to add or modify DSN suffixes and to configure the network interface for the embedded sessions module for Safeguard for Privileged Passwords.

    1. To change the DNS suffixes for your primary interface, click Edit next to the Network Interface X0 heading.

      • Enter the DSN suffixes to be used.
      • Click OK.
    2. To configure the sessions interface, click Edit next to the Network Interface X1 heading. If one or more Safeguard Sessions Appliances are joined to Safeguard for Privileged Passwords, X1 is not available in Safeguard for Privileged Passwords.

      • Enter the IP Address, netmask, and gateway information, and the DNS servers and suffixes.
      • Click OK.
Related Documents