# Quickstarts

Connectez votre application pour la connexion via OpenID Connect, avec des guides prêts à copier pour le flux générique, Node, Python et React.

Ces guides permettent à une application de connecter ses utilisateurs au travers de la plateforme via **OpenID Connect (OIDC)**. Commencez par le flux générique pour comprendre les différentes pièces, puis passez au guide correspondant à votre stack.

| Guide | À utiliser pour |
|---|---|
| [OpenID Connect (Authorization Code + PKCE)](https://dts-identity.com/fr/docs/quickstarts/oidc-authorization-code.md) | Le protocole lui-même, en HTTP brut et avec curl. À lire en premier : les autres guides s'appuient dessus. |
| [Backend Node / Express](https://dts-identity.com/fr/docs/quickstarts/node-express.md) | Une application web rendue côté serveur ou adossée à une API, en Node.js. |
| [Backend Python / Flask](https://dts-identity.com/fr/docs/quickstarts/python-flask.md) | Une application web rendue côté serveur, en Python. |
| [Application monopage React](https://dts-identity.com/fr/docs/quickstarts/react-spa.md) | Une application de navigateur sans backend propre. |
| [Client Financial-grade API (FAPI 2.0)](https://dts-identity.com/fr/docs/quickstarts/fapi-2.md) | Une application sous profil de sécurité FAPI 2.0 : private key JWT, pushed authorization requests, DPoP. |
| [Protéger une API](https://dts-identity.com/fr/docs/quickstarts/protect-an-api.md) | L'autre côté : valider les access tokens de la plateforme dans votre propre API et appliquer les scopes. |

Pour appeler l'**API REST de gestion** de la plateforme depuis un service backend (sans connexion d'utilisateur), reportez-vous plutôt au quickstart machine-to-machine sous [API](https://dts-identity.com/fr/docs/integrations/apis.md#call-the-management-api-machine-to-machine-quickstart).

## Avant de commencer [#before-you-start]

1. **Enregistrez votre application.** Dans l'Admin Console, ajoutez une application et choisissez le type OIDC correspondant à votre déploiement : un client **confidentiel** pour tout ce qui dispose d'un backend capable de garder un secret (Node/Express, Python/Flask), ou un client **public** pour une application monopage ou native qui ne le peut pas. Voir [Applications](https://dts-identity.com/fr/docs/integrations/applications.md#choosing-an-oidc-type-by-deployment-shape).
2. **Notez les identifiants.** Un client confidentiel possède un **client ID** et un **client secret** ; un client public ne possède qu'un **client ID** et s'appuie sur PKCE. Gardez le secret sur le serveur, jamais dans le code du navigateur.
3. **Ajoutez votre redirect URI.** Enregistrez l'URL exacte vers laquelle la plateforme renvoie l'utilisateur après la connexion (par exemple `https://app.example.com/callback`). Les redirect URI sont comparées caractère par caractère : le schéma, l'hôte, le port, le chemin et la barre oblique finale doivent être identiques ; les jokers ne sont pas pris en charge.
4. **Connaissez vos endpoints.** Tout ce qui suit est découvrable dans le document de configuration OpenID de votre instance :

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

   Remplacez `<your-domain>` par le domaine de connexion de votre instance (votre [domaine personnalisé](https://dts-identity.com/fr/docs/branding/custom-domains.md) si vous en avez un, sinon l'hôte de la plateforme). Ce document liste `authorization_endpoint`, `token_endpoint`, `userinfo_endpoint`, `jwks_uri` et `end_session_endpoint`. **Traitez le document de discovery comme la source de vérité** et laissez votre bibliothèque le lire, plutôt que de coder les chemins en dur.

## Les endpoints en un coup d'œil

À titre de repère, voici les chemins standard :

| Objectif | Chemin |
|---|---|
| Discovery | `/.well-known/openid-configuration` |
| Autorisation | `/authorize` |
| Token | `/oauth/token` |
| UserInfo | `/userinfo` |
| Clés de signature (JWKS) | `/.well-known/jwks` |
| Déconnexion (end session) | `/logout` |

**PKCE** est exigé pour les clients publics et pour les applications sous profil de sécurité Financial-grade API, et S256 est la seule méthode de challenge acceptée. Utilisez toujours Authorization Code avec PKCE ; le flux implicite n'est pas recommandé.
