Registering the Entra ID application

Admin Content

This procedure is required when you choose to authenticate your outgoing emails via an Entra ID application. This feature is available in 12d Synergy version 5.1.7.753 or later.

1.1. How to Register the Entra ID Application for Email Authentication

1. Log in to your Azure portal and click the Microsoft Entra service link.

   

2. Select Manage > App registrations link from the left panel and click the New registration link.

   

   
   The Register an application screen is displayed.

3. Do the following as shown in the image below.
    
   

   1. Enter a name for your application in the Name box. Let’s say For Email Authentication.

   2. Select the first option, Account in this organizational directory only (12dsynergy.com only - Single tenant), for your application from the options displayed under Supported account types section.

4. Click the Register button.

5. Click the Manage > Authentication link as displayed in the image below.
   
   

6. Click the Add a platform link, and then click the Mobile and desktop applications option as shown in the image below.

   

   
   The Configure desktop + devices panel is displayed on the right side of the page.

   

7. Select the checkbox that mentions nativeclient in its address. In the example above, it is the first check box.

8. Enter "http://localhost" in the Custom redirect URIs box.

9. Click the Configure button.

   The setup for Mobile and desktop application is now completed.

10. Click the Manage > API permissions link displayed in the left panel.

    

11. As a 12d Synergy Administrator, you need to give consent to the application permissions. For that, firstly we need to add the required permissions. Click the Add a permission link.

    

    
    The Request API permissions panel is displayed to the right of the page.

12. Click the Microsoft Graph option.

    

13. Click the Delegated permissions option.

    

14. In the Select permissions section, search for the following permissions and select the checkbox displayed against them.  

    1. Email

    2. Offline_access

    3. SMTP.Send

    4. User.Read

15. Click the Add permissions button.
    The following page is displayed with the configured permissions.

    

16. Click the Grant admin consent for 12dsynergy.com link, which is highlighted in the above image.
    A Grant admin consent confirmation prompt is displayed.

17. Click the Yes button.
    Once the permissions are granted, the status of the configured permissions is updated as shown below.

    

18. Click the Overview link in the left panel.

    The Application (client) ID and Directory (tenant) ID are displayed on this page. Make a note of these, as you have to enter them in the 12d Synergy Administration application.

    

19. In the 12d Synergy Administration application, select the Emails > Email Server tab.

20. Select the Exchange Online with Entra ID from the Authentication Type list.
    

21. Enter the Directory (tenant) ID and Application (client) ID from step 18 above in the Entra ID: Tenant ID and Entra ID: Client ID boxes, respectively.

22. Click the Save Settings button.

23. Restart the 12d Synergy Server and the 12d Synergy Client applications.
    The Entra ID application setup is now complete.