# Quickstarts

Uw eigen applicatie aansluiten voor aanmelding via OpenID Connect, met kopieerklare handleidingen voor de generieke flow, Node, Python en React.

Deze handleidingen zorgen dat een applicatie gebruikers via **OpenID Connect (OIDC)** door het platform laat aanmelden. Begin met de generieke flow om de afzonderlijke bouwstenen te begrijpen en spring dan naar de handleiding die bij uw stack past.

| Handleiding | Waarvoor u ze gebruikt |
|---|---|
| [OpenID Connect (Authorization Code + PKCE)](https://dts-identity.com/nl/docs/quickstarts/oidc-authorization-code.md) | Het protocol zelf, met kale HTTP en curl. Lees deze eerst; de andere bouwen erop voort. |
| [Node/Express-backend](https://dts-identity.com/nl/docs/quickstarts/node-express.md) | Een servergerenderde of door een API ondersteunde webapp in Node.js. |
| [Python/Flask-backend](https://dts-identity.com/nl/docs/quickstarts/python-flask.md) | Een servergerenderde webapp in Python. |
| [React single-page-app](https://dts-identity.com/nl/docs/quickstarts/react-spa.md) | Een browserapp zonder eigen backend. |
| [Financial-grade API-client (FAPI 2.0)](https://dts-identity.com/nl/docs/quickstarts/fapi-2.md) | Een applicatie met een FAPI 2.0-beveiligingsprofiel: private key JWT, pushed authorization requests, DPoP. |
| [Een API beschermen](https://dts-identity.com/nl/docs/quickstarts/protect-an-api.md) | De andere kant: de access tokens van het platform in uw eigen API valideren en scopes afdwingen. |

Om de **management-REST-API** van het platform vanuit een backendservice aan te roepen (geen gebruikersaanmelding), gebruikt u in plaats daarvan de machine-to-machine-quickstart onder [API's](https://dts-identity.com/nl/docs/integrations/apis.md#call-the-management-api-machine-to-machine-quickstart).

## Voordat u begint [#before-you-start]

1. **Registreer uw applicatie.** Voeg in de Admin Console een applicatie toe en kies het OIDC-type dat bij uw deployment past: een **confidential** client voor alles met een backend dat een secret geheim kan houden (Node/Express, Python/Flask), of een **public** client voor een single-page- of native app die dat niet kan. Zie [Applicaties](https://dts-identity.com/nl/docs/integrations/applications.md#choosing-an-oidc-type-by-deployment-shape).
2. **Noteer de aanmeldgegevens.** Een confidential client heeft een **client ID** en een **client secret**; een public client heeft alleen een **client ID** en steunt op PKCE. Bewaar het secret op de server, nooit in browsercode.
3. **Voeg uw redirect-URI toe.** Registreer de exacte URL waarnaar het platform de gebruiker na de aanmelding terugstuurt (bijvoorbeeld `https://app.example.com/callback`). Redirect-URI's worden teken voor teken vergeleken: schema, host, poort, pad en een afsluitende schuine streep moeten identiek zijn; jokertekens worden niet ondersteund.
4. **Ken uw eindpunten.** Alles hieronder is vindbaar via het OpenID-configuratiedocument van uw instantie:

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

   Vervang `<your-domain>` door het aanmelddomein van uw instantie (uw [aangepaste domein](https://dts-identity.com/nl/docs/branding/custom-domains.md) als u er een hebt, anders de host van het platform). Dit document noemt de `authorization_endpoint`, het `token_endpoint`, het `userinfo_endpoint`, de `jwks_uri` en het `end_session_endpoint`. **Behandel het discovery-document als de maatgevende bron** en laat uw bibliotheek het inlezen in plaats van paden hard te coderen.

## De eindpunten in één oogopslag

Ter oriëntatie de standaardpaden:

| Doel | Pad |
|---|---|
| Discovery | `/.well-known/openid-configuration` |
| Autorisatie | `/authorize` |
| Token | `/oauth/token` |
| UserInfo | `/userinfo` |
| Ondertekeningssleutels (JWKS) | `/.well-known/jwks` |
| Afmelden (end session) | `/logout` |

**PKCE** is vereist voor public clients en voor applicaties met een Financial-grade API-beveiligingsprofiel, en S256 is de enige geaccepteerde challenge-methode. Gebruik altijd authorization code met PKCE; de implicit flow wordt afgeraden.
