Sicherheits-Scan

Security Scan Skill (Sicherheits-Scan-Fähigkeit)

Überprüfen Sie Ihre Claude Code-Konfiguration auf Sicherheitsprobleme mit AgentShield.

Wann aktivieren

• Einrichtung eines neuen Claude Code-Projekts
• Nach Änderungen an .claude/settings.json, CLAUDE.md oder MCP-Konfigurationen
• Vor dem Committen von Konfigurationsänderungen
• Beim Einstieg in ein Repository mit bestehenden Claude Code-Konfigurationen
• Regelmäßige Sicherheitshygiene-Checks

Was gescannt wird

Datei	Prüfungen
CLAUDE.md	Hartcodierte Secrets, Auto-Run-Anweisungen, Prompt-Injection-Muster
settings.json	Übermäßig permissive Erlaubnislisten, fehlende Verbotslisten, gefährliche Bypass-Flags
mcp.json	Riskante MCP-Server, hartcodierte Env-Secrets, npx Supply-Chain-Risiken
hooks/	Command-Injection durch Interpolation, Datenextraktion, stilles Unterdrücken von Fehlern
agents/*.md	Uneingeschränkter Tool-Zugriff, Prompt-Injection-Oberfläche, fehlende Modellspezifikationen

Voraussetzungen

AgentShield muss installiert sein. Überprüfen und installieren Sie es bei Bedarf:

# Prüfen, ob installiert
npx ecc-agentshield --version

# Global installieren (empfohlen)
npm install -g ecc-agentshield

# Oder direkt über npx ausführen (keine Installation nötig)
npx ecc-agentshield scan .

Verwendung

Basis-Scan

Führen Sie den Scan gegen das .claude/-Verzeichnis des aktuellen Projekts aus:

# Aktuelles Projekt scannen
npx ecc-agentshield scan

# Einen bestimmten Pfad scannen
npx ecc-agentshield scan --path /pfad/zu/.claude

# Mit einem Filter für die minimale Schweregrade
npx ecc-agentshield scan --min-severity medium

Ausgabeformate

# Terminalausgabe (Standard) – farbiger Bericht mit Bewertung
npx ecc-agentshield scan

# JSON – für CI/CD-Integration
npx ecc-agentshield scan --format json

# Markdown – für Dokumentation
npx ecc-agentshield scan --format markdown

# HTML – eigenständiger Dark-Theme-Bericht
npx ecc-agentshield scan --format html > security-report.html

Automatische Korrektur

Sichere Korrekturen automatisch anwenden (nur als automatisch korrigierbar markierte Korrekturen):

npx ecc-agentshield scan --fix

Dies wird:

• Hartcodierte Secrets durch Umgebungsvariablen-Referenzen ersetzen
• Wildcard-Berechtigungen auf eingeschränkte Alternativen verschärfen
• Niemals manuelle Vorschläge ändern

Opus 4.6 Tiefenanalyse

Führen Sie die adversariale Drei-Agenten-Pipeline für eine tiefere Analyse aus:

# Erfordert ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=Ihr-Schlüssel
npx ecc-agentshield scan --opus --stream

Diese führt aus:

1. Angreifer (Red Team) – findet Angriffsvektoren
2. Verteidiger (Blue Team) – empfiehlt Härtung
3. Prüfer (Final Verdict) – synthetisiert beide Perspektiven

Sichere Konfiguration initialisieren

Erstellen Sie eine neue sichere .claude/-Konfiguration von Grund auf:

npx ecc-agentshield init

Erstellt:

• settings.json mit eingeschränkten Berechtigungen und Verbotsliste
• CLAUDE.md mit Sicherheitsbest Practices
• mcp.json-Platzhalter

GitHub-Aktion

Fügen Sie sie in Ihre CI-Pipeline ein:

- uses: affaan-m/agentshield@v1
  with:
    path: '.'
    min-severity: 'medium'
    fail-on-findings: true

Schweregrade

Note	Punktzahl	Bedeutung
A	90-100	Sichere Konfiguration
B	75-89	Kleinere Probleme
C	60-74	Erfordert Aufmerksamkeit
D	40-59	Erhebliche Risiken
F	0-39	Kritische Schwachstellen

Ergebnisse interpretieren

Kritische Funde (sofort beheben)

• Hartcodierte API-Schlüssel oder Token in Konfigurationsdateien
• Bash(*) in der Erlaubnisliste (uneingeschränkter Shell-Zugriff)
• Command-Injection in Hooks durch ${file}-Interpolation
• Shell-ausführende MCP-Server

Hohe Funde (vor Produktion beheben)

• Auto-Run-Anweisungen in CLAUDE.md (Prompt-Injection-Vektor)
• Fehlende Verbotslisten in Berechtigungen
• Agenten mit unnötigem Bash-Zugriff

Mittlere Funde (empfohlen)

• Stille Fehlerunterdrückung in Hooks (2>/dev/null, || true)
• Fehlende PreToolUse-Sicherheitshaken
• npx -y Auto-Installation in MCP-Server-Konfigurationen

Info-Funde (zur Kenntnisnahme)

• Fehlende Beschreibungen auf MCP-Servern
• Prohibitive Anweisungen, die korrekt als gute Praxis gekennzeichnet sind

Links

• GitHub: github.com/affaan-m/agentshield
• npm: npmjs.com/package/ecc-agentshield