Synchronizing Active Directory groups with AgilePoint groups

Special characters can be included in group names while synchronizing users of Active Directory and AgilePoint by using a CustomActiveDirectorySync key of String data type in the ADSync module. However, the semicolon (;) and tilde (~) characters cannot be used in group names, because they act as group-pair separators, as follows:

<AgilePointGroup1>~<ActiveDirectoryGroup1>;<AgilePointGroup2>~<ActiveDirectoryGroup2> and so on.

Prerequisites

The ADSyncModule extension is enabled.

Instructions

In the Windows Registry, create the following keys in the location SOFTWARE\Ascentn\Server\ActiveDirectory

Name	Value
CustomActiveDirectorySync	Definition: The data type is String. Allowed Values: A semicolon-delimited list of group pairs in the following format: <APGroup1>~<ADGroup1>;<APGroup2>~<ADGroup2> Example: <APMyGroup>~<ADYourGroup> Specifies that an AgilePoint Group named APMyGroup is to be synchronized with an Active Directory Group named ADYourGroup. <APMyGroup>~<ADYourGroup>;<APOurGroup>~<ADTheirGroup> Specifies that 2 pairs of groups are synchronized: APMyGroup with ADYourGroup, and APOurGroup with ADTheirGroup.

Name

Value

CustomActiveDirectorySync

Definition:

The data type is String.

Allowed Values:

A semicolon-delimited list of group pairs in the following format:

Example:

<APMyGroup>~<ADYourGroup>
Specifies that an AgilePoint Group named APMyGroup is to be synchronized with an Active Directory Group named ADYourGroup.
<APMyGroup>~<ADYourGroup>;<APOurGroup>~<ADTheirGroup>
Specifies that 2 pairs of groups are synchronized: APMyGroup with ADYourGroup, and APOurGroup with ADTheirGroup.