---
title: Einen OpenID-Connect-Anbieter verbinden
description: Verbinde Keycloak, Microsoft Entra ID, Auth0, Ping Identity oder einen anderen OpenID-Connect-Anbieter, setze den Groups-Claim und ordne Gruppen Pyn-Rollen zu.
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
---

Dein Identitätsanbieter spricht OpenID Connect, und du willst, dass er Personen bei Pyn anmeldet und über ihre Rollen entscheidet. Die Integration Single Sign-On nimmt den Anbieter, seinen Issuer und einen Client mit dem Authorization-Code-Flow entgegen, prüft die OpenID-Konfiguration des Anbieters und zeigt die Redirect-URI und den Anmeldelink, die du brauchst.

## Bevor du beginnst

- Du bist Admin oder Owner in Pyn, und die Integration Single Sign-On ist für deinen Workspace aktiviert.
- Jemand kann in deinem Anbieter einen vertraulichen Client anlegen: „The client needs the standard authorization code flow and a client secret.“ Pyn fordert die Scopes `openid`, `profile` und `email` an; für die Rollenzuordnung braucht das ID-Token einen `groups`-Claim (Entra gibt `roles` aus), und jeder Scope, der ihn freischaltet, kommt in **Additional Scopes**.
- Du hast Issuer, Client-ID und Client-Secret. Für Keycloak brauchst du die **Keycloak Server URL** und den **Realm**; Pyn setzt den Issuer daraus zusammen.

![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)

## Schritte

1. Öffne in Pyn **Settings** in der linken Navigation, dann **Available** unter **Integrations**.

2. Wähle die Kachel **Single Sign-On**. Der Dialog **Connect single sign-on** öffnet sich.

3. Wähle den **Provider**: **Keycloak**, **Okta**, **Microsoft Entra ID**, **Auth0**, **Ping Identity** oder **Single Sign-On** für alles andere.

4. Bei Keycloak gib die **Keycloak Server URL** und den **Realm** ein; bei den anderen die **Issuer URL**.

5. Gib **Client ID** und **Client Secret** ein. Setze **Groups Claim**, wenn dein Anbieter einen anderen Namen als `groups` nutzt, und **Additional Scopes**, wenn er mehr als `openid profile email` braucht.

6. Kopiere die im Dialog gezeigte **Redirect URI**: „Add this as a valid redirect URI on the client in your provider, then come back and connect.“

7. Wähle **Connect**. Der Dialog zeigt „Checking those details with your provider...“ und dann einen Hinweis: „Single sign-on is configured. Use the sign-in link on the integration to let your people sign in with it.“

8. Gib auf dem Panel unter **Group mappings** kommagetrennte Gruppennamen für **Owner groups**, **Admin groups**, **Power user groups** und **User groups** ein, beginnend mit den Ownern.

> **Caution:** Sobald eine Gruppenzuordnung gesetzt ist, entscheidet der Anbieter bei jeder Anmeldung über die Rollen, und wer zu keiner Gruppe passt, wird User. Ordne zuerst deine Owner zu.

## Was du sehen solltest

Die Kachel zeigt **Active** unter **Installed**, und das Panel zeigt die **Redirect URI** und den **Sign-in link**: „Share this with your people to sign in through your provider. Opening it signs you in.“ Lehnt der Dialog ab, lies seinen Grund: „That address answered, but not with an OpenID configuration.“ heißt, der Issuer ist nicht die Basis-URL, unter der der Anbieter seine Konfiguration veröffentlicht; „Could not reach that issuer.“ heißt, er ist aus dem Internet nicht erreichbar; „The issuer needs to be a full URL, starting with https://.“ ist ein Formatproblem; „An unexpected error occurred. Please check the details and try again. If the error persists, contact support.“ heißt, die Anfrage ist nicht durchgegangen, also versuche es erneut. **Reconnect** im Menü **...** öffnet den Dialog erneut, damit du jede dieser Angaben ändern kannst.

## Verwandte Seiten

- [Single Sign-on](https://support.pyn.ai/de/integrations/sso/) für die Rollenzuordnung und was Mitarbeitende sehen.
- [Okta verbinden](https://support.pyn.ai/de/integrations/sso/connect-okta/) für die eigenständige Okta-Integration.
- [Users](https://support.pyn.ai/de/settings/users/) für die Rollen, auf die sich die Gruppenlisten beziehen.
