--- title: "Microsoft Entra ID (Active Directory) Integration" slug: "microsoft-entra-id-active-directory-integration" description: "Integrate Microsoft Entra ID for seamless user authentication with SAML SSO. Configure your app and manage user approvals effortlessly." updated: 2026-07-21T15:14:49Z published: 2026-07-21T15:14:49Z canonical: "www.civicplus.help/microsoft-entra-id-active-directory-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Entra ID (Active Directory) Integration The Microsoft Entra ID (formerly Active Directory) integration will allow you to authenticate the users of your [Progressive Web App](/process-automation/docs/microsoft-entra-id-active-directory-integration#progressive-web-app-instructions) or [Approvals solution](/process-automation/docs/microsoft-entra-id-active-directory-integration#approvals-instructions) against your own existing Entra ID user pool. CivicPlus's Entra ID integration uses SAML 2.0. > [!NOTE] > Important Note > > - This integration is separate from the [Custom IdP (Identity Provider) integration with Entra ID and CivicPlus](/civicplus-help-center/docs/microsoft-entra-id-azure-active-directory-integration). ## Configure Entra ID App 1. To use the integration, you must have an Entra ID App configured. In the example below, we are using the Enterprise application and choosing the **Integrate any other application you don't find in the gallery (Non-gallery)** option. ![User interface for creating a new application in Azure AD Gallery.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Configure%20Entra%20ID%20App%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=NVpHVctYzsIDvBtPDw%2FvAPg0B0lc5vXuNSk86VsVGfk%3D) --- ## App Instructions 1. [Sign in to your site](/process-automation/docs/sign-in-to-your-site) 2. Navigate to **Apps** and click **Manage** on your app ![Manage button on the application card.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Manage App - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=GNNgTviQ58zXUHcKuM6lJ4Dw9TXKKPp%2FLwXVYfZfbHg%3D) 3. Navigate to the **Developer Tools** tab ![Navigation menu highlighting the Developer Tools section among other options.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Developer Tools Apps - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=bogJWV6fbHMw5uMYLRFPLRcM3rR0avimlj4hpgp42eA%3D) 4. Click the **Configure SAML** button under **Integrate with a SAML** **SSO Provider** ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Configure SAML - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=2roeDG2y7nf4dmvyyzz7QiK19%2BzcY%2FwLzXARg7DxRtY%3D) 5. Follow the **SAML Configuration and Instructions** ![Instructions for configuring SAML with Microsoft Entra ID and Auth0 for Single Sign-On.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/SAML%20Entra%20ID%20Configuration%20Instructions%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=B2q1RaquNJ25jIe78cOJ2DgQmvLQ5p8rEIgSn%2BpLm%2FA%3D) - **Entra ID** **Setup** 1. Create a **Single Sign-On** application in your Entra ID 2. Copy the **Identifier (Entity ID)** into your application configuration 3. Copy the **Reply URL (Assertion Consumer Service URL)** into your application configuration 4. Copy the **App Federation Metadata URL** from your Single Sign-On application ![SAML configuration settings including Identifier and Reply URL for single sign-on setup.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/App%20Federation%20Metadata%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=ifCiAEtE4nwfII8BvGSTaW9HVkBtL2K4kizOabdR1wY%3D) - **App Federation Metadata Url:** Enter the URL you copied from your application - **Mapping Additional User Details:** The listed claims can be added to your Single Sign-On application which will be included in the submission data 6. Click **Save** ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save SAML Configuration - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=FFlL%2F3Dx5pNSwb1K9E1yynSTQHV11CNGnMXa3ManVSs%3D) > [!WARNING] > Note: > > After clicking the Save button, users will be redirected straight to your Entra ID login screen when clicking the Login button in this app. 7. If needed, **Edit Group Claims** ![Instructions for integrating a SAML SSO provider with options to configure and edit claims.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Edit%20Group%20Claims%20for%20SAML%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=ilejNU%2Fl12oXtDkT12JDUqbIUOo9Eetc%2FI9wV3IaiU0%3D) > [!WARNING] > Note: > > Users should be granted access when they belong to any configured group, while apps with no group claims should continue to allow any authorized SAML user. Each group name **must match a value in the groups claim returned by your SAML identity provider**. Users can access this application if they have any configured matching group claim. --- ## Approvals Instructions 1. [Sign in to your site](/process-automation/docs/sign-in-to-your-site) 2. Navigate to the **Approvals** tab ![The Approvals option in the navigation menu.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals%20Menu%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=ID69AeXRlSvcLgQ8O2cPUNfFsLsv2oDUv%2BMVah6VCmA%3D) 3. Select the **Approvers** tab ![The image shows a navigation menu with the 'Approvers' tab highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvers%20Tab%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=OgiO%2BgkZP7mE67npu3Tbk1SHS6%2BbZYUhzxgnn4emfX4%3D) 4. **Enable** the **Integrate with a SAML** **SSO** **Provider** toggle ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals Enable SAML - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=MbiZGng73R7d1oX4XzVRI7svqq2xQnnpP3jbUk44Zbw%3D) 5. Click **Edit Groups** to configure the groups assigned to your SAML users ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals Edit Groups - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=veXuMWcDXUbrLoKHm6sKn98udNFvWPnz6vugY6RajSM%3D) > [!WARNING] > **Note**: > > Your existing groups will not carry over as SAML groups. These will need to be reconfigured if you have existing flows using the same group name. 6. Click **Add Group**![The Add Group button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals%20Add%20Group%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=a1mxaBrKvzMRsu7TUcYzd%2B5xzhmU2K2Y44M%2BdVkhSUI%3D) 7. Add a **Group name** and enter the **Notification** **email addresses** for the group ![Form for creating groups with fields for group name and notification email addresses.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals%20Add%20Group%20Fields%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=5ML6JhOg2n9c5ajUjtncSQ%2BCzloVNOuSdj1Ok1Jhsbc%3D) > [!WARNING] > **Note**: > > To ensure your users have access to the correct approvals, you will need to map the configured group name to your SAML user claims. 8. Click **Save**![The Save button on the add groups screen.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals%20Save%20Group%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=ptmQCtb8HpxnmOwBTG3hIMdbF9rZgDZGb5P4VNDmZIE%3D) 9. Follow the **SAML Configuration and Instructions** for your **Entra ID/Active Directory** integration ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/SAML Configuration Instructions - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=4bwvcIpBLkXwKg218ClKXndfmLlOvofa6h5J4H5%2BuwU%3D) - **Entra ID** **Setup** 1. Create a **Single Sign-On** application in your Entra ID 2. Copy the **Identifier (Entity ID)** into your application configuration 3. Copy the **Reply URL (Assertion Consumer Service URL)** into your application configuration 4. Copy the **App Federation Metadata URL** from your Single Sign-On application ![SAML configuration settings including Identifier and Reply URL for single sign-on setup.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/App%20Federation%20Metadata%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=ifCiAEtE4nwfII8BvGSTaW9HVkBtL2K4kizOabdR1wY%3D) 5. **App Federation Metadata Url:** Enter the URL you copied from your application 6. **Mapping Additional User Details:** The listed claims can be added to your Single Sign-On application, which will be included in the submission data > [!WARNING] > **Note**: > > To ensure your users have access to the correct approvals, you will need to map the configured **group name** to your SAML user claims. 10. Click **Save![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save SAML Configuration - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A36Z&se=2026-11-22T13%3A51%3A36Z&sr=b&sp=r&sig=FFlL%2F3Dx5pNSwb1K9E1yynSTQHV11CNGnMXa3ManVSs%3D)** Identification or Identifier. Security Assertion Markup Language. Single Sign-On. An identification method that enables users to log in to multiple applications and websites with one set of credentials. SSO streamlines the authentication process for users. Uniform Resource Locator ## Related - [Configure Approvals Solution](/configure-approvals-solution.md) - [Create and Manage Apps](/create-and-manage-apps.md)