Anleitung: Agenten-Sicherheit — Best Practices

KI-Agenten übernehmen zunehmend produktive Aufgaben: Sie schreiben Code, verwalten Dateien, senden Nachrichten und steuern Systeme. Mit dieser Macht wächst die Verantwortung. Dieser Guide zeigt dir, wie du deine Agenten sicher betreibst — ohne Kompromisse bei der Produktivität.

Die folgenden Schritte sind als aufbauende Checkliste gedacht. Jeder Schritt baut auf dem vorherigen auf. Beginne mit Schritt 1 und arbeite dich vor.

Schritt 1: Zugriffskontrolle einrichten

SCHRITT 01

Prinzip der minimalen Rechte

Jeder Agent bekommt nur die Rechte, die er für seine Aufgabe wirklich braucht. Ein Agent, der nur Mails lesen soll, braucht kein Schreibrecht auf das Dateisystem.

# Beispiel: Hermes-Toolset auf minimale Tools beschränken
# In config.yaml:
toolsets:
  - terminal
  - file
  - web
# Nicht: computer_use, admin, cron

Definiere für jeden Agenten ein eigenes Toolset
Entferne Standard-Tools, die nicht benötigt werden
Nutze Command-Allowlists statt Blocklists

Schritt 2: Datenisolierung sicherstellen

SCHRITT 02

Trennung von Systemen und Daten

Agenten sollten in isolierten Umgebungen laufen. Ein kompromittierter Agent darf nicht auf das gesamte System zugreifen können.

# Docker-Container pro Agent
docker run -d \
  --name agent-worker-1 \
  --read-only \
  --tmpfs /tmp:size=100M \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  hypdb-agent:latest

Jeder Agent läuft in einem eigenen Container
Dateisystem schreibgeschützt mounten (--read-only)
Temporäre Daten nur in tmpfs mit Größenlimit
Keine privilegierten Container

Schritt 3: Audit-Logs aktivieren

SCHRITT 03

Jede Aktion protokollieren

Lückenlose Protokollierung ist die Grundlage für Sicherheitsanalysen. Jeder Befehl, jede Dateiänderung und jeder API-Aufruf muss nachvollziehbar sein.

# Hermes Audit-Log konfigurieren
# In config.yaml:
logging:
  level: debug
  audit: true
  audit_path: /var/log/hermes/audit/
  retention_days: 90
  format: json

Logs im JSON-Format für einfache Analyse
Mindestens 90 Tage Aufbewahrung
Logs zentral sammeln (z. B. Loki, Grafana)
Regelmäßige Log-Analyse auf Anomalien

Schritt 4: Genehmigungsstufen definieren

SCHRITT 04

Menschliche Freigabe für kritische Aktionen

Nicht jede Aktion sollte ein Agent automatisch ausführen dürfen. Definiere klare Genehmigungsstufen für destruktive oder sicherheitsrelevante Operationen.

# Approval-Regeln in Hermes
approvals:
  enabled: true
  rules:
    - action: "rm -rf"
      require: "human"
    - action: "docker rm"
      require: "human"
    - action: "git push --force"
      require: "human"
    - action: "scp"
      require: "human"
    - action: "systemctl restart"
      require: "human"

Löschbefehle immer mit menschlicher Freigabe
Systemänderungen (systemd, Docker) freigabepflichtig
Externe Kommunikation (E-Mail, Nachrichten) prüfen lassen
Automatische Freigabe nur für lesende Operationen

Schritt 5: Notfallplan erstellen

SCHRITT 05

Was tun im Ernstfall?

Ein Sicherheitsvorfall ist keine Frage des Ob, sondern des Wann. Ein klarer Notfallplan minimiert Schäden und verkürzt die Ausfallzeit.

# Notfall-Skript: Agent sofort stoppen
# stop-agent.sh
#!/bin/bash
AGENT_NAME="$1"
docker stop "$AGENT_NAME"
docker logs "$AGENT_NAME" > /var/log/hermes/incidents/"$AGENT_NAME-$(date +%s).log"
docker rm "$AGENT_NAME"
echo "Agent $AGENT_NAME gestoppt und Log gesichert."

Definiere klare Eskalationsstufen (gelb, orange, rot)
Halte Stop-Skripte für jeden Agenten bereit
Sichere Logs und Zustand vor dem Stoppen
Dokumentiere den Wiederherstellungsprozess

Schritt 6: Regelmäßige Sicherheitsprüfungen

SCHRITT 06

Automatisierte Audits einplanen

Sicherheit ist kein einmaliges Setup, sondern ein fortlaufender Prozess. Plane regelmäßige automatisierte Prüfungen ein.

# Cron-Job für wöchentlichen Security-Scan
# In Hermes-Cron:
- name: weekly-security-audit
  schedule: "0 6 * * 1"
  command: hermes security-audit --all
  notify: true
  channel: "7664467819"

Wöchentliche Überprüfung aller Agenten-Konfigurationen
Monatliches Review der Audit-Logs
Vierteljährliche Überprüfung der Berechtigungen
Automatische Benachrichtigung bei Auffälligkeiten

Beginne nicht mit allen sechs Schritten auf einmal. Starte mit Schritt 1 (Zugriffskontrolle) und Schritt 3 (Audit-Logs). Sobald diese etabliert sind, füge die restlichen Schritte hinzu. Ein sicherer Agent, der läuft, ist besser als ein perfekt abgesicherter, der nie produktiv wird.

Teile niemals API-Keys, Tokens oder Passwörter in Agent-Prompts oder Konfigurationsdateien, die im Klartext vorliegen. Nutze immer Environment-Variablen oder einen Secrets-Manager (z. B. HashiCorp Vault, systemd-credentials). Ein Agent, der seinen eigenen API-Key im Log ausgibt, hat bereits die erste Sicherheitsregel verletzt.

Sicherheits-Checkliste

Toolset auf minimale Rechte beschränkt
Command-Allowlist statt Blocklist definiert
Agent läuft in isoliertem Container
Dateisystem schreibgeschützt (read-only)
Audit-Logs aktiviert und zentral gesammelt
Mindestens 90 Tage Log-Aufbewahrung
Genehmigungsstufen für kritische Aktionen
Stop-Skript für jeden Agenten vorhanden
Wöchentlicher Security-Audit eingerichtet
Secrets-Manager statt Klartext-Keys

Bereit für produktive KI?

Mit HYPDB.ONE betreibst du KI-Agenten sicher, kontrolliert und produktionsreif. Starte jetzt mit deinem ersten sicheren Agenten.

JETZT STARTEN