Fichiers
site-principal/docu/connexion.html
T
claudeetClaude Sonnet 5.5 b970ed75f5 docu : pages sauvegardes, donnees, connexion et licences (exemples fictifs)
- 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>
2026-11-13 05:56:38 +01:00

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
&amp;client_id=service-demo
&amp;redirect_uri=https://demo.exemple.test/retour
&amp;state=abc123
&amp;code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
&amp;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&amp;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
&amp;code=CODE_DE_DEMO
&amp;redirect_uri=https://demo.exemple.test/retour
&amp;client_id=service-demo
&amp;client_secret=SECRET_DE_DEMO
&amp;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>