Audit-Trail & Änderungszuordnung

In der Immobilienverwaltung sind Nachvollziehbarkeit und Revisionssicherheit gesetzliche und operative Pflicht. Wenn automatisierte Workflows und KI-Agenten Bestandsdaten lesen und verändern, reicht die Information „Ein Datensatz wurde aktualisiert“ nicht aus. Die etg24-Plattform protokolliert jede Statusänderung lückenlos und ordnet sie einem eindeutigen Akteur zu.

Die drei Kernfragen

Jeder Eintrag im zentralen Änderungsprotokoll beantwortet drei wesentliche Fragen präzise:

1. Was hat sich geändert? Der exakte Entitätstyp, die ID des Datensatzes sowie ein Feld-Diff mit Alt- und Neuwerten.
2. Wer hat es geändert? Die eindeutige Identität des Akteurs – ein automatisierter Bot, ein Dienstleister-System oder eine Mitarbeiterin bzw. ein Mitarbeiter.
3. Wann ist es passiert? Ein unveränderlicher, millisekundengenauer UTC-Zeitstempel.

Es gibt keine anonymen Änderungen durch „die API“. Jede Operation ist fest an einen spezifischen API-Schlüssel und eine Identität gekoppelt.

Aufbau eines Audit-Log-Eintrags

Das Protokoll ist maschinenlesbar strukturiert und lässt sich granular abfragen oder in externe SIEM- und Monitoring-Systeme einspeisen. Ein typischer Protokolleintrag:

{
  "id": "evt_01J8K3M9NP7Q4VR5WXYZ123456",
  "timestamp": "2026-03-24T14:32:00.123Z",
  "actor": {
    "type": "agent",
    "name": "rechnungs-extraktions-bot",
    "keyId": "key_01J8K1AB90CDEF1234567890",
    "binding": "tenant",
    "delegatedUser": null
  },
  "entity": {
    "type": "Contract",
    "id": "ctr_98765432-1234-abcd-ef01-23456789abcd",
    "propertyId": "obj_12345678-abcd-1234-5678-abcdef123456"
  },
  "action": "update",
  "changes": [
    {
      "field": "billingCycle",
      "oldValue": "monthly",
      "newValue": "quarterly"
    }
  ],
  "context": {
    "ipAddress": "198.51.100.42",
    "requestId": "req_88f912e4b01c"
  }
}

Eigene Identität pro Agent

Multi-Agenten-Architekturen erfordern eine klare Trennung der Verantwortlichkeiten. In einer modernen Verwaltung laufen häufig mehrere Automatisierungen parallel:

• Ein nächtlicher Abgleich mit dem Finanz- oder ERP-System
• Ein KI-Bot zur Kategorisierung eingehender Mieter- und Schadensmeldungen
• Eine Dokumenten-Extraktion für Eingangsrechnungen
• Persönliche Assistenz-Tools einzelner Objektbetreuer

Statt einen gemeinsamen Sammel-Key zu nutzen, gilt auf etg24: ein dedizierter Key pro Agent. Jeder Schlüssel trägt einen verständlichen Namen und eine feste Kennung, die über den gesamten Lebenszyklus erhalten bleibt.

Gezielte Isolation im Fehlerfall

Sollte ein Bot unerwartete Anfragen senden oder fehlerhafte Daten erzeugen, lässt sich anhand des Audit-Logs sofort erkennen, welcher Agent verantwortlich ist. Der betroffene Key kann in den Portaleinstellungen mit einem Klick gesperrt werden – ohne andere Integrationen oder Mitarbeiter zu beeinträchtigen.

Delegation: User-gebunden vs. Tenant-gebunden

Die Zuordnung unterscheidet zwei grundlegende Betriebsmodi:

• User-gebundene Keys: Der Agent agiert im Namen einer konkreten Person (z. B. ein E-Mail-Entwurfs-Bot für eine Sachbearbeiterin). Aktionen werden dem persönlichen Assistenten dieser Person zugeordnet.
• Tenant-gebundene Keys: Der Agent agiert im Namen des Unternehmens (z. B. systemweite Synchronisationen, Webhooks oder Migrationen).

Mehr zu den beiden Bindungsarten erfährst du unter Identität & Delegation.

Fundament für Governance und Wiederherstellung

Die lückenlose Änderungszuordnung ist der zentrale Baustein unserer Sicherheitsarchitektur:

• Berechtigungs-Scopes definieren, was ein Agent ausführen darf.
• Das Audit-Log dokumentiert jeden Schritt unveränderlich.
• Soft Delete & Rollback ermöglicht es, fehlerhafte Operationen gezielt rückgängig zu machen.