Multi tenancy

Admin Content

This feature is available in 12d Synergy version 5.1.7.413 and later. Please check with your Account Manager for more details.

1.1 How to Configure Multi Tenant Setup?

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

   

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

   

   The Register an application screen is displayed.

3. Enter a name for your application in the Name box. Let’s say 12d Synergy MS365 Multi Tenant .

   

4. Select the first option, Account in any organizational directory only (Any Microsoft Entra ID tenant - Multitenant), for your application from the options displayed under Supported account types section.

5. Click the Register button displayed towards the bottom of the page.

6. In the page that follows, click the Branding & Properties link from the left panel.

   

   In a multi tenant app, users need to have a verified Microsoft Partner Number, else the permission requests will show up as 'Unverified'.

7. Click the Authentication  link from the left panel.

   

8. Click the Add a platform link as shown in the below image.

   

   
   The Configure platforms panel is displayed on the right side of the page.

9. Select the Single-page application option as shown in the image above.
   The Configure single-page application panel is displayed on the right side of the page.

   

10. In the Redirect URls section, enter your server address (for example - https://synergy.12dsynergycloud.com) in the box provided.

11. Click the Configure button.

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

    

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

    

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

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

15. Click the Configure button.

    The following page is again displayed.

    

16. Scroll down and click Yes in the toggle button displayed against the Enable the following mobile and desktop flows: field.

17. Click the Save button.

    Multi-tenancy is setup for the single-page, and mobile and desktop applications.

18. Click the API permissions link displayed in left panel.

    

19. 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.

20. Click the Microsoft Graph option.

    

21. Click the Delegated permissions option.

    

22. In the Select permissions section, search for the following permissions and select the check box displayed against it.  

    1. Files.ReadWrite

    2. Offline_access

    3. Openid

    4. Profile

    5. User.Read

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

    

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

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

    

     

26. Click the Overview link in the left panel.

    The Application (client) ID is displayed in this page. Make a note of this as you have to enter it in the 12d Synergy Administration application.

    

27. In the 12d Synergy Administration application, select the System Settings > General tab.

28. Filter the settings by entering "Microsoft 365" in the Filter box.

29. Enter the Application (client) ID from step 25 above in the Microsoft 365 Client ID setting.

30. Enter the word “common” in the Microsoft 365 Tenant ID setting as it is a multi-tenant collaboration.

    

31. Click the Save button.
    Restart the 12d Synergy Server and the 12d Synergy Client applications. Multi-tenant collaboration setup is now complete.