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

# SAML with Ping Identity

> Configure SAML single sign-on to Gumloop with PingOne

This guide walks a PingOne administrator through connecting Ping Identity to Gumloop for SAML single sign-on.

## Before you start: get your SP details from Gumloop

A Gumloop organization admin generates an SSO setup link at [gumloop.com/settings/organization/sso](https://www.gumloop.com/settings/organization/sso) (see [SSO, SAML & SCIM](/enterprise-features/sso_saml_scim)). The setup page shows the two Service Provider values you'll copy into Ping:

* **Assertion Consumer Service (ACS) URL** — ends in `/acs`
* **SP Entity ID** — the same URL without the `/acs` suffix

The same page has the fields for the values Ping produces: **Redirect URL**, **IDP Entity ID**, and the **Certificate** upload.

<Steps>
  ### Creating an application in PingOne

  PingOne setup starts from your administrator home page. Exactly how this looks will vary. This example uses a newly provisioned account and therefore shows an onboarding guide; your admin page will look different in most cases.

  Nonetheless, you'll always start by hitting *Applications* > *Applications* in the left navigation bar. This will take you to a new page.

  <Frame caption="Navigating to Applications > Applications in the left nav bar">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping0.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=775573dba3c39562c6957ac744d946ee" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping0.png" />
  </Frame>

  Once you've navigated to Ping's *Applications* page, press the circular blue button with a plus icon toward the top left. This will trigger a slideover.

  <Frame caption="Pressing the plus icon to trigger Application creation in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping1.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=9a7d705ee870cda38f75de2f3e614d04" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping1.png" />
  </Frame>

  Ping wants you to assign the Application an *Application Name*. The name has no impact on the integration, but Ping will use the *Application Name* as the display name. Write "Gumloop" as the *Application Name*.

  <Frame caption="Entering an Application Name in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping2.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=53f48fb0e22453cf9246c53933530b64" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping2.png" />
  </Frame>

  Then you need to tell Ping that the Application uses SAML. Click the card that reads *SAML Application*. You may notice that this changes the text on the blue button below from *Save* to *Configure*.

  <Frame caption="Telling Ping we want a SAML Application">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping3.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=31b2395fc349804f0fe4dc1d3641c1af" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping3.png" />
  </Frame>

  Here, select *Configure*. This finalizes creation of the SAML application and progresses you to the next step.

  <Frame caption="Selecting 'Configure' in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping4.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=db5f6436a65527eaccb735d6353199e8" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping4.png" />
  </Frame>

  Next, you'll enter some details from Gumloop into Ping.

  ### Entering Gumloop data in Ping Identity

  You'll now see a page with a *SAML Configuration* header. It will present three radio button options; of these, select *Manually Enter*. Doing so will trigger two input forms below the radio buttons.

  <Frame caption="Selecting 'Manually Enter' in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping5.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=a2f1f183ba1305efb30338632059bb90" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping5.png" />
  </Frame>

  Ping Identity requires two pieces of information about the SAML Connection.

  Ping first asks for *ACS URLs*. Gumloop provides exactly one — the URL labeled *Assertion Consumer Service (ACS) URL* on your Gumloop SSO setup page. It always ends in `/acs`.

  Copy the URL from Gumloop and paste it into Ping here.

  <Frame caption="Pasting the 'Assertion Consumer Service (ACS) URL' into Ping as an 'ACS URL'">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping6.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=31916f9132d3f2c0c03aa1843000cfa2" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping6.png" />
  </Frame>

  You'll do something similar again for a field Ping calls *Entity ID*. Gumloop calls this an *SP Entity ID*. You can find it adjacent to the *Assertion Consumer Service (ACS) URL* on the setup page. It matches the *Assertion Consumer Service (ACS) URL* exactly, except it lacks the `/acs` suffix.

  <Frame caption="Pasting Gumloop's 'SP Entity ID' in Ping as the 'Entity ID'">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping7.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=479669c127795f08ef0419afe25b1185" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping7.png" />
  </Frame>

  Hit *Save* toward the bottom of the page.

  <Frame caption="Hitting 'Save' to finish this step">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping8.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=c7b564544ff15cca9d3e4a5a4a75a5b5" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping8.png" />
  </Frame>

  ### Entering Ping Identity data into Gumloop

  Now you'll need to enter information about Ping into Gumloop.

  To start, make sure you're on the *Configure* tab. In a moment, you'll pull three pieces of information from this tab.

  <Frame caption="Confirming that you're on the 'Configure' tab in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping9.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=a8227268b3d0155701e90f4e2ea1179e" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping9.png" />
  </Frame>

  Gumloop requires a *Certificate* from Ping. You'll find the appropriate uploader on your Gumloop SSO setup page.

  To get the file from Ping, click the *Download Signing Certificate* button. Select *X509 PEM (.crt)* from the menu.

  You'll see a `.crt` file begin to download. The file may have a long and non-descriptive name; that is normal.

  Upload the file to Gumloop.

  <Frame caption="Finding the 'Certificate' in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping10.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=14f7694a85a05711530c2973c2a46f6d" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping10.png" />
  </Frame>

  After you've taken care of the Certificate, you'll need a field that Gumloop calls an *IDP Entity ID*. It's an input field on the same card as the Certificate uploader.

  Ping calls this information an *Issuer ID* and places it directly under *Download Signing Certificate* from the previous step.

  Copy this URL from Ping and paste it into Gumloop as the *IDP Entity ID*.

  <Frame caption="Copying the 'Issuer ID' from Ping Identity">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping11.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=cacf21cc5e268e82de2752a8c2f2e2f3" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping11.png" />
  </Frame>

  Finally, look for a field that Ping calls the *Single Signon Service*. Gumloop calls this a *Redirect URL*.

  Copy the *Single Signon Service* URL and paste it into Gumloop as the *Redirect URL*.

  <Frame caption="Copying the 'Single Signon Service' URL from Ping Identity">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping12.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=18dbd30ca8b97daf0f81a00be43dfbbc" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping12.png" />
  </Frame>

  Once you've copied over the *Single Signon Service* URL, you're done swapping information between Gumloop and Ping Identity.

  Now navigate to the *Attribute Mappings* tab to adjust one final setting in Ping.

  <Frame caption="Navigating to the 'Attribute Mappings' tab">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping13.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=3065bcac8baf2bffb54a443101ffe0be" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping13.png" />
  </Frame>

  ### Adjusting Ping attribute mappings

  Here, you'll see three headers: *Attributes*, *PingOne Mappings*, and *Required*. Where you see *saml\_subject* under *Attributes*, change the corresponding *PingOne Mappings* field. This will trigger a dropdown selector. Make sure you've set this field to *Email Address*.

  <Frame caption="Adjusting the 'saml_subject' in Ping">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping14.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=22a19dfef0a4816b5908aef2e234fc13" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping14.png" />
  </Frame>

  Hit *Save* at the bottom of the page.

  <Frame caption="Hitting 'Save' to finish the set-up">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping15.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=a563df8cf8843f7bf1beec6f13d4288d" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping15.png" />
  </Frame>

  In the top right, change the toggle from *off* to *on*.

  You're all done!

  <Frame caption="Turning the application on">
    <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-assets/ping/ping16.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=eea6a31a9ad21a54783d0eacac3d3fcc" width="1440" height="900" data-path="images/idp-guides/idp-assets/ping/ping16.png" />
  </Frame>

  Please do bear in mind, however, that a Ping admin will still need to assign users to this application before they can sign in.
</Steps>
