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. 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.
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
3. L'échange du code
Depuis son serveur (jamais depuis le navigateur), le service envoie le code et le verifier d'origine :
La réponse contient un jeton d'accès valable une heure :
4. Qui est la personne ?
Le service présente le jeton pour obtenir l'identité minimale, un identifiant et un pseudo :
Ce que ça apporte
- Le service ne voit jamais le mot de passe.
- Le service ne reçoit que le strict nécessaire, sans adresse e-mail.
- Le code expire vite ; sans le verifier, il est inutilisable.
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.
Mise à jour : novembre 2026.