Set up interface language through SAML

April 29, 2025

Adobe Learning Manager (ALM) now accepts a SAML attribute for language. This attribute is then mapped to the user’s interface and content language settings, ensuring smooth interaction with the LMS in their preferred language. The configuration of these language settings is managed through the Identity and Access Management (IAM) platform, utilizing SAML for Single-Sign-On (SSO). This supports both Service Provider (SP) initiated and Identity Provider (IdP) initiated logins, allowing users to see the interface and content in their chosen language. The workflow is as follows:

  1. Create application in Okta
  2. Add a user in Okta
  3. Configure SSO in ALM

Create application in Okta

To create an application in Okta, follow these steps:

  1. Create a developer account in Okta using your company email and log in to your account.

  2. Select Applications > Create App Integration.

  3. Select SAML 2.0 and then select Next.

  4. Type a name for the application and select Next.

  5. Configure the following fields:

    • Single Sign-On URL: Type the specific domain URL to which you want to link the application (for example, https://learningmanagerstage.adobe.com/saml/SSO). Change the environment URL if necessary.
    • Audience URI (SP Entity ID): Use the same environment URL as above.
    • Name ID Format: Select email address.
    • Application Username: Select Okta username.

  6. Under Attribute Statements, add the following (or additional fields as needed):

    • Name: locale
    • Name Format: Undefined
    • Value: user.locale

  7. Select Next and then select Finish.

  8. Once done, scroll down to SAML Signing Certificates:

    • Find the row where the status is Active.
    • Select Actions > View IdP Metadata.
    • This will open an XML file in a new tab. Copy the XML code and save it as a .xml file locally.

Add a user in Okta

To create a user in Okta, follow these steps:

  1. Select Directory > People and then select Add Person.
  2. Type the necessary details for the user and select Save.
  3. Search and select the new user’s username.
  4. Select Assign Application.
  5. Select the application you created earlier and then select Save.
  6. Navigate to the user’s profile and select Edit.
  7. On the locale field, type the required value (for example, fr_FR, en_US) and select Save.

Configure SSO in ALM

To configure the SSO in ALM, follow these steps:

  1. Log in as an Admin.

  2. Select Settings > Login Methods.

  3. Go to the Single Sign-On (SSO) Configuration tab.

  4. Select Add new SSO configuration.


    Add sso in ALM

  5. Configure the following details and select Save.

    • Type a name for the configuration.

    • Select **IDP Initiated ** from the Single Sign-On (SSO) Settings dropdown.

    • For IDP-Initiated Authentication URL:

      • Open the metadata XML file you downloaded earlier.
      • Search for the location value and copy it.
      • Paste this value into the IDP-Initiated Authentication URL field.

    • For Metadata XML File: Upload the .xml file you downloaded earlier.

  6. Go back to the Setup tab.

  7. From the dropdown, select Single Sign-On Configuration.

  8. In the SSO Setup dropdown, select the configuration name you created earlier.

  9. Select Save.