If your organization is moving to a new Identity Provider (IdP) for Single Sign-On (SSO), this guide explains how to update your SSO configuration in Udemy Business, and help ensure a transition with minimal disruption to your users.
Pre-migration checklist
Before you update your SSO settings in Udemy Business, make sure you:
- Have admin access to the Udemy Business Admin Portal.
- Ensure your users main identifier remain consistent (email address, externalID).
- Ensure the EntityID you provide Udemy is not currently in use in another connection.
- Have access to the new IdP’s metadata or configuration details.
- Have access to your previous IdP’s metadata as backup.
How to migrate your IdP in Udemy Business
Step 1: Delete your current SSO integration
- Go to your Udemy Admin portal.
- Go to Manage > Settings > SSO > Delete Connection.
Step 2: Follow the SSO Set up guide from your new Identity Provider
- Okta SSO Configuration Guide
- Azure AD (Entra ID) SSO Configuration Guide
- Google Workspace SSO Configuration Guide
- One Login SSO Configuration Guide
- ADFS SSO Configuration Guide
- Other/Custom SSO Configuration Guide
Step 3: Test login
- When attempting to log in after the set up, make sure to use an incognito window to make sure the previous login is not cached.
Common errors & how to resolve them
| Errors | Why It Happens | Fix |
| “Error while editing and enabling SSO Connection" | You are uploading a Metadata file that contains an IdP EntityID already in use in Udemy. | Create a unique EntityID in your Identity Provider. |
| SAML_003: "There was a problem with your SAML request" | The user does not have permission in your Identity provider to Access Udemy. | Make sure that your users are given permission to log into Udemy Business with SSO in your Identity Provider, either individually or via group assignment |
| Unrecognized Error Code: "There was a problem with your login request. Please try again later or contact Support for more help." | Typically occurs when the Identity Provider (IdP) sends a malformed or incomplete SAML. | Make sure your SSO Attributes have “email” set up in all lower case, and the user logging in has a valid email address assigned to this property. |
Frequently asked questions
Will this affect existing Udemy user accounts?
As long as the email addresses stay the same, existing user accounts will remain intact and licenses will not be lost.
Do we need to reassign licenses?
No, user licenses are tied to email addresses. If the main identifier remains the email, users retain their licenses.
How do we revert to the old IdP if something goes wrong?
If you've saved your old IdP metadata or settings, you can re-upload them to revert. Please contact Udemy Business Support if you need help.
Will this affect my users' learning history?
A Udemy users’ learning history is tied to their email address. As long as the email addresses do not change, the learning history will be unaffected.