How to configure a custom SSO connection (standard experience)

This article outlines how to configure single sign-on (SSO) with Udemy Business for any identity provider that supports SAML 2.0 SSO.

Additional resources:

Please note: SSO integration is only available with the Enterprise Plan.

Note: On March 25, 2026, we introduced a new, streamlined way to configure SSO. This new experience became the standard setup experience for all net-new configurations after that date, and we are currently working to transition all existing connections from the legacy experience. You can read about the legacy experience here. Please reach out to the Udemy Business support team if you have any questions.

Table of contents

Configuration steps

  1.  Log in to Udemy Business and navigate to Manage > Settings > Single Sign-On (SSO) > Configure SSO.
  2. Select Configure SSO.
  3. In the drop down, select Custom

Option A: Configure using SAML

  1. Under connection types, select SAML.
  2. Name your SSO configuration.
  3. Copy your SP EntityID.
  4. Go to your Identity  Provider and start the set up. 
  5. Below are the Udemy SSO SAML values needed for most configurations:
  6. Confirm SAML attributes. Identity providers often provide these by default but you may wish to edit these attributes.

Udemy Business supports the following SAML attributes

Please note: all attributes are space and case-sensitive.  Please copy paste directly from the list below to ensure proper formatting:

Attributes

SAML Attribute Required? Description
email Yes the unique email of the user 
firstName Optional  the first name of the user
middleName Optional  the middle name (if any) of the user
lastName Optional  the last name of the user
displayName Optional  the fully formatted name of the user
Name ID Yes  an identifier that can be used in cases where a name is duplicated
groups Optional  the list of groups to which the user belongs. Note: If you do not plan to pass over groups do not send this attribute, as it will override existing groups.
externalID Optional  a unique user ID specified by the customer
lmsUserID Optional  a unique user ID specified by the customer. (an lms integration must be configured for this value to pass over.)
licenseTypes Optional  specifies the types of Udemy Business license assigned to a user. Values include either Enterprise or Enterprise Pro
licensePoolName Optional  an optional attribute to identify which license pool the user is associated with.
  1. Give users permission to use the Udemy Application.
  2. Download the Metadata file from your system, or copy the Metadata URL.

Uploading Metadata information to Udemy

  1. Once you obtain your Metadata info, go back to your Udemy Business SSO setup page in Manage > Settings > Single Sign-On (SSO). 
  2. Under Configure using, you can import your metadata info either by Metadata URL or Metadata info.
  3. If you’re using the URL select Metadata URL and paste in the Metadata URL you previously copied and click Import metadata.
  4. If you have the Metadata file, select Metadata file and Select file. Look for the file and click Open.
  5. You should now see the metadata info appearing, once you confirm this, scroll down to the bottom of the page and click Save.
  6. Your SSO connection is now enabled. You can verify the status on the Single sign-on (SSO) page, which will display the connection status, certificate expiration date, and options to edit or pause the connection.

Option B: Configure using OIDC

  • Complete the set up in your Identity Provider.
  • If asked by your Identity Provider,, enter the Udemy Redirect URI: https://sso.udemy.com/api/oauth/oidc
  • Once set up is done in your Identity Provider, go back to your Udemy Portal and go to Manage > Settings > Single sign-on (SSO) and select Start setup, then custom
  • Name your SSO configuration.

  • Under Connection type select OIDC


    Enter the following values obtained from your Identity Provider
     

  • Client ID: Obtained from your Identity Provider.
  • Client Secret: Obtained from your Identity Provider
  • Well-known URL: 
    • Often known as the Discovery Endpoint 
  • Click Save.

Testing your SSO connection

Before rolling out SSO to your organization, we recommend testing the connection:

  1. Open a private/incognito browser window.
  2. Navigate to your Udemy Business login page.
  3. Select the SSO connection you created and sign in with a test user account.
  4. Confirm the user is authenticated and successfully redirected to Udemy Business.

Related articles

Contact Us