Groups Synchronization

Overview

The hoozin synchronization process can be used to synchronize one or several groups from the customer source to the hoozin directory.

Every time the synchronization is processed, this step will ensure that the hoozin group is synchronized with the source group. This synchronization only processes new users and users removed from the original group.

This feature is not optimized for processing a lot of groups.

Prepare the directory source

The first step is to ensure that your source content contains a MemberOf node for every user, with all the groups to be synchronized separated by semicolons (;).

<DirectoryEntity>
    <key>[e-mail]</key>
    <cn>[e-mail]</cn>
    <displayName>John DOE</displayName>
    <givenName>John</givenName>
    <sn>DOE</sn>
    <mail>[e-mail]</mail>
    <description>Network Specialist | Spécialiste, réseau informatique</description>
    <title>Network Specialist</title>
    <company>ACME</company>
    <department>Technologie de l'information</department>
    <memberOf>CN=source,OU=groups,dc=source,dc=acme,dc=com;CN=allmembers,OU=groups,dc=source,dc=acme,dc=com</memberOf>
    <postalAddress>36, rue Lajeunesse,</postalAddress>
    <l>Contoso</l>
    <userPrincipalName>[e-mail]</userPrincipalName>
    <preferredLanguage>1036</preferredLanguage>
    <hoozinPasswordChangedInWelcomeProcess>TRUE</hoozinPasswordChangedInWelcomeProcess>
    <msDS-UserAccountDisabled>FALSE</msDS-UserAccountDisabled>
</DirectoryEntity>

Add a new post processing

The next step is to add a new post processing to the synchronization process.

Go to the Advanced tab in the Directory Synchronization definition. In the Post processing synchronization section, click the Add button to define a new step.

Once the new post processing has been created, define the following settings:

Name	Description
Process title	The name that will identify your post processing
Assembly strong name	Prexens.Hoozin.SharePoint.Directory.PostProcessing.FillGroup, Prexens.Hoozin.SharePoint.Directory, Version=14.0.0.0, Culture=neutral, PublicKeyToken=1ba01bf322d8e4cb

Then, customize the post processing by adding following parameters:

Name	Description
SourceGroupDN	A value expected in the MemberOf source content Example: CN=source,OU=groups,dc=source,dc=acme,dc=com)
DestinationGroupDN	The complete DistinguishedName of the destination group in hoozin Example: CN=source,OU=Groups,OU=Hoozin,dc=hoozin,dc=com
SynchronizationSource	Name of the synchronization source containing the source records Example: ACME
SynchronizationKey	The key used to match the source user and the destination user in hoozin Possible values: userPrincipalName cn objectSid
SiteUrl	The hoozin site URL to connect to the directory Example: https://acme.hoozin.com