Chat now with support
Chat with Support

One Identity Safeguard for Privileged Passwords 2.4 - 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 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 Privileged Sessions 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

Taking action on a session request

The actions a user authorized to request access to a privileged session can take depends on the state of the request.

To take action on a session request

  1. From your  Home page, the Requests widget has these controls:
    1. Select  (expand down) to open the list of active requests.
    2. Select  Popout to float the Requests 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 menu.

  2. Open the list of requests and select one of these view filters:

    State Description
    All Requests in all states.
    Available Approved requests that are ready (that is, a session that can be launched).
    Approved Requests that have been approved, but the checkout time has not arrived.
    Pending Requests that are waiting for approval.
    Revoked

    Approved requests retracted by the approver.

    NOTE: The approver can revoke a request between the time the requester launches the session and checks it back in.

    NOTE: When a user with Security Policy administrator permissions revokes a "live" session, the active session is terminated.

    Expired Requests for which the checkout duration has elapsed.
    Denied Requests denied by the approver.

    Note: The number indicates how many requests are in that state.

  3. Select an account to see the details of the session request.
  4. You can take the following actions on session requests, depending on the state:

    State Actions
    Available

    Click (or tap) Launch to launch the SSH client or Remote Desktop Connection. For more information, see Launching the SSH client or Launching an RDP session.

    Click (or tap)  Check-In to complete the checkout process once you have ended your session.

    In addition, you can use the following buttons to view or copy information into the configuration dialog that contains the credentials needed to launch the session:

    • View: Click (or tap) this button to view the password or connection string, which is required to launch the session.
    • Copy: Click (or tap) this button to copy a value to the copy buffer.
    • Help: Click (or tap) this button to copy the value into the appropriate field of the configuration dialog.

    NOTE: The configuration dialogs are populated with the required information; these actions are available if the fields are not populated for some reason.

    Approved

    Click (or tap) Cancel to remove the request.

    NOTE: A sessions request changes from "Approved" to "Available" when the requested time is reached. It stays available until you either cancel the request or it reaches the end of the duration period.

    Pending

    Click (or tap)  Cancel to remove the request.

    Revoked

    Click (or tap)  Resubmit Request to request the session again.

    Click (or tap)  Remove to delete the request from the list.

    Expired Click (or tap)  Remove to delete the request from the list.
    Denied

    Click (or tap)  Resubmit Request to request the session again.

    Click (or tap)  Remove to delete the request from the list.

Approving a session request

Depending on how the Security Policy Administrator configured the policy, a sessions request will either require approval by one or more Safeguard for Privileged Passwords users, or be auto-approved.

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

To approve or deny a sessions request

  1. From your  Home page, the Approvals widget has these controls:
    1. Select  (expand down) to open the list of approvals.
    2. Select  Popout to float the Approvals 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 menu.

  2. Open the list of approvals and select one of these view filters:
    State Description
    All Requests in all states.
    Pending Requests that are waiting for approval.
    Approved Requests that have been approved, but not yet available to the requester.

    Note: The number indicates how many requests are in that state.

  3. Once you open the list, select the requester's name to see the details of the sessions request.
  4. Take the following actions on sessions requests:

    State Actions
    Pending

    Select to Approve or Deny a sessions request.

    Optionally, enter a comment of up to 255 characters.

    Pending Additional Approvers

    Select to Deny a sessions request.

    Optionally, enter a comment of up to 255 characters.

    Approved

    Select to Deny or Revoke an approved request.

    Note: You can revoke a request between the time the requester views it and checks it in.

    Any eligible approver can deny an access request after it has already been approved or auto-approved. Once disallowed, the requester will no longer be able to access the requested session, but he is given another opportunity to request that session again. The requester receives an email notifying him that the request was denied. For more information, see Configuring alerts.

Launching the SSH client

Once an SSH session request becomes available, the requester can launch the SSH client to start the session.

To launch the SSH client to begin your session

  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, Hostname Connection String) required to launch the SSH client.
  2. Click (or tap) the Launch button to the right of the asset name. Clicking this button displays the PuTTY Configuration dialog. The required information is populated, click Open to launch the SSH client.

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

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

      • View: To view the hostname connection string.
      • Copy: To copy the value to your copy buffer, which can then be pasted into the Hostname field of the PuTTY Configuration dialog.
      • Help: To copy the value into the Hostname field of the PuTTY Configuration 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 PuTTY Configuration dialog.
      • Help: To copy the value into the Password field of the PuTTY Configuration 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.

  3. In the SSH client, run the commands or programs on the target host.

    NOTE: 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.

  4. 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 Command Detection option is selected in the policy, the reviewer can view a list of the commands and programs run during the session.

Launching an RDP session

Once an RDP session request becomes available, the requester can launch the remote desktop connection to start the session.

To launch a remote desktop connection to begin your RDP session

  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. Click (or tap) 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.

    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.

  3. In the remote desktop session, run the commands or programs on the target host.

    NOTE: 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.

  4. 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 playback 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.

Related Documents