Configure SAML Single Sign-On and Profile Synchronization - Article
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
| Capability | What it establishes |
|---|---|
| Authentication | The configured identity provider authenticates the user through SAML |
| Auto-create a new user | Allows a new Eurekos account after successful authentication when no matching account exists |
| Synchronize user info on login | Updates mapped profile fields at login; synchronized fields become read-only locally |
| Eurekos enrollment and permissions | Separate rules determine the Training Activities, content and administrative functions available |
| Deactivation and departure | SSO 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.

| Scenario | Typical Use Case | Key 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) |
|
| 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 |
|
| 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 |
|
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 Attribute | Eurekos Field |
|---|---|
| email / NameID | Email (unique identifier) |
| given_name | First name |
| family_name | Last name |
| department | Department |
| manager | Immediate 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:
| Aspect | One-time provisioning (static) | Synchronization at each login |
|---|---|---|
| Data lifecycle | Data is set once during initial login | Data is updated on every login |
| Source of truth | Eurekos (after creation) | Identity Provider |
| Updates from IdP | Not reflected automatically | Always reflected on login |
| Profile editing in Eurekos | Allowed | Restricted (read-only fields) |
| Administrative control | Local control within Eurekos | Centralized control via IdP |
| Typical use case | Flexible environments where data may differ from IdP | Enterprise environments with centralized identity governance |
| Risk/limitation | Data may become outdated over time | Less 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 group | Meaning and decision |
|---|---|
| Federation metadata URL | Use the intended provider metadata URL |
| Federation metadata | Supply the metadata content when a URL is not provided; this is a text area, not an assumed XML upload control |
| Entity ID | Use the service-provider identifier agreed with the identity owner |
| Name ID policy | Use 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:
| Control | When to use it and effect |
|---|---|
| Auto-create a new user | Enable when a successfully authenticated identity may create a new Eurekos account; disable when accounts should already exist |
| Synchronize user info on login | Enable when the identity provider owns the mapped fields; later logins update them and make them read-only locally |
| Use regular login | Enable 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.
| Control | Effect and practical boundary |
|---|---|
| Auto-login | Redirects the supported main-page login flow to the provider; only one identity-provider connection can use this option |
| Pre-login redirect URL | Defines a portal or intermediate entry before authentication; agree how the journey returns |
| After-logout redirect URL | Defines the destination after logout; it does not by itself establish logout from every connected system |
| Enable UUID for import/export files | Adds 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 check | Expected result or evidence |
|---|---|
| Protocol connection | The intended callback, endpoints/metadata, credentials and trust complete the sign-in round trip |
| Existing user | The configured identifier matches the original learner record and retains history, enrollment and permissions |
| New user | An account is created only under the configured auto-create policy and required attributes are valid |
| Mapped fields and renamed labels | The expected values reach the intended technical fields rather than a similarly named label |
| Missing data | Approved defaults or a clear validation outcome apply; no unintended privileged assignment |
| New organization/category value | Organization/category values are created according to the selected login synchronization mode |
| Profile changed at source | A subsequent login updates the mapped fields when synchronization is enabled; disabled sync retains local ownership |
| Mapped field editing | Synchronized fields are read-only locally where configured |
| Visible, hidden and direct entry | The intended audience can use its route; hidden display is not treated as blocked authentication |
| Auto-login and recovery | Only the chosen provider redirects the supported main-page login and the authorized reserve route is usable |
| Regular login and multiple providers | The chosen local-login policy applies, including password setup and all connected-provider restrictions |
| Identity-provider departure | A new authentication through that provider is denied; other login routes, sessions and Eurekos account state are reviewed separately |
| Training access | The 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
| Problem | What to check |
|---|---|
| Login returns a protocol error | The intended application, exact callback and endpoints or federation metadata and trust |
| A duplicate or unexpected account is created | Unique identifier, source attributes, account matching and auto-create policy |
| Profile change is not reflected | Synchronize user info on login and a fresh subsequent authentication |
| A mapped field cannot be edited | Whether the field is deliberately owned by the identity provider |
| Hidden provider still works by direct URL | Hidden visibility is separate from disabling the connection |
| Provider-disabled user still has access | Existing sessions, local or other-provider login, Eurekos account state and the separately configured deactivation workflow |
| Training remains unavailable after sign-in | Enrollment and learning permissions rather than authentication alone |
FAQ
-
Do users need to be created in Eurekos before using SAML?
No. If auto-create user is enabled, users are created automatically when they log in via SAML for the first time. This is known as just-in-time provisioning.
-
How are users matched to existing accounts in Eurekos?
Users are matched based on a unique identifier from the SAML assertion, typically the NameID (most often the email address). If a match is found, the existing account is reused.
-
What happens if the NameID does not match an existing user?
If no match is found and auto-provisioning is enabled, a new user account is created. If not enabled, the user will not be able to log in.
-
What is the most common cause of SAML configuration issues?
The most common issues are:
- Incorrect Entity ID or ACS URL
- Invalid or missing certificates
- Incorrect or missing attribute mappings
-
What is the difference between NameID and attributes?
- NameID is the primary identifier used to match or create users
- Attributes provide additional user data (e.g. name, department, manager)
Both must be configured correctly for successful provisioning.
-
Can users still log in with email and password after SAML is enabled?
Yes, if “Use regular login” is enabled. However, users who primarily use SSO may need to reset their password before using email/password login.
-
What happens if a user is removed from the Identity Provider?
Disabling or removing the identity at the provider prevents new authentication through that provider. It does not by itself prove that the Eurekos account has been blocked or deleted, that every existing session has ended, or that another login route has been disabled.
For complete offboarding, review the user’s Eurekos status, existing sessions and any regular-login or alternative-provider access alongside the organization’s identity-management process. Do not rely on single sign-on alone as an account-deactivation workflow.
-
What is Federation Metadata and why is it recommended?
Federation metadata is information supplied by the Identity Provider, through a URL or XML, that contains its SAML endpoints, certificates and related settings. Using it reduces manual entry and helps avoid mismatched configuration. Agree who will maintain the connection when endpoints or certificates change. Pasting XML into the configuration does not by itself establish automatic updates; verify the update process for your connection.
-
Can Eurekos create new departments or organizations automatically?
The organization/category mapping can create missing values from incoming SAML attributes under the selected provisioning and login-synchronization settings. With synchronization enabled, supported creation can also occur on later logins; without it, the route applies when the user is first created.
Do not assume that every department, arbitrary profile field or custom record is automatically created. Agree the exact supported mappings with the identity administrator and verify unfamiliar values in a pilot account before using them for access or reporting.
-
When should synchronization be enabled?
Enable synchronization when the Identity Provider should act as the source of truth for user data. This ensures that changes in the Identity Provider (e.g. department or role updates) are reflected automatically in Eurekos on login.
-
Does hiding the SAML provider prevent login through its direct URL?
No. Hiding the displayed login option is separate from disabling the provider. Test the direct route and use the appropriate account and provider controls for access restrictions.