Configuring Reconciliation Process
Once the applications have been configured to allow that the end-users have been provisioned into the managed application. We may now start configuring the reconciliation process for an application. The reconciliation process involves identifying the user attributes as stored in the Identity hub (Cymmetri Identity platform deployment) and their attributes as a user or a group account in the managed application; and the ensuring that the synchronization of the user and group accounts takes place either one-way or both ways between the managed application and the Identity hub, to ensure that there no discrepancies in the accounts stored by both the systems.
The reconciliation process may follow two strategies -
Full Reconciliation Full reconciliation is typically carried out when the managed application is first introduced into an organization’s Cymmetri Identity platform deployment. This involves ensuring all user (and group accounts, where applicable) account from the Cymmetri Identity platform, are synchronized with the account information on the managed application. This often takes a longer time, and is often only used as a one-time activity.
Filtered Reconciliation The Cymmetri identity platform and the managed application might lose synchronization due to a number of reasons, including backend changes to the user or group account information on the managed application or failure of communication between the identity platform and the managed application. In such cases, filtered reconciliation is employed on a regular, scheduled basis. This includes filters for a particular set of users, or to choose only the users that have been modified on either platforms, this is known as filtered reconciliation.
Cymmetri Identity platform allows for both types of reconciliation phases, by allowing administrator to define an optional user filter during the reconciliation process.
The reconciliation process involves two major processes -
Pull In this mechanism, the Cymmetri Identity platform allows for user and group account information to be pulled from the managed application.
Push In this mechanism, the Cymmetri Identity platform pushes the user and group account information to be pushed to the managed application.
Regardless of the process employed, the configuration for the most part remains the same. Let us explore the reconciliation configurations on the Cymmetri Identity Platform -
You may access the reconciliation menu by clicking on the application tile, and then clicking on the “Reconciliation” left-hand side menu bar.
Proceed to configure by clicking on the “+ Add New” button.
![](https://help.cymmetri.io/~gitbook/image?url=https%3A%2F%2Fs3-ap-south-1.amazonaws.com%2Find-cdn.freshdesk.com%2Fdata%2Fhelpdesk%2Fattachments%2Fproduction%2F84003452411%2Foriginal%2Fi1trgAErATCXMp3wWNgX0xj1O75UsfbstA.png%3F1649361585&width=768&dpr=4&quality=100&sign=728776c7&sv=1)
Name - Refers to the name of the Reconciliation process
Modes - FILTERED_RECONCILIATION (Currently the only mode supported by Cymmetri)
Sync Fields - The field from the user/group’s account information as available on the Cymmetri Identity platform that must be used as a basis to identify the corresponding account on the managed application database.
Source Attributes - The field from the user/group’s account information as available on the managed application database that must be used as a basis to match with the “Sync fields”.
Status - Whether to run the reconciliation for Active/Inactive users.
Type - Some applications allow GROUP reconciliation, but most will have USER reconciliation only.
Filled Reconciliation basic configuration looks as above.
Conditions indicate what happens when any of the following scenarios occur -
Let us assume we are synchronizing the Cymmetri Identity Platform with a cloud provider using email or mail attribute as the Sync field. As such users on both platforms having the same email address will be matched/un-matched.
Following are the scenarios managed by the Cymmetri platform -
User does not exist in Target system & exists in Cymmetri This indicates a situation during a pull phase or a push phase, where the user account exists on the Cymmetri platform, but not in the managed application. This typically occurs when the users have been pulled into the Cymmetri platform, but the managed application is yet to be synchronized with these users.
User exists in Cymmetri & Target system This indicates a situation during a pull phase or a push phase, where the user account exists on the Cymmetri platform and in the managed application, but they may or may not have the same attributes or the same values of the attributes.
User exists in Target system & does not exist in Cymmetri This indicates a situation during a pull phase or a push phase, where the user account exists in the managed application database but not on the Cymmetri Identity platform. This typically occurs when the users have been pulled into the managed application through its backend and the users have not been centrally managed through the Cymmetri platform.
Conditions explained
User does not exist in Target system & exists in Cymmetri
PROVISION - User is created in the target system with the attributes as present in their Cymmetri user profile.
IGNORE - User is not modified in either system.
UPDATE - Not relevant for this scenario.
DEPROVISION - User is removed from the Cymmetri Identity platform to be consistent with the managed application user database.
UNASSIGN - Not relevant for this scenario.
ASSIGN - User is assigned access to this system in Cymmetri, this option may be used in the case of options like JIT being available to generate user profile in the managed application.
UNLINK - Not relevant for this scenario.
LINK - Not relevant for this scenario.
User exists in Cymmetri & Target system
PROVISION - User is created in the target system with the attributes as present in their Cymmetri user profile.
IGNORE - User is not modified in either system.
UPDATE - User information from the Cymmetri Identity platform is updated using the account information from the managed application and vice versa.
DEPROVISION - Not relevant for this scenario.
UNASSIGN - Not relevant for this scenario.
ASSIGN - User is assigned the managed application on the Cymmetri platform in case they are already not assigned.
UNLINK - Not relevant for this scenario.
LINK - Not relevant for this scenario.
User exists in Target system & does not exist in Cymmetri
PROVISION - User is created in the Cymmetri Identity platform deployment using the account information from the managed application.
IGNORE - User is not modified in either system.
UPDATE - Not relevant for this scenario.
DEPROVISION - User is removed from the managed application user database.
UNASSIGN - Not relevant for this scenario.
ASSIGN - Not relevant for this scenario.
UNLINK - Not relevant for this scenario.
LINK - Not relevant for this scenario.
Scheduling the reconciliation Process
Next Execution Date This indicates the base date to start the execution date and time of the reconciliation process.
Cron Expression This indicates the frequency with which the further reconciliation events will be run. There are 6 fields here - * * * * * * (e.g., 5 15 0 1 8 *) ; they refer to seconds, minutes, hours, days, months, and year after the first execution date.
Last updated