---
title: "Ping Identity SAML 2.0 SSO Setup"
canonical: "https://help.agiloft.com/space/HELP/43714348/Ping+Identity+SAML+2.0+SSO+Setup"
format: markdown
---
This article provides instructions for setting up SAML 2.0 single sign-on (SSO) with Ping Identity as the Identity Provider (IdP). It also includes instructions on how to log in with SSO after the integration and make sure other users log in with SSO as well.

> Macro (include)

# Set Up SAML 2.0 SSO

> Macro (include)

## > Macro (anchor)

Create a SAML SSO Profile

> Macro (include)

## > Macro (anchor)

Configure Service Provider Details

> Macro (include)

At this point, you can't finish the setup in Agiloft until you configure your IdP. Continue to [Configure Ping](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714348/Ping+Identity+SAML+Integration#PingIdentitySAMLIntegration-configure_idp) for instructions on setting up your IdP.

## > Macro (anchor)

Configure Ping

Follow the steps below to integrate Agiloft as a SAML service provider in Ping.

> ℹ️ These are general steps for adding a SAML application to PingOne. If the options you see in the console or your practices for adding apps differ from those described here, refer to Ping's [documentation](https://docs.pingidentity.com/pingone/applications/p1_applications_add_applications.html) on adding applications to complete the task.

1. First, to streamline the Ping setup, download the SAML Service Provider Metadata XML file from Agiloft so you can import it to Ping:
  1. In Agiloft, go to **Setup > Access > Configure SAML 2.0 Profiles**.
  2. Select the profile for this IdP, then click Download Metadata XML. The file includes the X.509 certificate.
2. Now, sign on to your PingOne admin console and go to the environment in which you want to add an application.
3. In the sidebar, go to **Applications > Applications**.
4. Click the blue plus icon to create a new application.
5. Enter a name for the application and configure any optional settings.
6. For Application Type, select SAML Application and click Configure.
7. On the SAML Configuration screen, select Import Metadata and click Select a file.
8. Browse for and select the XML file you downloaded from Agiloft, then click Save. The console presents the Overview page for the application.
9. At the bottom of the screen, click Download Metadata to download the IdP metadata XML file. You use the contents of this file to configure the identity provider details in Agiloft.
10. Edit the configuration as needed. Refer to Ping's [documentation](https://docs.pingidentity.com/pingone/applications/p1_edit_application_saml.html) on editing a SAML application:
  1. If you want to create or update user records in Agiloft based on attributes from Ping, add attribute mappings to send in the SAML assertion.
  2. By default, all users have access to the SAML application. You may want to change Access settings to limit access to specific groups.
11. If necessary, enable the new application by sliding the enablement toggle.

Now that Ping is configured, return to Agiloft. If you want to configure IdP attribute to Agiloft field mappings, continue to [Configure User Group, Team, and Fields Mapping](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714348/Ping+Identity+SAML+Integration#PingIdentitySAMLIntegration-mapping) below. If you don't want to configure mappings, proceed to [Configure Identity Provider Details](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714348/Ping+Identity+SAML+Integration#PingIdentitySAMLIntegration-identity_provider).

## > Macro (anchor)

Configure User Group, Team, and Fields Mapping

> Macro (include)

### > Macro (anchor)

SAML Attribute Mapping

The following image shows attribute mappings that are configured for an Agiloft SAML application in Ping: 

![Attribute mappings in Ping](media://0c9e0a26-b9fc-4858-abed-73f219060a57)

> ℹ️ The saml_subject attribute is the NameID that is mapped on the [Service Provider Details](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714348/Ping+Identity+SAML+Integration#PingIdentitySAMLIntegration-service_provider) tab. In this instance, it's customized to send Username as the NameID.

To map the attributes to fields in Agiloft, enter the application values in the relevant fields on the User Field(s) Mapping tab.

![Attribute names on User Field Mappings tab](media://8447ac53-283e-4587-a399-295edda348f4)

Now that user, group, and team mappings are configured, proceed to [Configure Identity Provider Details](#identity_provider) to complete the SAML SSO setup.

## > Macro (anchor)

Configure Identity Provider Details

> Macro (include)

# > Macro (anchor)

Log in with SAML

> Macro (include)

# > Macro (anchor)

Force SSO Login

> Macro (include)

# > Macro (anchor)

Generating a Key Pair

> Macro (include)

> Macro (hide-if)
> 
> #### Related articles
> 
> > Macro (contentbylabel)