--- title: "Configuring SAML SSO with Microsoft Entra ID" slug: "saml-sso-with-microsoft-entra-id-for-the-skp" updated: 2025-02-13T07:26:28Z published: 2025-02-13T07:26:28Z canonical: "skthelp.syniti.com/saml-sso-with-microsoft-entra-id-for-the-skp" --- > ## Documentation Index > Fetch the complete documentation index at: https://skthelp.syniti.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring SAML SSO with Microsoft Entra ID ## Overview This article describes the single sign-on (SSO) integration process between the Syniti Knowledge Platform (SKP) and Microsoft Entra ID (formerly Azure Active Directory). When you integrate the SKP with Microsoft Entra ID, you can manage and control your organization’s user account and their access to the SKP in Microsoft Entra ID. ## Prerequisites - You must be an SKP Administrator for a tenant that uses the SKP-initiated sign-on page to configure the SAML settings in the SKP. > [!NOTE] > Note > > - This SKP Administrator account must be the initial administrator account that uses a trusted domain sent to you during the provisioning process by Syniti’s Customer Success team. > - If you require additional domains to get added and activated in your tenant for using the SKP-initiated sign-on page, you must [submit a request](https://support.syniti.com/hc/en-us/requests/new?ticket_form_id=360000774934&tf_20735434106263=type_request&tf_20735495864983=devops_sso&tf_description=) to Syniti Support. - Your organization’s active directory and a Microsoft Entra ID subscription. - A Cloud Application or Application Administrator account in your organization’s active directory. ## Add a New Application for the SKP 1. Sign in to [portal.azure.com](https://portal.azure.com/) as an Application or Cloud Application Administrator. 2. Browse or access **Microsoft Entra ID** and access your organization’s active directory. 3. Click **Manage > Enterprise Applications > New Application**. 4. On the *Browse Microsoft Entra Gallery* page, enter **Entra SAML Toolkit** in the search box and select **Microsoft Entra SAML Toolkit** from the results panel. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(599).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=3lR%2FfJL7CVqyc4on%2BaBvSPQEvxdWOt1dS1dSP08XICU%3D) 5. Enter a unique name for the new SKP application and click **Create**. Wait a few seconds while the new application is added to your tenant in the active directory. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(443).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=f%2F1VXIBAA8F%2BE%2Bkcr2f9wXMQTUaOywo5Shlg7Y7NLU4%3D) ## Configure Microsoft Entra ID with the SKP 1. In Microsoft Entra ID, access your SKP application and select **Single sign-on** either on the left-side panel or in the *Getting Started* section. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(444).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=fb%2BwP6%2FNYCuYTPCkemglqG567e%2F1i3GYO1m%2FL5pSJkE%3D) 2. Select **SAML** as your single sign-on method. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(445).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=3NuZ0AUk1p%2Fu0qlXdioYSDBtRFnQgLaz8YHaoSR5J1U%3D) 3. On the *Set up Single Sign-On with SAML* page, click **Edit** in the *Basic SAML Configuration* section. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(446).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=QJa%2FkfjbBsniO6EFugQxeaQhapFhvmW1euqtw4%2FtfBg%3D) 4. Enter the Entity ID, Assertion Consumer Service URL, and Sign on URL details in their corresponding fields as per your tenant region as displayed in the below screenshot. > [!NOTE] > Note > > The Sign on URL field is not required as you’ll be performing your organization’s Microsoft Entra ID initiated single sign-on. Enter a dummy URL in this field. | SKP Tenant Region | Entity ID | Assertion Consumer Service URL | | --- | --- | --- | | Americas | `syniti.com` | `https://api.syniti.com/oauth/signin/callback` | | Australia | `syniti.au` | `https://api.syniti.au/oauth/signin/callback` | | EMEA | `syniti.eu` | `https://api.syniti.eu/oauth/signin/callback` | | Canada | `syniti.ca` | `https://api.syniti.ca/oauth/signin/callback` | ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(447).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=OykKo%2FeDZDB3HCQsCxedO7YZxQNdXYUeSWxosxXr5bY%3D) 5. Click **Save** and access the **SAML Certificates** section. 6. Copy your Microsoft Entra ID’s metadata URL as displayed in the below screenshot. This metadata URL is required to configure SSO in the SKP. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(448).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=LOpqNXUrTzUad7Mw1JIF%2BIVOgMtsiF8Ptpv5TxQN4ow%3D) 7. [Log into](https://login.syniti.com/home) the SKP using the Syniti provisioned administrator account to access and log in using the SKP-initiated sign-on page. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(499).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=TPxDqPkCIjQGcu%2BsgiRv6K8yH%2BDgryeKq87W%2F2QC8%2F0%3D) SKP-initiated sign-on page 8. Click **Admin > Single Sign-On > Configure SSO**. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(590).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=P4CJamx9vA%2FGV1jaI%2F5zvHEPLNgdzX6qpM%2FmPZrOstk%3D) 9. Select **SAML** to configure the SAML 2.0 SSO protocol in the SKP. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(591).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=jKaWeHdXDljQ0BMcgWBD2CiAn%2FMkrpnXT2DrRBg4uxo%3D) 10. In the *SSO Configuration Name* field, enter a unique name for your organization. 11. In the *Metadata URL* field, enter the copied metadata URL from your organization’s Microsoft Entra ID. 12. In the *User Metadata Attributes* section, enter the URLs for the Name, Email, and Identifier attributes (an example of these URLs is given in the below table). These attributes can be extracted from the metadata URL that you have copied. | Field Name in the SKP | SAML Attribute URL in the Metadata | Description | | --- | --- | --- | | Name | `http://schemas.microsoft.com/identity/claims/displayname` | Display name of the user. | | Email | `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` | Email address of the user. | | Identifier | `http://schemas.microsoft.com/identity/claims/objectidentifier` | Primary identifier for the user in the directory. Immutable and globally unique. | 13. Select **Save** to save your configuration in the SKP. Saving the SSO details does not activate the SSO configuration. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(597).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=lSQADPpOWjYPeuwQU1NN6diIDPOLC0pmySq5%2BzRFiZ4%3D) 14. Turn on the **Active** toggle button to activate the SSO configuration for your tenant. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(598).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=N8lc5JsssRZ5Cmmd1Cb%2BOAHWYV4QKbYfQSFAAKUiz1o%3D) Your SSO configuration is now complete, and the SKP is integrated with your organization’s Microsoft Entra ID. ## Verify Your SSO Configuration ### Create a Test User You'll create a temporary test user called Test User. 1. Access your organization’s Microsoft Entra ID admin center with a user administration role. 2. Click **Manage > Users**. 3. Select **New User > Create new user**, and follow these steps: 4. In the *Display Name* field, enter **Test User**. 5. In the *User Principal Name* field, enter the username@companydomain.extension. For example, TestUser@example.com. 6. Select the **Show Password** check box, and then note down the value that's displayed in the Password box. 7. Select **Review + create**. 8. Select **Create**. ### Assign the Test User You’ll assign the Test User to the newly created SKP application in Microsoft Entra ID. 1. Access your organization’s Microsoft Entra ID admin center as an Application or Cloud Application Administrator. 2. Click **Manage > Enterprise Applications** and select the newly created SKP application. 3. On the application's overview page, select **Users and Groups > Add User/Group**. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(454).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=xj9vowQP3O%2Bw6Zr201QtEv7YMMt9xNip4MWfCTOKqQI%3D) 4. In the Add Assignment dialog box, follow these steps: 1. Select **Users**. 2. In the *Users* dialog box, select **Test User** from the Users list, and then click **Select**. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(455).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=4yTdkbGFYrM58TCtwyrKcmVCV4TDYPsmwTy60Q9UVUk%3D) 3. If you are expecting a role to be assigned to the users, you can select it from the *Select a Role* list. If no role has been set up for this application, you’ll see the Default Access role. 4. In the Add Assignment dialog box, click the **Assign** button. ### Test the SSO Configuration You don’t need to create a user account for the Test User in the SKP, as your organization’s Microsoft Entra ID controls and manages the access required for your users in the SKP. The SKP validates the email address used for signing in to its database and lets you sign in to the SKP. If the entered email address is a new one, then a new user with the default viewer role is created in the SKP. 1. Open an incognito or private window in your browser. 2. [Log into](https://login.syniti.com/home) the SKP using the email address of the Test User and click **Next**. 3. The Login page redirects you to your Microsoft Entra ID initiated login page. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(456).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=KkVvMS4UXnN8bzDvlpJsn%2FisRa4yfICQ%2F48mmXLWihs%3D) 4. Enter the credentials of the Test User and sign in. ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(457).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A38%3A18Z&se=2026-11-17T20%3A38%3A18Z&sr=b&sp=r&sig=5nQz3rC7%2FJA0xiI9DPd3ryTOe1vEhEwn6MHOl5gpkCg%3D) The Test User with the Default Viewer role is successfully logged into the SKP using the credentials from your organization’s Microsoft Entra ID. Refer to the [Troubleshoot Your SAML SSO Configuration](/v1/docs/troubleshoot-your-saml-sso-configuration) section for more information on troubleshooting issues while performing the SAML SSO configuration. ## Next Steps: Invite Existing Users or Add New Users Now that you have configured and verified your SAML SSO configuration, you can proceed with inviting or adding the required users with appropriate roles in your organization’s Microsoft Entra ID. Refer to the [Assign the Test User](/v1/docs/saml-sso-with-microsoft-entra-id-for-the-skp#assign-the-test-user) section for more information on inviting or adding the required users to the newly created application for the SKP.