Quickstarts
Eigene Anwendung per OpenID Connect anbinden, mit Copy-Paste-Anleitungen für den generischen Flow, Node, Python und React.
Diese Anleitungen bringen eine Anwendung dazu, Benutzer über OpenID Connect (OIDC) durch die Plattform anzumelden. Beginnen Sie mit dem generischen Flow, um die einzelnen Bausteine zu verstehen, und wechseln Sie dann zu der Anleitung, die zu Ihrem Stack passt.
| Anleitung | Einsatzzweck |
|---|---|
| OpenID Connect (Authorization Code + PKCE) | Das Protokoll selbst, mit reinem HTTP und curl. Lesen Sie diese Anleitung zuerst; die anderen bauen darauf auf. |
| Node/Express-Backend | Eine servergerenderte oder API-gestützte Web-App in Node.js. |
| Python/Flask-Backend | Eine servergerenderte Web-App in Python. |
| React-Single-Page-App | Eine Browser-App ohne eigenes Backend. |
| Financial-grade-API-Client (FAPI 2.0) | Eine Anwendung mit FAPI-2.0-Sicherheitsprofil: Private Key JWT, Pushed Authorization Requests, DPoP. |
| Eine API schützen | Die andere Seite: die Access Token der Plattform in der eigenen API validieren und Scopes durchsetzen. |
Um die Management-REST-API der Plattform aus einem Backend-Dienst aufzurufen (keine Benutzeranmeldung), nutzen Sie stattdessen den Machine-to-Machine-Quickstart unter APIs.
Bevor Sie beginnen
-
Registrieren Sie Ihre Anwendung. Fügen Sie in der Admin Console eine Anwendung hinzu und wählen Sie den OIDC-Typ, der zu Ihrem Deployment passt: einen Confidential Client für alles mit einem Backend, das ein Secret geheim halten kann (Node/Express, Python/Flask), oder einen Public Client für eine Single-Page- oder native App, die das nicht kann. Siehe Anwendungen.
-
Notieren Sie die Zugangsdaten. Ein Confidential Client hat eine Client-ID und ein Client-Secret; ein Public Client hat nur eine Client-ID und stützt sich auf PKCE. Bewahren Sie das Secret auf dem Server auf, niemals im Browser-Code.
-
Fügen Sie Ihre Redirect-URI hinzu. Registrieren Sie die exakte URL, an die die Plattform den Benutzer nach der Anmeldung zurückleitet (zum Beispiel
https://app.example.com/callback). Redirect-URIs werden Zeichen für Zeichen verglichen: Schema, Host, Port, Pfad und abschließender Schrägstrich müssen identisch sein; Wildcards werden nicht unterstützt. -
Kennen Sie Ihre Endpunkte. Alles Folgende ist über das OpenID-Konfigurationsdokument Ihrer Instanz auffindbar:
https://<your-domain>/.well-known/openid-configurationErsetzen Sie
<your-domain>durch die Login-Domain Ihrer Instanz (Ihre Custom Domain, falls vorhanden, andernfalls den Plattform-Host). Dieses Dokument listetauthorization_endpoint,token_endpoint,userinfo_endpoint,jwks_uriundend_session_endpointauf. Behandeln Sie das Discovery-Dokument als maßgebliche Quelle und lassen Sie Ihre Bibliothek es einlesen, statt Pfade fest zu codieren.
Die Endpunkte im Überblick
Zur Orientierung die Standardpfade:
| Zweck | Pfad |
|---|---|
| Discovery | /.well-known/openid-configuration |
| Autorisierung | /authorize |
| Token | /oauth/token |
| UserInfo | /userinfo |
| Signaturschlüssel (JWKS) | /.well-known/jwks |
| Abmeldung (End Session) | /logout |
PKCE ist für Public Clients und für Anwendungen mit einem Financial-grade-API-Sicherheitsprofil erforderlich, und S256 ist die einzige akzeptierte Challenge-Methode. Verwenden Sie immer Authorization Code mit PKCE; der Implicit Flow wird nicht empfohlen.