user_guide

Themis Admin Tools – Benutzerhandbuch

Stand: 5. Dezember 2025
Version: 1.0.0
Kategorie: Admin Tools

---

Dieses Handbuch beschreibt die sieben Themis Admin-Tools mit einheitlichem Layout (Toolbar | Sidebar | Content | StatusBar) und erklärt die wichtigsten Funktionen und Workflows.

• Einheitliches Branding: Rechts oben „Themis“ (hellblau) öffnet den About-Dialog
• Hamburger-Menü: Links oben einklappbare Sidebar
• StatusBar: Live-Status, Zähler und Ladeindikator

Gemeinsame Bedienkonzepte

• Themis-Brand-Button: Klick öffnet „Über …“-Dialog mit Version/Build-Hinweisen
• Hamburger-Button: Sidebar ein-/ausblenden
• Suche: Textfeld über dem Grid filtert die angezeigten Einträge
• Export: CSV/PDF/Excel je nach Tool verfügbar

1) Audit Log Viewer

• Zweck: Audit-Events sichten, filtern, exportieren
• Wichtige Aktionen: Aktualisieren, CSV-Export
• Filter: Datum, Benutzer, Action, Entity
• Tipps: Multi-Column-Sortierung über Spaltenköpfe nutzen

2) SAGA Verifier

• Zweck: SAGA-Batch-Signaturen verifizieren
• Aktionen: Batches laden, Details ansehen, Signatur prüfen, Batch flushen
• Hinweise: Detail-View zeigt Steps/Ergebnisse; Export-Funktion verfügbar

3) PII Manager

• Zweck: Verwaltung von UUID↔Pseudonym-Mappings, Art. 17 Löschung, Export
• Aktionen: Laden, Export CSV, Filter zurücksetzen, DSGVO-Löschung per UUID
• Grid-Spalten: OriginalUuid, Pseudonym, CreatedAt, UpdatedAt, Active

4) Key Rotation Dashboard

• Zweck: Überblick über LEK/KEK/DEK-Keys, Rotations-Status und manuelle Rotation
• Aktionen: Aktualisieren, Rotieren (gesamt oder je Typ LEK/KEK/DEK)
• Filter: Schlüsseltyp, nur abgelaufene Keys
• StatusBar: Anzahl Schlüssel und abgelaufene in Rot

Backend-Calls:

• Liste laden: GET /keys
• Rotation auslösen: POST /keys/rotate
  • Parameter: key_id im JSON-Body { "key_id": "DEK" } oder als Query ?key_id=DEK

Fehlerfälle und Hinweise:

• 400 Missing key_id → Bitte Schlüssel auswählen
• 503 Keys API not available → Server-Konfiguration prüfen (KeyProvider)

5) Retention Manager

• Zweck: Aufbewahrungs-Policies verwalten und Bereinigung auslösen
• Aktionen: Policies laden, neue Policy erstellen, Bereinigung starten
• Filter: Status (Aktiv/Inaktiv/Abgelaufen), Entitätstyp (AuditLog/Document/…)

6) Classification Dashboard

• Zweck: Datenklassifizierung (PUBLIC/INTERNAL/CONFIDENTIAL/RESTRICTED) überwachen und testen
• Aktionen: Aktualisieren, CSV-Export, Compliance-Check, Test-Classification
• Filter: Klassifizierung, Verschlüsselung, Compliance-Status, Gaps-only
• Statistik: Live-Counts in der Sidebar

Backend-Calls:

• Regeln laden: GET /classification/rules
• Klassifikation testen: POST /classification/test
  • Body: { "text": "<Probeinhalt>", "metadata": { "source": "sample" } }
  • Response: { "classification": "CONFIDENTIAL", "confidence": 0.92, "detected_entities": [ { "type": "EMAIL", "value": "a@b.c" } ] }

Fehlerfälle und Hinweise:

• 400 Missing JSON body → Eingabefeld ausfüllen
• 503 Classification API not available → Server-Konfiguration (PIIDetector) prüfen

7) Compliance Reports

• Zweck: Reports (DSGVO, SOX, HIPAA, ISO 27001, PCI-DSS) generieren und exportieren
• Aktionen: Report generieren, Export (PDF/Excel/CSV)
• Einstellungen: Zeitraum, Template (Standard/Detailliert/…); Diagramme/Technikdetails

Backend-Calls:

• Compliance-Übersicht laden: GET /reports/compliance?type=overview|dsgvo|sox|hipaa|iso27001|pci
  • Response-Beispiel (gekürzt): { "report_type": "overview", "generated_at": "2025-11-02T14:55:00Z", "metrics": { "encrypted_entities": 1234, "pii_findings": 42 } }

Fehlerfälle und Hinweise:

• 503 Reports API not available → Server-Berechtigungen/Config prüfen

Starten der Tools

• Bereitstellung: Veröffentlichte EXEs liegen unter dist/<ToolName>/
• Start: Doppelklick auf die jeweilige EXE
• Voraussetzung: Themis-Server sollte laufen (Standard: http://localhost:8765)

Routing-Hinweis:

• Falls die Tools /api/*-Routen verwenden, richten Sie einen Reverse-Proxy ein, der /api/ auf den Server-Root / rewritet (siehe Admin-Guide). Alternativ die Tool-Konfiguration auf prefix-freie Endpunkte anpassen.

Häufige Fragen (FAQ)

• Die Sidebar ist weg? → Mit dem ☰-Button oben links wieder einblenden
• Export-Datei nicht sichtbar? → In den Standard-Download-Ordner oder Tool-Verzeichnis schauen; ggf. mit Admin-Rechten starten
• Keine Daten? → Server/Endpoint prüfen, Logs ansehen, Filter zurücksetzen