Files
breakpilot-compliance/docs-src/services/sdk-modules/evidence.md
Benjamin Admin e6201d5239 feat: Anti-Fake-Evidence System (Phase 1-4b)
Implement full evidence integrity pipeline to prevent compliance theater:
- Confidence levels (E0-E4), truth status tracking, assertion engine
- Four-Eyes approval workflow, audit trail, reject endpoint
- Evidence distribution dashboard, LLM audit routes
- Traceability matrix (backend endpoint + Compliance Hub UI tab)
- Anti-fake badges, control status machine, normative patterns
- 2 migrations, 4 test suites, MkDocs documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-23 17:15:45 +01:00

3.1 KiB
Raw Blame History

Nachweise / Evidence (CP-NAC)

Verknüpft Prüfnachweise mit Controls. Unterstützt manuelle Uploads sowie CI/CD-Automatisierung.

Prefix: CP-NAC · Frontend: https://macmini:3007/sdk/evidence Proxy: /api/sdk/v1/compliance/[[...path]]backend-compliance:8002/compliance/...


Features

  • Manuelle Nachweis-Uploads (PDF, ZIP, ...)
  • CI/CD-Integration: Nachweise automatisch via Pipeline erfassen
  • Automatischer Control-Status-Update nach Nachweis-Ingest (AutoRiskUpdater)
  • CI-Nachweisstand-Abfrage pro Control

Nachweistypen

test_results · audit_report · penetration_test · sast · dependency_scan · sbom · container_scan · secret_scan · code_review


Rechtsgrundlage

Artikel Bezug
Art. 5 Abs. 2 DSGVO Rechenschaftspflicht
Art. 24 DSGVO Nachweis der Compliance
Art. 32 DSGVO Sicherheitsmaßnahmen dokumentieren

API Endpoints

Methode Pfad Beschreibung
GET /evidence Liste (control_id, evidence_type, status, page, limit)
POST /evidence Nachweis manuell anlegen
DELETE /evidence/{id} Nachweis löschen
POST /evidence/upload Datei hochladen (PDF, ZIP, ...)
POST /evidence/collect CI/CD-Nachweis automatisch erfassen
GET /evidence/ci-status CI-Nachweisstand für eine Kontrolle

CI/CD-Integration

POST /evidence/collect
{
  "control_id": "SDLC-001",
  "evidence_type": "test_results",
  "title": "Pytest Run 2026-03-05",
  "ci_job_id": "gh-actions-12345",
  "artifact_url": "https://github.com/.../artifacts/report.xml"
}

Nach dem Collect wird automatisch der Control-Status aktualisiert (AutoRiskUpdater).


Frontend

URL: https://macmini:3007/sdk/evidence

Tabelle mit Nachweis-Einträgen, filterbar nach Control und Typ. Upload-Button für manuelle Nachweise. CI-Status-Badge zeigt automatisierungsgrad pro Control.


Datenbankschema

compliance_evidence (
  id             UUID PRIMARY KEY,
  control_id     VARCHAR REFERENCES compliance_controls(control_id),
  evidence_type  VARCHAR,               -- test_results/audit_report/...
  title          TEXT,
  description    TEXT,
  artifact_path  TEXT,
  artifact_url   TEXT,
  ci_job_id      VARCHAR,
  status         VARCHAR DEFAULT 'pending',
  collected_at   TIMESTAMP,
  created_at     TIMESTAMP
)

Anti-Fake-Evidence

Seit Phase 1 (2026-03-23) werden Nachweise automatisch mit Confidence Levels (E0E4) und Truth Status klassifiziert. Details: Anti-Fake-Evidence Architektur


Tests

Testdatei: backend-compliance/tests/test_evidence_routes.py Anzahl Tests: 11 · Status: alle bestanden (Stand 2026-03-05)

Anti-Fake-Evidence Tests: backend-compliance/tests/test_anti_fake_evidence.py Anzahl Tests: ~45 · Confidence-Klassifikation, State Machine, Multi-Score, LLM Audit

cd backend-compliance
python3 -m pytest tests/test_evidence_routes.py tests/test_anti_fake_evidence.py -v