Skip to main content

Configuring + Managing Single-Sign-On (SSO)

Written by Michael Stephenson

Overview

Element451 supports Single Sign-On (SSO) for both internal users (staff/faculty) and external users (students). This guide walks you through configuring SSO, managing metadata updates, and ensuring seamless authentication for your users. Internal SSO can be configured to match users on Email, School ID, or SSO ID, so institutions whose IdPs return a non-email identifier don't have to use email as the matching attribute.

If you're looking for guidance on enabling SSO or other authentication methods, visit our Security + Authentication Settings help article.


Configuration of SSO

To use your school's SAML2 SSO provider for either internal users (staff) or external users (students/contacts), you'll need to add your metadata to the SSO Authentication Settings:

  1. Navigate to SSO Settings

    • Settings > Manage Users > Security
      ​

  2. Find the Appropriate User Type Section

    • SSO must be configured separately for Internal Users (staff/admins) and External Users (students).

    • On this page, locate the relevant section:

      • SSO Authentication for Internal Users

      • SSO Authentication for External Users
        ​


SSO for Internal Users (Admins/Staff/Faculty)

  1. Create a New SSO Configuration

    • Click the + Create SSO Authentication button under SSO Authentication for Internal Users.

  2. Enter Metadata

    • Paste your SSO Metadata URL or XML provided by your Identity Provider (IdP). 📌 Note: If you're also prompted to enter a single sign-on service provider URL, please contact Element451 Live Support for assistance.

  3. Save your Configuration

  4. Confirm that SSO is enabled for Internal Users in Authentication Settings.

Internal SSO User Matching

Each internal SSO configuration matches users on one field. Element451 checks the value your identity provider sends against that field only. It doesn't check the other fields or fall back between them.

  • Email (default): The user's primary email.

  • School ID: A stable institutional ID, such as the value on a staff badge or used in HR records.

  • SSO ID: The identifier your identity provider returns in its SAML response.

By default the value comes from the SAML NameID. A separate SAML attribute can be configured instead.

🚨 Important: Element451 sets the internal matching field. You can't change it in Settings. To switch to School ID or SSO ID matching, contact Element451 Support. The switch applies to every internal user on that SSO configuration. Before switching, give each user a value that exactly matches what your IdP sends, then test a login.

🧠 Good to Know: Adding a School ID or SSO ID in Basic Info stores the value but doesn't change how that user is matched.

💡 Example: Your SSO matches on Email. A user's Email is jordan.lee@school.edu and their SSO ID is jlee@school.edu. Your IdP sends jlee@school.edu. Login fails because Element451 looks for a user whose Email is jlee@school.edu.


SSO for External Users (Students)

  1. Create a New SSO Configuration

    • Click the + Create SSO Authentication button under SSO Authentication for External Users.

  2. Enter Metadata

    • Paste your SSO Metadata URL or XML provided by your Identity Provider (IdP). 📌 Note: If you're also prompted to enter a single sign-on service provider URL, please contact Element451 Live Support for assistance.

  3. Save your Configuration

  4. Confirm that SSO is enabled for External Users in Authentication Settings.

External SSO User Matching

Once SSO is enabled and configured for external users, an "External SSO User Matching" settings card will appear. This is where you choose how Element451 matches external users from your identity provider response.

  • Email (default): Element451 matches the value returned by the identity provider against any of the user's email fields: primary email, email identity, or school email.

  • Identities: Administrators can select a single identity attribute to match against. Options: Primary Email, Email Identity, School Email, School ID, or Username ID. When an identity is selected, matching occurs exclusively against that attribute.


🚨 Important Notes

  • Use your identity provider's metadata: Paste the metadata URL or XML from your IdP, such as Entra, ADFS, or Okta. The Metadata Url shown on Element451's SSO cards is Element451's own metadata, not for this field. After saving, confirm the Single SignOn Service field is filled in.

  • NameID Mapping: Ensure the SAML2 NameID maps to the value Element451 matches on. For internal users, that's the configured field: Email by default, or School ID or SSO ID if Element451 has switched it. For external users, you can configure matching against another identity attribute.

  • For SSO login to succeed, the value in the SAML response must match a user account on the configured field: Email, School ID, or SSO ID for internal users, or the attribute set in External SSO User Matching for external users.

Learn how to add internal users to Element451 here.


Renewing Your SSO Certificate

If your SSO signing certificate is set to expire, you'll need to update the certificate to maintain uninterrupted authentication. Element451 does not actively monitor your metadata for updates. Therefore, it's important to remember to update your metadata when your certificate is renewed:

  1. Work with your SSO provider to regenerate your SSO signing certificate. Once this is done, the updated certificate will be reflected in your metadata URL/file.

  2. Navigate to Settings > Manage Users > Security.

  3. Locate the expired authentication.

  4. Replace the current metadata with your updated metadata URL or file.

  5. Save your changes.

Did this answer your question?