---
title: Single Sign-On (SSO) Documentation
description: Setup SSO with SAML 2.0
---

[Skip to content](https://support.edapp.com/edapp-sso-documentation#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)

# Single Sign-On (SSO) Documentation

## Setup SSO with SAML 2.0

#### **Contents**

- [Providers](https://support.edapp.com/edapp-sso-documentation#providers)
- [Set-up instructions](https://support.edapp.com/edapp-sso-documentation#set-up)<https://support.edapp.com/edapp-sso-documentation#data-points> 
    - [Company ID/ Business ID](https://support.edapp.com/edapp-sso-documentation#company-id)
    - [SSO URL](https://support.edapp.com/edapp-sso-documentation#sso-url)
    - [SAML Entity ID](https://support.edapp.com/edapp-sso-documentation#SAML-entity-id)
    - [SAML Certificate](https://support.edapp.com/edapp-sso-documentation#SAML-certificate)
- [Sync employee information with custom fields](https://support.edapp.com/edapp-sso-documentation#additional-features)
- [Single Log Out (SLO)](https://support.edapp.com/edapp-sso-documentation#SLO)

*Last updated 28 November 2023*

Available on [**DIY, Managed, and Enterprise**](https://www.edapp.com/pricing/) plans.

### 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.

### Providers

We provide support for SAML 2.0 based SSO integrations.

This includes:

\- [Active Directory](https://support.edapp.com/configuring-sso-with-azure-active-directory-ad?hsLang=en)

\- [Google](https://support.edapp.com/setup-sso-with-google?hsLang=en)

\- [Okta (SCIM available)](https://support.edapp.com/configuring-sso-with-okta?hsLang=en)

\- OneLogin

\- Salesforce

\- Auth0

\- Ping Identity

\- All other systems that use SAML 2.0.

### Set-up instructions

Ensure the person setting up SSO has **admin privileges** to both EdApp and the SSO provider.

Step 1: Go to the EdApp LMS ([admin.edapp.com](http://admin.edapp.com)) with the ‘Single Sign-On’ button in the top right.

![](https://support.edapp.com/hubfs/1-png-Dec-14-2022-06-48-34-5140-AM.png)

 

Step 2: Click on the **Connect with SAML**

![](https://support.edapp.com/hubfs/2-png-4.png)

Step 3: Once you have a SAML IDP set up, you can fill in the relevant details on this page, which will enable SSO for your users.

If you'd like to set up **domain recognition**, reach out to your customer success manager with the email domain you wish to set up. This must be unique to your company.

#### ![](https://support.edapp.com/hs-fs/hubfs/Screenshot%202023-10-12%20at%202-37-24%20pm-png.png?width=602&height=432&name=Screenshot%202023-10-12%20at%202-37-24%20pm-png.png)

#### Company ID/ Business 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 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**

 

#### SSO URL

This URL will be available in your IDP under the ‘Login URL’ field.

*Below is an example from Azure.*

![](https://lh3.googleusercontent.com/rILVLRECmoCySX7Sp174Yj2xF317nwKHV-TCJ5TyLNNv6iQNjDUSzT4gqc6HVp6tACuzuWVq5y5Kw1VDzW5HWXXqKoEAUD_vd-vdP-5omxzxDdWik9Y3xEtoFeR8gzm3Nxz7PqW3)

#### SAML Entity ID

Your entity ID must match the entity ID for this configuration in your IDP e.g you can use **https://web.edapp.com/{companyID}. **

You can replace company ID above with your organization's company ID e.g. **https://web.edapp.com/acmeventures**

 

#### SAML Certificate file

Depending on your IDP, you may need to add a certificate file for your SSO to function. This should be provided by your IDP. Consider adding a certificate file even if your IDP doesn’t enforce it to enhance the security of your application.

**![image (53)](https://support.edapp.com/hs-fs/hubfs/image%20(53).png?width=688&height=166&name=image%20(53).png)**

**Reminder: LMS SSO works ONLY with `.cer, .crt and .pem` file certificates.  If the certificate you downloaded is not a `.cer, .crt or .pem` file you may need to change its file extension.**

### User Synchronization

Users are created in EdApp as soon as they log in to our system using SSO. In the event you wish to create the users in EdApp before they log in with SSO, that can be done through our LMS, [SCIM with Okta](https://support.edapp.com/configuring-scim-integration-with-okta?hsLang=en) and with our public API. If a user exists in the system with the same email address as the user signing in through SSO, EdApp will treat them as the same user.

### Sync employee information with custom fields

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'll need to map your "**Claims**" in the IDP to the "**Custom fields**" in EdApp.

**The name of the claim needs to match the custom field.**

**It is important to leave the "namespace" field in your IDP empty.**

Below is an example in Azure AD for a claim that populates the jobtitle field.

![](https://support.edapp.com/hubfs/image-png-Aug-19-2021-07-08-39-98-AM.png)The next step is to create the custom field in EdApp via the admin portal:  
[https://admin.edapp.com/app-settings#panel-user-custom-fields](https://admin.edapp.com/app-settings#panel-user-custom-fields)

 

In EdApp, this would look like the below:

![](https://support.edapp.com/hubfs/Screenshot%202023-10-12%20at%202-54-15%20pm-png.png)

The **fieldname** should match the **claim** in the IDP.

Emails, first and last names are already available in the EdApp system. Ensure your IDP fields match the following:

- email
- firstname (configured in invite settings)
- lastname (configured in invite settings)

 

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).

### Single Log Out

In EdApp we support single log out where the user is logged out of EdApp automatically when they log out of your organization's IDP. In your IDP, the logout URL should be like:

```
https://api.edapp.com/sso-logout/{COMPANY-ID}
```

 

If you log out of EdApp, this does not log you out of the IDP.

 

- [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

<https://www.linkedin.com/company/edapp-micro-learning/> <https://www.instagram.com/thisisedapp/?hl=en> <https://www.facebook.com/thisisedapp> <https://www.youtube.com/channel/UCgDNMep0ASddBGi7HV5-dJg>

Copyright © 2026, EdApp Pty Ltd