12.5. Synchronizing Groups
- Groups in the Active Directory domain are synced if it is configured in the sync agreement by selecting the Sync New Windows Groups option. All of the Windows groups are copied to the Directory Server when synchronization is initiated and then new groups are synced over as they are created.
- A Directory Server group account is synchronized to Active Directory through specific attributes that are present on the Directory Server entry. Any Directory Server entry must have the
ntGroupobject class and the
ntGroupCreateNewGroupattribute (even on an existing entry) signals Directory Server Win Sync to write the entry over to the Active Directory server.New or modified groups that have the
ntGroupobject class are created and synced over to the Windows machine at the next regular update.
- Two attributes control whether Directory Server groups are created and deleted on Active Directory,
ntGroupCreateNewGroupis required to sync Directory Server groups over to Active Directory.
- ntUserDomainId contains the unique ID for the entry on the Active Directory domain. This is the only required attribute for the
- ntGroupType is the type of Windows group. Windows group types are global/security, domain local/security, global/distribution, or domain local/distribution. This is set automatically for Windows groups that are synchronized over, but this attribute must be set manually on Directory Server entries before they can be synced.
12.5.1. About Windows Group Types
-21483646for global/security (the default)
-21483644for domain local/security
4for domain local/distribution
12.5.2. Group Attributes Synchronized between Directory Server and Active Directory
Table 12.4. Group Entry Attribute Mapping between Directory Server and Active Directory
Table 12.5. Group Entry Attributes That Are the Same between Directory Server and Active Directory
12.5.3. Group Schema Differences between Red Hat Directory Server and Active Directory
12.5.4. Configuring Group Sync for Directory Server Groups
126.96.36.199. Configuring Group Sync in the Console
- In the Directory Server Console, select the Directory tab.
- Right-click the group entry, and click Advanced to open the advanced property editor for the entry. All of the sync-related attributes must be added manually, so only the advanced property editor can set the attributes.
- Click the objectClasses field, and then click the button.
- Select the
- Setting the
ntGroupobject class automatically adds the
ntUserDomainIdattribute. This attribute is required, so add a value.
- To enable synchronization, click thebutton, and select the
ntGroupCreateNewGroupattribute from the list. Then, set its value to
true. This signals to the sync plug-in that the entry should be added to the Active Directory directory.To delete the group entry from the Active Directory domain if it is deleted from the Directory Server database, set the
ntGroupDeleteGroupattribute and set it to
- Add any other Windows attributes for the Directory Server entry. The available attributes are listed in Section 12.5.2, “Group Attributes Synchronized between Directory Server and Active Directory”.If the
ntGroupTypeis not added, then the group is automatically added as a global security group (
188.8.131.52. Configuring Group Sync in the Command Line
ntUserDomainIdattribute, to give the Windows ID for the entry.
ntGroupCreateNewGroupattribute, to signal to the synchronization plug-in to sync the Directory Server entry over to Active Directory.The
ntGroupDeleteGroupattribute is optional, but this sets whether to delete the entry automatically from the Active Directory domain if it is deleted in the Directory Server.
ntGroupTypeattribute. If this attribute is not specified, then the group is automatically added as a global security group (
ldapmodify -D "cn=directory manager" -W -p 389 -h server.example.com -x dn: cn=Example Group,ou=Groups,dc=example,dc=com changetype: modify add: objectClass objectClass:ntGroup add: ntUserDomainId ntUserDomainId: example-group add: ntGroupCreateNewGroup ntGroupCreateNewGroup: true add: ntGroupDeleteGroup ntGroupDeleteGroup: true add: ntGroupType ntGroupType: 2
ntGroupobject class, are described in more detail in the Red Hat Directory Server 9 Configuration, Command, and File Reference.
12.5.5. Configuring Group Sync for Active Directory Groups
184.108.40.206. Configuring Group Sync in the Console
- Open the Configuration tab and expand the Replication folder.
- Open the appropriate database, and select the sync agreement.
- Open the Connection tab.
- Check the New Windows Group Sync check box to enable group sync. To disable sync, uncheck the box.
220.127.116.11. Configuring Group Sync in the Command Line
nsds7NewWinGroupSyncEnabledand is set on the sync agreement. To enable group sync, add this attribute to the sync agreement or create a sync agreement with this attribute set to
ldapmodify -D "cn=directory manager" -W -p 389 -h server.example.com -x dn: cn=ExampleSyncAgreement,cn=userRoot,cn=dc=example\,dc=com,cn=mapping tree,cn=config changetype: modify replace: nsds7NewWinGroupSyncEnabled nsds7NewWinGroupSyncEnabled: on