> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/ping-identity.md).

# PingIdentity

Use o PingIdentity como seu provedor de identidade para single sign-on federado, para que os usuários acessem o Dispel com suas credenciais corporativas existentes via OAuth (OIDC) ou SAML.

## Visão geral

Conecte o PingIdentity — a plataforma de identidade federada da Ping — como o provedor de identidade da sua organização. Depois de conectado, seus usuários fazem login no Dispel com suas credenciais corporativas existentes por meio de login único. Você pode conectar o Ping via **OAuth (OIDC)** ou **SAML**.

Esta página aborda a configuração específica do Ping. Para o comportamento compartilhado que se aplica a todos os provedores — como os usuários fazem login, o mapeamento de grupos, MFA e a desconexão — veja [Provedores de identidade](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md).

{% hint style="info" %}
**Onde encontrá-lo.** Faça login como administrador da organização e abra **Configurações → Integrações** (ou a dedicada **Configurações → Autenticação** página). O PingIdentity aparece na **Identidade e autenticação (IdP / SSO)** seção. Clique em **Conectar** no cartão para começar.
{% endhint %}

## Antes de começar

* Você configurará o lado do IdP no seu ambiente Ping — **PingOne** ou **PingFederate** — então você precisará de acesso administrativo lá.
* Decida por um protocolo — **OAuth (OIDC)** ou **SAML**. Veja [Escolhendo um protocolo](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#choosing-a-protocol).
* Certifique-se de que os usuários que farão login via Ping já estejam **convidados para sua organização** no Dispel. O SSO autentica usuários, mas não cria acesso por conta própria.

{% hint style="warning" %}
**Um provedor por vez.** Se sua organização já estiver conectada a outro provedor de identidade, desconecte-o antes de conectar o PingIdentity.
{% endhint %}

## Conectar com OAuth (OIDC)

#### No PingIdentity

1. No seu ambiente Ping, crie um novo **OIDC / Web** aplicativo para o Dispel.
2. Defina o **URI de redirecionamento** para o endereço do Dispel seguido de `/oauth/login-callback` — por exemplo `https://app.dispel.com/oauth/login-callback`. Confirme o endereço exato do seu ambiente com seu representante da Dispel se não tiver certeza.
3. Gere um **segredo do cliente** para o aplicativo.
4. Anote o **ID do cliente**, **segredo do cliente**, e o endpoint emissor OAuth/OIDC do seu Ping.

#### No Dispel

1. Clique em **Conectar** no cartão do PingIdentity e **Selecione Protocolo de autenticação → OAuth**.
2. Preencha os campos:

| Campo                            | Valor do PingIdentity                                                                 |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| **URL do cliente**               | Seu endpoint emissor OAuth/OIDC do Ping (onde os tokens são emitidos).                |
| **ID do cliente**                | O **ID do cliente**.                                                                  |
| **Segredo do cliente**           | O **segredo do cliente**.                                                             |
| **Identificador da organização** | Um identificador exclusivo que você escolher; os usuários o digitam na tela de login. |

3. Clique em **Salvar configurações**.

## Conectar com SAML

#### No PingIdentity

1. No seu ambiente Ping, crie um novo **SAML** aplicativo para o Dispel.
2. Na configuração SAML, cole os valores que o Dispel mostra no topo do formulário SAML:
   * **URL ACS / URL do Serviço do Consumidor de Asserção** ← do Dispel **URL do Serviço do Consumidor de Asserção**.
   * **ID da entidade / público** ← do Dispel **ID da entidade do Provedor de Serviço (SP)**.
3. Dos detalhes SAML / da conexão do aplicativo Ping, colete:
   * A **URL do Serviço de Logon Único** → do Dispel **URL do SSO**.
   * A **ID da entidade do IdP / emissor** → do Dispel **ID da entidade do provedor de identidade**.
   * A **certificado de assinatura** → do Dispel **Certificado de assinatura Base64**.
4. Conceda o aplicativo aos usuários ou grupos que devem ter acesso.

#### No Dispel

1. Clique em **Conectar** no cartão do PingIdentity e **Selecione Protocolo de autenticação → SAML**.
2. Copie o **ID da entidade do Provedor de Serviço (SP)** e **URL do Serviço do Consumidor de Asserção** mostrados no topo do formulário (use **Copiar ID** / **Copiar URL**) no Ping, como acima.
3. Preencha os campos:

| Campo                                        | Valor do PingIdentity                                                                 |
| -------------------------------------------- | ------------------------------------------------------------------------------------- |
| **URL do SSO**                               | A **URL do Serviço de Logon Único**.                                                  |
| **ID da entidade do provedor de identidade** | A **ID da entidade do IdP / emissor**.                                                |
| **Certificado de assinatura Base64**         | O certificado de assinatura do Ping. Cole-o ou use **Enviar certificado**.            |
| **Identificador da organização**             | Um identificador exclusivo que você escolher; os usuários o digitam na tela de login. |

4. Clique em **Salvar configurações**.
5. Clique em **Testar conexão**. O Dispel redireciona você para o Ping para fazer login e então mostra o e-mail e o nome que recebeu. Se o teste falhar, confirme se os valores correspondem ao seu aplicativo Ping e se o usuário de teste foi convidado para sua organização.

## Depois de conectar

* **Os usuários fazem login** digitando seu Identificador da organização na tela de login do Dispel e autenticando com o Ping. Veja [Como os usuários fazem login](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#how-users-sign-in).
* **Mapear grupos do Ping para grupos do Dispel** para que a associação permaneça sincronizada — veja [Mapeamento de grupos OIDC](/documentation/documentation-pt-br/integre-e-administre/integrations/oidc-group-mapping.md).
* **MFA** imposta no Ping se aplica durante o login; os códigos de uso único por e-mail do Dispel não se aplicam a usuários de SSO. Veja [SSO e autenticação multifator](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#sso-and-multi-factor-authentication).
* **Para trocar de protocolos ou provedores**, desconecte primeiro. Veja [Alternar ou desconectar um provedor](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#switching-or-disconnecting-a-provider).

## Perguntas frequentes

<details>

<summary>Isso funciona com PingOne e PingFederate?</summary>

Sim. Crie um aplicativo OIDC ou SAML no produto Ping que você usar e, em seguida, insira seus valores no Dispel. Os campos do lado do Dispel são os mesmos em ambos os casos.

</details>

<details>

<summary>Qual protocolo devo usar com o Ping?</summary>

Qualquer um funciona. Use o que corresponder ao aplicativo que você criar no Ping — um aplicativo OIDC para OAuth ou um aplicativo SAML para SAML.

</details>

<details>

<summary>Minha conexão de teste SAML falhou. O que devo verificar?</summary>

Confirme se a URL do SSO, o ID da entidade do IdP e o certificado correspondem ao seu aplicativo Ping, se você colou o ID da entidade do SP e a URL ACS do Dispel na configuração SAML do Ping, e se o usuário de teste recebeu acesso ao aplicativo Ping e foi convidado para sua organização no Dispel.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/ping-identity.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.