Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

Identity Manager On Demand - Starling Edition Hosted - Attestation Administration Guide

Table of Contents

Attestation and recertification

One Identity Manager users for attestation Attestation base data Attestation types

Default attestation types Additional tasks for attestation types

Overview of the attestation type Assigning attestation procedures

Attestation procedure

General main data of an attestation procedure Templates for attestation procedures Providing information about attestation objects

Defining reports for attestation Defining snapshot content

Default attestation procedures Additional tasks for attestation procedures

Overview of the attestation procedure Assigning approval policies Creating a copy

Attestation schedules

Default schedules Assigning attestation policies Assigning policy collections Schedule overview Starting schedules immediately

Compliance frameworks

Additional tasks for compliance frameworks

Compliance framework overview Assigning attestation policies

Chief approval team Attestation policy owners Standard reasons for attestation

Predefined standard reasons for attestations

Attestation policies

General main data of attestation policies Specifying risk indexes for attestation guidelines Default attestation policies Additional tasks for attestation policies

The attestation policy overview Assigning approvers to attestation policies Assigning compliance frameworks to attestation policies Mitigating controls

Assigning mitigating controls Creating mitigating controls

Running attestation for single objects Showing or hiding conditions Copy attestation policies Showing selected objects Deleting attestation policies

Disabling attestation policies

Sample attestation

Creating, editing, deleting samples General main data of samples Managing sample data Generating sample data automatically Using samples with attestation policies Displaying the sample overview Default sample for attesting memberships in system entitlements Default sample for attesting identities

Grouping attestation policies

Creating and editing policy collections General main data of policy collections Assigning policy collections to attestation policies Disabling policy collections Deleting policy collections Default policy collections

Custom mail templates for notifications

Creating and editing attestation mail templates General properties of a mail template Creating and editing a mail definition

Using base object properties Use of hyperlinks in the Web Portal

Default functions for creating hyperlinks

Customizing email signatures

Copying mail templates for attestation Displaying attestation mail templates previews Deleting mail templates for attestation Custom notification processes

Suspending attestation Automatic attestation of policy violations

Approval processes for attestation cases

Approval policies for attestations

General main data of approval policies Default approval policies Additional tasks for approval policies

Editing approval workflows Validity checking

Approval workflow for attestations

Working with the workflow editor Setting up approval workflows

Editing approval levels Editing approval steps Properties of an approval step Connecting approval levels

Additional tasks for approval workflows

The approval workflow overview Copying approval workflows

Deleting approval workflows Default approval workflows

Selecting attestors

Default approval procedures

Using attestation policies to find attestors Using roles of identities to be attested to find attestors Using attestation objects to find attestors Determining attestors using the attestation objects' service item Using attestation object managers to find attestors Using persons responsible for attestation objects to find attestors Using a specified role to find attestors Using product owners to find attestors Using owners of a privileged object to find attestors Using additional Active Directory group owners to find attestors Using owners of the attestation objects to find attestors Using identities assigned to user accounts to find attestors Determining attested identity as attestor Determining attestation policy owners Calculated approval Approvals to be made externally Waiting for further approval

Setting up approval procedures

General main data of an approval procedure Queries for finding attestors

Additional tasks for approval procedures

Overview of the approval procedure Specifying permitted approval procedures for tables Copying an approval procedure

Deleting approval procedures Determining the responsible attestors

Setting up multi-factor authentication for attestation Prevent attestation by identity awaiting attestation Automatic acceptance of attestation approvals Phases of attestation

Setting up the staging phase Criteria for the Staging phase Setting up the challenge phase Setting up withdrawal of entitlements

Attestation by peer group analysis

Configuring peer group analysis for attestations

Approval recommendations for attestations

Criteria for approval recommendations for attestation Configuring approval recommendations for attestation

Managing attestation cases

Getting more information Appointing other attestors Escalating an attestation case Attestors cannot be established Automatic approval on timeout Halting an attestation case on timeout Attesting by chief approval team

Attestation sequence

Starting attestation Attestation case overview Approval sequence Attestation history Modifying approval workflows for pending attestation cases Closing attestation cases for deactivated identities Deleting attestation cases Notifications in the attestation case

Requesting attestation Reminding attestors Scheduling attestation requests Reminding attestors about attestation objects Approving or denying attestation cases Notifying delegates Canceling attestation cases Escalation of attestation cases Delegating attestations Rejecting approvals Notifications with questions Notifications from additional attestors Link for verifying new external users Default mail templates

Attestation by mail

Processing attestation mails

Adaptive cards attestation

Using adaptive cards for attestations Adding and deleting recipients and channels Creating, editing, and deleting adaptive cards for attestations Creating, editing, and deleting adaptive cards templates for attestations General main data for adaptive cards Deploying and evaluating adaptive cards for attestations Disabling adaptive cards

Approving attestation cases in the Manager Displaying attestation cases of an attestor Displaying information about attestation objects Assigning extended properties to attestation cases Displaying incomplete attestation runs Canceling incomplete attestation runs Displaying canceled attestation runs Reports about attestations

Default attestations

Configuring withdrawal of entitlements

Attesting system entitlements System role attestation Application role attestation Business role attestation

Configuring sample attestation of identities and their entitlements User attestation and recertification

One Identity Manager users for attesting and recertifying users Configuring user attestation and recertification Attesting new users

Self-registration of new users in the Web Portal Adding new identities using a manager or administrator for identities Importing new identity main data Scheduled attestation Limiting attestation objects for certification

Recertifying existing users

Preparing for recertification The recertification sequence Limiting attestation objects for recertification

Certifying new roles and organizations

One Identity Manager users for certifying roles and organizations Configuring certification of new departments Configuring certification of new cost centers Configuring certification of new locations Configuring certification of new business roles Configuring certification of new application roles

Mitigating controls

General main data of mitigating controls Additional tasks for mitigating controls

Mitigating controls overview Assigning attestation policies

Calculating mitigation

Setting up attestation in a separate database

Requirements for the central database Setting up work databases Setting up synchronization between central and work databases Setting up and running attestations in the work database

Configuration parameters for attestation

Properties of an approval step

On the General tab, enter the data described below. On the Mail templates tab, select the mail templates for generating mail notifications. If you add a new approval step, you must fill out the required fields.

Table 25: General properties of an approval step
Property	Meaning
Single step	Approval step name.
Approval procedure	Procedure to use for determining the attestors.
Role	Hierarchical role from which to determine the attestors. The role is used in the OM and OR default approval procedures. Additionally, you can use the role if you use a custom approval procedure in the approval step.
Fallback approver	Application role whose members are authorized to approve attestation cases if an attestor cannot be determined through the approval procedure. Assign an application from the menu. To create a new application role, click . Enter the application role name and assign a parent application role. For more information, see the One Identity Manager Authorization and Authentication Guide. NOTE: The number of approvers is not applied to the fallback approvers. The approval step is considered approved the moment as soon as one fallback approver has approved the request.
Condition	Condition for calculating the approval decision. The condition is used in the CD, EX, or WC default approval procedures. Additionally, you can use the role if you use a custom approval procedure in the approval step.
Number of approvers	Number of attestors required to approve an attestation case. Use this number to further restrict the maximum number of approvers of the implemented approval procedure. If there are several identities allocated as attestors, then this number specifies how many identities from this group have to approve an attestation case. A request can only be passed up to next level afterward. If you want approval decisions to be made by all the identities found using the applicable approval procedure, for example, all members of a role (default approval procedure OR), enter the value -1. This overrides the maximum number of attestors defined in the approval procedure. If not enough attestors can be found, the approval step is presented to the fallback approvers. The approval step is considered approved as soon as one fallback approver has approved the attestation case. If an approval decision is made by the chief approval team, it overrides the approval decision of just one regular attestor. This means, if three attestors must approve an approval step and the chief approval team one of the decision, two more are still required. The number of approvers defined in an approval step is not taken into account in the approval procedures CD, EX, or WC.
Description	Text field for additional explanation.
Approval reason	Reason entered in the attestation case if approval is automatically granted. This field is only shown for the approval procedures CD, EX, and WC.
Reject reason	Reason entered in the attestation case and the attestation history, if approval is automatically denied. This field is only shown for the approval procedures CD, EX, and WC.
Reminder after (minutes)	Number of minutes to elapse after which the attestor is notified by mail that there are still pending attestation cases for attestation. The input is converted into working hours and displayed additionally. The reminder interval is set to 30 minutes, by default. To change this interval, modify the Checks reminder interval and timeout of attestation cases schedule. NOTE: Ensure that a state, county, or both is entered into the identity's main data of determining the correct working hours. If this information is missing, a fallback is used to calculate the working hours. For more information about calculating identities' working hours, see the One Identity Manager Identity Management Base Module Administration Guide. TIP: Weekends and public holidays are taken into account when working hours are calculated. If you want weekends and public holidays to be dealt with in the same way as working days, set the QBM \| WorkingHours \| IgnoreHoliday or QBM \| WorkingHours \| IgnoreWeekend configuration parameter. For more information about this, see the One Identity Manager Configuration Guide. If more than one attestor was found, each attestor will be notified. The same applies if an additional attestor has been assigned. If an attestor delegated the approval, the time point for reminding the delegation recipient is recalculated. The delegation recipient and all the other attestors are notified. The original attestor is not notified. If an attestor has made an inquiry, the time point for reminding the queried identity is recalculated. As long as the inquiry has not been answered, only this identity is notified.
Timeout (minutes)	Number of minutes to elapse after which the approval step is automatically granted or denied approval. The input is converted into working hours and displayed additionally. The timeout is check every 30 minutes, by default. To change this interval, modify the Checks reminder interval and timeout of attestation cases schedule. The working hours of the respective approver are taken into account when the time is calculated. NOTE: Ensure that a state, county, or both is entered into the identity's main data of determining the correct working hours. If this information is missing, a fallback is used to calculate the working hours. For more information about calculating identities' working hours, see the One Identity Manager Identity Management Base Module Administration Guide. TIP: Weekends and public holidays are taken into account when working hours are calculated. If you want weekends and public holidays to be dealt with in the same way as working days, set the QBM \| WorkingHours \| IgnoreHoliday or QBM \| WorkingHours \| IgnoreWeekend configuration parameter. For more information about this, see the One Identity Manager Configuration Guide. If more than one approver was found, then an approval decision for the approval step is not automatically made until the timeout for all approvers has been exceeded. The same applies if an additional approver has been assigned. If an approver delegated approval, the time point for automatic approval is recalculated for the new approver. If this approval is rejected, the time point for automatic approval is recalculated for the original approver. If an approver is queried, the approval decision must be made within the defined timeout anyway. The time point for automatic approval is not recalculated. If additional approvers are determined by recalculating the current approvers, then the automatic approval deadline is not extended. The additional approvers must approve within the time frame that applies to the current approver.
Timeout behavior	Action that is run if the timeout expires. Approved: The attestation case is approved in this approval step. The next approval level is called. Deny: The attestation case is denied in this approval step. The approval level for denying is called. Escalation: The attestation case is escalated. The escalation approval level is called. Cancel: The approval step and, therefore, the entire attestation procedure, is canceled.
Reason type on approval	Specifies which type of reason is required when granting approval to this approval step. Optional: A reason can be provided if required. Reason required (standard or free): A standard reason must be selected or a reason given with any text. Free text required: A reason must be given with freely selected text. NOTE: In the Web Designer Web Portal this information is not used. No distinction is made between the different types of reasons.
Reason type on denial	Specifies which type of reason is required when denying approval to this approval step. Optional: A reason can be provided if required. Reason required (standard or free): A standard reason must be selected or a reason given with any text. Free text required: A reason must be given with freely selected text. NOTE: In the Web Designer Web Portal this information is not used. No distinction is made between the different types of reasons.
Additional approver possible	Specifies whether a current attestor is allowed to instruct another identity as an attestor. This additional attestor has parallel authorization to make approvals for the current attestation case. The attestation case is not passed on to the next approval level until both attestors have made a decision. This option can only be set for approval levels with a single, manual approval step.
Approval can be delegated	Specifies whether a current attestor can delegate the attestation to another identity. This identity is added to the current approval step as the attestor and then makes the approval decision instead of the attestor who delegated. This option can only be set for approval levels with a single, manual approval step.
Approval by affected identity	Specifies whether the identity who is affected by the approval decision can also approve it. If this option is set, identities to be attested can attest themselves. If this option is not set, use the QER \| Attestation \| PersonToAttestNoDecide configuration parameter to define whether the identities to be attested can attest themselves.
Do not show in approval history	Specifies whether or not the approval step should be displayed in the attestation history. For example, this behavior can be applied to approval steps with the CD - calculated approval procedure, which are used only for branching in the approval workflow. It It makes it easier to follow the attestation history.
Escalate if no approver found	Specifies whether the approval step is escalated if no attestor can be found and no fallback approver is assigned. In this case, the attestation case is neither canceled nor passed to the chief approval team. This option can only be enabled if an approval level is linked to escalation.

Detailed information about this topic

Related topics

Connecting approval levels

When you set up an approval workflow with several approval levels, you have to connect each level with another. You may create the following links.

Table 26: Links to approval levels
Link	Description
Approve	Link to next approval level if the current approval level was granted approval.
Deny	Link to next approval level if the current approval level was not granted approval.
Reroute	Link to another approval level to bypass the current approval. Attestors can pass the approval decision through another approval level, for example, if approval is required by a manager in an individual case. To do this, create a connection to the approval levels to which the approval can be rerouted. This way, approvals can also be rerouted to a previous approval level, for example, if an approval decision is considered not to be well-founded. Starting from one approval level, more than one reroute can lead to different approval levels. The attestors select, in the Web Portal, which of these approval levels to reroute the approval to. It is not possible to reroute approval steps with the approval procedures EX, CD, SB, or WC.
Escalation	Link to another approval level when the current approval level is escalated after timing out.

If there are no further approval levels after the current approval level, the attestation case is considered approved if the approval decision was to grant approval. If approval is not granted, the attestation case is considered to be finally denied. The attestation procedure is closed in both cases.

Additional tasks for approval workflows

After you have entered the main data, you can run the following tasks.

The approval workflow overview

Copying approval workflows

The approval workflow overview

To obtain an overview of an approval workflow

In the Manager, select the Attestation > Basic configuration data > Approval workflows category.
Select the approval workflow in the result list.
Select Approval workflow overview.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© 2024 One Identity LLC. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center