---
title: Custom SSO Setup for signing in to Jomablue
slug: docs/custom-sso-setup-for-signing-in-to-jomablue
createdAt: 2022-09-23T03:42:23.000Z
---





## Overview

Jomablue supports user login via a SAML2.0-based SSO Identity Provider.

Setting up your SSO Identity Provider (e.g. Okta, Onelogin, Jumpcloud, Azure AD etc) for use with Jomablue will involve the following steps:

1. Contact Jomablue to enable SSO login
2. Jomablue will provide you with details to create an integration in your SSO Identity Provider
3. Once you have entered those details into your SSO Identity Provider, it will provide you with details to give back to Jomablue
4. Once we have received those details and completed setup, we will notify you that SSO login is ready to go

## Contact Jomablue to enable SSO login

Firstly you will need to contact Jomablue to enable SSO login, and then we will provide you with a few URLs and a certificate to enter into your SSO Identity Provider.

Additionally, you'll need to tell us which email domain(s) you would like to enforce SSO login for.

The URLs you will receive are:

### Identifier (Entity ID)

This URL takes the following form:

`https://<instance>.jomablue.com/saml2/<tenant_uuid>/metadata`&#x20;

In your Identity Provider, this may also be referred to as:

- Audience URI/URL&#x20;
- SP Entity ID
- SP Issuer URL

### Reply URL (ACS URL)

This URL takes the following form:

`https://<instance>.jomablue.com/saml2/<tenant_uuid>/acs`&#x20;

In your Identity Provider, this may also be referred to as a number of different names, including (but not limited to):

- "Single Sign On URL"
- "ACS URL"
- "Assertion Consumer Service URL"
- "Recipient"
- "Reply URL"



### Sign On URL

This URL takes the following form:

`https://<instance>.jomablue.com/saml2/<tenant_uuid>/login`&#x20;

### Logout URL

This is only used if your identity provider supports SLO (Single Log Out).

This URL takes the following form:

`https//<instance>jomablue.com/saml2/<tenant_uuid>/sls`&#x20;

### X509 Certificate

Your Identity Provider may ask you to provide an X509 certificate; this will be provided to you by Jomablue in the form of a `.crt`  file.

## Creating an application integration in your Identity Provider

In your Identity Provider's admin console, create a new custom SAML2 app integration, then populate the configuration fields for the SAML2 app integration using the matching fields provided by Jomablue.&#x20;

### Populate SAML2 configuration fields

The exact field names will vary from provider to provider, but they will all match with one of the fields described in the previous section.

:::hint{type="info"}
Note that depending on your Identity Provider, not all the URLs provided by Jomablue will be required.
:::

### Attribute Mapping

In addition to entering the correct URLs into configuration fields when setting up your integration, you'll need to ensure the correct Attributes are mapped.

By default, your Identity Provider should select "email" as the application username, but you'll also need to set up name attribute mapping.

The attribute `name` can be mapped to the "full name" value in your Identity Provider, if one is available. Otherwise, `first_name`  and `last_name`  can be mapped to the "first name" and "last name" attributes in your Identity Provider. For example:

::Image[]{src="https://api.archbee.com/api/optimize/DHKOH0YwbTGPz2KqdQjth/Wpb1uw7L2PosY4Dj28XLy_image.png" size="50" width="771" height="352" caption="Mapping attributes in Okta" position="center" showCaption="true"}

## Provide Jomablue with the fields from your Identity Provider

Once you have created your SAML2 integration in your Identity Provider, the Identity Provider will provide you with a number of fields which it will instruct you to enter into your Service Provider (which is Jomablue). These fields will include a number of URLs, and a X509 certificate. Some Identity Providers will alternatively offer an XML file to download, which will contain all the information.

Provide these fields to us (via the same channel we provided the setup information to you) and we will take it from there.

An example of what these fields look like:

::Image[]{src="https://api.archbee.com/api/optimize/DHKOH0YwbTGPz2KqdQjth/ukh8Sq1ABsRpP9qpskeLe_image.png" size="50" width="1050" height="1034" position="center" showCaption="false"}



## Final setup

Once you have provided the fields from your Identity Provider to us, we will proceed with the final setup steps, and once we have enabled SSO login for your instance, you will be able to use SSO to log in.

You'll also know that SSO has been enabled for you instance when the portal login page changes, to only display an Email Address field:


::Image[]{src="https://api.archbee.com/api/optimize/DHKOH0YwbTGPz2KqdQjth/DgsU6gqqRlzUFgOplcuow_cleanshot-2026-05-01-at-113316-2x.png" size="62" width="966" height="616" position="center" showCaption="false"}

