- 4 nouvelles pages (sujets 7 a 10), menu et sommaire mis a jour, lien suivant de Mind. - Sous-traitants et durees repris de la politique de confidentialite publiee. - Points a verifier signales dans les pages (licences Inter/Comfortaa/Papicons, DPA, purge des comptes). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
80 lignes
4.5 KiB
HTML
80 lignes
4.5 KiB
HTML
<!doctype html>
|
|
<html lang="fr">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<meta name="color-scheme" content="light">
|
|
<title>Se connecter avec Gastinel · Documentation · Théo Gastinel</title>
|
|
<meta name="description" content="Comment fonctionne la connexion « Se connecter avec Gastinel » (OAuth 2, code d'autorisation avec PKCE), avec des exemples fictifs.">
|
|
<link rel="stylesheet" href="docu.css">
|
|
</head>
|
|
<body>
|
|
<header class="entete"><div class="barre">
|
|
<a class="marque" href="/">Théo Gastinel</a>
|
|
<nav><a href="./">Documentation</a><a href="architecture.html">Architecture</a><a href="roles.html">Rôles</a><a href="reseau.html">Réseau</a><a href="meteo.html">Météo</a><a href="mind.html">Mind</a><a href="sauvegardes.html">Sauvegardes</a><a href="donnees.html">Données</a><a href="connexion.html" aria-current="page">Connexion</a><a href="licences.html">Licences</a></nav>
|
|
</div></header>
|
|
<main>
|
|
<p class="surtitre">Documentation · Sujet 9</p>
|
|
<h1>Se connecter avec Gastinel</h1>
|
|
<p class="chapeau">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.</p>
|
|
<div class="encadre"><p>Pour l'instant, seuls mes propres services sont enregistrés auprès du Hub. L'inscription d'applications tierces n'est pas ouverte.</p></div>
|
|
|
|
<h2>Le déroulé en quatre temps</h2>
|
|
<div class="schema">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)</div>
|
|
|
|
<h2>1. La demande d'autorisation</h2>
|
|
<p>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.</p>
|
|
<div class="schema">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</div>
|
|
<p>Le paramètre <code>state</code> est une valeur aléatoire liée au navigateur : le service vérifie au retour qu'il retrouve la même.</p>
|
|
|
|
<h2>2. Le retour avec un code</h2>
|
|
<div class="schema">https://demo.exemple.test/retour?code=CODE_DE_DEMO&state=abc123</div>
|
|
|
|
<h2>3. L'échange du code</h2>
|
|
<p>Depuis son serveur (jamais depuis le navigateur), le service envoie le code et le verifier d'origine :</p>
|
|
<div class="schema">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</div>
|
|
<p>La réponse contient un jeton d'accès valable une heure :</p>
|
|
<div class="schema">{ "access_token": "JETON_DE_DEMO", "token_type": "Bearer", "expires_in": 3600 }</div>
|
|
|
|
<h2>4. Qui est la personne ?</h2>
|
|
<p>Le service présente le jeton pour obtenir l'identité minimale, un identifiant et un pseudo :</p>
|
|
<div class="schema">GET https://hub.exemple.test/oauth/moi
|
|
Authorization: Bearer JETON_DE_DEMO
|
|
|
|
{ "id": "00000000-0000-0000-0000-000000000000", "pseudo": "Marmotte" }</div>
|
|
|
|
<h2>Ce que ça apporte</h2>
|
|
<ul>
|
|
<li>Le service ne voit jamais le mot de passe.</li>
|
|
<li>Le service ne reçoit que le strict nécessaire, sans adresse e-mail.</li>
|
|
<li>Le code expire vite ; sans le verifier, il est inutilisable.</li>
|
|
</ul>
|
|
<p>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.</p>
|
|
<div class="suite"><a href="donnees.html">← Données, sous-traitants et durées</a><a href="licences.html">Licences et crédits →</a></div>
|
|
<p class="maj">Mise à jour : novembre 2026.</p>
|
|
</main>
|
|
<footer class="global-footer">
|
|
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
|
|
<div class="footer-bottom">© 2026 Théo Gastinel</div>
|
|
</footer>
|
|
</body>
|
|
</html>
|