> ## 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.

# PingOne SAML SSO

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

## Create application

1. From your PingOne account, click **Connections > Applications** from left 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 **plus button** to create a new application.

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_pingone_1.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=f872f7ddb8304215bd528ce38512f52a" alt="Sso Pingone 1 Pn" width="3184" height="1702" data-path="images/sso_pingone_1.png" />
4. Give your application an **Application Name**, choose **SAML Application** from the **Application Type** and click **Configure**.

## Configure application

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

1. From the next screen, you have to enter the following values in the **SAML Configuration** section:

   * **ACS URLs**
   * **Entity ID**

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

   <img src="https://mintcdn.com/aameo/nTJJr7c-2zWPTL1i/images/sso_pingone_3.png?fit=max&auto=format&n=nTJJr7c-2zWPTL1i&q=85&s=74073b454b8fa8124f7c3b07b599ca8a" alt="Sso Pingone 3 Pn" width="3184" height="1705" data-path="images/sso_pingone_3.png" />
3. Click the **Configuration** tab from the top and click **Download Metadata** to download the metadata XML file.

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

## Attribute mapping

1. Click the **Attribute Mappings** tab from the top and you have to configure the following attributes:

| SAML App        | PingOne       |
| :-------------- | :------------ |
| `id`            | `User ID`     |
| `Email Address` |               |
| `firstName`     | `Given Name`  |
| `lastName`      | `Family Name` |

See the screenshot below.

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

2. Make sure you have enabled your app so that it can be used by the users. You can do this by clicking the **Toggle button** next to your app.

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

## Next steps

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