Skip to Content

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 / ExpressUne application web rendue côté serveur ou adossée à une API, en Node.js.
Backend Python / FlaskUne application web rendue côté serveur, en Python.
Application monopage ReactUne 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 APIL'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

  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.

  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é 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 :

ObjectifChemin
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é.

Sur cette page