---
title: Een OpenID Connect-provider koppelen
description: Koppel Keycloak, Microsoft Entra ID, Auth0, Ping Identity of een andere OpenID Connect-provider, stel de groepsclaim in en koppel groepen aan Pyn-rollen.
sidebar:
  order: 2
area: integrations
feature: sso
appPath: /settings/integrations/available
lastVerified: 2026-11-09
version: "2026-11-09"
audience: admin
related:
  - integrations/sso
  - integrations/sso/connect-okta
  - settings/users
intercom:
  - id: "16838066"
    title: Enabling Single Sign On (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16838066-enabling-single-sign-on-pyn-2
    note: replaces
translation:
  source: integrations/sso/connect-an-oidc-provider.mdx
  sourceSha: 6c4fc9c14619f4daa3b2e06d83cb418cd8d3b119
---

Je identity provider spreekt OpenID Connect en je wilt dat die provider mensen bij Pyn laat inloggen en hun rollen bepaalt. De integratie Single Sign-On vraagt om de provider, zijn issuer en een client met de authorization code flow, controleert de OpenID-configuratie van de provider en toont de redirect-URI en inloglink die je nodig hebt.

## Voordat je begint

- Je bent admin of owner in Pyn, en de integratie Single Sign-On is ingeschakeld voor je workspace.
- Iemand kan een vertrouwelijke client aanmaken in je provider: "The client needs the standard authorization code flow and a client secret." Pyn vraagt de scopes `openid`, `profile` en `email`; voor het koppelen van rollen heeft het ID-token een `groups`-claim nodig (Entra geeft `roles` mee), en elke scope die deze claim ontsluit, hoort in **Additional Scopes**.
- Je hebt de issuer, client-id en het client secret. Voor Keycloak heb je de **Keycloak Server URL** en **Realm** nodig; Pyn stelt de issuer daaruit samen.

![Connect single sign-on: choose the Provider, then enter the issuer, client ID, client secret and groups claim.](https://support.pyn.ai/media/integrations/sso/integrations-sso-connect.png)

## Stappen

1. Open in Pyn **Settings** in de linkernavigatie, en dan **Available** onder **Integrations**.

2. Selecteer de tegel **Single Sign-On**. Het dialoogvenster **Connect single sign-on** opent.

3. Kies de **Provider**: **Keycloak**, **Okta**, **Microsoft Entra ID**, **Auth0**, **Ping Identity** of **Single Sign-On** voor al het andere.

4. Voer voor Keycloak de **Keycloak Server URL** en **Realm** in; voer voor de andere de **Issuer URL** in.

5. Voer de **Client ID** en het **Client Secret** in. Stel **Groups Claim** in als je provider een andere naam dan `groups` gebruikt, en **Additional Scopes** als hij meer nodig heeft dan `openid profile email`.

6. Kopieer de **Redirect URI** die het dialoogvenster toont: "Add this as a valid redirect URI on the client in your provider, then come back and connect."

7. Selecteer **Connect**. Het dialoogvenster toont "Checking those details with your provider..." en daarna een melding: "Single sign-on is configured. Use the sign-in link on the integration to let your people sign in with it."

8. Voer op het paneel, onder **Group mappings**, door komma's gescheiden groepsnamen in voor **Owner groups**, **Admin groups**, **Power user groups** en **User groups**, te beginnen met de owners.

> **Caution:** Zodra een groepsmapping is ingesteld, bepaalt de provider bij elke login de rollen en wordt iemand die op geen enkele groep matcht een User. Koppel eerst je owners.

## Wat je zou moeten zien

De tegel toont **Active** onder **Installed** en het paneel toont de **Redirect URI** en de **Sign-in link**: "Share this with your people to sign in through your provider. Opening it signs you in." Weigert het dialoogvenster, lees dan de reden: "That address answered, but not with an OpenID configuration." betekent dat de issuer niet de basis-URL is waaronder de provider zijn configuratie publiceert; "Could not reach that issuer." betekent dat hij niet bereikbaar is vanaf het internet; "The issuer needs to be a full URL, starting with https://." is een notatieprobleem; "An unexpected error occurred. Please check the details and try again. If the error persists, contact support." betekent dat het verzoek niet is aangekomen, dus probeer het opnieuw. **Reconnect** in het menu **...** opent het dialoogvenster opnieuw om er iets aan te wijzigen.

## Gerelateerd

- [Single sign-on](https://support.pyn.ai/nl/integrations/sso/) voor het koppelen van rollen en wat medewerkers zien.
- [Okta koppelen](https://support.pyn.ai/nl/integrations/sso/connect-okta/) voor de speciale Okta-integratie.
- [Users](https://support.pyn.ai/nl/settings/users/) voor de rollen waarnaar de groepslijsten verwijzen.
