Reviewing a completed password release request
The Security Policy Administrator can configure an access request policy to require a review of completed password release requests for accounts in the scope of the policy.
You can configure Safeguard for Privileged Passwords to notify you of a password release request that requires your review. For more information, see Configuring alerts.
(web client) To review a completed password release request
Select
Reviews on the left of the page to manage reviews. On the Reviews page, you can:
- View details by selecting a request then looking at the details display on the right of the page, including the workflow.
- Mark one or more request as reviewed: Select the requests. Do the following:
- If no comment is needed, click
Mark all the selected requests as reviewed.
- If a comment is needed, this icon will display as
One or more of the selected requests requires review comments. Add the comment. Then, click Mark as Reviewed.
- Change the columns that display: Click
Select columns to display then select the columns you want to see.
- Action: Displays
This request requires review comments or
Mark only this request as reviewed.
- Requester: Displays the user name of the requester.
- Access Type: Displays the type of access (for example, Password, SSH Key, RDP, SSH, or Telnet).
- Account: Displays the managed account name.
- Ticket Number: Displays the ticket number, if required.
- Request For/Duration: Displays the date and time as well as the window of availability (for example, March 20, 2021 9:56 AM 2 hours).
- Search: For more information, see Search box.
(desktop client) To review a completed password release request
- From your
Home page, the Reviews widget has these controls:
- Click
(expand down) to open the list of pending reviews.
- 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.
- Open the list of pending reviews and select an account name to see the details of the password release request.
-
Take the following action on password release requests:
Once the review is complete, it no longer appears on the Reviews pane.
TIP: If one requester checks in the request and another requester wants to use it, the second requester is unable to check out the password until the original request has been reviewed. However, the Security Policy Administrator can Close a request that has not yet been reviewed. This will bypass the reviewer in the workflow and allow the account to be accessed by another requester.
SSH key release request workflow
One Identity Safeguard for Privileged Passwords provides secure control of managed accounts by storing SSH keys until they are needed, and releases them only to authorized persons. Then, Safeguard for Privileged Passwords automatically updates the account SSH keys based on configurable parameters.
Typically, an SSH key release request follows this workflow.
- Request: Users that are designated as an authorized user of an entitlement can request SSH keys for any account in the scope of that entitlement's policies.
- Approve: Depending on policy configuration, approval can be automatic or require the consent of one or more users which provides closer control over system accounts.
- Review: The Security Policy Administrator can optionally configure an access request policy to require a review of completed SSH key release requests for accounts in the scope of the policy.
The following topics explain the entire end-to-end SSH key release process from request to approval to review.
Requesting an SSH key release
If you are designated as an authorized user of an entitlement, you can request SSH keys for any account in the scope of the entitlement's policies.
You can configure One Identity Safeguard for Privileged Passwords to notify you of pending SSH key release workflow events, such as when an SSH key release request is pending, denied, or revoked, and so forth. For more information, see Configuring alerts.
To request an SSH key release
- Go to the new access request page:
(web client) Click
Home or
My Requests, then click
New Request.
(desktop client) Go to the
Home page, then click New Request.
NOTE: You can also submit an access request from your Favorites pane, if you previously saved it as a favorite.
-
On Asset Selection, select the assets to be included in the access request. The assets available for selection are based on the scope defined in the entitlement's access request policies. There is a limit of 50 assets per request.
-
On Account & Access Type Selection, select the accounts to be included in the access request and the type of access being requested for each selected account. The accounts include linked accounts, if any.
-
Asset: The display name of the managed system.
- Account: The available account appears in the Account column. When an asset has multiple accounts available, either Select Account(s) or the account name appears as a hyperlink in the Account column. Click the hyperlink in the Account column to display a list of accounts available and select the accounts to be included in the access request.
-
Access Type: The type of access request appears in the Access Type column. If the type is a hyperlink, you can click the link then multiple access request types are available. Select the hyperlink and select the access type, in this case, SSH Key.
You can remove an asset or account from the list. Select the entry in the grid and click
Delete.
- On Request Details, configure the following settings, which will apply to all of the selected assets and accounts:
-
Normal Access: If the policy has emergency access enabled, select this option to gain normal access to this SSH key. Normal access ensures the access request goes through the entire end-to-end access release process from request to approval to review as defined in the policy by the Security Policy Administrator.
-
Emergency Access: If the policy has emergency access enabled, select this option to gain immediate emergency access to this SSH key. When you use Emergency Access, the request requires no approval.
-
Request Immediately: If selected, the request is immediately created. You can clear this option to enter a specific date and time for the request in the user's local time.
- Checkout Duration: Based on the policy, do one of the following:
- View the Checkout Duration.
- If the Allow Requester to Change Duration option is enabled in the policy, you can set the days, hours, and minutes that you want to use the SSH key. This overrides the Checkout Duration set in the access request policy.
-
Ticket Number: If the policy requires a ticket number, enter a ticket number. If multiple accounts are in the request and one or more require a ticket number, the ticket number is applied to all of the requests associated with this access request. This feature is set up through the desktop client.
-
Reason: If the policy requires a reason, enter a reason. If multiple accounts are in the request and one or more require a reason. The reason is applied to all of the requests associated with this access request.
Select the Description down arrow to view the description defined for the selected reason.
-
Comment: If required, enter information about this request. When multiple accounts are specified in the request, if any of the selected accounts require a comment, you must enter a comment. The comment will be applied to all of the requests associated with this access request. The limit is 255 characters.
-
To save the access request as a favorite, click the Add to Favorites button.
Add to Favorites displays, allowing you to specify a name and description for the access request. It also allows you to assign a color to the request's icon.
This access request is then added to your Favorites. How you manage favorites depends on your interface:
-
After entering the required information, click Submit Request.
The Results dialog displays the access requests submitted and whether a request was successful. If unsuccessful due to usage restrictions, a message returns the time available.
When the request has been approved, you can use the SSH key. For more information, see Taking action on an SSH key release request.
Taking action on an SSH key release request
The actions that can be taken on an SSH key release request depends on the state of the request and the client interface you are using.
(web client) To take action on an SSH key release request
-
From the web client, click
My Requests. Use any of the following methods to control the request displayed:
- Click Sort By
then select to sort by Account Name, Asset Name, Due Next, Expiring Next, Most Recent, or Status.
- Click
sort up or
sort down to sort in ascending or descending order.
- Click
Filters to filter by the status.
- All: Requests in all states.
- Available: Approved requests that are ready to view or copy.
- Pending Approval: Requests that are waiting for approval.
- Approved: Requests that have been approved, but the check out time has not arrived. Or, for pending accounts restored when using the Safeguard for Privileged Passwords suspend feature.
- Revoked: Approved requests retracted by the approver. The approver can revoke a request after the request has become available.
- Expired: Requests for which the Checkout Duration has elapsed.
- Denied: Requests denied by the approver.
- Click
Search to see a list of search-able elements. Or enter search characters. For more information, see Search box.
-
You can take any of the following actions on the SSH key release request:
- Available request: Make selections on the request based on your user interface.
- Click on
to expand the box to see the options. The name, Account and Remaining time displays.
- The Format displays and can be selected, if necessary. Formats include OpenSSH, SSH2, and PuTTY. The Format chosen is preselected as the default for the next access request.
- Click
Checkout SSH Key to check out the SSH key. This puts the SSH key into your copy buffer, ready for you to use.
- Private Key: You can click
Save or
Copy.
- Passphrase: You can click
Show or
Copy if Passphrase Protect SSH Key was selected on when creating an access request policy. For more information, see Access Config tab in the Safeguard for Privileged Passwords Administration Guide.
- To view more detail, select More Info
. The following types of information may display based on the format you select.
- SHA-1 Fingerprint
- MD5 Fingerprint
- Public Key: You can click
Save or
Copy.
If the SSH key changes while you have it checked out, and your current request is still valid, you can select the following to obtain an new SSH key, as available:
Save,
Copy, or
Show.
- Once you are done working, click
Check-In to complete the SSH key check out process. (You may need to close More Info
.)
-
Approved request: Select
Cancel to remove the request.
An SSH key release 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 request: Select
Cancel to remove the request.
-
Revoked request: Select
Resubmit Request to request the SSH key again.
Select
Remove to delete the request from the list.
- Expired request: Select
Remove to delete the request from the list.
-
Denied request: Select
Resubmit Request to request the SSH key again.
Select
Remove to delete the request from the list.
(desktop client) To take action on an SSH key release request
- From your
Home page, the Requests widget has these controls:
- Open the list of requests and select one of the following view filters. The number indicates how many requests are in that state.
-
All: Requests in all states.
-
Available: Approved requests that are ready to view or copy.
-
Approved: Requests that have been approved, but the check out time has not arrived.
-
Pending: Requests that are waiting for approval or for pending accounts restored when using the Safeguard for Privileged Passwords suspend feature.
-
Revoked: Approved requests retracted by the approver. The approver can revoke a request between the time the requester views the SSH key and checks it in.
-
Expired: Requests for which the Checkout Duration has elapsed.
-
Denied: Requests denied by the approver.
-
Select an account to see the details of the SSH key release request. Take the following actions on SSH key release requests:
- Available request: Make selections on the request based on your user interface.
-
The name, Account and Remaining time displays.
- The Format displays and can be selected, if necessary. Formats include OpenSSH,SSH2, and PuTTY. The Format chosen is preselected as the default for the next access request.
- Click
Checkout SSH Key to check out the SSH key. This puts the SSH key into your copy buffer, ready for you to use.
- Private Key: You can click
Save or
Copy.
- Passphrase: You can click
Show or
Copy if Passphrase Protect SSH Key was selected on when creating an access request policy. For more information, see Access Config tab in the Safeguard for Privileged Passwords Administration Guide.
- To view more detail, select More Info
. The following types of information may display based on the format you select.
- SHA-1 Fingerprint
- MD5 Fingerprint
- Public Key: You can click
Save or
Copy.
If the SSH key changes while you have it checked out, and your current request is still valid, you can select the following to obtain an new SSH key, as available:
Save,
Copy, or
Show.
- Once you are done working, click
Check-In to complete the SSH key check out process. (You may need to close More Info
.)
-
Approved request: Select
Cancel to remove the request.
An SSH key release 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 request: Select
Cancel to remove the request.
-
Revoked request: Select
Resubmit Request to request the SSH key again.
Select
Remove to delete the request from the list.
- Expired request: Select
Remove to delete the request from the list.
-
Denied request: Select
Resubmit Request to request the SSH key again.
Select
Remove to delete the request from the list.