Synchronization (v 2.0)

There are three different ways to synchronize user profile elements with a central storage: Periodically or manually for all users (full synchronization), or at login for a single user. During this process, the data of a users profile elements is updated with the values from the configured LDAP repositories according to the mapping that was defined during configuration of the profile fields.

Please Note

The synchronization is only working in one direction. Data will only be pulled from a repository and will never be written back. This also applies to repositories which are configured as “Read/Write”.

The synchronization is currently not working for directories of type “Apache Directory Server (ApacheDS)”. Synchroniziation is also not working for delegated directories.

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'KB:Synchronizing constellations - does Crowd work?'.

Manual Synchronization

The manual synchronization can be started from the advanced configuration setting (Administration Console > User Profiles for Confluence > Advanced). There is a button “Start Synchronization” below in the synchronization settings. After clicking it, a full synchronization will happen. This means that every user profile will be synchronized according to your configuration. After the synchronization, a short summary will be shown.

Since a full synchronization is a resource-consuming task, it should not be started during business hours!

Periodical Synchronization

A full synchronization will be executed periodically. The add-on is configured to start this synchronization by default at 1:11 a.m. each night.

You can customize or disable periodical synchronization via “Scheduled Jobs” in the administration. Look for the entry “External User Directory Sync Job” to configure the job that schedules periodical synchronizations.

Single-User Synchronization

Whenever a user logs in, their profile data is synchronized with the user repository. Since Version 1.10 this setting is disabled by default, because it can have an impact on the login performance.

You can enable this synchronization type, if you select the checkbox “Enable Login Synchronization” from the advanced configuration settings (Administration Console > User Profiles for Confluence > Advanced).

Note: The synchronization will only run for that single user.

(lightbulb) Demo of synchronization (If you can not see embedded video below, please check whether you have agreed to the privacy policy of this website or if your browser blocks unsafe content.)

Configuration of Active User Policy

This option is no longer available. It is still being displayed for compatibility reasons however.

The add-on allows you to configure which users are considered “active” users. Only active users are synchronized, exported and considered for organization charts. This is useful if your user repository has users that are not real users – like rooms or computers. You can choose between two policies:

  • All users that are present in the system. That is, all users who are synchronized from the configured “User Directories”, even if they are not yet visible everywhere (e.g. the people directory). These are all the users who are displayed to you after
    • navigating to “Manage Users” in the global administration and
    • clicking “Show all users”
  • Visible Users: Only users currently visible, e.g. in the people directory and via search.

This configuration is available by clicking the “Advanced” link in the “User Profiles for Confluence” section and the first section on this screen “Active User Policy” contains the configuration.

 


Back to Top