Chat now with support
Chat with Support

One Identity Safeguard for Privileged Passwords 6.0.7 LTS - Administration Guide

Introduction System requirements and versions Using API and PowerShell tools Using the virtual appliance and web management console Cloud deployment considerations Setting up Safeguard for Privileged Passwords for the first time Using the web client Getting started with the desktop client Using the desktop client Search box Privileged access requests Toolbox Accounts Account Groups Assets Asset Groups Discovery 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 Safeguard Access settings
Users User Groups Disaster recovery and clusters Administrator permissions Preparing systems for management Troubleshooting Frequently asked questions Appendix A: Safeguard ports Appendix B: SPP 2.7 or later migration guidance Appendix C: SPP and SPS join guidance Appendix D: Regular Expressions SPP glossary

Launching an RDP session

Once an RDP session request becomes available, the requester can launch the remote desktop connection to start the session. This is applicable for both the web client and desktop client user interfaces.

To launch a remote desktop connection

  1. If the User Supplied option is selected in the policy, you will be prompted to enter your user credentials. After entering the requested credentials, click Apply. This will retrieve the information (for example, Username Connection String) required to launch the remote desktop session.
  2. Depending on your interface:

    • (desktop client) Click the Launch button to the right of the asset name. Clicking this button displays the Remote Desktop Connection dialog. Click Connect to launch the remote desktop session.
    • (web client) In the web client:
      • If you have an application registered (rdp:// for RDP sessions), you can click the Launch button to the right of the asset name then click Connect . See KB 313918 for details on application registration. A password must be entered and we recommend sg. A blank password will cause the session to fail.
      • If you do not have an application registered, download the RDP launch file instead of using the Launch button. A password must be entered and we recommend sg. A blank password will cause the session to fail.

    NOTE: If the required information is not populated in the Remote Desktop Connection dialog, use the following buttons to copy and paste the information into the dialog:

    1. Use the buttons to the right of the Username Connection String to perform the following tasks:

      • View: To view the username connection string.
      • Copy: To copy the value to your copy buffer, which can then be pasted into the Username field of the Remote Desktop Connection dialog.
      • Help: To copy the value into the Username field of the Remote Desktop Connection dialog.
    2. Use the buttons to the right of the Password to perform the following tasks:

      • View: To view the password.
      • Copy: To copy the password to your copy buffer, which can then be pasted into the Password field of the Remote Desktop Connection dialog.
      • Help: To copy the value into the Password field of the Remote Desktop Connection dialog.

      NOTE: The Password field only appears if the Include password release with session requests option (Access Config tab) is selected in the entitlement's access request policy.

Begin your RDP session and close the session

  1. In the remote desktop session, run the commands or programs on the target host.
    If there is no activity in an open session for about 10 minutes, the session will be terminated. However, as long as the request is in an Available state, you can launch the session again to resume your tasks.

  2. Once you are completed, log out of the target host and select Check in to complete the session request process.

    This makes the session request available to reviewers. If the Record Sessions option is enabled in the policy, the reviewer can play back the recording as part of the review process. In addition, if the Enable Window Title Detection option is selected in the policy, the reviewer can view a list of the windows opened on the desktop during the session.

Reviewing a session request

The Security Policy Administrator can configure an access request policy to require a review of completed session requests for assets or accounts in the scope of the policy.

Note: You can configure Safeguard for Privileged Passwords to notify you of an access request that requires your review. For more information, see Configuring alerts.

Desktop Player User Guide

To download the player user guide, go to One Identity Safeguard for Privileged Sessions - Technical Documentation. Scroll to User Guide and click One Identity Safeguard for Privileged Sessions [version] Safeguard Desktop Player User Guide.

(web client) To review a completed sessions request

Select Reviews on the left of the page to manage reviews. On the Reviews page, you can:

  • View details: Select the request and the details display on the right of the page.
  • Mark one or more request as reviewed: Select the requests. Then, click Mark all the selected requests as reviewed. A comment may be required or, if not required, added.
  • Change the columns that display: Click Select columns to display then select the columns you want to see.
  • Search: For more information, see Search box.

(desktop client) To review a completed sessions request

  1. From your  Home page, the Reviews widget has these controls:
    1. Click  (expand down) to open the list of pending reviews.
    2. Click  Popout to float the Reviews pane.

      You can then select and drag the pane to any location on the console and re-size the window.

    Note: You enable or disable the Home page widgets in the  Settings (desktop client) menu.

  2. Open the list of pending reviews and select an account name to see the details of the sessions request.
  3. Take the following action on sessions requests:

    1. Select Workflow to review the transactions that took place in the selected request.

      • If Record Sessions is enabled in the policy, click Play on the Initialize Session event to play back the session.

        A (green dot) indicates the session is live. A user with Security Policy Administrator permissions can click this icon to follow an active session.

        If the session recording has been archived from the local Safeguard file system or was recorded prior to joining a Sessions Appliance, you will see a Download button instead of a Play button. Click Download to download the recording and then click Play.

        CAUTION: If you receive a message like: No Desktop Player. The Safeguard Desktop Player is not installed. Would you like to install it now?, click Yes. See Installing the desktop client, Installing the Desktop Player, step 2.

      • If Enable Command Detection is enabled in the policy, expand to show the details and click the events link on the Initialize Session event to view a list of the commands and programs run during the session.

        For an RDP session, the setting is Enable Windows Title Detection. When enabled, you can view a list of windows that were opened during the privileged session.

    2. Select  Review to complete the review process.

      Optionally, enter a comment of up to 255 characters.

    Once the review is complete, it no longer appears on the Reviews pane.

Replaying a session

You can play back a recorded session from the Request Workflow dialog, which can be accessed by clicking the Workflow button that appears to reviewers for completed session requests and in the Activity Center view when an access request event is selected in an activity audit log report. In addition, you can play back a recorded session by clicking the icon displayed to the left of an access request session event on the activity audit log report in the Activity Center view.

NOTE: This feature is only available for session requests that have Record Session enabled in the access request policy (Access Config tab).

(desktop client only) To play back a session (Request Workflow dialog)

  1. Open the Request Workflow dialog using the Workflow button.

    NOTE: If accessing the Request Workflow dialog from the Activity Center, select an Access Request Session event from the activity audit log report.

  2. Locate an Initialize Session event and click Play to launch the Desktop Player.

    A (green dot) indicates the session is live. A user with Security Policy Administrator permissions can click this icon to follow an active session.

    If the session recording has been archived from the local Safeguard file system, you will see a Download button instead of a Play button. Click Download to download the recording and then click Play.

    CAUTION: If you receive a message like: No Desktop Player. The Safeguard Desktop Player is not installed. would you like to install it now?, click Yes. See Installing the desktop client, Installing the Desktop Player, step 2.

  3. Accept the certificate to continue.

    In the Certificate error message, click Continue to use the default Session Recording Signing certificate shipped with Safeguard for Privileged Passwords. To use a different SSL certificate, click Abort and then import the appropriate certificates including the root CA.

  4. Use one of the following methods to play back the session recording:

    • Click Play Channel from the toolbar at the top of the player.
    • Click in the thumbnail in the upper right corner of the Information page.
    • Click Play Channel next to a channel in the Channels pane.

Desktop Player User Guide

To download the player user guide, go to One Identity Safeguard for Privileged Sessions - Technical Documentation. Scroll to User Guide and click One Identity Safeguard for Privileged Sessions [version] Safeguard Desktop Player User Guide.

Following and terminating a "live" session

An access request session event with a (green dot) in the left-most column of the activity audit log report or Request Workflow dialog indicates that the session is "live". Clicking this button launches the Desktop Player allowing you to follow what is happening in the active session. Safeguard for Privileged Passwords also allows you to terminate an active session directly from the desktop player.

NOTE: You must have Security Policy Administrator permissions to follow an active session.

(desktop client only) To watch or terminate a "live" session

  1. From the Request Workflow dialog or Activity Center activity audit log report click the (green dot) next to an access request session event.

    NOTE:Security Policy Administrators can also launch the Safeguard Desktop Player from the Access Requests view. Select an access request session in the request grid and click the View Live Session toolbar button.

    The Safeguard Desktop Player launches allowing you to watch the active session. On the Information page, the thumbnail (upper right) displays a blinking red recording button when a session is "live".

  2. Use one of the following methods to follow the session:

    • Click Play Channel from the toolbar at the top of the player.
    • Click in the thumbnail in the upper right corner of the Information page.
    • Click Play Channel next to a channel in the Channels pane.
  3. In the play back window, you will see a Terminate button and a Live indicator in the lower right corner.
  4. Click Terminate to stop the active session.

NOTE: You can also terminate an active session by revoking the session through the Windows desktop client.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating