--- title: Configuring SSO with Azure EntraID with SAML description: This article guides Admin users step-by-step on how to configure SSO using Azure EntraID with SAML --- [Skip to content](https://support.edapp.com/configuring-sso-with-azure-active-directory-ad#main-content) English Show submenu for translations ![EdApp - logo dark mode-1.png\]](https://support.edapp.com/hs-fs/hubfs/EdApp%20-%20logo%20dark%20mode-1.png?height=40&name=EdApp%20-%20logo%20dark%20mode-1.png) - [Default HubSpot Blog](https://edapp-5741180.hs-sites.com/blog) Open main navigation Close main navigation - [Default HubSpot Blog](https://edapp-5741180.hs-sites.com/blog) - English Show submenu for translations - [edapp.com](https://www.edapp.com/) [edapp.com](https://www.edapp.com/) Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Help Center](https://support.edapp.com/?hsLang=en) 2. [Technical / API documentation](https://support.edapp.com/technical-api-documentation?hsLang=en) 3. [Single Sign On for the Learner's Portal](https://support.edapp.com/technical-api-documentation?hsLang=en#single-sign-on-for-the-learners-portal) # Configuring SSO with Azure EntraID with SAML ## This article guides Admin users step-by-step on how to configure SSO using Azure EntraID with SAML ### Why set up single sign-on? Single sign-on (SSO) allows EdApp to identify users through an external Identity Provider (IDP). Instead of manually registering learners, users are directed to their company identity portal, fill in their company login details, and are redirected back to EdApp. This enables a user to log in to multiple systems via a single portal. On EdApp's side, a user is internally created to match the user's details sent back from the IDP. If you’d like domain recognition enabled for SSO, please reach out to us via live chat or your EdApp program manager - we would be happy to help.   Ensure the person setting up SSO has **admin privileges** to both EdApp and the SSO provider. #### Contents [Configure SSO in Azure](https://support.edapp.com/configuring-sso-with-azure-active-directory-ad#Azure) [Configure SSO in EdApp](https://support.edapp.com/configuring-sso-with-azure-active-directory-ad#edapp) ### **Configure SSO in Azure AD** First, let’s start with setting up SSO in Azure AD (we’ll move on to setting this up in EdApp once this part is completed).   **Step 1:**  Sign in to the Azure portal using your Azure Active Directory administrator account. Browse to the **Active Directory \> Enterprise Applications \> New application \> Non-gallery application** section.   **Step 2:** Fill in "EdApp" as the application name, select **Add**. ![](https://lh3.googleusercontent.com/zfIx9wbRS11ZO9ZYpLotITA4vuBvpaE5h5ZVyK9MrLo7VALqRb_O1ONiZMSUscs79C0Ugs4vasKch82qZxFR2Z8q15DwnBA3zRJBYLgpO58AtE8WO39i6BIETnVKU4JDkyNal-Ln) Azure portal will redirect to the app overview page. Select **Single sign-On \> SAML** **![](https://lh3.googleusercontent.com/1OsbBuA7j6IySTk9NkP5HC9RMsDfhpEumCbdwCawqN7BGikgvWZcCI7s8RbFH2t8DOA5YHltKCqx_LGYkqxeCokpyyeY6TL_CWgOY_AZxa7mVo0yeOXArUIsr8KA4WyjFlhKHuXR)**   **Step 3:** Update Basic SAML Configuration - Fill in Identifier (Entity ID) with **https://web.edapp.com/{companyID}. ** You can replace company ID above with your organization's company ID e.g. **https://web.edapp.com/acmeventures** - Fill in Reply URL with **https://api.edapp.com/sso-saml-callback/\** - Fill in Logout URL with **https://api.edapp.com/sso-logout/\** - The following example has **\** as **uniqueEdCustomerCompanyId** you can make this up but ensure that it is identifiable and easy for your learners to type in e.g. companyname **![](https://lh5.googleusercontent.com/M-k_45-RsEWflqJqwdd99jLZkvhnudGXWVJO-T-qDozrOr7zYuRNd6QGGKg1T7vsfD30iAE2MurCBDoJlj8mWKJwYuJ8p7tWr0FFHWvnCDzatHhqP7yGHLBF2RE0Av0QGMJq7wXa)**   **Step 4:** Download Certificate (Base64) from **SAML Signing Certificate** section. ![](https://lh4.googleusercontent.com/DSz4wkprC4KGcqW2x_TzZ7_PlVZ8VkaAHoK9aDHGyhwbi2KdKFx9ub80GHGntPJ1SJyBgDsv-s8qkU7hOnOc6OcRZ0lIJwHY30Y5HQOrkmfkkfdtWlEIVoYyH_fnWDNobBES15Ot) You can send additional information about your learners via [custom fields](https://support.edapp.com/custom-fields?hsLang=en) including *job title, first name, last name, active status* or any custom fields you'd like. You can send these values as custom claims. The name of the claim needs to be exactly the same as the field name in EdApp. Also, the namespace of the claim needs to be blank. ![](https://support.edapp.com/hs-fs/hubfs/image-png-Aug-19-2021-07-08-39-98-AM.png?width=688&height=343&name=image-png-Aug-19-2021-07-08-39-98-AM.png) This custom field data can then be used to automate user management through dynamic user groups. You can create criteria based rules on dynamic user groups to automatically assign learners to courses based on their information. [Read more on dynamic user groups here](https://support.edapp.com/dynamic-user-groups?hsLang=en).   ### Example The firstname and lastname fields are supported out of the box in EdApp and can be passed as shown in the example below. In this example, the additional field "jobtitle" is passed as a claim as well and if configured in EdApp as a custom field it will be populated as soon as the user logs in using SSO. ![](https://support.edapp.com/hubfs/image-png-May-22-2023-11-24-11-2393-PM.png) Consider yourself halfway done! Now that we’ve managed to set up SSO in Azure AD, we’re ready to configure SSO in EdApp.   ### **Configure SSO in EdApp**   **Step 1:** Sign in to [Ed LMS](https://admin.edapp.com/courseware) using your Ed Admin account, and click on the dropdown arrow located on the upper right of your screen. Select **Single Sign-On**. ![Configuring SSO with Azure Active Directory](https://support.edapp.com/hs-fs/hubfs/Configuring%20SSO%20with%20Azure%20Active%20Directory.png?width=624&height=285&name=Configuring%20SSO%20with%20Azure%20Active%20Directory.png) **Step 2:** Click on the **Connect with SAML** ![](https://support.edapp.com/hs-fs/hubfs/2-png-4.png?width=688&height=183&name=2-png-4.png)   **Step 3:** You’ll then arrive to your **Single Sign-On** page, where you can tick the box next to **Enable Single Sign-On** in order to expand the page to see the SSO fields below:   ![Configuring SSO with Azure Active Directory 1](https://support.edapp.com/hs-fs/hubfs/Configuring%20SSO%20with%20Azure%20Active%20Directory%201.png?width=624&height=287&name=Configuring%20SSO%20with%20Azure%20Active%20Directory%201.png)   **Step 4:** Fill in Company ID The **company ID** (on the admin portal) **or business ID** (on the learner's app) can be anything you want. Company ID and business ID are interchangeable terms on EdApp. You must ensure this matches what you've used in your specific IDP, i.e. if you use "**acmeventures**" in the company ID in EdApp, make sure it's also "**acmeventures**" in your SSO provider. It can be used by your learners at the login page, so it is important to choose a company ID that is easy to remember for your learners. ![](https://support.edapp.com/hs-fs/hubfs/Screenshot%202023-11-23%20at%203-09-39%20pm-png.png?width=400&height=280&name=Screenshot%202023-11-23%20at%203-09-39%20pm-png.png) The company ID is also used to identify your account in EdApp when your IDP calls our API to authenticate the user. The ACS (Reply) URL field in your IDP specifies the endpoint in EdApp. The format in your IDP is **https://api.edapp.com/sso-saml-callback/{COMPANY-ID}** If your company ID in EdApp is "**acmeventures**", your ACS (Reply) URL in your IDP would be **https://api.edapp.com/sso-saml-callback/acmeventures**     **Step 5**: Fill in **SSO URL** with the **Login URL** from **Set up EdApp** section. ![](https://lh3.googleusercontent.com/rILVLRECmoCySX7Sp174Yj2xF317nwKHV-TCJ5TyLNNv6iQNjDUSzT4gqc6HVp6tACuzuWVq5y5Kw1VDzW5HWXXqKoEAUD_vd-vdP-5omxzxDdWik9Y3xEtoFeR8gzm3Nxz7PqW3)   **Step 6:** Fill SAML Entity ID with **https://web.edapp.com/{companyID}. ** You can replace company ID above with your organization's company ID e.g. **https://web.edapp.com/acmeventures**   ![Configuring SSO with Azure Active Directory 2](https://support.edapp.com/hs-fs/hubfs/Configuring%20SSO%20with%20Azure%20Active%20Directory%202.png?width=594&height=272&name=Configuring%20SSO%20with%20Azure%20Active%20Directory%202.png) **Step 7:** upload your SAML certificate by clicking the upload button at the bottom of the page. **![image (54)](https://support.edapp.com/hs-fs/hubfs/image%20(54).png?width=688&height=198&name=image%20(54).png)** **Reminder: Learner SSO works ONLY with `.cer, .crt and .pem` file certificates. If the certificate you downloaded in Step 7 is not a `.cer, .crt and .pem` file you may need to change its file extension.** Congratulations!  You’ve just configured your EdApp account with SSO, using Azure AD.  At this point, we recommend completing a round of successful testing by attempting login via SSO.  If you get stuck at any point along the way, be sure to reach out to our live chat desk, or your EdApp account manager - we’d be happy to lend a helping hand.  Additionally, feel free to share this [Learner Guide for logging into EdApp using SSO](https://support.edapp.com/learners-guide-to-logging-in-through-single-sign-on?hsLang=en) with your users.     - [Getting started](https://support.edapp.com/getting-started?hsLang=en#main-content) - [Get Started in 5 Minutes](https://support.edapp.com/getting-started?hsLang=en#get-started-in-5-minutes) - [Lessons & Courses](https://support.edapp.com/getting-started?hsLang=en#lessons-courses) - [Basic User Management](https://support.edapp.com/getting-started?hsLang=en#basic-user-management) - [Course Library](https://support.edapp.com/getting-started?hsLang=en#course-library) - [Definitions](https://support.edapp.com/getting-started?hsLang=en#definitions) - [Admin portal](https://support.edapp.com/admin-portal?hsLang=en#main-content) - [Advanced User Management](https://support.edapp.com/admin-portal?hsLang=en#advanced-user-management) - [Lesson Management](https://support.edapp.com/admin-portal?hsLang=en#lesson-management) - [Course Management](https://support.edapp.com/admin-portal?hsLang=en#course-management) - [App Customisation](https://support.edapp.com/admin-portal?hsLang=en#app-customisation) - [Peer Learning](https://support.edapp.com/admin-portal?hsLang=en#peer-learning) - [Engagement](https://support.edapp.com/admin-portal?hsLang=en#engagement) - [Analytics](https://support.edapp.com/admin-portal?hsLang=en#analytics) - [Features](https://support.edapp.com/admin-portal?hsLang=en#features) - [EducateAll](https://support.edapp.com/admin-portal?hsLang=en#educateall) - [Sharing Content](https://support.edapp.com/admin-portal?hsLang=en#sharing-content) - [Integrations](https://support.edapp.com/admin-portal?hsLang=en#integrations) - [Learner's app](https://support.edapp.com/learners-app?hsLang=en#main-content) - [Logging In](https://support.edapp.com/learners-app?hsLang=en#logging-in) - [Taking Courses](https://support.edapp.com/learners-app?hsLang=en#taking-courses) - [Features For Learners](https://support.edapp.com/learners-app?hsLang=en#features-for-learners) - [Extras](https://support.edapp.com/learners-app?hsLang=en#extras) - [Star Bar](https://support.edapp.com/learners-app?hsLang=en#star-bar) - [Creator Tool](https://support.edapp.com/creator-tool?hsLang=en#main-content) - [Branding](https://support.edapp.com/creator-tool?hsLang=en#branding) - [Templates](https://support.edapp.com/creator-tool?hsLang=en#templates) - [Course & Lesson Configurations](https://support.edapp.com/creator-tool?hsLang=en#course-lesson-configurations) - [Copying Slides/Lessons/Courses](https://support.edapp.com/creator-tool?hsLang=en#copying-slides-lessons-courses) - [Translations](https://support.edapp.com/creator-tool?hsLang=en#translations) - [Content](https://support.edapp.com/creator-tool?hsLang=en#content) - [Tips and tricks](https://support.edapp.com/tips-and-tricks?hsLang=en#main-content) - [Learning Programme Management](https://support.edapp.com/tips-and-tricks?hsLang=en#learning-programme-management) - [Authoring](https://support.edapp.com/tips-and-tricks?hsLang=en#authoring) - [Best Practices](https://support.edapp.com/tips-and-tricks?hsLang=en#best-practices) - [Programme Success](https://support.edapp.com/tips-and-tricks?hsLang=en#programme-success) - [Engagement](https://support.edapp.com/tips-and-tricks?hsLang=en#engagement) - [Launch Kit](https://support.edapp.com/tips-and-tricks?hsLang=en#launch-kit) - [FAQ](https://support.edapp.com/faq?hsLang=en#main-content) - [Lessons & Courseware](https://support.edapp.com/faq?hsLang=en#lessons-courseware) - [Authoring](https://support.edapp.com/faq?hsLang=en#authoring) - [User Registration & Management](https://support.edapp.com/faq?hsLang=en#user-registration-management) - [Display](https://support.edapp.com/faq?hsLang=en#display) - [Engagement](https://support.edapp.com/faq?hsLang=en#engagement) - [Peer Learning](https://support.edapp.com/faq?hsLang=en#peer-learning) - [Knowledge Performance](https://support.edapp.com/faq?hsLang=en#knowledge-performance) - [Analytics](https://support.edapp.com/faq?hsLang=en#analytics) - [System & Technical Support](https://support.edapp.com/faq?hsLang=en#system-technical-support) - [Subscriptions & Pricing](https://support.edapp.com/faq?hsLang=en#subscriptions-pricing) - [Educate All](https://support.edapp.com/faq?hsLang=en#educate-all) - [Contact & Support](https://support.edapp.com/faq?hsLang=en#contact-support) - [Webinars](https://support.edapp.com/webinars?hsLang=en) - [Technical / API documentation](https://support.edapp.com/technical-api-documentation?hsLang=en#main-content) - [Single Sign On for the Learner's Portal](https://support.edapp.com/technical-api-documentation?hsLang=en#single-sign-on-for-the-learners-portal) - [Single Sign-on for Admin Portal](https://support.edapp.com/technical-api-documentation?hsLang=en#single-sign-on-for-admin-portal) - [Integrations](https://support.edapp.com/technical-api-documentation?hsLang=en#integrations) - [API](https://support.edapp.com/technical-api-documentation?hsLang=en#api) - [Legal documentation](https://support.edapp.com/legal-documentation?hsLang=en#main-content) - [Third Party Gateway](https://support.edapp.com/legal-documentation?hsLang=en#third-party-gateway) - [Privacy & Terms](https://support.edapp.com/legal-documentation?hsLang=en#privacy-terms) - [Troubleshooting](https://support.edapp.com/troubleshooting?hsLang=en) - [EdApp to SC Migration](https://support.edapp.com/edapp-to-sc-migration?hsLang=en) - [Default HubSpot Blog](https://edapp-5741180.hs-sites.com/blog) [![Chill listening crop-3](https://support.edapp.com/hs-fs/hubfs/EdApp-AIP%20icon-216x216.jpg?width=32&height=32&name=EdApp-AIP%20icon-216x216.jpg "Chill listening crop-3")](http://edapp.com) EdApp Help Center Copyright © 2026, EdApp Pty Ltd