--- title: Single Sign-On (SSO) for Microsoft/Azure Schools description: Learn how to configure Microsoft/Azure with Wellio for Single Sign On. --- [Skip to content](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#main-content) English Show submenu for translations [![Untitled design](https://help.wellioeducation.com/hubfs/Untitled%20design.svg)](https://www.wellioeducation.com) Open main navigation Close main navigation - English Show submenu for translations - [Sign In](https://app.wellioeducation.com/) [Sign In](https://app.wellioeducation.com/) Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Help Centre](https://help.wellioeducation.com/?hsLang=en) 2. [IT Setup](https://help.wellioeducation.com/it-setup?hsLang=en) 3. [SSO](https://help.wellioeducation.com/it-setup?hsLang=en#sso) # Single Sign-On (SSO) for Microsoft/Azure Schools ## Learn how to configure Microsoft/Azure with Wellio for Single Sign On. ⚠️ **Before you start:** IT admins will need **admin access in Wellio** to complete the SSO setup. Please contact your school's Wellio admin to request access, or email [support@wellioeducation.com](mailto:support@wellioeducation.com) This process is divided into five steps: - [Set Up Enterprise Application & Configure SAML](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#connect) - [Upload Metadata File](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#metadata) - [Map User Attributes & Claims](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#mapping) - [Provide Test Login Details](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#testing) - [Submit for Review](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#submit) ### Before you begin: Access the SSO Setup Page in Wellio 1. [Log into your Wellio account](https://app.wellioeducation.com/users/sign_in) 2. Click ***Settings*** on the right-hand corner. 3. Select the ***SSO*** tab  ![](https://help.wellioeducation.com/hs-fs/hubfs/Screenshot%202025-05-09%20at%202-19-00%E2%80%AFPM-png.png?width=670&height=227&name=Screenshot%202025-05-09%20at%202-19-00%E2%80%AFPM-png.png) ### **Step 1: Set Up Enterprise Application & Configure SAML** 1. Visit the [Azure portal](https://portal.azure.com/) 2. Under the **Azure Services** header, click ***Enterprise Applications*** 3. Click ***New Application*** -\>***Create your own application*** 4. Use "Wellio" as the application name and select the **Non-gallery** radio button option 5. Once the application is created, go to the ***Single Sign-On*** section 6. Select **SAML** as the SSO method 7. In the **Basic SAML Configuration** section, enter the details provided in your Wellio SSO settings:  - **Entity ID (Identifier)** – Copy & paste this from Wellio - **Reply URL** – Copy & paste this from Wellio ⚠️ **These values are unique to your Wellio setup. Retrieve them directly from the Wellio SSO Setup - *Connect* step in *Settings*.** ### Step 2: Upload Metadata File Once you receive the URLs, continue with the following steps: - **Download the Federation Metadata XML file** shown below: ![azure1](https://help.wellioeducation.com/hs-fs/hubfs/azure1.png?width=670&height=403&name=azure1.png) - **Upload the Federation Metadata XML file** in the *Metadata* section of Wellio's SSO Setup page ### **Step 3: Map User Attributes & Claims** Once you've uploaded your metadata XML file, continue with the configuration. 1. In the ***User Attributes and Claims*** section, set the ***Required claim*** to match the following:![azure2](https://help.wellioeducation.com/hs-fs/hubfs/azure2.png?width=670&height=274&name=azure2.png) 2. Set *the **Additional Claims*** in lowercase text to match the required layout:![azure3 copy](https://help.wellioeducation.com/hs-fs/hubfs/azure3%20copy.png?width=622&height=294&name=azure3%20copy.png) **🚨 These fields are CASE-SENSITIVE** — make sure you enter them exactly as shown. 3. **Delete the content of the** *Namespace* **field** **for** **each claim a**s shown in the below:![azure4](https://help.wellioeducation.com/hs-fs/hubfs/azure4.png?width=670&height=263&name=azure4.png) 💡 **Mistakes in this step are the #1 cause of SSO setup failures.** If you’re unsure, refer to the screenshot for the exact formatting. ### Step 4: Enable User Access to App 1. Set ***Assignment required?*** to **NO** in the ***Properties*** tab **🚨 This enables users to access the app via SSO. Skipping this step** **means staff and students will receive an error when they attempt to sign-in.** ### **Step 5: Provide Test Login Details** To verify the SSO setup, provide credentials for the following: - **Teacher Test Account:** Email & password - **Student Test Account:** Email & password These accounts will be provisioned in Wellio for testing. The test accounts should be different and be a school-affiliated email address.  ⚠️ Please ensure the following when setting up your test accounts: 1. **Both test accounts are in the correct user group**, permitted access to the Wellio App. 2. **Two-factor authentication (2FA) is OFF**. This will allow the Wellio team to test the logins without any issues. ### Step 6: Submit for Review & Testing Once you've completed the steps above, we'll use the test account credentials you've provided in [Step 5](https://help.wellioeducation.com/single-sign-on-sso-for-microsoft/azure-schools#testing) to verify the configuration is working as expected before setting SSO live for your school. **Note:** Our team will use this information to configure your setup. You can expect a response **within 7 business days** and confirmation of a successful activation or request for adjustments if needed. ### Step 7 (if applicable): User Matching for existing users If your school previously used Wellio without SSO, existing accounts must be correctly linked to email addresses before activation. We’ll match accounts where possible and provide a list of any unmatched accounts for you to confirm. After configuration testing, we’ll be in touch if user matching is needed and provide simple instructions to complete the process for a smooth SSO transition.   **Troubleshooting an issue?** If you're running into errors or want to check your setup is working correctly, see our guide: [SSO Troubleshooting for IT Teams](https://help.wellioeducation.com/sso-troubleshooting-for-it-teams?hsLang=en) - [Getting Started](https://help.wellioeducation.com/getting-started?hsLang=en#main-content) - [Getting started as a teacher](https://help.wellioeducation.com/getting-started?hsLang=en#getting-started-as-a-teacher) - [Getting students started](https://help.wellioeducation.com/getting-started?hsLang=en#getting-students-started) - [IT Setup](https://help.wellioeducation.com/it-setup?hsLang=en#main-content) - [SSO](https://help.wellioeducation.com/it-setup?hsLang=en#sso) - [Whitelisting](https://help.wellioeducation.com/it-setup?hsLang=en#whitelisting) - [Teacher & Class Enrolments](https://help.wellioeducation.com/it-setup?hsLang=en#teacher-class-enrolments) - [For Admins](https://help.wellioeducation.com/for-admins?hsLang=en#main-content) - [IT Setup](https://help.wellioeducation.com/for-admins?hsLang=en#it-setup) - [Onboarding](https://help.wellioeducation.com/for-admins?hsLang=en#onboarding) - [Planning your sequences](https://help.wellioeducation.com/for-admins?hsLang=en#planning-your-sequences) - [Managing accounts](https://help.wellioeducation.com/for-admins?hsLang=en#managing-accounts) - [Planning Your Sequence](https://help.wellioeducation.com/for-admins?hsLang=en#planning-your-sequence) - [Lesson Tools & Delivery](https://help.wellioeducation.com/lesson-tools-delivery?hsLang=en#main-content) - [Delivering a lesson](https://help.wellioeducation.com/lesson-tools-delivery?hsLang=en#delivering-a-lesson) - [Editing content](https://help.wellioeducation.com/lesson-tools-delivery?hsLang=en#editing-content) - [For Students](https://help.wellioeducation.com/for-students?hsLang=en) - [Insights](https://help.wellioeducation.com/insights?hsLang=en#main-content) - [Activity Dashboard](https://help.wellioeducation.com/insights?hsLang=en#activity-dashboard) - [Surveys](https://help.wellioeducation.com/insights?hsLang=en#surveys) - [Student Profiles](https://help.wellioeducation.com/insights?hsLang=en#student-profiles) - [Articles For Teachers](https://help.wellioeducation.com/articles-for-teachers?hsLang=en) - [Troubleshooting & Help](https://help.wellioeducation.com/troubleshooting-help?hsLang=en) - [Teacher and Class Enrolment](https://help.wellioeducation.com/teacher-and-class-enrolment?hsLang=en) - [Parent Webinars](https://help.wellioeducation.com/parent-webinars?hsLang=en) - [Knowledge](https://help.wellioeducation.com/knowledge?hsLang=en#main-content) - [Professional Learning Resources for Schools](https://help.wellioeducation.com/knowledge?hsLang=en#professional-learning-resources-for-schools) [![Untitled design](https://help.wellioeducation.com/hubfs/Untitled%20design.svg "Untitled design")](https://www.wellioeducation.com) Teach wellbeing with confidence. Copyright © 2026, Wellio