Settings & Customization

How to configure SSO with One Login

November 15, 2021 | 2 min read

AlphaLearn supports SAML-based SSO, acting as a Service Provider (SP) that delegates authentication to OneLogin as the Identity Provider (IdP). Once configured, users can log in to AlphaLearn using their existing OneLogin credentials.

Step 1: Add AlphaLearn as an Application in OneLogin

  1. Log in to OneLogin and go to AdministrationApplicationsApplications.
  2. Click Add App, search for SAML Custom Connector (Advanced), and select it.
  3. Set the Display Name to AlphaLearn LMS and click Save.

Adding a new application in OneLogin
Selecting SAML Custom Connector in OneLogin
Setting display name for AlphaLearn LMS in OneLogin

Step 2: Configure the X.509 Certificate

  1. In the AlphaLearn LMS application in OneLogin, click SSO in the left menu.
  2. Under X.509 Certificate, click Change, select Low Strength Certificate, and click Continue.

X.509 certificate configuration in OneLogin

Step 3: Add SAML Parameters

  1. Click Parameters in the left menu and click the + icon to add each of the following. For each: enter the field name, check Include in SAML assertion, click Save, select the value, and click Save again.
    • email → Value: Email
    • fname → Value: First Name
    • lname → Value: Last Name
Note: The field names email, fname, and lname must be entered in lowercase exactly as shown.

SAML parameters configuration in OneLogin

Step 4: Enable OneLogin SSO in AlphaLearn

  1. In AlphaLearn, go to CustomizeSSO.
  2. Select OneLogin as the Identity Provider and click Submit.
  3. Click on OneLogin to edit it and enter the following values (found in OneLogin → Application → AlphaLearn LMS → SSO):
    • Entity IDIssuer URL
    • Single Sign-On ServiceSAML 2.0 Endpoint (HTTP)
    • Single Logout ServiceSLO Endpoint (HTTP)
    • Signing Cert → click View Details under X.509 Certificate and copy the full certificate text
  4. Click Update. Note the Config Details values – you will need them in the next step.

Enabling OneLogin SSO in AlphaLearn LMS
SSO Config Details in AlphaLearn LMS

Step 5: Enter AlphaLearn Config Details in OneLogin

  1. In OneLogin, go to AdministrationApplicationsAlphaLearn LMSConfiguration and enter the following values from AlphaLearn’s Config Details:
    • Audience (Entity ID)Audience
    • RecipientRecipient
    • ACS (Consumer) URL ValidatorACS (Consumer) URL
    • ACS (Consumer) URLACS (Consumer) URL
    • Single Logout URLSingle Logout URL
    • Login URLLogin URL
    • SAML signature element → select Both
  2. Leave all other fields blank and click Save.

OneLogin configuration tab with AlphaLearn SSO details

Auto-registration: If a user is not yet registered in AlphaLearn and logs in via SSO, an account is created automatically. Ensure the AlphaLearn LMS application is assigned to the relevant users in OneLogin before going live.