# 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)](https://dts-identity.com/de/docs/quickstarts/oidc-authorization-code.md) | Das Protokoll selbst, mit reinem HTTP und curl. Lesen Sie diese Anleitung zuerst; die anderen bauen darauf auf. |
| [Node/Express-Backend](https://dts-identity.com/de/docs/quickstarts/node-express.md) | Eine servergerenderte oder API-gestützte Web-App in Node.js. |
| [Python/Flask-Backend](https://dts-identity.com/de/docs/quickstarts/python-flask.md) | Eine servergerenderte Web-App in Python. |
| [React-Single-Page-App](https://dts-identity.com/de/docs/quickstarts/react-spa.md) | Eine Browser-App ohne eigenes Backend. |
| [Financial-grade-API-Client (FAPI 2.0)](https://dts-identity.com/de/docs/quickstarts/fapi-2.md) | Eine Anwendung mit FAPI-2.0-Sicherheitsprofil: Private Key JWT, Pushed Authorization Requests, DPoP. |
| [Eine API schützen](https://dts-identity.com/de/docs/quickstarts/protect-an-api.md) | 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](https://dts-identity.com/de/docs/integrations/apis.md#call-the-management-api-machine-to-machine-quickstart).

## Bevor Sie beginnen [#before-you-start]

1. **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](https://dts-identity.com/de/docs/integrations/applications.md#choosing-an-oidc-type-by-deployment-shape).
2. **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.
3. **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.
4. **Kennen Sie Ihre Endpunkte.** Alles Folgende ist über das OpenID-Konfigurationsdokument Ihrer Instanz auffindbar:

   ```
   https://<your-domain>/.well-known/openid-configuration
   ```

   Ersetzen Sie `<your-domain>` durch die Login-Domain Ihrer Instanz (Ihre [Custom Domain](https://dts-identity.com/de/docs/branding/custom-domains.md), falls vorhanden, andernfalls den Plattform-Host). Dieses Dokument listet `authorization_endpoint`, `token_endpoint`, `userinfo_endpoint`, `jwks_uri` und `end_session_endpoint` auf. **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.
