Set up interface language through SAML
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:
- Create application in Okta
- Add a user in Okta
- Configure SSO in ALM
Create application in Okta
To create an application in Okta, follow these steps:
-
Create a developer account in Okta using your company email and log in to your account.
-
Select Applications > Create App Integration.
-
Select SAML 2.0 and then select Next.
-
Type a name for the application and select Next.
-
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.
-
Under Attribute Statements, add the following (or additional fields as needed):
- Name: locale
- Name Format: Undefined
- Value: user.locale
-
Select Next and then select Finish.
-
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:
- Select Directory > People and then select Add Person.
- Type the necessary details for the user and select Save.
- Search and select the new user’s username.
- Select Assign Application.
- Select the application you created earlier and then select Save.
- Navigate to the user’s profile and select Edit.
- 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:
-
Log in as an Admin.
-
Select Settings > Login Methods.
-
Go to the Single Sign-On (SSO) Configuration tab.
-
Select Add new SSO configuration.
Add sso in ALM -
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.
-
-
Go back to the Setup tab.
-
From the dropdown, select Single Sign-On Configuration.
-
In the SSO Setup dropdown, select the configuration name you created earlier.
-
Select Save.
User login and language Setting
When a user logs in using the credentials through SSO, the language attribute passed from the IDP is mapped to the user’s interface and content language fields in ALM. The language settings are reflected immediately in the user interface and content without any caching time.
Users can manually update their language settings in the user profile section. These manually updated language preferences will remain in effect and will not be overridden by the IDP settings during future logins.
If a user is soft deleted from ALM, the language settings will be retained in the database. When the same user is added again, the previously set language will be restored.
Admins can check User Activity, Learning Summary, and Compliance Dashboard reports for language-specific details.