diff --git a/connection-guides/lms/sapsuccessfactors.mdx b/connection-guides/lms/sapsuccessfactors.mdx index f955bde4..68eb7da9 100644 --- a/connection-guides/lms/sapsuccessfactors.mdx +++ b/connection-guides/lms/sapsuccessfactors.mdx @@ -71,7 +71,7 @@ flow you follow will depend on your use case. - ## Additional Configuration if syncing Skills and Competencies + ## Additional Configuration if syncing Skills and Competencies via API endpoints (Optional) ### Locating API Server @@ -430,7 +430,71 @@ To create a LinkedIn Learning label, take the following steps: -## Additional Configuration if syncing Skills and Competencies +### SSO Configuration + +Proper SSO (Single Sign-On) configuration is essential for the SAP SuccessFactors integration to work correctly. The configuration ensures that users are properly identified and matched between your platform and SAP SuccessFactors. + +#### NameID Configuration + + + + The NameID in your SSO configuration should be set to the **UserID** field to ensure proper user identification. + + This is the preferred configuration and should be implemented whenever possible. + + + + Work with your content provider to verify that the NameID is properly configured to use the UserID field. + + Test the SSO flow to ensure users are correctly identified in SAP SuccessFactors. + + + +#### Alternative Configuration Options + +If the preferred NameID configuration cannot be implemented, the following alternatives are available: + +##### Option 1: Custom Field Configuration + + + + If setting the NameID to UserID is not possible, configure a custom field called `lms_user_id` and set it to the **UserID/StudentID** field value. + + + + Ensure the `lms_user_id` custom field is properly populated and accessible through the SSO configuration. + + + +##### Option 2: External Reference Field Configuration + + + + If neither the NameID nor the custom field are able to be configured to the UserID, configure an additional field called `lms_external_reference_field` to map to the **personExternalID** field. + + This is the fallback option when other configurations are not feasible. + + + + Work with your content provider to ensure the external reference field mapping is correctly implemented and tested. + + + +#### Important Notes + + + Correct SSO configuration is **essential** for ensuring the integration works as expected. Incorrect configuration may result in: + + - Users not being properly identified + - Learning records not being correctly attributed + - Authentication failures + + + + **Customer Responsibility**: You should work closely with your content provider to ensure the SSO configuration follows one of the recommended approaches above. The content provider should validate that the configuration meets the integration requirements. + + +## Additional Configuration if syncing Skills and Competencies via API endpoints (Optional) ### Locating API Server