Skip to content

Managing Approval Settings for Agent Requests

As an administrator, you can configure approval processes for requests to activate and deactivate agents.

Configuring the Global Approval Process for Requests to Activate Agents

You can define a global approval process for requests to activate agents.

Note

When global settings are different from the approval settings on individual resources, the resource-level settings take precedence.

  1. In SailPoint Human Fabric, go to Admin > Global > System Settings.

  2. From the left panel, select Feature Settings > Approval Settings.

  3. Select the Agent Requests tab.

  4. In the Requests to Activate Agents section, select the Requires Approval toggle.

  5. Configure the approval policy:

    • In the Approvers section, choose whether the request will be reviewed by a single approver or multiple approvers:

      • Single Approver

        • Select Single from the Approval Type field.

        • Select the type of reviewer from the Reviewer Category field. You can select from the following options:

          • Source Owner - The source owner reviews the request.
          • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
          • Primary Owner - The primary owner of the agent reviews the request.
          • Additional Owners - Any of the agent’s other owners can review the request.
          • Requester's Manager - The manager of the user who submitted the request reviews the request.
          • Identity - The selected identity reviews the request.
          • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
      • Multiple Approvers

        • Select Multi-Step from the Approval Type field.

        • In the Reviewers section, select Add Reviewer.

        • Configure the approval policy by taking the following actions:

          • Select the types of reviewers from the Reviewer Category field. You can select from the following options:

            • Source Owner - The source owner reviews the request. This is the default reviewer.
            • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
            • Primary Owner - The primary owner of the agent reviews the request.
            • Additional Owners - Any of the agent’s other owners can review the request. Only needs to be approved or denied by one.
            • Requester's Manager - The manager of the user who submitted the request reviews the request.
            • Identity - The selected identity reviews the request.
            • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
          • Add additional reviewers by selecting Add Approver.

          • Remove reviewers by selecting the Delete icon .

          • Move a reviewer’s tile to change the order the approvers will review the request.

            Note

            All reviewers must approve the request for the agent to be activated. If one reviewer denies the user’s request, the request is denied.

          • Select Save to save the approval process.

            If the approval process requires changes, select Edit Approvers. You can add or remove approvers and rearrange the order in which they will review the request.

  6. Choose whether comments are required when reviewers approve or deny requests to activate agents.

  7. Select Save at the bottom of the page to save these approval settings.

From this page, you can also define the approval process for requests to deactivate agents, set up reminders for approvers, and configure an escalation process. For more information about reminders and escalations, refer to Configuring Global Approval Settings.

Configuring the Global Approval Process for Requests to Deactivate Agents

You can define a global approval process for requests to deactivate agents.

  1. In SailPoint Human Fabric, go to Admin > Global > System Settings.

  2. From the left panel, select Feature Settings > Approval Settings.

  3. Select the Agent Requests tab.

  4. In the Requests to Deactivate Agents section, select the Requires Approval toggle.

  5. Configure the approval policy:

    • In the Approvers section, choose whether the request will be reviewed by a single approver or multiple approvers:

      • Single Approver

        • Select Single from the Approval Type field.

        • Select the type of reviewer from the Reviewer Category field. You can select from the following options:

          • Source Owner - The source owner reviews the request.
          • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
          • Primary Owner - The primary owner of the agent reviews the request.
          • Additional Owners - Any of the agent’s other owners can review the request.
          • Requester's Manager - The manager of the user who submitted the request reviews the request.
          • Identity - The selected identity reviews the request.
          • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
      • Multiple Approvers

        • Select Multi-Step from the Approval Type field.

        • In the Reviewers section, select Add Reviewer.

        • Configure the approval policy by taking the following actions:

          • Select the types of reviewers from the Reviewer Category field. You can select from the following options:

            • Source Owner - The source owner reviews the request. This is the default reviewer.
            • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
            • Primary Owner - The primary owner of the agent reviews the request.
            • Additional Owners - Any of the agent’s other owners can review the request. Only needs to be approved or denied by one.
            • Requester's Manager - The manager of the user who submitted the request reviews the request.
            • Identity - The selected identity reviews the request.
            • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
          • Add additional reviewers by selecting Add Approver.

          • Remove reviewers by selecting the Delete icon .

          • Move a reviewer’s tile to change the order the approvers will review the request.

            Note

            All reviewers must approve the request for the agent to be deactivated. If one reviewer denies the user’s request, the request is denied.

          • Select Save to save the approval process.

            If the approval process requires changes, select Edit Approvers. You can add or remove approvers and rearrange the order in which they will review the request.

  6. Choose whether comments are required when reviewers approve or deny requests to deactivate agents.

  7. Select Save at the bottom of the page to save these approval settings.

From this page, you can also define the approval process for requests to deactivate agents, set up reminders for approvers, and configure an escalation process. For more information about reminders and escalations, refer to Configuring Global Approval Settings.

Configuring the Resource-Level Approval Process for Requests to Activate Agents

If your tenant supports source datasets and resources, you can define separate processes for how individual resources will handle approval requests to activate agents.

Note

When global settings are different from the approval settings on individual resources, the resource-level settings take precedence.

  1. In SailPoint Human Fabric, go to Admin > Connections > Sources.
  2. Select a source.
  3. On the left navigation of the source’s page, select Dataset Management > Resources, then select the specific resource.
  4. Select the Approval Settings tab.
  5. In the Requests to Activate Agents section, select the Requires Approval toggle.
  6. Configure the approval policy:

    • Use the Approval Type dropdown to choose whether the request will be reviewed by a single approver or multiple approvers:

      • Single Approver

        • Select Single from the Approval Type field.
        • Select from the following Reviewer Category options:

          • Source Owner - The source owner reviews the request.
          • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
          • Primary Owner - The primary owner of the agent reviews the request.
          • Additional Owners - Any of the agent’s other owners can review the request.
          • Requester's Manager - The manager of the user who submitted the request reviews the request.
          • Identity - The selected identity reviews the request.
          • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
      • Multiple Approvers

        • Select Multi-Step from the Approval Type field.
        • In the Reviewers section, select Add Reviewer.
        • Configure the approval policy by taking the following actions:

          • Select from the following Reviewer Category options:

            • Source Owner - The source owner reviews the request. This is the default reviewer.
            • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
            • Primary Owner - The primary owner of the agent reviews the request.
            • Additional Owners - Any of the agent’s other owners can review the request. Only needs to be approved or denied by one.
            • Requester's Manager - The manager of the user who submitted the request reviews the request.
            • Identity - The selected identity reviews the request.
            • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
          • Add additional reviewers by selecting Add Approver.

          • Remove reviewers by selecting the Delete icon .
          • Move a reviewer’s tile to change the order the approvers will review the request.

            Note

            All reviewers must approve the request for the agent to be activated. If one reviewer denies the user’s request, the request is denied.

          • Select Save to save the approval process.

            If the approval process requires changes, select Edit Approvers. You can add or remove approvers and rearrange the order in which they will review the request.

  7. Choose whether comments are required when reviewers approve or deny requests to activate agents.

  8. In the Timeout field, select the number of days you want to allow before requests expire. 90 days is the maximum.
  9. In the Reminders section, select the toggle if you want to enable reminders, then complete the following fields:

    • Number of Reminders - Maximum number of reminders that will be sent.
    • Days After the Request to Start Reminders - Number of days after an approval request is initiated before you want the first reminder to be sent.
    • Reminder Frequency - How often reminders will be sent. Options include daily, weekly, or monthly.
    • Times - Time of day the reminders will be sent.
    • Schedule Preview - Review the schedule of when reminders will be sent. If adjustments are needed, make changes to the prior fields and recheck the schedule preview.

      Note

      Time zone is configured at the bottom of the page.

  10. In the Escalations section, select the toggle if you want to enable escalations, then complete the following fields:

    • Days After the Request to Start Escalation - Number of days after an approval request is initiated before you want the first escalation to take place.
    • Escalation Frequency - The timing of approval escalations. Options include daily, weekly, or monthly.
    • Time - Time of day the escalation will take place.
    • Reviewers - Select Edit Approvers to open the Escalation Chain interaction.

      • Make changes to the Reviewer Category or select Add Approver. Available options include Manager, Identity, Governance Group, or Owners.
      • When you add an approver in the Identity or Governance Group category, a field appears where you can select which one.
      • Select Save.
      • To reorder approvers, select Edit Approvers, then select the Reorder icon next to an approver to click and drag. Select Save.
    • Fallback Approver - Select a Reviewer Category. When you add an approver in the Identity or Governance Group category, a field appears where you can select which one. A request is sent to a fallback approver when it has been routed through the full Approvers escalation chain and no one has taken action on it. Refer to Escalation Pattern.

    • Schedule Preview - Review the schedule on which reminders will be sent. If adjustments are needed, make changes to the prior fields and recheck the schedule preview.
  11. Set the Time Zone that will apply to all escalations and reminders.

  12. Select Save at the bottom of the page to save these approval settings.

From this page, you can also define the approval process for requests to deactivate agents.

Configuring the Resource-Level Approval Process for Requests to Deactivate Agents

You can define separate processes for how individual resources will handle approval requests to deactivate agents.

  1. In SailPoint Human Fabric, go to Admin > Connections > Sources.
  2. Select a source.
  3. On the left navigation of the source’s page, select Dataset Management > Resources, then select the specific resource.
  4. Select the Approval Settings tab.
  5. In the Requests to Deactivate Agents section, select the Requires Approval toggle.
  6. Configure the approval policy:

    • In the Approvers section, choose whether the request will be reviewed by a single approver or multiple approvers:

      • Single Approver

        • Select Single from the Approval Type field.
        • Select from the following Reviewer Category options:

          • Source Owner - The source owner reviews the request.
          • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
          • Primary Owner - The primary owner of the agent reviews the request.
          • Additional Owners - Any of the agent’s other owners can review the request.
          • Requester's Manager - The manager of the user who submitted the request reviews the request.
          • Identity - The selected identity reviews the request.
          • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
      • Multiple Approvers

        • Select Multi-Step from the Approval Type field.
        • In the Reviewers section, select Add Reviewer.
        • Configure the approval policy by taking the following actions:

          • Select from the following Reviewer Category field options:

            • Source Owner - The source owner reviews the request. This is the default reviewer.
            • Governance Group - The selected governance group reviews the request. Only one identity in the governance group is required to approve the request.
            • Primary Owner - The primary owner of the agent reviews the request.
            • Additional Owners - Any of the agent’s other owners can review the request. Only needs to be approved or denied by one.
            • Requester's Manager - The manager of the user who submitted the request reviews the request.
            • Identity - The selected identity reviews the request.
            • All Owners - The primary owner and additional owners review the request. Only needs to be approved or denied by one.
          • Add additional reviewers by selecting Add Approver.

          • Remove reviewers by selecting the Delete icon .
          • Move a reviewer’s tile to change the order the approvers will review the request.

            Note

            All reviewers must approve the request for the agent to be deactivated. If one reviewer denies the user’s request, the request is denied.

          • Select Save to save the approval process.

            If the approval process requires changes, select Edit Approvers. You can add or remove approvers and rearrange the order in which they will review the request.

  7. Choose whether comments are required when reviewers approve or deny requests to deactivate agents.

  8. Select Save at the bottom of the page to save these approval settings.

From this page, you can also set up reminders for approvers and configure an escalation process.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.