> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wejam.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up Enterprise SSO

> Configure SAML or OIDC so your users authenticate through your corporate identity provider.

Once Enterprise SSO is configured, users entering a company email (e.g. `@yourcompany.com`) are automatically redirected to your identity provider (IdP) for authentication. Password and social login options disappear entirely - access is controlled exclusively through your IdP.

To enable SAML for your organization, email [support@wejam.ai](mailto:support@wejam.ai). You'll receive a one-time setup link with a 5-step wizard. The setup takes 10-15 minutes and requires the **Admin** role in Jam.

> [!WARNING]
>
> Once Enterprise SSO is active for a domain, users with that domain can no longer log in with other methods. If you run a separate Jam organization (e.g. a recruiting org), use a different email address for it.

***

## What Changes After SSO Is Live

Users with your company email domain see only the SSO login path - no password field, no social login buttons. When they enter their email, Jam detects the domain and redirects them to your IdP automatically. After authenticating there, they land in Jam without a separate Jam password.

From an IT perspective: no manual user invites, and access is controlled in your IdP. New users join with the **Learner** role by default; to have your IdP set roles, contact [support@wejam.ai](mailto:support@wejam.ai).

**Existing accounts** migrate automatically. On their next login, existing users with a matching email are mapped to SSO seamlessly - no migration needed.

***

## Generic SAML Setup

**1. Request enablement**

Email [support@wejam.ai](mailto:support@wejam.ai) to request SAML for your organization. You'll receive a unique setup link (it looks like `https://auth.wejam.ai/setup_saml/...`).

**2. Open the setup wizard**

Click the setup link. The wizard walks you through 5 steps and provides the values your IdP needs: **Entity ID**, **ACS URL**, and **Start URL**.

![The Jam SAML setup wizard](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/saml-setup-wizard.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=8f6420e3a3277640bdee1c5ea4ada3cf)

**3. Create a SAML app in your IdP**

In your identity provider, create a new SAML application and enter Jam's **Entity ID**, **ACS URL**, and **Start URL** from the wizard.

**4. Exchange metadata**

Download your IdP's metadata file (or copy the metadata URL) and upload it to the Jam wizard.

**5. Map user attributes**

In your IdP, map the email attribute to `email` and first name to `first_name`. Add any other attribute mappings your setup requires.

**6. Test**

Use the test link provided in the wizard. Enter a company email and verify you are redirected to your IdP and land back in Jam successfully.

***

## Google Workspace

1. In **Google Admin**, go to **Apps & Services → Web/Mobile Apps** and add a custom SAML app.
2. Enter Jam's **Entity ID**, **ACS URL**, and **Start URL** from the wizard.
3. Download Google's metadata and upload it to the Jam wizard.
4. Configure attribute mapping in Google (email → `email`, given name → `first_name`).
5. Test with the wizard's test link - users with your domain should auto-redirect to Google and land in Jam.

After setup, Jam appears in the Workspace app grid for your users.

![Jam Trainer App visible in the Google Workspace app grid](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/google-workspace-app-grid.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=37a00c13bf1ee712d779073b465e46b3)

***

## Microsoft Entra (Azure AD)

1. In the **Azure Portal**, go to **Enterprise Applications** and create a new non-gallery application.
2. Under **Single sign-on → SAML**, enter in **Basic SAML Configuration**:
   * **Identifier**: Jam's Entity ID
   * **Reply URL**: Jam's ACS URL
   * **Sign on URL**: Jam's Start URL
3. Download the **Federation Metadata XML** from Entra and upload it to the Jam wizard.
4. Under **User Attributes & Claims**, map `email` and `givenname` to the corresponding Jam attributes.
5. Optionally assign users or groups to the app.
6. Test with the wizard's test link.

![The Microsoft Entra SAML configuration wizard](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/entra-wizard.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=5a2a7f0205ff2ca6c7ec9a1db79549ae)

> [!NOTE]
>
> If users previously logged in via Jam's Microsoft SSO (not SAML), their browser may try the old method. Direct them to `auth.wejam.ai/login_sso` or ask them to clear cookies and try again in an incognito window.

***

## Directing Users Straight to SSO (Optional)

To skip Jam's hosted login page and send users directly to your IdP, use the SAML redirect URL with one of these query parameters:

* `?domain=yourcompany.com` - redirects by domain
* `?email=user@yourcompany.com` - parses the domain from the email
* `?org_name=YourOrgName` - redirects by organization name (case-sensitive)

Example: `https://auth.wejam.ai/api/fe/v3/login/saml?domain=yourcompany.com`

To force a specific login method for all users, share one of these links:

* Google SSO only: `https://auth.wejam.ai/?opt_hint=gl`

  ![Login page showing Google SSO only](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/login-google-only.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=b15b6ce1d5aaa60f05d218d66ff97abd)

* Microsoft/Entra only: `https://auth.wejam.ai/?opt_hint=ms`

  ![Login page showing Microsoft SSO only](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/login-microsoft-only.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=840f06f977b93deb0914fb301ee2753b)

* Enterprise SSO only: `https://auth.wejam.ai/?opt_hint=sso`

  ![Login page showing Enterprise SSO only](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/login-sso-only.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=885bdc0482151daddd8508d069a83c49)

***

## Troubleshooting

> [accordion] Users still see a password option
>
> SAML setup is incomplete. Check that your domain is correctly configured in the wizard and that the setup completed all 5 steps.

> [accordion] 'Invalid SAML response' error
>
> Copy the Entity ID, ACS URL, and Start URL exactly from the wizard - small differences in formatting cause this error.

> [accordion] 'User not found' error
>
> Verify the email attribute mapping in your IdP matches what the wizard expects (`email`).

> [accordion] Lost the setup link
>
> Contact [support@wejam.ai](mailto:support@wejam.ai) to have a new link generated.

> [accordion] Microsoft/Entra users can't log in after SAML setup
>
> The user's browser is caching the old Microsoft SSO flow. Direct them to `auth.wejam.ai/login_sso` or ask them to use an incognito window.

> [accordion] 'AADSTS50105' error on Microsoft Entra sign-in
>
> This error means the user's own Entra ID admin has the enterprise application set to require assignment, and the signed-in user hasn't been granted access - either directly or via a group. This is configured entirely on the customer's tenant and can't be fixed from Jam's side.
>
> ![AADSTS50105 error shown on the Microsoft sign-in page](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/aadsts50105-error.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=865926e111102c7e8745fd68434412ec)
>
> **Getting access to this app**
>
> * Ask your organization's Microsoft Entra ID admin to grant you access.
> * They'll go to **Enterprise Applications → \[your app name] → Users and groups**.
> * Select **Add user/group**.
> * Assign you directly, or add you to a group that's already assigned to the app.
>
>   ![The Users and groups screen for an enterprise app in Microsoft Entra, with Add user/group highlighted](https://mintcdn.com/jam-dd997f5e/wsRk89r3iFRCkAnS/external/admin/images/entra-users-and-groups-add.png?fit=max\&auto=format\&n=wsRk89r3iFRCkAnS\&q=85\&s=c9a16feb1ba34afba9b7ce3badde8668)
>
> <sub>Screenshot: [Microsoft Learn](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/assign-user-or-group-access-portal), CC BY 4.0.</sub>
>
> **Helpful links**
>
> * [Assigning users and groups to an app](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/assign-user-or-group-access-portal)
> * [Troubleshooting AADSTS50105](https://learn.microsoft.com/en-us/entra/identity-platform/reference-error-codes)

## Related Articles

* [Accessing Multiple JAM Organizations](https://docs.wejam.ai/external/admin/multi-organization-access.md) - use separate account addresses when one person needs access to more than one organization


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.