Cours Vibe coding avec Claude Code · Module 9: Clone de Discord
Connexion : qui monte à bord
Dans cette leçon10
Ouvre dans Cursor lib/session.ts de la leçon 8_1. On y trouve const CURRENT_MEMBER_ID = "redbeard" : quiconque ouvre Pirate's Cove est donc capitaine. Les rôles de la leçon 8_3 disent ce que chacun a le droit de faire, mais l'appli ne sait toujours pas qui se trouve de l'autre côté de l'écran. Établir qui est l'utilisateur, c'est l'authentification, donc la connexion. Vérifier ce qu'il a le droit de faire, c'est l'autorisation, que tu as déjà. Dans cette leçon, Claude Code ajoute une vraie connexion, et toi, tu vérifies que la serrure se trouve vraiment sur le serveur.
Ce que tu vas apprendre
- choisir une bibliothèque de connexion d'après la documentation actuelle, et non un vieux tutoriel ;
- demander la connexion avec un plan et un secret que Claude ne verra jamais ;
- vérifier la session sur le serveur, dans les pages et dans les routes d'API ;
- reconnaître l'erreur typique de l'agent : la serrure seulement dans le composant.
La bibliothèque : Better Auth
Un système de mots de passe maison se rate facilement ; c'est pourquoi la documentation de Next.js renvoie vers des bibliothèques toutes faites, entre autres Auth0, Better Auth, Clerk et NextAuth.js. Le projet Auth.js, c'est-à-dire l'ancien NextAuth.js, fait aujourd'hui partie de Better Auth, et ses mainteneurs recommandent Better Auth aux nouveaux projets. Pirate's Cove prend cette voie : connexion par e-mail et mot de passe avec une base SQLite dans un seul fichier, donc tout tourne sur ton ordinateur sans compte sur un service externe.
Dans les tutoriels plus anciens, tu croiseras NextAuth.js : npm install next-auth installe la version stable 4 avec la fonction getServerSession. Auth.js en version 5, avec une seule fonction auth() dans le fichier auth.ts, est toujours marqué bêta. Ces tutoriels protègent les pages avec un fichier middleware.ts, qui s'appelle proxy.ts dans Next.js 16. Quand l'agent propose l'un de ces schémas, demande-lui de quelle documentation il l'a tiré.
Demande pour Claude Code
La connexion touche beaucoup de fichiers : tu la construis donc sur une branche à part, connexion, comme dans la leçon 2_9, et tu commences par un plan, comme dans la leçon 8_1.
Demande pour Claude Code :
/plan Ajoute la connexion par e-mail et mot de passe avec Better Auth
(better-auth et better-sqlite3), base dans le fichier sqlite.db, d'après
la documentation better-auth.com/docs/integrations/next. Configuration
dans lib/auth.ts, route app/api/auth/[...all]/route.ts, client dans
lib/auth-client.ts, page app/sign-in/page.tsx. getCurrentMember() de
@lib/session.ts doit lire la vraie session sur le serveur et relier le
compte au membre par l'adresse e-mail (lib/crew-accounts.ts). Sans
session, les routes de app/api renvoient 401 et les pages redirigent
vers /sign-in. Ne crée pas .env.local et ne le lis pas, je le remplirai
moi-même. Prépare .env.example avec les seuls noms des variables.
À la fin : tests, lint, types et build.Dans le plan, vérifie trois choses : sqlite.db va-t-il dans .gitignore, qui écrira le secret, et chaque route de app/api figure-t-elle dans la liste des modifications.
La règle de la leçon 8_4 fonctionne
La première tentative de créer .env.example s'est terminée chez nous par un refus : File is covered by a Read deny rule in your permission settings and cannot be written.. Le motif Read(./.env.*) couvre aussi le fichier qui ne contient que des noms, et une règle Read bloque aussi l'écriture. La documentation permet de découper une exception avec un motif précédé d'un point d'exclamation, qui agit comme dans .gitignore :
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)", "Read(!.env.example)"]
}
}L'exception n'agit que sur les règles listées avant elle dans le même fichier. Après ce changement, Write a créé .env.example, et la lecture de .env.local recevait toujours un refus. Le même piège se cache dans Git : git check-ignore -v .env.example a affiché chez nous .gitignore:34:.env*, donc le motif de create-next-app cache aussi .env.example. Claude a ajouté à .gitignore la ligne !.env.example.
Le secret que tu écris toi-même
Better Auth a besoin de deux variables. D'après la documentation, BETTER_AUTH_SECRET sert au chiffrement et au hachage, doit compter au moins 32 caractères et être très aléatoire, et tu le génères avec la commande :
openssl rand -base64 32Lance-la dans un autre onglet du terminal de Cursor, pas par ! dans la session de Claude : la documentation de Claude Code dit que le résultat d'une commande lancée avec ! entre dans la conversation. BETTER_AUTH_URL est l'adresse de l'appli, en local http://localhost:3000. Tu écris les deux dans .env.local, et .env.example ne montre que les noms.
Ce que Claude a écrit : l'instance auth
Ouvre lib/auth.ts :
import Database from "better-sqlite3";
import { betterAuth } from "better-auth";
export const auth = betterAuth({
database: new Database("./sqlite.db"),
emailAndPassword: {
enabled: true,
},
});betterAuth crée un seul objet qui gère l'inscription, la connexion et les sessions. better-sqlite3 est le pilote SQLite recommandé dans la documentation de Better Auth, et toute la base est le fichier sqlite.db dans le dossier du projet. Les tables ont été créées par la commande npx auth@latest migrate --yes, qui a signalé chez nous les tables user, session, account et verification. Le mot de passe n'arrive pas dans la base en clair : chez nous, dans la table account, il y avait à sa place une longue suite de chiffres hexadécimaux, c'est-à-dire son empreinte.
Claude Code lance des commandes comme npm install ou cette migration avec ton accord, et en mode auto sans demander. C'est pourquoi tu lis git diff avant le commit : dans package.json sont arrivés chez nous better-auth, better-sqlite3 et @types/better-sqlite3.
La route de la documentation tient en trois lignes et gère toutes les adresses sous /api/auth :
import { toNextJsHandler } from "better-auth/next-js";
import { auth } from "@/lib/auth";
export const { GET, POST } = toNextJsHandler(auth);lib/auth-client.ts crée le client avec createAuthClient() de better-auth/react. La page /sign-in appelle authClient.signIn.email ou authClient.signUp.email et, en cas de succès, passe au panneau des rôles.
Ce que Claude a écrit : la session sur le serveur
Le changement le plus important se trouve dans lib/session.ts :
export async function getCurrentMember(): Promise<Member | null> {
const session = await auth.api.getSession({ headers: await headers() });
if (!session) return null;
const memberId = crewAccounts.get(session.user.email);
return memberId ? (findMember(mainServer, memberId) ?? null) : null;
}headers() de next/headers donne les en-têtes de la requête en cours, dont le cookie de session, et auth.api.getSession les vérifie dans la base. Sans session valide, la fonction renvoie null. Le compte est relié au membre du serveur par la table des adresses dans lib/crew-accounts.ts : par exemple, anne@pirates-cove.test est anne.
Le type Member | null travaille tout de suite pour toi. npx tsc --noEmit a désigné chez nous 11 endroits dans 6 fichiers qui supposaient que le membre existe toujours, par exemple Argument of type 'Member | null' is not assignable to parameter of type 'Member'. Chaque route a reçu une serrure au début :
const me = await getCurrentMember();
if (!me) {
return Response.json({ error: "Connecte-toi" }, { status: 401 });
}Le code 401 signifie "je ne sais pas qui tu es", et le 403 de la leçon 8_3 "je sais, mais tu n'en as pas le droit". Les pages, dont le panneau des rôles, font ici redirect("/sign-in"), et le test de la route d'expulsion a reçu le cas "sans session, 401".
Discord comme deuxième porte
Discord s'ajoute par la seule configuration dans lib/auth.ts, quand tu le voudras :
socialProviders: {
discord: {
clientId: process.env.DISCORD_CLIENT_ID as string,
clientSecret: process.env.DISCORD_CLIENT_SECRET as string,
},
},D'après la documentation de Better Auth, tu enregistres dans le Discord Developer Portal l'adresse de retour http://localhost:3000/api/auth/callback/discord, et en production la même adresse avec ton domaine. Sans ces variables, le build a affiché chez nous l'avertissement Social provider discord is missing clientId or clientSecret.
La revue du capitaine
- Les secrets hors de Git. Avant la correction de
.gitignore, la commandegit status --shorta montré chez nous?? sqlite.db. Ce fichier contient les comptes et les sessions : il ne doit pas entrer dans le dépôt. Après la correction,git statusne montre ni la base ni.env.local. - L'entrée directe sans session. Ouvre le panneau des rôles dans une fenêtre privée. Chez nous,
curl -isur cette adresse a donné307aveclocation: /sign-in, un cookie avec un jeton falsifié aussi, etPOST /api/members/blackbeard/kicksans cookie a reçu401et{"error":"Connecte-toi"}. - Les rôles après connexion. Anne, officière sans
MANAGE_ROLES, a reçu un 404 sur le panneau des rôles, et sa tentative d'expulser le capitaine s'est terminée par un 403. Le capitaine a vu le panneau et a expulsé Blackbeard. - Erreur typique de l'agent : la serrure seulement dans le composant. Nous l'avons testée sur la liste de l'équipage avec les adresses e-mail, que l'agent a ajoutée au panneau des rôles. Un Client Component cachait la liste quand
authClient.useSession()n'avait pas de session, mais les données venaient d'une nouvelle route/api/crew, qui ne vérifiait pas la session. À l'écran, tout avait l'air bon, etcurlsans cookie a reçu de cette route200et les adresses de tout l'équipage. La documentation de Next.js demande de traiter chaque route d'API comme un point d'accès public, et Better Auth rappelle qu'il faut vérifier la session sur le serveur pour chaque page et chaque action protégée.
Pour finir, les tests, npm run lint, npx tsc --noEmit après npx next typegen et npm run build. Les étapes dans le navigateur, tu les vérifies en direct : inscription, connexion et entrée sur le panneau sans session.
Étape suivante
Demande un commit, par exemple "Connexion Better Auth, session sur le serveur, 401 dans les routes". Pirate's Cove a maintenant tout ce que prévoit la carte de cette location, construit dans cet ordre : le modèle du serveur avec ses canaux, le canal vocal avec son statut, les rôles avec la serrure dans les routes, la météo avec la clé dans la cale et la connexion. Si, dans ton projet, une liste semblable ou une autre route sans serrure est apparue, note-la, mais ne la corrige pas encore : dans la prochaine leçon, tu verras si la revue de sécurité la trouve toute seule.
Dans l'éditeur ci-dessous t'attend une simulation du port avec connexion : entre dans le panneau sans session, connecte-toi en tant que différents pirates et active l'erreur de l'agent où la liste de l'équipage n'a de serrure qu'à l'écran.
Retiens : le garde à la passerelle demande son nom à chacun, tandis que le garde peint sur la porte a seulement bonne mine.
Code de cette leçon : App.jsx
// Port avec connexion : cookie de session, getCurrentMember() et deux routes sur un faux serveur.
// Les mots de passe et les comptes sont inventés ; rien ne sort sur le réseau.
import { useState } from 'react';
const crew = [
{ email: 'redbeard@pirates-cove.test', memberId: 'redbeard', name: 'Capitaine Barbe-Rousse', canManageRoles: true },
{ email: 'anne@pirates-cove.test', memberId: 'anne', name: 'Anne Bonny (Officier)', canManageRoles: false },
{ email: 'jack@pirates-cove.test', memberId: 'jack', name: 'Jack Rackham (Équipage)', canManageRoles: false },
];
// Serveur : sessions dans la « base » et getCurrentMember comme dans lib/session.ts.
const sessions = new Map();
function getCurrentMember(cookie) {
const email = cookie ? sessions.get(cookie) : undefined;
if (!email) return null;
return crew.find((c) => c.email === email) ?? null;
}
function rolesPage(cookie) {
const me = getCurrentMember(cookie);
if (!me) return { status: 307, body: 'location: /sign-in' };
if (!me.canManageRoles) return { status: 404, body: 'Page introuvable' };
return { status: 200, body: 'Panneau des rôles pour : ' + me.name };
}
function crewRoute(cookie, buggy) {
if (!buggy && !getCurrentMember(cookie)) {
return { status: 401, body: JSON.stringify({ error: 'Connecte-toi' }) };
}
return { status: 200, body: JSON.stringify(crew.map((c) => c.email)) };
}
export default function App() {
const [cookie, setCookie] = useState(null);
const [buggy, setBuggy] = useState(true);
const [answers, setAnswers] = useState([]);
function signIn(email) {
const token = 'session-' + email.split('@')[0];
sessions.set(token, email);
setCookie(token);
}
function request(label, res) {
setAnswers((prev) => [label + ' → ' + res.status + ' ' + res.body, ...prev].slice(0, 6));
}
const me = getCurrentMember(cookie);
const screenCrew = me ? JSON.parse(crewRoute(cookie, buggy).body) : null;
return (
<div className="min-h-screen space-y-4 bg-slate-100 p-4 font-sans text-slate-900">
<section className="space-y-2 rounded-lg bg-slate-800 p-4 text-slate-100">
<h1 className="font-bold">Monter à bord</h1>
<p className="text-sm">Connecté : {me ? me.name : 'personne'} {cookie ? '(cookie : ' + cookie + ')' : ''}</p>
<div className="flex flex-wrap gap-2">
{crew.map((c) => (
<button key={c.email} onClick={() => signIn(c.email)} className="rounded bg-indigo-600 px-3 py-1 text-sm">Connexion : {c.memberId}</button>
))}
<button onClick={() => setCookie(null)} className="rounded border border-slate-400 px-3 py-1 text-sm">Déconnexion</button>
</div>
</section>
<section className="rounded-lg border border-slate-300 bg-white p-3">
<h2 className="font-bold">Écran : liste de l'équipage sur le panneau</h2>
<p className="text-xs text-slate-500">Le composant cache la liste quand useSession() n'a pas de session.</p>
{screenCrew ? (
<ul className="mt-2 list-disc pl-5 text-sm">{screenCrew.map((e) => <li key={e}>{e}</li>)}</ul>
) : (
<p className="mt-2 text-sm italic">Liste cachée.</p>
)}
</section>
<label className="flex items-center gap-2 text-sm">
<input type="checkbox" checked={buggy} onChange={(e) => setBuggy(e.target.checked)} />
Erreur de l'agent : /api/crew ne vérifie pas la session, la serrure n'est que dans le composant
</label>
<section className="space-y-2 rounded-lg border border-slate-300 bg-white p-3">
<h2 className="font-bold">Requêtes directement au serveur</h2>
<div className="flex flex-wrap gap-2 text-sm">
<button onClick={() => request('GET /servers/black-pearl/settings/roles', rolesPage(cookie))} className="rounded bg-slate-700 px-3 py-1 text-white">Ouvrir le panneau des rôles</button>
<button onClick={() => request('curl /api/crew (sans cookie)', crewRoute(null, buggy))} className="rounded bg-red-600 px-3 py-1 text-white">curl /api/crew sans cookie</button>
<button onClick={() => request('GET /servers/... avec un cookie falsifié', rolesPage('falsifie'))} className="rounded bg-slate-700 px-3 py-1 text-white">Cookie falsifié</button>
</div>
<ul className="space-y-1 font-mono text-xs">{answers.map((a, i) => <li key={i}>{a}</li>)}</ul>
</section>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Comment getCurrentMember() de lib/session.ts établit-il, après la leçon sur la connexion, qui est connecté ?
2. Que se passe-t-il quand quelqu'un sans session ouvre l'adresse du panneau des rôles ?
Tâches pratiques dans le jeu
- Tri horizontal
Ordonne la lecture de l'adresse du pirate connecté : session.user.email
- Clique dans l'ordre
Clique pour construire la récupération de la session sur le serveur : await auth.api.getSession({ headers: await headers() })
- Tri vertical
Ordonne la façon dont la Crique du Pirate a été construite dans cette location :