--- title: "SSO Integration: How to connect Microsoft Azure SSO" description: How to setup SSO with Microsoft Azure --- [Skip to content](https://helpcenter.pequity.com/help/sso-setup-microsoft-azure#main-content) English Show submenu for translations [More support](https://helpcenter.pequity.com/help/kb-tickets/new?hsLang=en) ![Logo (1)](https://helpcenter.pequity.com/hs-fs/hubfs/Logo%20(1).png?width=202&height=50&name=Logo%20(1).png) - [Pequity](https://pequity.com/) - [Platform](https://pequity.com/solutions) - [Blog](https://blog.pequity.com) - [Login](https://pequity.app/login) - [Get a demo](https://pequity.com/contact) Open main navigation Close main navigation - [Pequity](https://pequity.com/) - [Platform](https://pequity.com/solutions) - [Blog](https://blog.pequity.com) - [Login](https://pequity.app/login) - [Get a demo](https://pequity.com/contact) - English Show submenu for translations - [More support](https://helpcenter.pequity.com/help/kb-tickets/new) - Contact us [Contact us](https://helpcenter.pequity.com/help/?hsLang=en) How can we help you? - There are no suggestions because the search field is empty. 1. [Help and Guide Center](https://helpcenter.pequity.com/help?hsLang=en) 2. [Getting Started with Pequity](https://helpcenter.pequity.com/help/getting-started-with-pequity?hsLang=en) 3. [Integrations & Data Management](https://helpcenter.pequity.com/help/getting-started-with-pequity?hsLang=en#integrations-data-management) - [Getting Started with Pequity](https://helpcenter.pequity.com/help/getting-started-with-pequity?hsLang=en#main-content) - [Pequity Setup & Company Admin Onboarding](https://helpcenter.pequity.com/help/getting-started-with-pequity?hsLang=en#pequity-setup-company-admin-onboarding) - [Personal Settings](https://helpcenter.pequity.com/help/getting-started-with-pequity?hsLang=en#personal-settings) - [Integrations & Data Management](https://helpcenter.pequity.com/help/getting-started-with-pequity?hsLang=en#integrations-data-management) - [Managing Your Team in Pequity](https://helpcenter.pequity.com/help/managing-your-team-in-pequity?hsLang=en#main-content) - [General User Access](https://helpcenter.pequity.com/help/managing-your-team-in-pequity?hsLang=en#general-user-access) - [Single Sign-On (SSO) Integration](https://helpcenter.pequity.com/help/managing-your-team-in-pequity?hsLang=en#single-sign-on-sso-integration) - [People Manager Access](https://helpcenter.pequity.com/help/managing-your-team-in-pequity?hsLang=en#people-manager-access) - [Pequity Features & Workflows](https://helpcenter.pequity.com/help/pequity-features-workflows?hsLang=en#main-content) - [Pequity Comp Cycles](https://helpcenter.pequity.com/help/pequity-features-workflows?hsLang=en#pequity-comp-cycles) - [Pequity Ranges Tool](https://helpcenter.pequity.com/help/pequity-features-workflows?hsLang=en#pequity-ranges-tool) - [Pequity People Tool](https://helpcenter.pequity.com/help/pequity-features-workflows?hsLang=en#pequity-people-tool) - [Pequity Approvals Tool](https://helpcenter.pequity.com/help/pequity-features-workflows?hsLang=en#pequity-approvals-tool) - [Pequity Best Practices](https://helpcenter.pequity.com/help/pequity-best-practices?hsLang=en) - [Proactive Support & Troubleshooting](https://helpcenter.pequity.com/help/proactive-support-troubleshooting?hsLang=en) - [Pequity Updates & Insights](https://helpcenter.pequity.com/help/pequity-updates-insights?hsLang=en) - [Pequity University](https://helpcenter.pequity.com/help/pequity-university?hsLang=en#main-content) - [Comp 101](https://helpcenter.pequity.com/help/pequity-university?hsLang=en#comp-101) - [Reward Letters](https://helpcenter.pequity.com/help/reward-letters?hsLang=en) # SSO Integration: How to connect Microsoft Azure SSO ## Setting up Microsoft Azure SSO for Pequity | **ⓘ**  You’ll need to have at minimum “Cloud Application Administrator” privileges in Microsoft Azure AD to setup the Pequity app & make the appropriate application configurations needed. | | --- | | **ⓘ**  You must be a Pequity administrator to make site-wide configurations in Pequity.  | | --- | #### **Steps Overview:** - Create a Pequity User Group in Microsoft Azure AD - STEP 1: Configure Microsoft Azure AD SSO - STEP 2: ASSIGN USERS & GROUPS - Step 2.1 Select the pencil icon next to the Basic SAML Configuration section - Step 2.2 Select the pencil icon to edit User Attributes & Claims - Step 2.3 Download the SAML Signing Certificate > Federation Metdata XML - Step 2.4 Copy the Azure AD Identifier, & Logout URL under Set up Pequity section 4 - STEP 3: PROPERTIES - USER ACCESS URL - Full List to Provision to Pequity   #### **Create a Pequity User Group in Microsoft Azure AD** 1. From your Default Directory page, Select “**Group**”, then “**New Group**” 2. Toggle the Group Type to “**Security**”, then name the group “**Pequity Users**” and ensure the Membership type is set to “Assigned” 3. Select Create Group 4. Add all appropriate users who should have access to the Pequity app | **📣** Please note: this group assignment will only control if an employee can login to Pequity. Once logged into Pequity, the specific Pequity user permissions (like which compensation Ranges that employee can view) will be dictated in the Pequity user settings. | | --- | #### **Configure Microsoft Azure AD SSO** Once you have logged into your Microsoft Azure AD Admin portal, navigate to “**Enterprise Applications**”, then “**All Applications**.” Click **New Application** to get started. On the next screen, select **NON GALLERY APPLICATION.** Name the application “Pequity”. ![Screenshot 2024-12-30 at 1.24.04 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.24.04%20AM.png?width=593&height=364&name=Screenshot%202024-12-30%20at%201.24.04%20AM.png) #### **STEP 1: ASSIGN USERS & GROUPS** **![Screenshot 2024-12-30 at 1.24.45 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.24.45%20AM.png?width=670&height=255&name=Screenshot%202024-12-30%20at%201.24.45%20AM.png)Click on “Assign Users & Groups”.** Select “add user” and find the Pequity Group. Then click “**Assign**”. Once done, head back to the overview page for Step 2. ![Screenshot 2024-12-30 at 1.25.16 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.25.16%20AM.png?width=495&height=140&name=Screenshot%202024-12-30%20at%201.25.16%20AM.png) **STEP 2: SET UP SINGLE SIGN ON** From the overview page, select “Set up single sign on” to enable users to sign into Pequity with their Azure AD Credentials.   ![Screenshot 2024-12-30 at 1.25.44 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.25.44%20AM.png?width=668&height=252&name=Screenshot%202024-12-30%20at%201.25.44%20AM.png)   Select the SAML module to begin configuration. **![Screenshot 2024-12-30 at 1.26.17 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.26.17%20AM.png?width=670&height=266&name=Screenshot%202024-12-30%20at%201.26.17%20AM.png)** #### **Step 2.1 Select the pencil icon next to the Basic SAML Configuration section**   To begin the set up for single sign-on with SAML, click on the pencil icon in the **Basic SAML Configuration** box.  **![Screenshot 2024-12-30 at 1.26.40 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.26.40%20AM.png?width=670&height=233&name=Screenshot%202024-12-30%20at%201.26.40%20AM.png)** Please enter the following information: - **Identifier (Entity ID):** [https://COMPANYNAME.pequity.app/api/saml2/metadata](https://companyname.pequity.app/api/saml2/metadata) - **Reply URL (Assertion Consumer Service URL):** [https://COMPANYNAME.pequity.app/api/saml2/acs/](https://companyname.pequity.app/api/saml2/acs/) | **📣** Please note that this Entity ID URL should **NOT** have a trailing slash. This is intentional. If a trailing slash is added to this link, the setup will not work. | | --- | Click **SAVE** in the top left corner of the screen, then close the basic SAML configuration screen. You can select “**No, I’ll Test Later**” since Pequity will still need to configure on our end before testing is possible. #### **Step 2.2 Select the pencil icon to edit User Attributes & Claims** ![Screenshot 2024-12-30 at 1.27.25 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.27.25%20AM.png?width=670&height=168&name=Screenshot%202024-12-30%20at%201.27.25%20AM.png)   Modify the existing attribute names as follows. The first value listed is the "Microsoft Azure AD attribute" and the second is the Pequity App attributes: - Basic Information > **emailaddress** to **Email** - Basic Information > **givenname** to **first\_name ** - Basic Information > **surname** to **last\_name** #### **Step 2.3 Download the SAML Signing Certificate > Federation Metadata XML** Click the download button next to **Federation Metadata XML** and save to send to the Pequity team. #### **Step 2.4 Copy the Azure AD Identifier, & Logout URL under Set up Pequity** Copy the following links to provide to the Pequity team: - Azure AD Identifier - Logout URL #### **STEP 3: PROPERTIES - USER ACCESS URL** Navigate to the “Properties” section of the Pequity application on the left hand side of your screen. Then copy the **User Access URL** to send to Pequity. ![Screenshot 2024-12-30 at 1.27.52 AM](https://helpcenter.pequity.com/hs-fs/hubfs/Screenshot%202024-12-30%20at%201.27.52%20AM.png?width=467&height=283&name=Screenshot%202024-12-30%20at%201.27.52%20AM.png) #### **Full List to Provision to Pequity**   Once you’ve completed all of the above steps, you will want to reach back out to your Pequity project manager and provide them with the following: - Downloaded Federation Metadata XML file from Step 2.3 - Following URLs: - User Access URL (ie. Login URL) from step 3 - Azure AD Identifier from Step 2.4 - Logout URL from Step 2.4   **Congratulations! You’ve setup Microsoft Azure SSO for Pequity 🎉** [![](https://helpcenter.pequity.com/hubfs/Logo%20(2).svg)](https://blog.pequity.com?hsLang=en) 123 Waverly Pl., Boston, MA 02135 Copyright © 2024, Pequity