Email notifications
You must configure One Identity Safeguard for Privileged Passwords properly for users to receive email notifications:
Role-based email notifications generated by default
One Identity Safeguard for Privileged Passwords can be configured to send email notifications warning you of operations that may require investigation or action. Your administrative permissions determine which email notifications you will receive by default.
Table 15: Email notifications based on administrative permissions
Appliance Administrator
Operations Administrator |
Appliance Healthy
Appliance Restarted
Appliance Sick
Appliance Task Failed
Archive Task Failed
Cluster Failover Started
Cluster Replica Enrollment Completed
Cluster Replica Removal Started
Cluster Reset Started
Disk Usage Warning
Factory Reset Appliance
License Expired
License Expiring Soon
NTP Error Detected
Operational Mode Appliance
Raid Error Detected
Reboot Appliance
Shutdown Appliance |
Partition Owner (if none, sent to the Asset Administrator)
NOTE: If Asset Administrators want to be notified along with the Partition Owners, they can set themselves up as an explicit owners or create an email subscription for the event (for example, IsSystemOwned=false).
The API /service/core/v3/EventSubscribers endpoint can be used to create event subscribers for events, including events on specific assets or accounts.
|
Account Discovery Failed
Dependent Asset Update Failed
Password Change Failed
Password Check Failed
Password Check Mismatch
Password Reset Needed
Restore Account Failed
Ssh Host Key Mismatch
Ssh Key Change Failed
Ssh Key Install Failed
Suspend Account Failed
Test Connection Failed |
Security Policy Administrator |
Policy Expiration Warning
Policy Expired
Entitlement Expiration Warning
Entitlement Expired |
NOTE:Safeguard for Privileged Passwords administrators can use the following API to turn off these built-in email notifications:
POST /service/core/v2/Me/Subscribers/{id}/Disable
In addition, Safeguard for Privileged Passwords administrators can subscribe to additional events based on their administrative permissions using the following API:
POST /service/core/v2/Events
Password release request workflow
One Identity Safeguard for Privileged Passwords provides secure control of administrative accounts by storing account passwords until they are needed, and releases them only to authorized persons. Then, Safeguard for Privileged Passwords automatically updates the account passwords based on configurable parameters.
Typically, a password release request follows this workflow.
- Request: Users that are designated as an authorized user of an entitlement can request passwords for any account in the scope of that entitlement's policies.
- Approve: Depending on how the Security Policy Administrator configured the policy, a password release request will either require approval by one or more Safeguard for Privileged Passwords users, or be auto-approved. This process ensures the security of account passwords, provides accountability, and provides dual control over the system accounts.
- Review: The Security Policy Administrator can optionally configure an access request policy to require a review of completed password release requests for accounts in the scope of the policy.
The following topics explain the entire end-to-end password release process from request to approval to review.
Requesting a password release
If you are designated as an authorized user of an entitlement, you can request passwords 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 password release workflow events, such as when a password release request is pending, denied, or revoked, and so forth. For more information, see Configuring alerts.
To request a password 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.
-
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. For more information, see Linked Accounts tab (user).
-
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, multiple access request types are available. Select the hyperlink and select the access type.
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 password. 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 password. When you use Emergency Access, the request requires no approval. For more information, see Creating an access request policy.
-
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 password. This overrides the Checkout Duration set in the access request policy. For more information, see Creating an 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.For more information, see Ticketing systems.
-
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. For more information, see Reasons.
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.
When the request has been approved, you can use the password. For more information, see Taking action on a password release request.
Taking action on a password release request
The actions that can be taken on a password release request depends on the state of the request and the client interface you are using.
(web client) To take action on a password 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 password release request:
-
Available request: Make selections on the request based on your user interface.
-
Approved request: Select Cancel to remove the request.
A password 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 password 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 password again.
Select Remove to delete the request from the list.
(desktop client) To take action on a password 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 password 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 password release request.
-
Take the following actions on password release requests:
-
Approved: Select Cancel to remove the request.
A password 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: Select Cancel to remove the request.
-
Revoked: Select Resubmit Request to request the password again.
Select Remove to delete the request from the list.