Théo Gastinel

Documentation · Sujet 9

Se connecter avec Gastinel

Mes services n'ont pas chacun leur mot de passe. Ils délèguent la connexion au Hub des comptes grâce à un échange standard : OAuth 2, code d'autorisation avec PKCE. Voici le déroulé, avec des valeurs inventées.

Pour l'instant, seuls mes propres services sont enregistrés auprès du Hub. L'inscription d'applications tierces n'est pas ouverte.

Le déroulé en quatre temps

1. Le service envoie la personne vers le Hub (/oauth/autoriser) 2. La personne se connecte et accepte 3. Le Hub la renvoie au service avec un code (valable 60 secondes) 4. Le service échange le code contre un jeton (/oauth/jeton) puis demande qui est la personne (/oauth/moi)

1. La demande d'autorisation

Le service prépare un secret aléatoire, le « verifier », et en calcule l'empreinte SHA-256, le « challenge ». Seul le challenge voyage dans le navigateur. Le Hub n'accepte que la méthode S256.

GET https://hub.exemple.test/oauth/autoriser ?response_type=code &client_id=service-demo &redirect_uri=https://demo.exemple.test/retour &state=abc123 &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM &code_challenge_method=S256

Le paramètre state est une valeur aléatoire liée au navigateur : le service vérifie au retour qu'il retrouve la même.

2. Le retour avec un code

https://demo.exemple.test/retour?code=CODE_DE_DEMO&state=abc123

3. L'échange du code

Depuis son serveur (jamais depuis le navigateur), le service envoie le code et le verifier d'origine :

POST https://hub.exemple.test/oauth/jeton Content-Type: application/x-www-form-urlencoded grant_type=authorization_code &code=CODE_DE_DEMO &redirect_uri=https://demo.exemple.test/retour &client_id=service-demo &client_secret=SECRET_DE_DEMO &code_verifier=VERIFIER_DE_DEMO

La réponse contient un jeton d'accès valable une heure :

{ "access_token": "JETON_DE_DEMO", "token_type": "Bearer", "expires_in": 3600 }

4. Qui est la personne ?

Le service présente le jeton pour obtenir l'identité minimale, un identifiant et un pseudo :

GET https://hub.exemple.test/oauth/moi Authorization: Bearer JETON_DE_DEMO { "id": "00000000-0000-0000-0000-000000000000", "pseudo": "Marmotte" }

Ce que ça apporte

Tous les noms de domaine, identifiants, secrets et jetons ci-dessus sont fictifs. Les noms des routes et des paramètres suivent le standard OAuth 2 et le fonctionnement actuel du Hub ; ils peuvent évoluer.

← Données, sous-traitants et duréesLicences et crédits →

Mise à jour : novembre 2026.