- Start the Directory Synchronization Tool application.
- On the Service Settings tab, configure the following:
- Under the TMEMS Administrator Logon Account section:
- Account Name: Your administrator account name you use to log on to TMEMS administrator console
- Service Auth Key: Your service authentication key for the TMEMS server
You can find your service authentication key on the API Access tab of the Service Integration screen (Administration > Service Integration) on the TMEMS administrator console.
- Under the Proxy Settings section:
- Do not use a proxy: If your network does not require a proxy, select this option to disable this setting.
- Automatically detect proxy settings: Select this option to let the Directory Synchronization Tool automatically detect your network proxy settings.
- Manually set the proxy (HTTP): Select this option to manually set the proxy server and port settings for your proxy server. If required, type the proxy user name and password.
The Directory Synchronization Tool currently supports only the HTTP proxy.
- Synchronize every x hours: Select this option and specify the duration in hours, if you want the Directory Synchronization Tool to automatically synchronize user groups, valid recipients and email aliases from the source directory to TMEMS on a recurrent basis.
This setting requires you to synchronize data manually for the first time. Later on, the Directory Synchronization Tool automatically synchronizes data according to your setting.
- Under the TMEMS Administrator Logon Account section:
- Click Apply.
- On the Source Directory tab, complete synchronization source settings.
- Next to Source Name, specify a source directory name.
- From the Source Type drop-down list, select Microsoft Office 365 / Azure Active Directory as the source directory type.
- Complete required settings:
- Tenant Domain: The domain name of the Azure directory, which is the sub-domain of the root domain "onmicrosoft.com"
- Application ID: A unique ID required for a custom application to make calls
- Application Key: A unique key value required for a custom application to make calls
To obtain the Application ID and Application Key, refer to Creating an Azure Active Directory Application section.
- Register an application.
- Log on to your Azure Active Directory admin center as an admin user.
- Navigate to Azure Active Directory > App registrations > New registration.
- Type a name for your application. For example, "TMEMS Azure AD Sync."
- Under Redirect URI (optional), select Web as platform then type the following URL of the TMEMS administrator console:
- North America, Latin America and Asia Pacific: https://ui.tmes.trendmicro.com
- Europe, the Middle East and Africa: https://ui.tmes.trendmicro.eu/
- Australia and New Zealand: https://ui.tmes-anz.trendmicro.com/
- Japan: https://ui.tmems-jp.trendmicro.com
- Singapore: https://ui.tmes-sg.trendmicro.com
- India: https://ui.tmes-in.trendmicro.com
- Click Register. A new application appears on the screen.
- Copy and save the Application (client) ID.
- Add a client secret for your application.
- Access the application you created.
- In the left navigation, click Certificates & secrets > Client secrets > New client secret.
- Type a description for the client secret, select a 24 months option from the Expires drop-down list, and click Add.
A client secret generates in the Client secrets section. This value will not be visible after you leave this screen.Directory synchronization will fail if the client secret expires. If this occurs, generate a new client secret. - Copy and save the client secret value (Application Key).
- Obtain API permissions for your application.
- Access the application you created.
- In the left navigation, click API permissions and click Add a permission.
- Click Microsoft Graph on the Microsoft APIs tab page.
- Select Application permissions > Directory.Read.All permission under Directory, and click Add permissions.
- Click Grant admin consent for Your tenant name.
- Click Yes in the dialog box that appears.