Passer au contenu principal
POST
Créer une destination SIEM
Vérifiez delivery_available dans la réponse de la liste avant d’activer une destination. La livraison couvre les nouveaux événements d’audit avec attribution d’environnement vérifiée. Les événements historiques et non attribués ne sont pas diffusés. Une destination enabled n’est pas une preuve d’ingestion réussie ; inspectez delivery_counts et votre récepteur.
Utilisez la clé API pour l’environnement sandbox ou de production prévu. La liste nécessite audit:read ; les modifications nécessitent audit:write. Une session de navigateur doit appartenir à un administrateur d’espace de travail. Une destination d’un autre locataire ou environnement ne peut pas être mise à jour ou supprimée. Les identifiants sont chiffrés au repos et n’apparaissent jamais dans les réponses. Pour les webhooks, fournissez secret ; pour Splunk, Datadog ou Elastic, fournissez token. La modification d’un point de terminaison nécessite de fournir à nouveau ses identifiants. La configuration CloudWatch n’est pas prise en charge. Un environnement peut contenir jusqu’à 20 destinations. La suppression d’une destination supprime ses identifiants enregistrés et ses enregistrements de livraison en file d’attente. La désactivation ou la modification d’une destination annule ses livraisons en attente ; enregistrez d’abord toutes les preuves de livraison dont vous avez besoin. Consultez le guide de livraison SIEM pour les tentatives, les paramètres du fournisseur et la vérification des webhooks. Pour l’ingestion d’instantanés, utilisez les exportations d’audit ou les exportations d’événements à risque. Ces exportations n’activent pas le streaming continu.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
provider
enum<string>
requis

Type de fournisseur SIEM.

Options disponibles:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
requis

Nom d'hôte HTTPS public sur le port 443, sans identifiants utilisateur, paramètres de requête ou fragment. La modification du point de terminaison nécessite de fournir à nouveau l'identifiant. La sauvegarde ne valide pas la propriété ou la livraison.

Maximum string length: 2048
token
string
write-only

Jeton pour la configuration Splunk, Datadog ou Elastic. Requis à la création pour ces fournisseurs. Ne pas fournir de secret également.

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

Secret partagé pour la configuration du webhook. Requis à la création pour le webhook. Ne fournissez pas de jeton également.

Required string length: 16 - 8192
enabled
boolean
défaut:false

Permet la livraison des événements d'audit nouvellement enregistrés attribués à l'environnement. Nécessite delivery_available=true ; sinon true renvoie 409. Par défaut à false lors de la création d'une destination.

Réponse

Destination SIEM créée.

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