Skip to main content

Configure SAML Single Sign-On and Profile Synchronization - Article

Connect SAML sign-in with clear account matching, profile mapping and login choices, and verify the boundaries with enrollment and deactivation.
Updated: 14 Nov 2026
17 min read

Summary

Connect Eurekos with the identity system your organization already uses so learners can sign in through a familiar, governed route. Optional first-login account creation and login-time profile synchronization can reduce manual administration.

Authentication, account state, training enrollment and permissions remain separate decisions. A successful identity-provider login does not grant every Course or automatically manage the complete user lifecycle.

Use this article to:

  • Configure the SAML connection and intended login experience
  • Choose account creation, mapping and synchronization behavior
  • Verify existing-user matching, alternative access and lifecycle boundaries

Business context

A customer, partner network or internal organization may already manage identity in Microsoft Entra ID, Okta or OneLogin. Connecting that provider to Eurekos lets people use the established authentication process, including the policies configured for that route, while keeping training administration in Eurekos.

For example, a new distributor’s technician can authenticate through the distributor’s identity system. If automatic creation is enabled and the configured attributes are valid, Eurekos can create their account at that login and apply the intended profile values. Enrollment and learning access still follow their separately configured rules.

For an established audience, agree how incoming identities match existing accounts before rollout. The benefit is continuity of learning history and less duplicate administration; it depends on correct identifiers and mappings, not a universal guarantee that every identity will be matched automatically.

Separate the identity outcomes

CapabilityWhat it establishes
AuthenticationThe configured identity provider authenticates the user through SAML
Auto-create a new userAllows a new Eurekos account after successful authentication when no matching account exists
Synchronize user info on loginUpdates mapped profile fields at login; synchronized fields become read-only locally
Eurekos enrollment and permissionsSeparate rules determine the Training Activities, content and administrative functions available
Deactivation and departureSSO authentication policy, Eurekos account state, sessions and other login routes must be governed together

Synchronization happens at login. It is not continuous background provisioning. If the objective includes scheduled account creation, updates or blocking independently of login, assess the separately configured provisioning route, such as SCIM where supported.

How the identity exchange works

The learner follows the configured login route, authenticates with the identity provider and returns to Eurekos with the supported identity response. Eurekos processes the configured identifier, optional account creation and profile mappings, then applies its own access rules.

SAML uses the configured metadata, identifiers and trust certificates to process the assertion. Eurekos does not receive the identity provider’s password. Local password login, where deliberately enabled, remains a separate route with its own controls.

Login Experience and Behavior

Once configured, SAML becomes part of the Eurekos login experience and can be adapted to different user groups and access models.

Users may see SSO as a login option alongside other methods such as email/password, depending on how the login form is configured. Administrators control this behavior in Settings → Forms → Login.

Here, you can define:

  • Which login methods are primary or secondary
  • Whether SSO is visible or hidden
  • How login options are presented to users

Multiple identity providers can be supported simultaneously, allowing flexibility across different user groups or organizational contexts.

This flexibility makes it possible to design login experiences that align with:

  • Fully centralized identity environments
  • Mixed audiences (internal and external users)
  • Controlled rollout or testing scenarios

💡 In a SAML-based setup, authentication is always performed by the Identity Provider, while Eurekos controls how users are directed into that authentication flow.

The following section outlines common login experience models and when to use them.

Login Experience Scenarios

Depending on how SAML and login settings are configured, different authentication experiences can be created in Eurekos. These configurations allow organizations to align login behavior with their user base, security requirements, and operational model.

Three alternative login models: SSO-only uses the identity provider; hybrid offers SSO and local login; hidden SSO uses a direct entry link without displaying the SSO option on the normal login form. Hiding an option does not restrict authorization.
Choose the entry experience for your audience: SSO-only, hybrid sign-in or a hidden direct SSO route. Every route still depends on the configured identity and Eurekos access rules.
ScenarioTypical Use CaseKey Characteristics
SSO-only environment
All users authenticate exclusively through the Identity Provider. The login process is fully centralized and controlled externally
Internal platforms where all users belong to the same organization and are managed in a central identity system (e.g. employees via Azure AD or a centralized partner portal)
  • Users are automatically redirected to the Identity Provider
  • No email/password login is visible
  • Authentication follows corporate policies (e.g. MFA)
  • Provider authentication is centrally controlled; account state and alternative routes need separate governance
Hybrid environment
Both SSO and local login are available, allowing different user groups to authenticate using different methods
Platforms with mixed audiences, such as internal employees and external partners, customers, or learners
  • Internal users log in via SSO
  • External users log in via email/password
  • Supports gradual SSO rollout
  • Provides flexibility without enforcing a single login method
Hidden SSO 
SSO is enabled but not visible on the standard login screen. Access is provided through a direct login URL
Controlled access scenarios (funnels), also pilot groups, specific clients, or staged rollouts. Is sometimes used in combination with other scenarios
  • SSO option is hidden from general users
  • Accessible via direct URL
  • Can be used for a pilot or targeted entry route; hidden visibility is not an authorization restriction
  • Allows configuration without impacting all users

How To Choose the Right Approach

The appropriate setup depends on your organizational context:

  • Use SSO-only when all users are managed centrally and security policies must be enforced consistently
  • Use Hybrid when supporting multiple user types with different identity sources
  • Use Hidden SSO for controlled rollouts, testing, or segmented access strategies

💡 In practice, many organizations begin with a hybrid or hidden setup during implementation and transition to an SSO-only model once fully validated.

Existing Users, Login Behavior, and Transition to SSO

When SAML is introduced in an existing Eurekos environment, users may already have accounts created through email/password or manual administration.

Eurekos is designed to support a seamless transition to SSO without creating duplicate users or requiring manual migration.

Match existing users deliberately

Configure the unique identifier and incoming attributes with the identity owner. Test a representative existing Eurekos account before rollout and confirm that the same record, learning history and enrollments are retained. An incorrect identifier can produce a mismatch or unintended new account; do not promise duplicate-free migration without that check.

Use a limited pilot to resolve mismatches before enabling automatic creation for a wider audience. Do not delete a learner’s existing account as a shortcut for testing profile synchronization.

Login Behavior After SSO Is Introduced

Authentication behavior depends on how login options are configured.

If “Use regular login” is enabled:

  • Users can log in using both SSO and email/password
  • Users who authenticate via SSO may need to reset their password before using email/password login, as SSO accounts are assigned a system-generated password

If disabled:

  • Users are expected to log in exclusively via SSO
  • Authentication is fully delegated to the Identity Provider

Introduce SSO without losing the existing context

A platform with existing customers can retain its established records while introducing SSO. Start with a known account, verify the identifier and profile result, then extend to the intended group. Decide separately whether those users may retain regular login and how account departure will be handled.

User Provisioning and Profile Mapping

One of the most important aspects of the integration is how user data is transferred, interpreted, and structured within Eurekos. When a user logs in via SAML, Eurekos receives a SAML assertion from the Identity Provider, which contains a set of user attributes within the assertion’s attribute statement.

These attributes must be mapped to the corresponding user profile fields in Eurekos to ensure that users are created correctly and that their data is usable for reporting, grouping, and access control.

In addition to attributes, the NameID element in the SAML assertion is typically used as the unique identifier for the user (most commonly the email address), and plays a key role in matching existing users.

For example:

Identity Provider AttributeEurekos Field
email / NameIDEmail (unique identifier)
given_nameFirst name
family_nameLast name
departmentDepartment
managerImmediate manager

This mapping determines:

  • How users are uniquely identified in the platform
  • How they appear across the user interface
  • How they are grouped, filtered, and reported on
  • How they align with organizational structure and governance

Map received attributes to the intended fields

Open User profile attributes in the provider form and map the claims or attributes actually supplied by your identity provider. Visible labels can be customized; use the configured technical field identifiers and mapping syntax supplied for that integration rather than assuming a renamed label is the claim name.

For example, the visible label “Business Unit” does not tell the identity administrator which attribute or mapping expression to send. Agree the source attribute, target field, accepted values and missing-value behavior, then inspect the result in a pilot user profile.

Plan missing values and dynamic organization data

Set defaults only for fields that offer that option, and choose values appropriate for the incoming audience. Do not use a broad fallback to place unrelated customer or partner users into one privileged organization merely to make account creation succeed.

The supported organization/category mapping can create missing values during login. With login synchronization enabled, this can occur on subsequent logins as well as first creation; with synchronization disabled, the creation route applies when the user is first created. Do not assume that every arbitrary field, department or custom record is automatically created from any received string.

Review the exact organization, category and tag mappings with your identity owner. Test missing values, unfamiliar values and an existing user before relying on those assignments for access or reporting.

Synchronization Behavior

Synchronization determines how user data evolves over time and, more importantly, which system is responsible for maintaining that data.

When integrating with an Identity Provider, organizations must decide whether Eurekos should act as a consumer of identity data or retain some level of local control over user profiles. This decision has a direct impact on governance, reporting accuracy, and administrative workload.

The two approaches can be compared as follows:

AspectOne-time provisioning (static)Synchronization at each login
Data lifecycleData is set once during initial loginData is updated on every login
Source of truthEurekos (after creation)Identity Provider
Updates from IdPNot reflected automaticallyAlways reflected on login
Profile editing in EurekosAllowedRestricted (read-only fields)
Administrative controlLocal control within EurekosCentralized control via IdP
Typical use caseFlexible environments where data may differ from IdPEnterprise environments with centralized identity governance
Risk/limitationData may become outdated over timeLess flexibility for local overrides

Practical example

Consider a user who moves from the Sales department to Marketing in the Identity Provider.

  • With one-time provisioning, the user remains assigned to Sales in Eurekos unless manually updated
  • With login-time synchronization, the change is applied automatically on the next login

As a result:

  • Reports reflect the correct department
  • Access and grouping remain aligned with the organization
  • The mapped change is applied at the next successful login

💡 Choose one-time provisioning for flexibility and local control, or login-time synchronization for consistency, scalability, and alignment with your identity system.

Configuration

Configuring SAML 2.0 requires coordination between Eurekos administrators and the IT team managing the Identity Provider. The objective is not only to establish a trusted authentication relationship, but also to ensure that authentication, user provisioning, and data governance behave as expected in your organization.

In practice, this means configuring both systems so that authentication works seamlessly and user data is structured correctly from the first login onward.

Step 1: Configure Identity Provider

The setup begins in your Identity Provider (e.g. Microsoft Entra ID, Okta, OneLogin), where Eurekos must be registered as a SAML application.

At this stage, you define how Eurekos is identified and how authentication responses are delivered.

This typically involves:

  • Creating a SAML application / enterprise application
  • Defining the Entity ID (Audience URI), which uniquely identifies Eurekos as a service provider
  • Configuring the Assertion Consumer Service (ACS URL), which is the endpoint in Eurekos that receives the SAML response after authentication
  • Defining attribute mappings, which determine what user data is included in the SAML assertion
  • Configuring the NameID, typically set to email, which is used as the unique identifier for users

These attributes and identifiers are critical, as they are used to match users and populate profile data in Eurekos. If attributes are missing or inconsistently defined, user provisioning may fail or result in incomplete profiles.

💡 In most implementations, this step is handled by IT, but it should be aligned with how user data is expected to appear and behave in Eurekos.

Step 2: Add the provider in Eurekos

Open Settings → Third party integrations → SAML and select Add identity provider. Give the connection a clear Name so users recognize it on the login page. Keep Enabled off until the connection is ready for the agreed pilot.

Control or groupMeaning and decision
Federation metadata URLUse the intended provider metadata URL
Federation metadataSupply the metadata content when a URL is not provided; this is a text area, not an assumed XML upload control
Entity IDUse the service-provider identifier agreed with the identity owner
Name ID policyUse the identifier format required by the trust relationship

After the provider record exists, use its displayed Login, Metadata and Callback URLs when completing the identity-provider setup. Copy the exact production values from that record rather than a QA example.

Step 3: Configure account and profile behavior

Expand User profile attributes and map the agreed identifiers and profile values. Then configure the Synchronization and Regular login sections:

ControlWhen to use it and effect
Auto-create a new userEnable when a successfully authenticated identity may create a new Eurekos account; disable when accounts should already exist
Synchronize user info on loginEnable when the identity provider owns the mapped fields; later logins update them and make them read-only locally
Use regular loginEnable only when the SSO-linked user should also be allowed the local email/password route

If a user is connected to several SSO providers, each must permit regular login for that password route to be available. An SSO-created account needs a usable password set through the supported reset process before local password login can be used.

Step 4: Agree the operating model

For a centrally managed partner population, login-time synchronization can keep mapped organization and contact details aligned with the source. For an external customer audience whose profile is maintained locally after creation, one-time provisioning may be more suitable. Use the earlier comparison to choose deliberately; changing a source attribute does not update a user who has not logged in again.

Keep enrollment and account departure in the same design discussion. Neither a mapped profile value nor the existence of an SSO account proves that the intended Training Activity is assigned.

Step 5: Configure the entry and exit experience

Use Settings → Forms → Login for the displayed login methods. Provider visibility and authentication permission are different controls: hiding a provider does not disable its direct login route.

ControlEffect and practical boundary
Auto-loginRedirects the supported main-page login flow to the provider; only one identity-provider connection can use this option
Pre-login redirect URLDefines a portal or intermediate entry before authentication; agree how the journey returns
After-logout redirect URLDefines the destination after logout; it does not by itself establish logout from every connected system
Enable UUID for import/export filesAdds the provider-specific unique-identifier column to user import/export files where that workflow is needed

The reserve login route is /user/reserve-login. Preserve and test the authorized administrative recovery route before changing the normal entry experience. With Auto-login, logout can lead to the confirmation page asking the user to close the browser tab; test that experience rather than assuming a global SSO logout.

Step 6: Save and run the agreed pilot

The initial SAML provider form uses Add. After completing the trust and mappings, save the intended configuration and test through the provider’s login route. Use the SAML provider’s login route for this test. The Save and make test login action belongs to the separate OpenID Connect configuration. Then use the complete verification table below with both new and existing accounts.

Verify the identity and learning journey

Test a pilot with a new user, a known existing account and representative incomplete or changed attributes. Use a fresh authentication session when checking changed source values.

Scenario or checkExpected result or evidence
Protocol connectionThe intended callback, endpoints/metadata, credentials and trust complete the sign-in round trip
Existing userThe configured identifier matches the original learner record and retains history, enrollment and permissions
New userAn account is created only under the configured auto-create policy and required attributes are valid
Mapped fields and renamed labelsThe expected values reach the intended technical fields rather than a similarly named label
Missing dataApproved defaults or a clear validation outcome apply; no unintended privileged assignment
New organization/category valueOrganization/category values are created according to the selected login synchronization mode
Profile changed at sourceA subsequent login updates the mapped fields when synchronization is enabled; disabled sync retains local ownership
Mapped field editingSynchronized fields are read-only locally where configured
Visible, hidden and direct entryThe intended audience can use its route; hidden display is not treated as blocked authentication
Auto-login and recoveryOnly the chosen provider redirects the supported main-page login and the authorized reserve route is usable
Regular login and multiple providersThe chosen local-login policy applies, including password setup and all connected-provider restrictions
Identity-provider departureA new authentication through that provider is denied; other login routes, sessions and Eurekos account state are reviewed separately
Training accessThe intended enrollment and permissions produce the right learning access independently of successful authentication

Standards and Security Considerations

The SAML integration in Eurekos is based on SAML 2.0 (Security Assertion Markup Language), an industry-standard protocol for enterprise single sign-on maintained by OASIS. This ensures compatibility with enterprise identity providers such as Microsoft Entra ID, Okta, and OneLogin.

Standards and References

  • SAML 2.0 Core Specification (OASIS)
  • SAML 2.0 Bindings and Profiles
  • SAML 2.0 Metadata Specification

These standards define how authentication, assertion exchange, and identity data are securely handled between the Identity Provider and Eurekos.

Keep authentication and local access controls distinct

The identity provider applies its configured authentication policies to the SSO route. Eurekos processes the supported identity response and applies its account, permission and learning-access rules. Eurekos does not receive the provider’s password; if regular login is allowed, local password handling is a separate configured route.

MFA and conditional-access policies belong to the route on which they are configured. Do not assume a provider policy also governs an enabled alternative local login.

Plan deactivation across the complete journey

Blocking an identity at the provider can prevent a new authentication through that provider. It does not, by itself, prove that an existing Eurekos session has ended, that every alternative login has been disabled, that the Eurekos account is blocked or that enrollments have been cancelled.

Agree the account-deactivation and session policy separately. Where supported, provisioning such as SCIM can manage account updates and blocking independently of login-time synchronization. Verify the intended departure outcome with an agreed test account; do not rely on a successful SSO login test as evidence of revocation.

Common Identity Provider Configurations

While SAML 2.0 follows a standard, each Identity Provider has its own terminology and setup flow. The configuration in Eurekos remains consistent, but how values are obtained and defined may differ slightly depending on your provider.

Below are common patterns to help align configuration across typical enterprise setups.

Microsoft Entra ID (Azure AD)

In Microsoft Entra ID, SAML is configured through an Enterprise Application.

  • The Identifier (Entity ID) represents Eurekos as the service provider
  • The Reply URL (Assertion Consumer Service / ACS URL) is the endpoint in Eurekos that receives the SAML response
  • The Signing certificate is used to validate incoming assertions
  • User attributes are configured under Attributes & Claims

A typical setup includes:

  • Entity ID and ACS URL provided by Eurekos
  • NameID configured as email (or another unique identifier)
  • Additional attributes such as department, job title, or manager

💡 In many organizations, Azure AD is also used to enforce MFA and conditional access policies, which automatically apply to Eurekos when using SAML.

Okta

In Okta, SAML is configured by creating a SAML 2.0 Application.

  • The Single sign-on URL corresponds to the Eurekos ACS URL
  • The Audience URI (SP Entity ID) identifies Eurekos
  • The X.509 certificate is used to sign assertions
  • Attributes are configured through attribute statements

Typical considerations:

  • Ensure NameID format is correctly configured (typically email)
  • Map attributes clearly (e.g. email, first name, last name)
  • Test configuration using Okta’s preview and test tools before enabling in Eurekos

OneLogin

In OneLogin, SAML is configured through a SAML App Connector.

  • The ACS URL defines where the authentication response is sent
  • The Audience (Entity ID) identifies Eurekos
  • Certificates are used to sign and validate assertions
  • User attributes are mapped through parameter configuration

Common setup includes:

  • Defining user attributes explicitly (e.g. email, username)
  • Ensuring consistent naming between OneLogin and Eurekos
  • Verifying that attribute statements are correctly included in the SAML assertion

Key Takeaways Across Providers

Although setup steps differ slightly, the integration always depends on the same core elements:

  • A registered SAML application
  • Entity ID (service provider identifier)
  • Assertion Consumer Service (ACS URL)
  • Identity Provider metadata (URL or XML)
  • Signing certificates for trust validation
  • Properly defined user attributes (attribute statements)

The most important success factor is alignment between the Identity Provider configuration and Eurekos attribute mapping.

Troubleshooting

ProblemWhat to check
Login returns a protocol errorThe intended application, exact callback and endpoints or federation metadata and trust
A duplicate or unexpected account is createdUnique identifier, source attributes, account matching and auto-create policy
Profile change is not reflectedSynchronize user info on login and a fresh subsequent authentication
A mapped field cannot be editedWhether the field is deliberately owned by the identity provider
Hidden provider still works by direct URLHidden visibility is separate from disabling the connection
Provider-disabled user still has accessExisting sessions, local or other-provider login, Eurekos account state and the separately configured deactivation workflow
Training remains unavailable after sign-inEnrollment and learning permissions rather than authentication alone

Third Party Integrations

FAQ