Cours Vibe coding avec Claude Code · Module 9: Clone de Discord

La revue du capitaine : la sécurité du code écrit par Claude

9 min de lecture
Dans cette leçon10

La branche connexion fonctionne. Tu t'inscris, tu te connectes, Anne n'entre pas dans le panneau des rôles, et Blackbeard est expulsé du serveur. Dans le navigateur, tout concorde. Seulement, le navigateur montre ce que l'appli fait pour un pirate honnête, et non ce qu'elle fera pour celui qui envoie une requête en contournant l'écran. Dans cette location, Claude a écrit les permissions, les routes de modération, la clé de la météo et la connexion, c'est-à-dire exactement le code où une erreur n'abîme pas l'apparence mais ouvre la cale. Avant que la branche aille plus loin, elle passe une revue de sécurité.

Ce que tu vas apprendre

  • lancer /security-review sur une branche et savoir ce que cette revue lit et ce qu'elle ne lit pas ;
  • distinguer une alerte juste d'une fausse et vérifier chacune toi-même ;
  • demander la correction des seuls points que tu acceptes, et annuler un changement qui est allé trop loin ;
  • distinguer la revue de code des règles deny et des modes de permissions.

Ce que lit /security-review

D'après la documentation de Claude Code, /security-review analyse les changements de la branche courante à la recherche de vulnérabilités. Elle compare la branche à la branche par défaut du dépôt distant origin et cherche des risques comme les injections, les erreurs d'authentification et les fuites de données. Elle lit le code source dans ton dossier, et non le site en marche. Elle ne couvre que les changements de la branche : le code qui était déjà sur main reste hors de la revue. Pour faire examiner un dossier précis, tu le demandes à Claude par une demande ordinaire.

La commande a besoin du dépôt distant origin. Si la revue se termine par une erreur contenant les mots ambiguous argument, la documentation demande d'indiquer la branche par défaut :

git remote set-head origin main

Cette commande note seulement quelle branche d'origin est la branche par défaut. Elle n'envoie rien et ne modifie pas tes fichiers.

La revue sur la branche connexion

D'abord un commit, pour que la revue voie tout le code de la branche et que tu aies un point de retour. Puis, dans la session de Claude Code :

/security-review

La revue dure quelques minutes. Chez nous, Claude a annoncé trois étapes : un agent cherche des candidats dans le diff de la branche, plusieurs agents écartent en parallèle les fausses alertes, et à la fin naît un rapport. La première étape a trouvé deux candidats, et un seul est entré dans le rapport, rédigé en anglais. Il commençait ainsi :

# Vuln 1: Privilege escalation via open sign-up and email-keyed member mapping: `lib/session.ts:11`
* Severity: High
* Category: `authorization_bypass` / `privilege_escalation`
* Confidence: 0.9

Sous l'en-tête se trouvaient la description, le scénario d'attaque et une recommandation. En bref : l'inscription est ouverte et ne vérifie pas la boîte mail, et getCurrentMember() relie le compte au membre par la seule adresse. Celui qui inscrit le premier redbeard@pirates-cove.test devient propriétaire du serveur avec tous les droits. Le rapport conseillait de fermer l'inscription (disableSignUp) et de créer les comptes de l'équipage en dehors de la page, ou d'exiger la confirmation de l'adresse (requireEmailVerification).

Alerte juste ou fausse

Le rapport est un compte rendu d'éclaireur, pas un verdict. Chaque signalement, tu le vérifies comme le rapport sur les routes dans la leçon 8_3 : tu ouvres dans Cursor le fichier indiqué, tu lis la ligne et tu essaies de reproduire l'attaque.

Cette alerte est juste, et la preuve est facile à obtenir : le compte jack@pirates-cove.test a été créé chez nous par une simple requête curl, sans aucune boîte mail, et a reçu aussitôt un cookie de session. Chaque adresse de lib/crew-accounts.ts que personne n'a encore prise attend donc le premier venu.

Une fausse alerte a un autre visage : le signalement décrit une ligne qui n'existe pas dans le fichier, ou une attaque dont un autre morceau de code ferme le chemin, par exemple une serrure dans la route que la revue n'a pas remarquée. Alors tu notes ce qui te l'a fait rejeter et tu ne demandes pas de correction.

Le rapport n'est pas non plus une liste complète. Le deuxième candidat était la liste de l'équipage de la leçon 8_5, qui rend les adresses sans session. Chez nous, la trace de l'exécution a montré que l'agent vérificateur l'avait notée TRUE POSITIVE (low-impact), confidence 6/10, et ce signalement n'est pas entré dans le rapport final. Pour ton équipage, c'est quand même une faille, car les adresses des gens ne doivent pas traîner en public. Le rapport dit de quoi la revue est sûre, et ce qui est une faille dans ton projet, c'est toi qui le décides.

Corriger seulement ce que tu acceptes

Tu n'écris pas "corrige tout". Tu désignes les points que tu as vérifiés et tu exiges une preuve. Chez nous, le premier était le point sur la liste de l'équipage, et toi, tu écris un point de ton rapport :

Demande pour Claude Code :

Corrige seulement le point sur /api/crew de la revue de sécurité : la route
doit vérifier la session par getCurrentMember() de @lib/session.ts et
renvoyer 401 sans session. Ajoute un test dans app/api/crew/route.test.ts :
une requête sans session reçoit 401, un membre connecté reçoit la liste.
Ne touche pas aux autres fichiers. À la fin : tests, lint et un curl sur
/api/crew sans cookie.

Dans Cursor, tu ouvres Source Control et tu lis le diff : le changement doit concerner une route et un nouveau test. Chez nous, le test sans la correction est tombé avec AssertionError: expected 200 to be 401, et avec la correction les 21 tests sont passés. curl sans cookie a reçu 401 et {"error":"Connecte-toi"}.

Le point du rapport, tu le corriges par une deuxième demande, séparée, car il concerne un autre fichier :

Demande pour Claude Code :

Corrige Vuln 1 de la revue de sécurité : dans @lib/auth.ts mets
disableSignUp: true et supprime le bouton Créer un compte de
app/sign-in/page.tsx. Laisse lib/session.ts tel quel. À la fin : curl sur
l'inscription et sur la connexion avec un compte existant.

Crée les comptes de l'équipage dont tu as besoin avant ce changement. Chez nous, l'inscription a ensuite répondu 400 avec {"message":"Email and password sign up is not enabled","code":"EMAIL_PASSWORD_SIGN_UP_DISABLED"}, et Anne s'est connectée comme avant. Avant le déploiement, reste la question de qui crée les comptes sur une base vide. Le rapport conseillait un script ou un plugin d'administrateur, et de relier le membre à l'identifiant du compte plutôt qu'à l'adresse : c'est une tâche à part, que tu commenceras par /plan.

/code-review : un second regard

/security-review cherche des failles, et /code-review de la leçon 2_9 cherche des erreurs de fonctionnement. La revue tourne en arrière-plan comme un agent à part avec son propre contexte et, sans --fix, elle ne fait que rapporter. Sur la branche de connexion, lance-la après les corrections, car une correction de sécurité peut aussi être fausse. La décision de ce qu'il faut corriger, c'est quand même toi qui la prends.

L'agent a trop corrigé

Il arrive qu'après "corrige le point sur /api/crew", Claude réécrive au passage lib/session.ts, change les routes de modération et ajoute une nouvelle dépendance. Le diff grossit, et tu ne sais plus ce qui marche encore. Tu reviens alors par le filet de la leçon 0_6. Deux fois Esc avec un champ vide, ou /rewind, ouvre la liste de tes demandes. Tu choisis la demande avec la correction et Restore code : les fichiers modifiés par les outils de Claude reviennent à l'état d'avant cette demande, et la conversation reste.

La documentation cite deux limites. Un fichier modifié uniquement par des commandes Bash n'est pas suivi. Les changements d'un sous-agent en arrière-plan, par exemple /code-review --fix, dans des fichiers que Claude n'avait pas touchés plus tôt dans cette conversation, restent aussi. Ces fichiers-là, tu les restaures depuis le dernier commit dans Git. Ensuite tu donnes une demande plus étroite avec la liste des fichiers qu'il est permis de modifier.

Les verrous ne sont pas une revue

La règle deny de la leçon 8_4 interdit à Claude de lire .env.local. Le mode auto a un classificateur qui, d'après la documentation, bloque entre autres l'envoi de données sensibles vers des adresses externes, les déploiements en production et la suppression d'un test qui garde la sécurité. Les deux mécanismes surveillent ce que l'agent fait dans ton système. Aucun des deux ne lit la route /api/crew ni ne remarque qu'elle rend les adresses à tout le monde. Une faille dans la logique, c'est la revue de code qui la trouve : la tienne, /security-review et les tests.

La revue du capitaine

  1. Chaque signalement vérifié. Pour chaque point du rapport, tu as le fichier, la ligne et ta propre preuve : un curl, un test ou du code lu.
  2. Une correction avec un test. Chaque point accepté reçoit un test qui tombe sans la correction.
  3. Un diff dans ses limites. La correction ne change que les fichiers de la demande ; le reste revient par /rewind ou par Git.
  4. Un deuxième passage. Après les corrections, /security-review encore une fois, et /code-review.

Étape suivante

Demande un commit, par exemple "Corrections de la revue de sécurité : liste de l'équipage derrière la serrure, inscription fermée". À ton mentor, tu enverras une capture du serveur en marche, le résultat de /security-review et une phrase sur ce que tu as corrigé après la revue.

Dans l'éditeur ci-dessous t'attend un rapport de revue à désamorcer : évalue chaque signalement, vérifie-le par une requête vers un faux serveur et vois ce qui reste après /rewind.

Retiens : le garde à la passerelle et le garde dans la cale sont deux gardes différents, et la revue est le capitaine qui contrôle les deux chaque soir.

Code de cette leçon : App.jsx
// Désamorçage d'un rapport de revue de sécurité sur un faux serveur Pirate's Cove.
// Les signalements 1 et 2 résument notre vraie exécution de /security-review, le 3 est un exercice.
import { useState } from 'react';

const findings = [
  {
    id: 1,
    title: 'Inscription ouverte : le membre est choisi par la seule adresse e-mail',
    source: 'rapport final, High',
    file: 'lib/session.ts:11',
    truth: true,
    check: 'curl -X POST /api/auth/sign-up/email {"email":"mary@pirates-cove.test"}',
    answer: (fixed) => fixed
      ? '400 {"code":"EMAIL_PASSWORD_SIGN_UP_DISABLED"}'
      : "200 + cookie de session. La nouvelle « Mary » a les droits d'officier.",
  },
  {
    id: 2,
    title: "/api/crew rend les adresses de l'équipage sans session",
    source: 'candidat écarté par le filtre (6/10)',
    file: 'app/api/crew/route.ts:4',
    truth: true,
    check: 'curl /api/crew (sans cookie)',
    answer: (fixed) => fixed
      ? '401 {"error":"Connecte-toi"}'
      : '200 [redbeard@..., anne@..., jack@..., mary@..., blackbeard@...]',
  },
  {
    id: 3,
    title: "La route kick ne vérifie pas les permissions (signalement d'exercice)",
    source: 'exercice',
    file: 'app/api/members/[id]/kick/route.ts:9',
    truth: false,
    check: 'curl -X POST /api/members/blackbeard/kick en tant que jack',
    answer: () => '403 {"error":"Permission KICK_MEMBERS manquante"}',
  },
];

const checkpoint = ['app/api/crew/route.ts', 'lib/auth.ts'];
const tooWide = ['lib/session.ts', 'app/api/members/[id]/timeout/route.ts', 'package.json (npm install dans Bash)'];

export default function App() {
  const [verdicts, setVerdicts] = useState({});
  const [checks, setChecks] = useState({});
  const [fixed, setFixed] = useState(false);
  const [changed, setChanged] = useState([]);

  const accepted = findings.filter((f) => verdicts[f.id] === true);

  function verify(f) {
    setChecks((prev) => ({ ...prev, [f.id]: f.answer(fixed && f.truth && verdicts[f.id] === true) }));
  }

  function applyFixes() {
    setFixed(true);
    setChanged([...checkpoint, ...tooWide]);
    setChecks({});
  }

  function rewind() {
    // Restore code annule les fichiers modifiés par les outils de Claude ; un fichier modifié seulement par une commande Bash reste.
    setChanged((prev) => prev.filter((file) => file.includes('Bash')));
    setFixed(false);
  }

  return (
    <div className="min-h-screen space-y-4 bg-slate-100 p-4 font-sans text-slate-900">
      <h1 className="text-lg font-bold">Rapport /security-review : branche connexion</h1>
      {findings.map((f) => (
        <section key={f.id} className="space-y-2 rounded-lg border border-slate-300 bg-white p-3">
          <h2 className="font-bold">{f.id}. {f.title}</h2>
          <p className="text-xs text-slate-500">{f.source} · {f.file}</p>
          <div className="flex flex-wrap gap-2 text-sm">
            <button onClick={() => verify(f)} className="rounded bg-slate-700 px-3 py-1 text-white">Vérifier : {f.check}</button>
            <button onClick={() => setVerdicts((v) => ({ ...v, [f.id]: true }))} className="rounded bg-red-600 px-3 py-1 text-white">Alerte juste</button>
            <button onClick={() => setVerdicts((v) => ({ ...v, [f.id]: false }))} className="rounded border border-slate-400 px-3 py-1">Fausse alerte</button>
          </div>
          {checks[f.id] && <pre className="rounded bg-slate-900 p-2 text-xs text-green-200">{checks[f.id]}</pre>}
          {verdicts[f.id] !== undefined && (
            <p className={'text-sm ' + (verdicts[f.id] === f.truth ? 'text-green-700' : 'text-red-700')}>
              {verdicts[f.id] === f.truth ? 'Conforme à la preuve.' : 'Revérifie : la preuve dit autre chose.'}
            </p>
          )}
        </section>
      ))}

      <section className="space-y-2 rounded-lg border border-slate-300 bg-white p-3">
        <h2 className="font-bold">Corrections</h2>
        <p className="text-sm">Signalements acceptés : {accepted.length ? accepted.map((f) => f.id).join(', ') : 'aucun'}</p>
        <div className="flex flex-wrap gap-2 text-sm">
          <button disabled={!accepted.length} onClick={applyFixes} className="rounded bg-indigo-600 px-3 py-1 text-white disabled:opacity-40">Claude corrige les points acceptés</button>
          <button disabled={!changed.length} onClick={rewind} className="rounded border border-slate-400 px-3 py-1 disabled:opacity-40">/rewind → Restore code</button>
        </div>
        <ul className="list-disc pl-5 font-mono text-xs">
          {changed.map((file) => <li key={file} className={checkpoint.includes(file) ? '' : 'text-red-700'}>{file}{checkpoint.includes(file) ? '' : '  (hors de la demande)'}</li>)}
        </ul>
        {changed.length > 0 && changed.every((file) => file.includes('Bash')) && (
          <p className="text-sm text-red-700">Le fichier modifié seulement par une commande Bash est resté. Restaure-le depuis le dernier commit dans Git.</p>
        )}
      </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. 1. Dans .claude/settings.json se trouve la règle Read(./.env.*). Que se passe-t-il quand Claude, en mode auto, essaie de lire .env.local avec l'outil Read ?

  2. 2. Où gardes-tu la clé de l'API météo dans Pirate's Cove ?

Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne la règle deny qui interdit de lire tout le dossier secrets : Read(./secrets/**)

  • Tri vertical

    Ordonne les étapes du travail avec la revue de sécurité sur la branche connexion :

  1. QuestionQuiz : la règle deny en mode auto
  2. Remets dans l'ordreOrdre : la règle pour le dossier des secrets
  3. QuestionQuiz : où vit la clé d'API
  4. QuestionQuiz : le montant du paiement dans Stripe
  5. QuestionQuiz : ce que vérifie /security-review
  6. Remets dans l'ordreOrdre : travailler avec la revue de sécurité
  7. QuestionQuiz : la serrure seulement dans le composant
  8. QuestionQuiz : annuler un changement trop large
  9. Projet à envoyerEnvoie la Crique du Pirate au mentor
  10. VidéoRésumé du module

Articles utiles