Créer une destination SIEM
curl --request POST \
--url https://api.truthlocks.com/v1/audit/siem \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"provider": "webhook",
"endpoint": "https://logs.example.com/ingest"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({provider: 'webhook', endpoint: 'https://logs.example.com/ingest'})
};
fetch('https://api.truthlocks.com/v1/audit/siem', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/audit/siem"
payload = {
"provider": "webhook",
"endpoint": "https://logs.example.com/ingest"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/audit/siem"
payload := strings.NewReader("{\n \"provider\": \"webhook\",\n \"endpoint\": \"https://logs.example.com/ingest\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": "splunk",
"endpoint": "<string>",
"enabled": true,
"status": "configured_delivery_unavailable",
"credential_configured": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}Audit et journaux
Créer une destination SIEM
Gérer les destinations de livraison d’audit protégées et délimitées par l’environnement.
POST
/
v1
/
audit
/
siem
Créer une destination SIEM
curl --request POST \
--url https://api.truthlocks.com/v1/audit/siem \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"provider": "webhook",
"endpoint": "https://logs.example.com/ingest"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({provider: 'webhook', endpoint: 'https://logs.example.com/ingest'})
};
fetch('https://api.truthlocks.com/v1/audit/siem', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/audit/siem"
payload = {
"provider": "webhook",
"endpoint": "https://logs.example.com/ingest"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/audit/siem"
payload := strings.NewReader("{\n \"provider\": \"webhook\",\n \"endpoint\": \"https://logs.example.com/ingest\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": "splunk",
"endpoint": "<string>",
"enabled": true,
"status": "configured_delivery_unavailable",
"credential_configured": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}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.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.Corps
application/json
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:
2048Réponse
Destination SIEM créée.

