NullSec-RedTeam-AI

Autorisierung zuerst, MCP-gesteuerte Sicherheitsausführung für ausdrücklich genehmigte Umgebungen.

NullSec-RedTeam-AI ist eine Single-Host-Steuerungsebene für gesteuerte Sicherheitswerkzeug-Abläufe. Sie erfasst den genehmigten Umfang einer Kampagne, den Akteurskontext, die Richtlinienentscheidung, den dauerhaften Job-Lebenszyklus, den Prüfpfad und den Evidenzverweis, bevor ein Worker einen Job ausführen darf. Die Standardhaltung ist Sandbox erforderlich und Fail-Closed: Eine erforderliche Sandbox wird niemals auf Host-Ausführung herabgestuft.

Nur mit ausdrücklicher schriftlicher Genehmigung verwenden. Dieses Projekt ist frühe Sicherheitssoftware, kein autonomes Red-Team-System, kein Ersatz für einen Einsatzvertrag und kein Multi-Tenant-Dienst. Führen Sie es in isolierten Testumgebungen oder auf Ressourcen aus, die Sie ausdrücklich bewerten dürfen.

Warum NullSec?

Related MCP server: Nervora

Architektur auf einen Blick

Ein Benutzer oder MCP-Client erreicht die Transportschicht erst nach Authentifizierung und Konstruktion des Aufruferkontexts. Die Kampagnen-Richtlinien-Engine entscheidet, ob eine typisierte Anfrage im Rahmen ist. Der dauerhafte Job-Speicher koordiniert Leases und Prüfereignisse; ein lease-fähiger Worker kann dann eine Least-Privilege-Sandbox-Ausführung anfordern. AURA bleibt oberhalb der Ausführungsgrenze, mit einer separaten Evidenzprüfungsstufe.

Das quellgesteuerte Mermaid-Diagramm befindet sich unter docs/assets/control-plane-architecture.mmd. Lesen Sie die Architekturbegründung in ADR-001.

Schnellstart für sichere lokale Entwicklung

Der Entwicklungsworkflow verwendet Mocks und simulierte Fixtures; er installiert, lädt oder führt keine Sicherheitswerkzeuge aus.

git clone https://github.com/Panda1847/NullSec-RedTeam-AI.git
cd NullSec-RedTeam-AI
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e '.[dev]'

pytest
ruff check .

Verwenden Sie für lokale API-Entwicklungsarbeit den projektlokalen Zustand, einen Nicht-Produktions-Token und nur Loopback-Bindung.

mkdir -p .nullsec/logs .nullsec/jobs
export NULLSEC_LOG_DIR="$PWD/.nullsec/logs"
export NULLSEC_JOB_DIR="$PWD/.nullsec/jobs"
export API_TOKEN="local-development-token"
export NULLSEC_LOCAL_ACTOR_ID="local-operator"
export NULLSEC_LOCAL_ACTOR_ROLES="operator"

hexstrike-server --host 127.0.0.1 --port 8888

Der Dienst lehnt Nicht-Loopback-Bindung ab, es sei denn, NULLSEC_ALLOW_NON_LOOPBACK=true ist explizit gesetzt. Behandeln Sie diese Einstellung als eine Bereitstellungsänderung, die einen authentifizierten Reverse-Proxy und eine genehmigte Netzwerkrichtlinie erfordert.

Sicherer Kampagnen-Ablauf

Eine Kampagne erfasst Autorisierung und Umfang. Das folgende Loopback-only-Beispiel erstellt einen Kampagnendatensatz; es führt kein Werkzeug aus.

curl --request POST http://127.0.0.1:8888/api/campaigns \
  --header "Authorization: Bearer $API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "campaign_id": "local-demo-001",
    "allowed_targets": ["127.0.0.0/8"],
    "allowed_capabilities": ["passive"],
    "starts_at": "2026-08-18T09:00:00+00:00",
    "ends_at": "2026-08-18T17:00:00+00:00"
  }'

Die Job-Einreichung erfordert diese Kampagne, eine unterstützte Kompetenzstufe und einen Idempotenzschlüssel. Mit dem Standardmodus sandbox_required bleibt ein Job sicher in der Warteschlange, schlägt aber bei der Ausführung fail-closed, es sei denn, ein Operator hat ein geprüftes unveränderbares Image und eine rootless Runner-Konfiguration bereitgestellt.

curl --request POST http://127.0.0.1:8888/api/tools/execute \
  --header "Authorization: Bearer $API_TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'X-Trace-Id: local-demo-trace-001' \
  --data '{
    "tool": "nmap",
    "target": "127.0.0.1",
    "options": "-sV",
    "campaign_id": "local-demo-001",
    "capability": "passive",
    "idempotency_key": "local-demo-request-001"
  }'

Platzieren Sie keine Bearer-Token in der Shell-Historie, Quellcodeverwaltung, Screenshots oder CI-Protokollen.

KI-Sicherheitslabor

Das KI-Sicherheitslabor unterscheidet eine Simulation von einer tatsächlichen Anbieterbewertung. Seine Standardausgabe hat den Modus mode: simulation und den Status status: not_evaluated; es behauptet nicht, dass ein Modell verwundbar, widerstandsfähig oder bewertet ist. Die Anbieterbewertung bleibt nicht verfügbar, bis eine Organisation einen zugestimmten Adapter, einen versionierten Datensatz, geschützte Anmeldeinformationen, Evidenzspeicher und eine Bewertungsmethode bereitstellt.

ai-lab --list
ai-lab --model consented-test-model --technique PROMPT_INJECTION --mode simulation

Das Projekt erzeugt bewusst keine Bypass-Payloads. Jede anbieterbasierte Bewertung sollte einen geprüften, versionierten Datensatz in einer isolierten Umgebung verwenden.

Qualitätstore

Jeder Beitrag sollte vor der Veröffentlichung Erwartungen an Tests, Codequalität, Sicherheit, Paketierung und Überprüfung erfüllen.

Der öffentliche Workflow umfasst Tests mit fokussierter Abdeckung, Ruff-Linting, fokussierte Typüberprüfung, statische Sicherheitsanalyse, Abhängigkeitsprüfung und PEP-517-Paketerstellung. Die Quelle des Qualitätstor-Diagramms ist docs/assets/quality-gates.mmd.

Projektstatus und Fahrplan

Siehe ROADMAP.md für die gepflegte Implementierungssequenz und IMPLEMENTATION_SUMMARY.md für den Modernisierungsdatensatz 7.1.

Dokumentation

Mitwirken

Beiträge müssen die Autorisierung-zuerst-Haltung bewahren. Neue Integrationen benötigen ein typisiertes Anfragemodell, Risikostufe, Fähigkeitsbereich, sicheres Ausführungsprofil, deterministische Tests und einen Evidenzparser oder dokumentierte Einschränkung. Fügen Sie keine willkürliche Shell-Ausführung, unbegrenzte Optionszeichenfolgen, Live-Zieltests, Anmeldeinformationen, Zielinventare oder generierte Scan-Artefakte hinzu.

Eröffnen Sie ein Design-Issue oder schlagen Sie einen Architekturentscheidungsdatensatz vor größeren Änderungen vor. Überprüfen Sie zuerst CONTRIBUTING.md und verwenden Sie SECURITY.md anstelle öffentlicher Issues für Schwachstellenmeldungen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Die Lizenz gewährt keine Autorisierung zur Bewertung eines Systems. Die Betreiber bleiben verantwortlich für geltendes Recht, Verträge, Unternehmensrichtlinien, schriftliche Autorisierung und Einsatzgenehmigung.