Zum Hauptinhalt springen
PUT
SIEM-Ziel aktualisieren
Überprüfen Sie delivery_available in der Listenantwort, bevor Sie ein Ziel aktivieren. Die Zustellung umfasst neue Audit-Ereignisse mit verifizierter Umgebungszuordnung. Historische und nicht zugeordnete Ereignisse werden nicht gestreamt. Ein enabled-Ziel ist kein Beweis für eine erfolgreiche Aufnahme; überprüfen Sie delivery_counts und Ihren Empfänger.
Verwenden Sie den API-Schlüssel für die vorgesehene Sandbox- oder Produktionsumgebung. Das Auflisten erfordert audit:read; Änderungen erfordern audit:write. Eine Browsersitzung muss einem Arbeitsbereichs-Administrator gehören. Ein Ziel von einem anderen Mandanten oder einer anderen Umgebung kann nicht aktualisiert oder gelöscht werden. Anmeldeinformationen werden im Ruhezustand verschlüsselt und erscheinen niemals in Antworten. Für Webhooks geben Sie secret an; für Splunk, Datadog oder Elastic geben Sie token an. Das Ändern eines Endpunkts erfordert die erneute Angabe seiner Anmeldeinformationen. Die CloudWatch-Konfiguration wird nicht unterstützt. Eine Umgebung kann bis zu 20 Ziele aufnehmen. Das Löschen eines Ziels entfernt dessen gespeicherte Anmeldeinformationen und in der Warteschlange befindliche Zustellungsdatensätze. Das Deaktivieren oder Ändern eines Ziels bricht ausstehende Zustellungen ab; speichern Sie zuerst alle benötigten Zustellungsnachweise. Informationen zu Wiederholungsversuchen, Anbietereinstellungen und Webhook-Verifizierung finden Sie im SIEM-Bereitstellungshandbuch. Für die Snapshot-Aufnahme verwenden Sie Audit-Exporte oder Risikoereignis-Exporte. Diese Exporte ermöglichen kein kontinuierliches Streaming.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Pfadparameter

id
string<uuid>
erforderlich

SIEM-Ziel-ID.

Body

application/json
endpoint
string<uri>

Öffentlicher HTTPS-Hostname auf Port 443, ohne Benutzeranmeldeinformationen, Abfrageparameter oder Fragment. Das Ändern des Endpunkts erfordert die erneute Angabe der Anmeldeinformationen. Das Speichern validiert weder den Besitz noch die Zustellung.

Maximum string length: 2048
token
string
write-only

Token für Splunk-, Datadog- oder Elastic-Konfiguration. Bei der Erstellung für diese Anbieter erforderlich. Geben Sie kein Geheimnis an.

Required string length: 16 - 8192
secret
string
write-only

Gemeinsamer Schlüssel für die Webhook-Konfiguration. Bei der Erstellung für Webhook erforderlich. Geben Sie kein Token zusätzlich an.

Required string length: 16 - 8192
enabled
boolean
Standard:false

Ermöglicht die Zustellung neu aufgezeichneter umweltbezogener Audit-Ereignisse. Erfordert delivery_available=true; andernfalls gibt true 409 zurück. Standardmäßig false beim Erstellen eines Ziels.

Antwort

SIEM-Ziel aktualisiert.

id
string<uuid>
environment_id
string<uuid>
provider
enum<string>
Verfügbare Optionen:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
enabled
boolean
status
enum<string>
Verfügbare Optionen:
configured_delivery_unavailable,
disabled,
enabled
credential_configured
boolean
created_at
string<date-time>
updated_at
string<date-time>