Overview
For customers who wish to Federate with Microsoft 365 when they begin using Access Control and are synchronizing Users with Active Directory (AD) for the first time, this article explains the definitions and delivery method for the HENNGE Directory Sync Tool synchronization configuration file used for AD Synchronization.
Notes
- The content of this article is based on the product information as of October 2026 and may be changed without prior notice.
-
If you have already performed User Synchronization with AD, please contact the Technical Support Desk.
I want to know how to contact the HENNGE One Support Desk
Procedure
1. Determine the criteria for Target Users to be synchronized.
You can select the Target Users to be synchronized based on the following criteria.
※ They must be Valid User objects.
※ If you would like to define criteria other than those listed below, please contact us using the form in Procedure 3.
-
Belongs to a specific OU
※ Users in child OUs under the specified OU will also be included in the Synchronization Target. Multiple OUs can be specified. -
Belongs to a specific security group (※2)
※ Users in child security groups (nested security groups) under the specified security group will not be included in the Synchronization Target.
Therefore, Target Users must belong directly to the specified security group. Multiple security groups can be specified. - The domain of the mail Attribute has a specific Value
- The domain of the UserPrincipalName Attribute has a specific Value
2. Determine the mapping between User Attributes in Access Control and Attributes in AD.
You can select from the following mappings.
※ If you would like to use a mapping other than the options listed below, please contact us using the form in Procedure 3.
| Attribute Value in Access Control | Attribute Value in AD | Description |
| Username |
samAccountName |
The Value of a Username cannot be changed after the User has been synchronized. Only alphanumeric characters can be specified. Uppercase and lowercase letters are distinguished. |
| Family name | Surname | |
| Given name | GivenName | |
|
Name |
DisplayName |
|
| Microsoft 365 UPN |
UserPrincipalName |
Specify the AD Attribute Value that corresponds to the Microsoft 365 UserPrincipalName (UPN). |
| Email Address |
UserPrincipalName |
Example) If the UserPrincipalName (UPN) Attribute on the AD side is user1@hennge.local and the mail Attribute is user1@hennge.com:
Because the .local domain cannot be used as a Microsoft 365 UserPrincipalName (UPN), which must be unique on the Internet, it is not appropriate to map the UserPrincipalName (UPN) Attribute on the AD side to the Microsoft 365 UPN Attribute in Access Control. It should be mapped to the mail Attribute.
3. Once the Target Users to be synchronized and the mapping of Attribute Values have been finalized, enter the required information in the form below and Send it.
It takes several business days to create the synchronization configuration file.
HENNGE Directory Sync Tool Synchronization Configuration File Notification Form
4. Based on the information entered in the form, HENNGE will create the synchronization configuration file and send it to you by email. The file to be sent and its description are as follows.
These files will be used in future implementation procedures, so be sure to save them in a location that can be accessed during implementation.
| File Name | Description |
| config.ini | The Access Control Tenant information and Attribute Value mapping definitions are registered. |
Translation Disclaimer
This article has been automatically translated from the original Japanese version for your convenience.
While we strive to ensure accuracy, we cannot guarantee its reliability or completeness.
In the event of any discrepancies or questions regarding the content, the official Japanese version shall prevail.