Documentation Center

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Support Portal
  • Home
  • Administration
  • Security & Compliance

Configure SSO with Microsoft Entra ID (Azure AD)

Contact Us

If you have questions or want help, please Submit a Request.

Updated at Jul 27, 2024
By Kali Patrick

Related Docs

  • Use Single Sign-On with Syncro
  • Hardware Security Keys

To configure Single Sign-On (SSO) with Microsoft Entra ID (Azure AD), follow these steps:

  1. Launch your Azure Instance, then click the Microsoft Entra ID pyramid logo:
  2. In Entra's left navigation, select “App Registrations" from the Manage section, then click + New Registration:

  1. On the Register an Application page:
    1. Enter a name for the App so you can identify it later (e.g., “Syncro,” “SyncroMSP,” or whatever you’d prefer).
    2. In the Redirect URI area, select “Web” from the Platform dropdown menu. 
    3. Copy the Redirect URI from Entra and paste it into the "Redirect (callback) URL" field in Syncro: 

      Note: Navigate to Admin > Syncro Administration - Login Settings and you'll find it in the “Single Sign On with OpenID Connect” section field:
  2. Back in Entra, click Save. Entra navigates you to the App’s details page, which displays several strings. 
  3. Copy the “Application (Client) ID” string from Entra and paste it into the “Client ID” field in Syncro:

     
    Note: The screen above highlights additional fields you'll need to provide Entra strings for in later steps.
  4. In Entra's left navigation, select “Certificates & Secrets" from the Manage section, then click + New Client Secret: 


Entra displays the “Add A Client Secret” side panel:

  1. In the Description field, enter a name for the Secret that you'll use to manage it later. 
  2. Use the Expires dropdown to choose a expiration for the secret key. Entra generates a set of Secret keys. 
  3. Copy the “Value” string from Entra and paste it into Syncro's “Client Secret” field (shown on the screen in step 5):

Note: If you copy the “Secret ID” field here instead, you'll get an authorization error.

  1. In Entra's left navigation, select “Overview”, then “Endpoints:”

Entra displays the “Endpoints” side panel and a group of fields. 

  1. Copy the contents of the “OpenID Connect Metadata Document” field into Syncro's “OpenID Connect Discovery (Discovery Document)” field (shown on the screen in step 5):

Tip: Don’t worry about cleaning up the URL; Syncro parses the URL string for you.

  1. In Syncro, click Save & Verify SSO. 

Tips:

  • If you receive the error message: OpenID Connect Discovery: is invalid, this means that the URL for the OpenID Connect Discovery field is not correct.
  • If you receive the error message: SSO configuration contains errors. Please check and verify again., this refers to the Client Secret not being correct. This can happen when a copy/paste includes junk data from the clipboard. Syncro recommends going back to the idP and trying to copy/paste again.
  1. Once the connection has been validated you can click Enable SSO to toggle it on. Remember to click Save.

Was this article helpful?

Yes
No
Give feedback about this article

The integrated platform for running a profitable MSP business

Syncro All-in-one MSP Software Facebook Syncro All-in-one MSP Software Twitter Syncro All-in-one MSP Software LinkedIn Syncro All-in-one MSP Software YouTube Syncro All-in-one MSP Software Reddit
  • Compliance
  • Privacy Policy
  • Website Terms
  • Service Terms
Knowledge Base Software powered by Helpjuice

© 2017-2024 Servably, Inc. All rights reserved.

Expand