Kurs vibe coding z Claude Code · Moduł 9: Klon Discorda

Przegląd kapitana: bezpieczeństwo kodu od Claude

7 min czytania
W tej lekcji10

Gałąź logowanie działa. Rejestrujesz się, logujesz, Anne nie wchodzi na panel rang, a Blackbeard wylatuje z serwera. W przeglądarce wszystko się zgadza. Tylko że przeglądarka pokazuje, co aplikacja robi dla uczciwego pirata, a nie co zrobi dla takiego, który wyśle żądanie z pominięciem ekranu. W tej lokacji Claude napisał uprawnienia, trasy moderacji, klucz do pogody i logowanie, czyli dokładnie ten kod, w którym błąd nie psuje wyglądu, tylko otwiera ładownię. Zanim gałąź trafi dalej, przechodzi przegląd bezpieczeństwa.

Czego się nauczysz

  • uruchomić /security-review na gałęzi i wiedzieć, co ten przegląd czyta, a czego nie;
  • odróżnić trafny alarm od fałszywego i sprawdzić każdy sam;
  • zlecić poprawki tylko tych punktów, które przyjmujesz, i cofnąć zmianę, która poszła za szeroko;
  • odróżnić przegląd kodu od reguł deny i trybów uprawnień.

Co czyta /security-review

Według dokumentacji Claude Code /security-review analizuje zmiany na bieżącej gałęzi pod kątem podatności. Porównuje gałąź z domyślną gałęzią zdalnego repozytorium origin i szuka ryzyk takich jak wstrzyknięcia, błędy uwierzytelniania i wyciek danych. Czyta kod źródłowy w Twoim folderze, a nie działającą stronę. Obejmuje tylko zmiany gałęzi: kod, który był wcześniej na main, zostaje poza przeglądem. Do przejrzenia konkretnego folderu poprosisz Claude zwykłym poleceniem.

Komenda potrzebuje zdalnego repozytorium origin. Jeśli przegląd zakończy się błędem ze słowami ambiguous argument, dokumentacja każe wskazać domyślną gałąź:

git remote set-head origin main

Ta komenda zapisuje tylko, która gałąź na origin jest domyślna. Niczego nie wysyła i nie zmienia Twoich plików.

Przegląd na gałęzi logowanie

Najpierw commit, żeby przegląd widział cały kod gałęzi, a Ty miał punkt powrotu. Potem w sesji Claude Code:

/security-review

Przegląd trwa kilka minut. U nas Claude zapowiedział trzy kroki: jeden agent szuka kandydatów w diffie gałęzi, kilka agentów równolegle odsiewa fałszywe alarmy, a na końcu powstaje raport. Pierwszy krok znalazł dwóch kandydatów, a do raportu, napisanego po angielsku, trafił jeden. Zaczynał się tak:

# 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

Pod nagłówkiem stały opis, scenariusz ataku i rekomendacja. W skrócie: rejestracja jest otwarta i nie sprawdza skrzynki, a getCurrentMember() łączy konto z członkiem po samym adresie. Kto pierwszy zarejestruje redbeard@pirates-cove.test, zostaje właścicielem serwera ze wszystkimi uprawnieniami. Raport radził zamknąć rejestrację (disableSignUp) i zakładać konta załogi poza stroną albo wymagać potwierdzenia adresu (requireEmailVerification).

Trafny alarm czy fałszywy

Raport to meldunek zwiadowcy, nie wyrok. Każde zgłoszenie sprawdzasz tak samo jak raport o trasach w lekcji 8_3: otwierasz wskazany plik w Cursorze, czytasz linię i próbujesz odtworzyć atak.

Ten alarm jest trafny, a dowód łatwo zdobyć: konto jack@pirates-cove.test założyło u nas gołe żądanie curl, bez żadnej skrzynki, i od razu dostało ciasteczko sesji. Każdy adres z lib/crew-accounts.ts, którego nikt jeszcze nie zajął, czeka więc na pierwszego chętnego.

Fałszywy alarm wygląda inaczej: zgłoszenie opisuje linię, której w pliku nie ma, albo atak, któremu drogę zamyka inny fragment kodu, na przykład zamek w trasie, którego przegląd nie zauważył. Wtedy zapisujesz, czym go odrzuciłeś, i nie zlecasz poprawki.

Raport nie jest też pełną listą. Drugim kandydatem była lista załogi z lekcji 8_5, która oddaje adresy bez sesji. U nas zapis przebiegu pokazał, że agent sprawdzający ocenił ją jako TRUE POSITIVE (low-impact), confidence 6/10, a do raportu końcowego to zgłoszenie nie weszło. Dla Twojej załogi to i tak dziura, bo adresy ludzi nie mają wisieć publicznie. Raport mówi, czego przegląd jest pewny, a o tym, co jest dziurą w Twoim projekcie, decydujesz Ty.

Poprawki tylko tego, co przyjmujesz

Nie piszesz "napraw wszystko". Wskazujesz punkty, które sprawdziłeś, i żądasz dowodu. U nas pierwszym był punkt o liście załogi, a Ty wpisujesz punkt ze swojego raportu:

Polecenie dla Claude Code:

Popraw tylko punkt o /api/crew z przeglądu bezpieczeństwa: trasa ma
sprawdzać sesję przez getCurrentMember() z @lib/session.ts i bez sesji
zwracać 401. Dopisz test w app/api/crew/route.test.ts: żądanie bez sesji
dostaje 401, zalogowany członek dostaje listę. Innych plików nie ruszaj.
Na koniec testy, lint i curl na /api/crew bez ciasteczka.

W Cursorze otwierasz Source Control i czytasz diff: zmiana ma dotyczyć jednej trasy i jednego nowego testu. U nas test bez poprawki padł z AssertionError: expected 200 to be 401, a z poprawką przeszły wszystkie 21 testów. curl bez ciasteczka dostał 401 i {"error":"Zaloguj się"}.

Punkt z raportu poprawiasz drugim, osobnym poleceniem, bo dotyczy innego pliku:

Polecenie dla Claude Code:

Popraw Vuln 1 z przeglądu bezpieczeństwa: w @lib/auth.ts ustaw
disableSignUp: true i usuń przycisk Załóż konto z app/sign-in/page.tsx.
lib/session.ts zostaw bez zmian. Na koniec curl na rejestrację
i logowanie istniejącym kontem.

Konta załogi, których potrzebujesz, załóż przed tą zmianą. U nas rejestracja odpowiedziała potem 400 z {"message":"Email and password sign up is not enabled","code":"EMAIL_PASSWORD_SIGN_UP_DISABLED"}, a Anne zalogowała się jak wcześniej. Przed wdrożeniem zostaje pytanie, kto zakłada konta na pustej bazie. Raport radził skrypt albo plugin administratora i wiązanie członka z identyfikatorem konta zamiast adresu: to osobne zadanie, które zaczniesz od /plan.

/code-review: drugie oczy

/security-review szuka dziur, a /code-review z lekcji 2_9 szuka błędów w działaniu. Recenzja biegnie w tle jako osobny agent z własnym kontekstem i bez --fix tylko raportuje. Na gałęzi z logowaniem uruchom ją po poprawkach, bo poprawka bezpieczeństwa też bywa błędna. Decyzję, co poprawić, i tak podejmujesz Ty.

Agent poprawił za dużo

Zdarza się, że po "popraw punkt o /api/crew" Claude przy okazji przepisuje lib/session.ts, zmienia trasy moderacji i dorzuca nową zależność. Diff rośnie, a Ty nie wiesz, co jeszcze działa. Wracasz wtedy siatką z lekcji 0_6. Dwa razy Esc przy pustym polu albo /rewind otwiera listę Twoich poleceń. Wybierasz polecenie z poprawką i Restore code: pliki zmienione narzędziami Claude wracają do stanu sprzed tego polecenia, a rozmowa zostaje.

Dokumentacja wymienia dwie granice. Plik, który zmieniły wyłącznie komendy Bash, nie jest śledzony. Zmiany subagenta w tle, na przykład /code-review --fix, w plikach, których Claude wcześniej nie ruszał w tej rozmowie, też zostają. Takie pliki przywracasz z ostatniego commita w Gicie. Potem wydajesz węższe polecenie z listą plików, które wolno zmienić.

Zamki to nie przegląd

Reguła deny z lekcji 8_4 zabrania Claude czytać .env.local. Tryb auto ma klasyfikator, który według dokumentacji blokuje między innymi wysyłanie wrażliwych danych do zewnętrznych adresów, wdrożenia produkcyjne i usuwanie testu, który pilnuje bezpieczeństwa. Oba mechanizmy pilnują tego, co agent robi w Twoim systemie. Żaden z nich nie czyta trasy /api/crew i nie zauważy, że oddaje adresy każdemu. Dziurę w logice znajduje przegląd kodu: Twój, /security-review i testy.

Przegląd kapitana

  1. Każde zgłoszenie sprawdzone. Przy każdym punkcie raportu masz plik, linię i własny dowód: curl, test albo przeczytany kod.
  2. Poprawka z testem. Każdy przyjęty punkt dostaje test, który bez poprawki pada.
  3. Diff w granicach. Poprawka zmienia tylko pliki z polecenia; reszta wraca przez /rewind albo Gita.
  4. Drugi przebieg. Po poprawkach /security-review jeszcze raz i /code-review.

Następny krok

Poproś o commit, na przykład "Poprawki z przeglądu bezpieczeństwa: lista załogi za zamkiem, rejestracja zamknięta". Do mentora wyślesz zrzut działającego serwera, wynik /security-review i jedno zdanie o tym, co poprawiłeś po przeglądzie.

W edytorze poniżej czeka raport przeglądu do rozbrojenia: oceń każde zgłoszenie, sprawdź je żądaniem do udawanego serwera i zobacz, co zostaje po /rewind.

Pamiętaj: strażnik przy trapie i strażnik w ładowni to dwóch różnych strażników, a przegląd to kapitan, który co wieczór sprawdza obu.

Kod do tej lekcji: App.jsx
// Rozbrajanie raportu przeglądu bezpieczeństwa na udawanym serwerze Pirate's Cove.
// Zgłoszenia 1 i 2 streszczają nasz prawdziwy przebieg /security-review, zgłoszenie 3 jest ćwiczebne.
import { useState } from 'react';

const findings = [
  {
    id: 1,
    title: 'Otwarta rejestracja: członek wybierany po samym adresie e-mail',
    source: 'raport końcowy, 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 + ciasteczko sesji. Nowa "Mary" ma uprawnienia oficera.',
  },
  {
    id: 2,
    title: '/api/crew oddaje adresy załogi bez sesji',
    source: 'kandydat odrzucony przez filtr (6/10)',
    file: 'app/api/crew/route.ts:4',
    truth: true,
    check: 'curl /api/crew (bez ciasteczka)',
    answer: (fixed) => fixed
      ? '401 {"error":"Zaloguj się"}'
      : '200 [redbeard@..., anne@..., jack@..., mary@..., blackbeard@...]',
  },
  {
    id: 3,
    title: 'Trasa kick nie sprawdza uprawnień (zgłoszenie ćwiczebne)',
    source: 'do ćwiczenia',
    file: 'app/api/members/[id]/kick/route.ts:9',
    truth: false,
    check: 'curl -X POST /api/members/blackbeard/kick jako jack',
    answer: () => '403 {"error":"Brak uprawnienia KICK_MEMBERS"}',
  },
];

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 w 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 cofa pliki zmienione narzędziami Claude; plik zmieniony tylko komendą Bash zostaje.
    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">Raport /security-review: gałąź logowanie</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">Sprawdź: {f.check}</button>
            <button onClick={() => setVerdicts((v) => ({ ...v, [f.id]: true }))} className="rounded bg-red-600 px-3 py-1 text-white">Trafny alarm</button>
            <button onClick={() => setVerdicts((v) => ({ ...v, [f.id]: false }))} className="rounded border border-slate-400 px-3 py-1">Fałszywy alarm</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 ? 'Zgadza się z dowodem.' : 'Sprawdź jeszcze raz: dowód mówi co innego.'}
            </p>
          )}
        </section>
      ))}

      <section className="space-y-2 rounded-lg border border-slate-300 bg-white p-3">
        <h2 className="font-bold">Poprawki</h2>
        <p className="text-sm">Przyjęte zgłoszenia: {accepted.length ? accepted.map((f) => f.id).join(', ') : 'brak'}</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 poprawia przyjęte punkty</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) ? '' : '  (spoza polecenia)'}</li>)}
        </ul>
        {changed.length > 0 && changed.every((file) => file.includes('Bash')) && (
          <p className="text-sm text-red-700">Plik zmieniony tylko komendą Bash został. Przywróć go z ostatniego commita w Gicie.</p>
        )}
      </section>
    </div>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. W .claude/settings.json stoi reguła Read(./.env.*). Co się stanie, gdy Claude w trybie auto spróbuje odczytać .env.local narzędziem Read?

  2. 2. Gdzie trzymasz klucz do API pogodowego w Pirate's Cove?

To 2 z 6 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Układanie w poziomie

    Ułóż regułę deny, która zabrania czytać cały folder secrets: Read(./secrets/**)

  • Układanie w pionie

    Ułóż kroki pracy z przeglądem bezpieczeństwa na gałęzi logowanie:

  1. PytanieQuiz: Reguła deny w trybie auto
  2. Ułóż w kolejnościSortowanie: Reguła dla folderu sekretów
  3. PytanieQuiz: Gdzie mieszka klucz API
  4. PytanieQuiz: Kwota płatności w Stripe
  5. PytanieQuiz: Co sprawdza /security-review
  6. Ułóż w kolejnościSortowanie: Praca z przeglądem bezpieczeństwa
  7. PytanieQuiz: Zamek tylko w komponencie
  8. PytanieQuiz: Cofnięcie za szerokiej zmiany
  9. Projekt do wysłaniaWyślij Pirate's Cove do mentora
  10. WideoPodsumowanie modułu

Przydatne artykuły