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

# OneLogin SAML SSO

> Here we will show you how to set up your own custom SAML application for OneLogin SAML

## Create application

1. From your OneLogin account, click **Applications** from the top navigation menu.
2. If your application is already created, choose it from the list and move to the section [Configure Application](#configure-application)
3. If you haven't created a SAML application, click the **Add App** button to create a new application.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_0.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=f7a03a9d60d4a728976cd2a8951de336" alt="Sso Onelogin 0 Pn" width="3184" height="1711" data-path="images/sso_onelogin_0.png" />
4. Search for **SAML Test Connector** in the Find Applications section. Select **SAML Custom Connector (Advanced)** from the search results.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_1.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=8ccd661a70433c622c430f11af8a6b5f" alt="Sso Onelogin 1 Pn" width="3184" height="1708" data-path="images/sso_onelogin_1.png" />
5. Give your application a **Display Name** and click **Save**.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_2.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=27b9c4c4a75aac565df3a209ecf6b75d" alt="Sso Onelogin 2 Pn" width="3179" height="1711" data-path="images/sso_onelogin_2.png" />

## Configure application

1. From your application, click the **Configuration** tab on the left to configure the application.
2. You have to enter the following values in the **Application details** section:

   * **Audience (Entity ID)**
   * **ACS (Consumer) URL Validator**
   * **ACS (Consumer) URL**
   * Select the **Service Provider** from the SAML initiator dropdown.

     <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_4.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=63f6a01123225bb375324170a17ea3ef" alt="Sso Onelogin 4 Pn" width="3184" height="1603" data-path="images/sso_onelogin_4.png" />

   Replace the values with the ones you have received from Aampe.
3. Click **Save** to save the configuration.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_3.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=f65940426cfde79a1ebcb40dde2eefe5" alt="Sso Onelogin 3 Pn" width="3184" height="1712" data-path="images/sso_onelogin_3.png" />
4. Click the dropdown menu **More Actions** from the top right corner and click **SAML Metadata** to download the metadata XML file.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_5.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=c4f268cf01f91c2481c32a33f4ae0001" alt="Sso Onelogin 5 Pn" width="3184" height="1707" data-path="images/sso_onelogin_5.png" />

## Attribute mapping

1. From your application, click the **Parameters** tab on the left.
2. You have to configure the following attributes:

| SAML Custom Connector Field | Value        |
| :-------------------------- | :----------- |
| `id`                        | `UUID`       |
| `firstName`                 | `First Name` |
| `lastName`                  | `Last Name`  |

See the screenshot below.

<img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_6.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=d36e1baefd88e6a29b3a590985594a4e" alt="Sso Onelogin 6 Pn" width="3184" height="1708" data-path="images/sso_onelogin_6.png" />

See the below screenshot to see how to map the id attribute to UUID.

3. Enter `id` in the **Field name** input and check the **Include in SAML assertion** checkbox. Click **Save** to continue.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_7.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=a3151cd2faa853e64ef61edcc49b9e83" alt="Sso Onelogin 7 Pn" width="3184" height="1710" data-path="images/sso_onelogin_7.png" />
4. On the next screen, select **UUID** from the **Value** dropdown and click **Save**.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_onelogin_8.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=9657409ee7f1a5acf7f453cc26281de0" alt="Sso Onelogin 8 Pn" width="3184" height="1707" data-path="images/sso_onelogin_8.png" />
5. Do the same for the other attributes (email, firstName, lastName).

## Next steps

You've successfully configured your custom SAML application for OneLogin SAML. At this stage, you can assign users to your application and start using it.