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) | Le protocole lui-même, en HTTP brut et avec curl. À lire en premier : les autres guides s'appuient dessus. |
| Backend Node / Express | Une application web rendue côté serveur ou adossée à une API, en Node.js. |
| Backend Python / Flask | Une application web rendue côté serveur, en Python. |
| Application monopage React | Une application de navigateur sans backend propre. |
| Client Financial-grade API (FAPI 2.0) | Une application sous profil de sécurité FAPI 2.0 : private key JWT, pushed authorization requests, DPoP. |
| Protéger une API | 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.
Avant de commencer
-
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.
-
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.
-
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. -
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-configurationRemplacez
<your-domain>par le domaine de connexion de votre instance (votre domaine personnalisé si vous en avez un, sinon l'hôte de la plateforme). Ce document listeauthorization_endpoint,token_endpoint,userinfo_endpoint,jwks_urietend_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é.