LearnWorlds SAML JIT Setup Guide

Item

Details

Prior Confirmation

  • Prior configuration in LearnWorlds is required.

  • For the latest setup instructions, please check the manual provided by LearnWorlds.

Name ID

Email address

Custom attribute Note: For instructions on how to configure a custom attribute, click here

SP-side Configuration

Configured by the administrator

Request configuration from the SP

Provisioning

Provisioning via API supported (account management possible in TrustLogin)

SAML JIT provisioning supported (account management possible in TrustLogin; user deletion not supported)
Note: For setup instructions when provisioning is not required, see here

None (accounts created in each system)

Access Method

SP-Initiated SSO

IdP-Initiated SSO

Verified Operation by Device

PC - Browser

PC - Desktop App

iOS - Standard Browser (Safari)

iOS - TrustLogin Mobile App In-App Browser

iOS - Native App

Android - Standard Browser (Chrome)

Android - TrustLogin Mobile App In-App Browser

Android - Native App

SAML Authentication Scope

Enabled for all users (SAML authentication only)

Other:
Enabled for all users (both SAML authentication and password authentication available)
Users (SAML authentication only), Administrators (password authentication only)

Notes

  • For users created via SAML JIT, the user's first name and email address are synced only when the account is first created. They are not synced on subsequent logins.
  • If there is an error in the SAML configuration and you become unable to log in, only the LearnWorlds School Owner account can log in from the LearnWorlds account sign-in page (https://account.learnworlds.com/login).
    For details, please see here.

Table of Contents:

TrustLogin Admin Page Settings

LearnWorlds Settings

TrustLogin Admin Page Settings (Continued)

TrustLogin User Settings

LearnWorlds Settings (Continued)

TrustLogin Admin Page Settings

  1. Log in to TrustLogin, open the "Admin Page > App" menu, and click the "Register App" button in the upper right of the screen.
    01.png

  2. Search on the "Register Company App" screen and select "LearnWorlds (SAML)".
    LearnWorlds01.png

  3. Note down the values for "IdP URL" and "Issuer/Entity ID" under "Identity Provider Information", and download the certificate using the "Get Certificate" button.03.png

Now, switch to configuring LearnWorlds.
Do not click the "Register" button yet — open LearnWorlds in a separate window.

LearnWorlds Settings

  1. Open "Website>Website Settings>Authentication>SAML" and click "by leveraging a SAML-based authentication flow."
    LearnWorlds02.png

  2. Configure the following settings.
    SAML Check the box
    Name Any name of your choice
    IDP Identifier (Entity ID) The "Issuer/Entity ID" noted down from TrustLogin
    Sign-on URL The "IdP URL" noted down from TrustLogin
    Single Logout URL https://portal.trustlogin.com/
    Identity Provider Certificate Paste in the contents of the "Certificate" noted down from TrustLogin

    LearnWorlds03.png

  3. Use the copy button to note down the "Service Provider (SP) URL", "Assertion Consumer Service (ACS) URL", and "Single Logout URL". Check "Create user if email doesn't exist" under "Create User" and click "Update".
    LearnWorlds05.png

Now return to the TrustLogin Admin Page again.

TrustLogin Admin Page Settings (Continued)

  1. Configure "Service Provider Settings" as follows.
    Entity ID The "Service Provider (SP) URL" noted down from LearnWorlds
    ACS URL to Service The "Assertion Consumer Service (ACS) URL" noted down from LearnWorlds
    Logout URL

    The "Single Logout URL" noted down from LearnWorlds

    Note: Single logout is planned as a future feature but is not currently implemented and does not function


    LearnWorlds06.png

  2. Save by clicking the "Register" button.

TrustLogin User Settings

① When a user adds the app from My Page

  1. Click the "Add App" button on "My Page".
  2. On the "Register App" screen, select "LearnWorlds (SAML)" and click the "Next" button in the upper right of the screen.
  3. If you want to change the "Display Name", enter it and click the "Register" button.

②When an administrator adds members

  1. Search for and click the "LearnWorlds (SAML)" app in the "Admin Page > App" menu.
  2. Click "Add Member", select the user to add from the member list, and click the "Register" button to add them.

LearnWorlds Settings (Continued)

Open "Website>Website Settings>Authentication>LearnWorlds" and select "Login is disabled. Only admins can login. Νο one can sign up." under "Login process". This will restrict users to logging in via SAML authentication only, and they will no longer be able to log in with a password. Configure this setting as needed.
Note: Administrators can still log in with a password.
LearnWorlds07.png

LearnWorlds SAML JIT Setup Guide

Item

Details

Prior Confirmation

  • Prior configuration in LearnWorlds is required.

  • For the latest setup instructions, please check the manual provided by LearnWorlds.

Name ID

Email address

Custom attribute Note: For instructions on how to configure a custom attribute, click here

SP-side Configuration

Configured by the administrator

Request configuration from the SP

Provisioning

Provisioning via API supported (account management possible in TrustLogin)

SAML JIT provisioning supported (account management possible in TrustLogin; user deletion not supported)
Note: For setup instructions when provisioning is not required, see here

None (accounts created in each system)

Access Method

SP-Initiated SSO

IdP-Initiated SSO

Verified Operation by Device

PC - Browser

PC - Desktop App

iOS - Standard Browser (Safari)

iOS - TrustLogin Mobile App In-App Browser

iOS - Native App

Android - Standard Browser (Chrome)

Android - TrustLogin Mobile App In-App Browser

Android - Native App

SAML Authentication Scope

Enabled for all users (SAML authentication only)

Other:
Enabled for all users (both SAML authentication and password authentication available)
Users (SAML authentication only), Administrators (password authentication only)

Notes

  • For users created via SAML JIT, the user's first name and email address are synced only when the account is first created. They are not synced on subsequent logins.
  • If there is an error in the SAML configuration and you become unable to log in, only the LearnWorlds School Owner account can log in from the LearnWorlds account sign-in page (https://account.learnworlds.com/login).
    For details, please see here.

Table of Contents:

TrustLogin Admin Page Settings

LearnWorlds Settings

TrustLogin Admin Page Settings (Continued)

TrustLogin User Settings

LearnWorlds Settings (Continued)

TrustLogin Admin Page Settings

  1. Log in to TrustLogin, open the "Admin Page > App" menu, and click the "Register App" button in the upper right of the screen.
    01.png

  2. Search on the "Register Company App" screen and select "LearnWorlds (SAML)".
    LearnWorlds01.png

  3. Note down the values for "IdP URL" and "Issuer/Entity ID" under "Identity Provider Information", and download the certificate using the "Get Certificate" button.03.png

Now, switch to configuring LearnWorlds.
Do not click the "Register" button yet — open LearnWorlds in a separate window.

LearnWorlds Settings

  1. Open "Website>Website Settings>Authentication>SAML" and click "by leveraging a SAML-based authentication flow."
    LearnWorlds02.png

  2. Configure the following settings.
    SAML Check the box
    Name Any name of your choice
    IDP Identifier (Entity ID) The "Issuer/Entity ID" noted down from TrustLogin
    Sign-on URL The "IdP URL" noted down from TrustLogin
    Single Logout URL https://portal.trustlogin.com/
    Identity Provider Certificate Paste in the contents of the "Certificate" noted down from TrustLogin

    LearnWorlds03.png

  3. Use the copy button to note down the "Service Provider (SP) URL", "Assertion Consumer Service (ACS) URL", and "Single Logout URL". Check "Create user if email doesn't exist" under "Create User" and click "Update".
    LearnWorlds05.png

Now return to the TrustLogin Admin Page again.

TrustLogin Admin Page Settings (Continued)

  1. Configure "Service Provider Settings" as follows.
    Entity ID The "Service Provider (SP) URL" noted down from LearnWorlds
    ACS URL to Service The "Assertion Consumer Service (ACS) URL" noted down from LearnWorlds
    Logout URL

    The "Single Logout URL" noted down from LearnWorlds

    Note: Single logout is planned as a future feature but is not currently implemented and does not function


    LearnWorlds06.png

  2. Save by clicking the "Register" button.

TrustLogin User Settings

① When a user adds the app from My Page

  1. Click the "Add App" button on "My Page".
  2. On the "Register App" screen, select "LearnWorlds (SAML)" and click the "Next" button in the upper right of the screen.
  3. If you want to change the "Display Name", enter it and click the "Register" button.

②When an administrator adds members

  1. Search for and click the "LearnWorlds (SAML)" app in the "Admin Page > App" menu.
  2. Click "Add Member", select the user to add from the member list, and click the "Register" button to add them.

LearnWorlds Settings (Continued)

Open "Website>Website Settings>Authentication>LearnWorlds" and select "Login is disabled. Only admins can login. Νο one can sign up." under "Login process". This will restrict users to logging in via SAML authentication only, and they will no longer be able to log in with a password. Configure this setting as needed.
Note: Administrators can still log in with a password.
LearnWorlds07.png