> 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-nl/beveiligen-en-beheren/identity-providers/ping-identity.md).

# PingIdentity

Gebruik PingIdentity als uw identiteitsprovider voor gefedereerde single sign-on, zodat gebruikers via OAuth (OIDC) of SAML toegang krijgen tot Dispel met hun bestaande bedrijfsgegevens.

## Overzicht

Koppel PingIdentity — Pings gefedereerde identiteitsplatform — als de identiteitsprovider van uw organisatie. Zodra het is verbonden, melden uw gebruikers zich bij Dispel aan met hun bestaande bedrijfsgegevens via single sign-on. U kunt Ping koppelen via **OAuth (OIDC)** of **SAML**.

Deze pagina behandelt de specifieke configuratie voor Ping. Voor het gedeelde gedrag dat op elke provider van toepassing is — hoe gebruikers zich aanmelden, groepskoppeling, MFA en het verbreken van de verbinding — zie [Identiteitsproviders](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md).

{% hint style="info" %}
**Waar u het kunt vinden.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties** (of de speciale **Instellingen → Authenticatie** pagina). PingIdentity verschijnt in de **Identiteit & Authenticatie (IdP / SSO)** sectie. Klik **Verbinden** op de kaart om te beginnen.
{% endhint %}

## Voordat u begint

* U configureert de IdP-zijde in uw Ping-omgeving — **PingOne** of **PingFederate** — dus u hebt daar beheerdersrechten nodig.
* Bepaal een protocol — **OAuth (OIDC)** of **SAML**. Zie [Een protocol kiezen](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#choosing-a-protocol).
* Zorg ervoor dat de gebruikers die zich via Ping gaan aanmelden al **zijn uitgenodigd voor uw organisatie** in Dispel. SSO authenticeert gebruikers, maar creëert niet zelfstandig toegang.

{% hint style="warning" %}
**Eén provider tegelijk.** Als uw organisatie al is verbonden met een andere identiteitsprovider, verbreek dan eerst de verbinding voordat u PingIdentity verbindt.
{% endhint %}

## Koppelen met OAuth (OIDC)

#### In PingIdentity

1. Maak in uw Ping-omgeving een nieuwe **OIDC / Web** applicatie voor Dispel aan.
2. Stel de **redirect-URI** in op uw Dispel-adres gevolgd door `/oauth/login-callback` — bijvoorbeeld `https://app.dispel.com/oauth/login-callback`. Bevestig het exacte adres voor uw omgeving bij uw Dispel-contactpersoon als u het niet zeker weet.
3. Genereer een **client secret** voor de applicatie.
4. Noteer de **Client ID**, **client secret**van de applicatie en uw Ping OAuth/OIDC-issuer-eindpunt.

#### In Dispel

1. Klik **Verbinden** op de PingIdentity-kaart en **Selecteer authenticatieprotocol → OAuth**.
2. Vul de velden in:

| Veld               | Waarde uit PingIdentity                                                           |
| ------------------ | --------------------------------------------------------------------------------- |
| **Client-URL**     | Uw Ping OAuth/OIDC-issuer-eindpunt (waar tokens worden uitgegeven).               |
| **Client ID**      | Het **Client ID**.                                                                |
| **Client Secret**  | Het **client secret**.                                                            |
| **Organisatie-ID** | Een unieke identificatie die u kiest; gebruikers typen deze op het aanmeldscherm. |

3. Klik **Instellingen opslaan**.

## Koppelen met SAML

#### In PingIdentity

1. Maak in uw Ping-omgeving een nieuwe **SAML** applicatie voor Dispel aan.
2. Plak in de SAML-configuratie de waarden die Dispel bovenaan het SAML-formulier toont:
   * **ACS-URL / Assertion Consumer Service-URL** ← Dispels **Assertion Consumer Service-URL**.
   * **Entiteits-ID / doelgroep** ← Dispels **Entiteits-ID van de serviceprovider (SP)**.
3. Verzamel uit de SAML-/verbindingsgegevens van de Ping-applicatie:
   * De **Single Sign-On Service-URL** → Dispels **SSO-URL**.
   * De **IdP-entiteits-ID / issuer** → Dispels **Entiteits-ID van de identiteitsprovider**.
   * De **ondertekeningscertificaat** → Dispels **Base64-ondertekeningscertificaat**.
4. Wijs de applicatie toe aan de gebruikers of groepen die toegang moeten hebben.

#### In Dispel

1. Klik **Verbinden** op de PingIdentity-kaart en **Selecteer authenticatieprotocol → SAML**.
2. Kopieer de **Entiteits-ID van de serviceprovider (SP)** en **Assertion Consumer Service-URL** die bovenaan het formulier worden weergegeven (gebruik **ID kopiëren** / **URL kopiëren**) naar Ping, zoals hierboven.
3. Vul de velden in:

| Veld                                        | Waarde uit PingIdentity                                                           |
| ------------------------------------------- | --------------------------------------------------------------------------------- |
| **SSO-URL**                                 | De **Single Sign-On Service-URL**.                                                |
| **Entiteits-ID van de identiteitsprovider** | De **IdP-entiteits-ID / issuer**.                                                 |
| **Base64-ondertekeningscertificaat**        | Het Ping-ondertekeningscertificaat. Plak het of gebruik **Certificaat uploaden**. |
| **Organisatie-ID**                          | Een unieke identificatie die u kiest; gebruikers typen deze op het aanmeldscherm. |

4. Klik **Instellingen opslaan**.
5. Klik **Verbinding testen**. Dispel leidt u om naar Ping om u aan te melden en toont vervolgens het e-mailadres en de naam die het heeft ontvangen. Als de test mislukt, controleer dan of de waarden overeenkomen met uw Ping-applicatie en of de testgebruiker is uitgenodigd voor uw organisatie.

## Na het verbinden

* **Gebruikers melden zich aan** door uw Organisatie-ID in te voeren op het aanmeldscherm van Dispel en zich te authenticeren met Ping. Zie [Hoe gebruikers zich aanmelden](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#how-users-sign-in).
* **Koppel Ping-groepen aan Dispel-groepen** zodat het lidmaatschap synchroon blijft — zie [OIDC-groepskoppeling](/documentation/documentation-nl/integreren-en-beheren/integrations/oidc-group-mapping.md).
* **MFA** dat in Ping wordt afgedwongen, geldt tijdens het aanmelden; de eenmalige e-mailcodes van Dispel gelden niet voor SSO-gebruikers. Zie [SSO en multifactorauthenticatie](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#sso-and-multi-factor-authentication).
* **Om van protocol of provider te wisselen**, verbreek eerst de verbinding. Zie [Van provider wisselen of de verbinding verbreken](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#switching-or-disconnecting-a-provider).

## Veelgestelde vragen

<details>

<summary>Werkt dit met zowel PingOne als PingFederate?</summary>

Ja. Maak in het Ping-product dat u gebruikt een OIDC- of SAML-applicatie aan en voer vervolgens de waarden ervan in Dispel in. De velden aan de Dispel-kant zijn in beide gevallen hetzelfde.

</details>

<details>

<summary>Welk protocol moet ik met Ping gebruiken?</summary>

Beide werken. Gebruik wat overeenkomt met de applicatie die u in Ping maakt — een OIDC-applicatie voor OAuth, of een SAML-applicatie voor SAML.

</details>

<details>

<summary>Mijn SAML-testverbinding is mislukt. Wat moet ik controleren?</summary>

Controleer of de SSO-URL, IdP-entiteits-ID en het certificaat overeenkomen met uw Ping-applicatie, of u Dispels SP-entiteits-ID en ACS-URL hebt geplakt in de SAML-configuratie van Ping, en of de testgebruiker toegang heeft tot de Ping-applicatie en is uitgenodigd voor uw Dispel-organisatie.

</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-nl/beveiligen-en-beheren/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.