Identity Cloud discovers and synchronizes changes from external resources by using reconciliation and liveSync.
Identity Cloud synchronizes changes made to managed resources by using reconciliation and implicit synchronization.
Reconciliation is the process of ensuring that the objects in two different data stores are consistent. Traditionally, reconciliation applies mainly to user objects, but Identity Cloud can reconcile any objects, such as groups, roles, and devices.
In any reconciliation operation, there is a source system (the system that contains the changes) and a target system (the system to which the changes will be propagated). The source and target system are defined in a mapping. The Identity Cloud repository can be either the source or the target in a mapping. You can configure multiple mappings for one Identity Cloud instance, depending on the external resources to which you are connecting.
To perform reconciliation, Identity Cloud analyzes both the source system and the target system, to discover the differences between them. Reconciliation can therefore be a heavyweight process. When working with large data sets, finding all changes can be more work than processing the changes.
Reconciliation is very thorough. It recognizes system error conditions and catches changes that might be missed by liveSync, and therefore serves as the basis for compliance and reporting.
LiveSync captures the changes that occur on an external system, and pushes those changes to Identity Cloud. Identity Cloud uses any defined mappings to replay those changes where they are required—to its managed objects, to another remote system, or to both. Unlike reconciliation, liveSync uses a polling system, and is intended to react quickly to changes as they happen.
To perform this polling, liveSync relies on a change detection mechanism on the external resource to determine which objects have changed. The change detection mechanism is specific to the external resource, and can be a time stamp, a sequence number, a change vector, or any other method of recording changes that have occurred on the system. For example, ForgeRock Directory Services (DS) implements a change log that provides Identity Cloud with a list of objects that have changed since the last request. Active Directory implements a change sequence number, and certain databases might have a
- Implicit synchronization
Implicit synchronization automatically pushes changes that are made to Identity Cloud managed objects out to external systems.
For direct changes to managed objects, Identity Cloud immediately synchronizes those changes to all mappings configured to use those objects as their source. A direct change can originate not only as a write request through the REST interface, but also as an update resulting from reconciliation with another resource.
Implicit synchronization only synchronizes changed objects to external resources. To synchronize a complete data set, you must run a reconciliation operation. The entire changed object is synchronized. If you want to synchronize only the attributes that have changed, you can modify the
onUpdatescript in your mapping to compare attribute values before pushing changes.