Crear destino 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"
}Auditoría y Registros
Crear destino SIEM
Administrar destinos de entrega de auditoría protegidos y con ámbito de entorno.
POST
/
v1
/
audit
/
siem
Crear destino 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"
}Verifique
delivery_available en la respuesta de la lista antes de habilitar un destino. La entrega cubre nuevos eventos de auditoría con atribución de entorno verificada. Los eventos históricos y no atribuidos no se transmiten. Un destino enabled no es evidencia de una ingesta exitosa; inspeccione delivery_counts y su receptor.audit:read; los cambios requieren audit:write. Una sesión de navegador debe pertenecer a un administrador del espacio de trabajo. Un destino de otro inquilino o entorno no puede ser actualizado o eliminado.
Las credenciales se cifran en reposo y nunca aparecen en las respuestas. Para webhooks, proporcione secret; para Splunk, Datadog o Elastic, proporcione token. Cambiar un endpoint requiere proporcionar sus credenciales nuevamente. La configuración de CloudWatch no es compatible.
Un entorno puede contener hasta 20 destinos. La eliminación de un destino elimina su credencial guardada y los registros de entrega en cola. Deshabilitar o cambiar un destino cancela sus entregas pendientes; guarde cualquier evidencia de entrega que necesite primero.
Consulte la guía de entrega de SIEM para reintentos, configuraciones de proveedor y verificación de webhook. Para la ingesta de instantáneas, utilice exportaciones de auditoría o exportaciones de eventos de riesgo. Estas exportaciones no permiten la transmisión continua.Cuerpo
application/json
Respuesta
Destino SIEM creado.

