Apidog Audit-Logs erfassen unterstützte sicherheitsrelevante Aktivitäten auf Organisationsebene. Organisationsinhaber und -administratoren können sie verwenden, um zu identifizieren, wer eine Aktion durchgeführt hat, wann sie stattfand, die Quell-IP-Adresse und die betroffene Organisationsressource.
Dieses Tutorial behandelt das Filtern, die Untersuchung, den CSV-Export und die API-basierte Sammlung. Diese Aufzeichnungen sind administrative Audit-Logs; sie sind keine Produktions-API-Anfrage- oder Gateway-Zugriffs-Logs.
Bevor Sie beginnen
- Audit-Logs sind im Enterprise SaaS-Plan verfügbar.
- Sie sind derzeit nicht in Apidog On-Premises verfügbar.
- Nur Organisationsinhaber und Organisationsadministratoren können sie anzeigen, exportieren oder abfragen.
- Audit-Log-Daten werden 180 Tage lang aufbewahrt.
Wenn Ihre Untersuchung über 180 Tage hinausgehen könnte, exportieren oder sammeln Sie die erforderlichen Datensätze, bevor sie ablaufen.
Schritt 1: Audit-Logs öffnen
Öffnen Sie Ihre Apidog-Organisation und navigieren Sie zu Audit-Logs in den Organisationseinstellungen.
Die Tabelle enthält:
- Akteur
- Ereignis
- Beschreibung
- IP-Adresse
- Zeit
Audit-Logs bieten Aufzeichnungen auf Organisationsebene für unterstützte Sicherheits- und Verwaltungsereignisse.
Authentifizierungsereignisse erscheinen nur, wenn Apidog sie der Organisation zuverlässig zuordnen kann.
Schritt 2: Untersuchungszeitraum festlegen
Beginnen Sie mit einer spezifischen Frage, wie zum Beispiel:
- Wer hat die Organisationsrolle eines Mitglieds geändert?
- Wann wurde ein Zugriffstoken rotiert oder widerrufen?
- Welches Konto hat die SSO-Konfiguration geändert?
- Wer hat eine Docs Site- oder geteilte Dokument-Zugriffseinstellung geändert?
- Wurde ein Benutzer über SCIM bereitgestellt oder entfernt?
Verwenden Sie den engstmöglichen praktischen Zeitbereich. Verfügbare Voreinstellungen umfassen die letzten 7, 30, 90 und 180 Tage. Sie können auch einen benutzerdefinierten Bereich innerhalb der 180-tägigen Aufbewahrungsfrist auswählen.
Notieren Sie die Zeitzone, die von Ihrem Vorfall- oder Auditprozess verwendet wird, bevor Sie diese Ereignisse mit Identitätsanbieter-, Ticketing-, Git- oder Dienstprotokollen vergleichen.
Schritt 3: Filter anwenden
Filtern Sie die Tabelle nach:
- Zeitbereich – wann das Ereignis möglicherweise stattgefunden hat.
- Ereignis – die relevante Aktion, wie z.B. eine Rollenänderung, ein Anmeldefehler, eine Änderung des Zugriffstokens oder ein Audit-Log-Export.
- Akteur – der Benutzer oder die Integration, die die Aktion durchgeführt hat.
Kombinieren Sie Zeit-, Ereignis- und Akteurfilter, um die für eine Untersuchung erforderlichen Aufzeichnungen zu isolieren.
Wenn Sie den Akteur nicht kennen, beginnen Sie mit Zeit und Ereignis. Wenn der Ereignisname unsicher ist, beginnen Sie mit dem Akteur und einem kurzen Zeitbereich.
Schritt 4: Ereignisdetails überprüfen
Erfassen Sie für jede relevante Zeile:
- die Ereigniszeit
- der Akteur oder die Integration
- die Aktion und Beschreibung
- die Quell-IP-Adresse
- das betroffene Mitglied, Team, die Einstellung oder Ressource
Korrelieren Sie dann das Ereignis mit der Quelle, die die nächste Frage beantworten kann:
| Frage | Zusätzlicher Nachweis |
|---|---|
| Wurde die Aktion genehmigt? | Änderungsanforderung, Zugriffsüberprüfung oder Ticket |
| War die Anmeldung erwartet? | Anmelde- und Geräteprotokolle des Identitätsanbieters |
| Welcher API-Traffic folgte? | Gateway-, Anwendungs- oder API-Zugriffsprotokolle |
| Welcher Inhalt wurde geändert? | Ressourcenhistorie, Spezifikationsdifferenz oder Git-Historie |
| Wurde ein Anmeldeinformation verwendet? | Protokolle des Systems, das die Anmeldeinformationen ausgestellt hat |
Ein Audit-Ereignis zeigt, dass eine unterstützte Aktion stattgefunden hat. Es beweist jedoch nicht von selbst, dass die Aktion autorisiert, sicher oder konform war.
Schritt 5: Die gefilterten Ergebnisse als CSV exportieren
Nachdem die Filter korrekt sind:
- überprüfen Sie die sichtbaren Ergebnisse
- wählen Sie die CSV-Exportoption
- speichern Sie die Datei am genehmigten Untersuchungs- oder Audit-Ort
- zeichnen Sie die Exportzeit, Filterkriterien und die Person auf, die die Datei bearbeitet
Der CSV-Export verwendet die aktuell auf die Audit-Logs-Seite angewendeten Filter und umfasst übereinstimmende Aufzeichnungen innerhalb der 180-tägigen Aufbewahrungsfrist.
Das Exportieren von Audit-Logs wird selbst in den Audit-Logs aufgezeichnet. Die resultierende CSV-Datei ist eine separate Kopie, daher schützen Sie sie mit entsprechenden Zugriffs-, Aufbewahrungs- und Integritätskontrollen.
Schritt 6: Audit-Logs mit der API sammeln
Enterprise-Organisationen können Datensätze programmgesteuert über die Audit-Logs-API abfragen. Die API unterstützt Zeitfenster-Abfragen und Cursor-Paginierung innerhalb der 180-tägigen Aufbewahrungsfrist.
Für einen geplanten Sammlungsprozess:
- wählen Sie ein Sammelintervall, das kürzer ist als das Aufbewahrungsfenster
- fragen Sie eine definierte Start- und Endzeit ab
- folgen Sie der Cursor-Paginierung, bis der Ergebnissatz vollständig ist
- speichern Sie den Sammlungskontrollpunkt
- wiederholen Sie fehlgeschlagene Fenster, ohne Stille Lücken zu erzeugen
- schützen Sie das Ziel gemäß seiner Sensibilität und Aufbewahrungsrichtlinie
Jede API-Abfrage wird als Zusammenfassung aufgezeichnet, die den Aufrufer, die IP-Adresse, das Abfragefenster, das Limit, das Ergebnis und den Zeitstempel umfassen kann. Die vollständig zurückgegebene Nutzlast wird nicht in die Metadaten dieses Ereignisses kopiert.
Validieren Sie die aktuelle API-Referenz, bevor Sie Authentifizierung, Endpunktpfade, Anforderungsparameter oder die Antwortanalyse implementieren. Kopieren Sie kein ungeprüftes Codebeispiel in einen Produktions-Collector.
Untersuchungsdatensatz überprüfen
Bevor Sie eine Untersuchung abschließen, bestätigen Sie, dass Sie Folgendes getan haben:
- den exakten Zeitbereich und die verwendeten Filter gespeichert haben
- alle relevanten Ergebnisseiten erfasst haben
- die ursprüngliche CSV- oder API-Antwort an einem genehmigten Ort aufbewahrt haben
- wichtige Aktionen mit Identitäts-, Änderungsmanagement- und Laufzeitnachweisen korreliert haben
- alle Lücken dokumentiert haben, die durch Aufbewahrung, Zuordnung oder nicht unterstützte Ereignistypen entstanden sind
Bei Zugriffsänderungen überprüfen Sie auch den aktuellen Status. Ein Log kann zeigen, dass eine Rolle geändert wurde, aber die Mitgliederseite zeigt, welche Rolle jetzt zugewiesen ist.
Umgang mit sensiblen Daten
Apidog wendet dieselbe Redaktionsrichtlinie auf die Audit-Logs-Seite, CSV-Exporte und API-Antworten an. Audit-Datensätze legen keine Token-Werte, Passwörter, geheime Werte, rohe SAML-Assertionen, Reset-Tokens, private Schlüssel oder exportierte Dateiinhalte offen.
Metadaten können weiterhin sensibel sein. Beschränken Sie den Zugriff auf exportierte Datensätze und vermeiden Sie es, diese in öffentlichen Tickets oder geteilten Dokumenten abzulegen.
Fehlerbehebung
| Problem | Was zu überprüfen ist |
|---|---|
| Die Audit-Logs-Seite ist nicht verfügbar | Bestätigen Sie, dass die Organisation Enterprise SaaS verwendet und der Betrachter ein Organisationsinhaber oder -administrator ist. |
| Ein erwartetes Authentifizierungsereignis fehlt | Authentifizierungsereignisse erscheinen nur, wenn Apidog sie der Organisation zuverlässig zuordnen kann. Überprüfen Sie auch den Identitätsanbieter. |
| Die CSV-Datei enthält weniger Datensätze als erwartet | Überprüfen Sie die aktiven Zeit-, Ereignis- und Akteurfilter. Der Export verwendet die aktuellen Filter. |
| Ein API-Collector überspringt Datensätze | Überprüfen Sie das Abfragefenster, die Cursor-Behandlung, Wiederholungsversuche und das 180-Tage-Limit. |
| Laufzeit-API-Aufrufe fehlen | Verwenden Sie Gateway-, Anwendungs- oder API-Zugriffsprotokolle. Apidog Audit-Logs sind administrative Organisationsprotokolle. |
Wichtige Einschränkungen
Audit-Logs bieten keine Produktionsanfrageprotokolle, Ressourcenhistorie, Rollback oder vollständige Wiederherstellung auf Feldebene. Native SIEM-Konnektoren, Syslog, generische Webhook-Weiterleitung und Echtzeit-Streaming werden derzeit nicht unterstützt. Die geplante API-Sammlung ist die dokumentierte Option zum Senden von Datensätzen an eine externe Überwachungs- oder Audit-Pipeline.
Verwandte API-Governance-Tutorials:
Diese Tutorials behandeln ergänzende Kontrollen zur Steuerung eines Enterprise API-Arbeitsbereichs:
- API-Governance-Framework – Verbinden Sie Eigentum, Kontrollen, Nachweise und Lebenszyklusentscheidungen.
- SAML-Gruppen-Mapping mit Microsoft Entra ID – Weisen Sie Teamzugriff von Identitätsanbietergruppen zu.
- Secret Scanner – Überprüfen Sie mögliche offengelegte Anmeldeinformationen in unterstützten Apidog-Assets.
- Audit-Logs – Untersuchen und exportieren Sie administrative Organisationsaktivitäten.
- SCIM-Bereitstellung – Verwalten Sie Organisationsbenutzer über den Identitätslebenszyklus.
- Enterprise-Richtlinien – Konfigurieren Sie Anmeldeinformationen, Mitgliedschaft, SSO-Sitzung und Einladungskontrollen.
- Self-Service API-Teams – Ermöglichen Sie von Mitgliedern erstellte Teams unter Beibehaltung der Eigentumsaufsicht.
- GitHub Enterprise Cloud Integration – Verbinden Sie unterstützte GHE.com-Repositories für OpenAPI-Workflows.
Verwandte offizielle Dokumentation: