// docs / security guides / cursor checklist

Cursor security checklist: 25 items before ship

Building with Cursor? Cursor's autocomplete and Agent features are exceptionally powerful — and create predictable security blind spots. This checklist targets Cursor-specific patterns: service-role key inlining, generated multi-file edits merged without review, Agent-mode terminal commands, and project rules (.cursor/rules) as your first security guardrail. 25 items across secrets, database, auth, headers, deployment, and Cursor-specific gotchas.

PRE = pre-deploy (audit your source). DEPLOY = at deploy time. POST = post-deploy verification.

Geheimnisse und API Schlüssel (5 Artikel)

Die automatische Vervollständigung von Cursor wird auf Open-Source-Code trainiert, bei dem Geheimnisse häufig vorkommen. Das Modell schlägt sie frei vor, insbesondere nach einem fehlgeschlagenen Authentifizierungsversuch.

PRE — Write security rules into your project rules. Add a rule in .cursor/rules (Cursor docs): "Never inline SUPABASE_SERVICE_ROLE_KEY, sk_live_*, or any server secret into client-side code. Always use server-only imports." Cursor applies project rules as context for Agent and chat.
PRE — Audit Composer-generated files. Wenn der Composer von Cursor eine ganze Datei erstellt (insbesondere Authentifizierungshandler), überprüfen Sie sie Zeile für Zeile. Composer integriert manchmal Umgebungsvariablen, die nur für den Server gelten sollten. Suchen Sie nach NEXT_PUBLIC_ oder direkten Verweisen auf Dienstschlüssel in Komponentenimporten.
PRE — Reject auto-imports of service clients into client components. Wenn Composer import { supabase } from '@/lib/supabase/service' in eine React-Datei importiert, löschen Sie es sofort und leiten Sie es stattdessen über einen API-Endpunkt weiter. Nur-Server-Importe sind explizit markiert – überspringen Sie sie nicht.
PRE — Scan Agent-mode commits. Der Agentenmodus führt Terminalbefehle aus und kann direkt festschreiben. Überprüfen Sie git log --oneline -20 und git diff HEAD~5, um sicherzustellen, dass während einer Agentenausführung keine geheimnisvollen Zeichenfolgen festgeschrieben wurden.
POST — Run Secrets in JavaScript Bundles. Passiver Scan auf dem bereitgestellten URL. Wenn ein Dienstschlüssel im JS-Bundle erscheint, rotieren Sie ihn sofort – die automatische Vervollständigung von Cursor hat ihn wahrscheinlich eingefügt.

Datenbankzugriffskontrolle (4 Artikel)

Composer generiert häufig funktionierenden Authentifizierungscode, überspringt jedoch RLS – der „Es funktioniert“-Moment macht die Leute blind für die fehlende Richtliniendurchsetzung.

PRE — Make Cursor generate migrations with RLS. In your project rules: "Every CREATE TABLE public.* migration must include ALTER TABLE ... ENABLE ROW LEVEL SECURITY and a policy per command scoped to auth.uid()." Then ask Cursor to generate the migration.
PRE — Review Composer-generated policies. Composer schreibt manchmal Richtlinien, ohne auth.uid() zu überprüfen. Richtlinien wie allow select on public.items ohne eine using-Klausel sind gefährlich weit gefasst. user_id-Abgleich erforderlich.
DEPLOY — Confirm RLS and policies are live. Open Supabase Studio and check that every table's RLS toggle is on and that each table has policies. A table with RLS on and no policies denies everything; one with USING (true) allows everyone.
POST — Run a FixVibe scan on the deployed app. Check the Supabase Row-Level Security result: it shows any table an anonymous visitor can read with your public key.

Authentifizierung und Sitzungen (4 Elemente)

Cursor generiert Authentifizierungsflüsse schnell, vermisst jedoch häufig die subtile serverseitige Validierung, die die Sicherheit der Token gewährleistet.

PRE — Ensure all auth routes use getUser(). Suchen Sie in Ihren API Routen nach getSession() und ersetzen Sie es durch await supabase.auth.getUser(). getSession() liest ein ungeprüftes Cookie; getUser() validiert mit Supabase Backend.
PRE — Check Composer auth handlers for token expiry. Magic-Link-Tokens benötigen vom Server erzwungenes expires_at. Der Standardwert für Supabase beträgt 1 Stunde – bitten Sie Cursor nicht, ihn ohne triftigen Grund zu überschreiben.
PRE — Audit the sign-in redirect guard. Die Umleitung des Abfrageparameters next nach der Anmeldung muss validiert werden: Sie muss mit / beginnen, niemals mit //. Der Komponist überspringt dies manchmal. Fügen Sie es manuell hinzu, falls es fehlt.
POST — Test logout server-side state destruction. Anmelden, abmelden, Cookies überprüfen (DevTools → Anwendung → Cookies). Das Sitzungscookie muss sofort gelöscht werden. Wenn es weiterhin besteht, zerstört der Logout-Handler den Status nicht.

HTTP Sicherheitsheader und CSP (3 Elemente)

Cursor generiert standardmäßig selten Middleware. Wenn Sie nicht explizit fragen, sind CSP und HSTS normalerweise nicht vorhanden.

PRE — Demand CSP in your project rules. Add: "Generate a src/middleware.ts with Content-Security-Policy. Use nonce for script-src, no unsafe-inline." Then ask Cursor to generate it. Without this hint, middleware is skipped.
PRE — Verify src/middleware.ts exists. Beim Verzeichnislayout src/ nimmt Next.js nur src/middleware.ts auf. Ein middleware.ts auf Stammebene wird stillschweigend ignoriert. Wenn CSP nicht landet, überprüfen Sie, ob sich die Datei am richtigen Ort befindet.
POST — Run HTTP Security Headers. Passive Scan-Berichte fehlen CSP, HSTS, X-Frame-Options, X-Content-Type-Options. Öffnen Sie den Bericht und befolgen Sie die Fehlerbehebungsanleitung für Ihre Bereitstellungsplattform.

Einsatzhygiene (5 Artikel)

Cursor-Apps landen oft auf Vercel, was gute Standardeinstellungen hat, aber eine explizite Härtung für die Build/deploy-Grenze erfordert.

DEPLOY — Check Vercel env-var scoping. Einstellungen → Umgebungsvariablen → Jedes Geheimnis sollte nur auf Production beschränkt sein. Teilen Sie sk_live_* niemals mit Vorschau oder Entwicklung.
DEPLOY — Disable build-log secret echo. Wenn Ihr vercel.json- oder GitHub-Aktionsworkflow echo $SECRET hat, entfernen Sie es. Build-Protokolle werden öffentlich archiviert; Geheimnisse in Protokollen sind gefährdet.
DEPLOY — Use Vercel's managed secrets, not inline workflow vars. Vercels Einstellungen → Umgebungsvariablen wird im Ruhezustand verschlüsselt. Die Geheimnisse von GitHub Aktionen sind besser als nichts, aber sie sind für CI konzipiert, nicht für die Integration in die Bereitstellungsplattform.
POST — Verify CSP nonce on the deployed preview. Öffnen Sie einen Vercel Vorschau-Link im Browser, öffnen Sie DevTools → Netzwerk → die Stammantwort HTML. Der CSP-Header muss vorhanden sein und 'strict-dynamic' mit einer eindeutigen Nonce pro Anfrage enthalten.
POST — Rotate any key that ever shipped, even to Preview. Wenn ein Schlüssel das Produktionspaket auch nur 10 Minuten lang erreicht, ist er kompromittiert. Sofort drehen.

Cursor-spezifische Fallstricke (4 Elemente)

Für den Workflow von Cursor einzigartige Muster, die Sicherheitsrisiken schaffen:

Agent mode auto-fixes propagate old patterns. Wenn Sie den Agenten bitten, „Authentifizierungsfehler zu beheben“, wird möglicherweise dieselbe Authentifizierungsdatei mehrmals neu generiert, wobei jedes Mal derselbe Dienstschlüssel eingefügt wird, wenn er sich im Codebasiskontext befindet. Reinigen Sie zuerst das Original und bitten Sie dann den Agenten, das Problem zu beheben.
Die @codebase-Indizierung von Cursor Index leaks intent. Cursor ist leistungsstark, aber wenn Ihr .cursor-Verzeichnis jemals offengelegt wird (falsch konfiguriertes S3, Git-Verlauf), enthüllt der Index Ihre Architektur und geheime Muster. Halten Sie .cursor lokal.
Composer mode loses context between files. Jede von Composer generierte Datei ist frisch. Wenn Sie es auffordern, eine Client-Datei und dann eine API-Route zu generieren, verwenden sie möglicherweise unterschiedliche Supabase Client-Konfigurationen. Überprüfen Sie beide und stellen Sie sicher, dass sie zu Ihrer Architektur passen.
Autocomplete bias toward "working" over "secure". Cursor schlägt den schnellsten Code vor, der Ihren aktuellen Kontext durchläuft. Wenn Ihr Test NEXT_PUBLIC_SERVICE_KEY hat, merkt sich die automatische Vervollständigung dies und schlägt es erneut vor. Reinigen Sie Testvorrichtungen, bevor Sie Code mit dem Modell teilen.

Nächste Schritte

Sobald Sie die Cursor-spezifischen Muster festgelegt haben, vergleichen Sie sie mit general vibe coding security checklist (51 Elemente) und dann mit step-by-step hardening. Sehen Sie sich auch Claude Code checklist an, wenn Sie Werkzeuge mischen.