Settings & Customization

How to configure SSO with ADFS

November 15, 2021 | 1 min read

Active Directory Federation Services (ADFS) is Microsoft’s SSO solution, allowing users to authenticate once with their Active Directory credentials and access AlphaLearn LMS without a separate login.

Step 1: Enable ADFS SSO in AlphaLearn

  1. Go to CustomizeSSO.
  2. Click Create, select ADFS as the Identity Provider, and click Submit.
  3. Click the ADFS row to view the Config Details – you will need the Entity ID URL in the next step.

SSO configuration screen in AlphaLearn LMS
Creating ADFS SSO in AlphaLearn LMS
ADFS config details in AlphaLearn LMS

Step 2: Add a Relying Party Trust in ADFS

  1. On your ADFS server, open the ADFS Management Console, expand Trust Relationships, and select Relying Party Trusts.
  2. In the Actions panel, click Add Relying Party Trust and click Start.
  3. Paste the Entity ID URL from AlphaLearn into the Federation Metadata address field and click Next.
  4. Click through the wizard. On the Ready to Add Trust page, verify that the certificates are present across the tabs.
  5. Click Next to add the Relying Party Trust.

ADFS Trust Relationships console
Adding relying party trust in ADFS
Federation metadata address field in ADFS
Ready to Add Trust page in ADFS
Certificate verification in ADFS trust wizard
ADFS relying party trust wizard step
Relying party trust added in ADFS

Step 3: Configure Claim Rules

  1. Select the Relying Party Trust you just created and click Edit Claim Rules.
  2. Add an Issuance Transform Rule using the Send LDAP Attributes as Claims template. Map at least UPN and one additional attribute such as mail.
  3. Add a second Issuance Transform Rule using the Transform an Incoming Claim template. This rule is required for SAML authentication to work correctly with AlphaLearn.
Expected result: You should end up with two Issuance Transform Rules – one for sending LDAP attributes and one for transforming the incoming claim.

Editing claim rules in ADFS
Send LDAP Attributes as Claims rule in ADFS
Transform Incoming Claim rule in ADFS
Incoming claim transformation configuration
Final claim rules configuration in ADFS