Listar destinos SIEM
curl --request GET \
--url https://api.truthlocks.com/v1/audit/siem \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
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"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/audit/siem"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"items": [
{
"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"
}
],
"delivery_counts": {},
"coverage": "<string>",
"delivery_available": true
}Auditoria e Registros
Listar destino SIEM
Gerenciar destinos de entrega de auditoria protegidos e com escopo de ambiente.
GET
/
v1
/
audit
/
siem
Listar destinos SIEM
curl --request GET \
--url https://api.truthlocks.com/v1/audit/siem \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
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"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/audit/siem"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"items": [
{
"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"
}
],
"delivery_counts": {},
"coverage": "<string>",
"delivery_available": true
}Verifique
delivery_available na resposta da lista antes de habilitar um destino. A entrega cobre novos eventos de auditoria com atribuição de ambiente verificada. Eventos históricos e não atribuídos não são transmitidos. Um destino enabled não é evidência de ingestão bem-sucedida; inspecione delivery_counts e seu receptor.audit:read; as alterações requerem audit:write. Uma sessão de navegador deve pertencer a um administrador do espaço de trabalho. Um destino de outro locatário ou ambiente não pode ser atualizado ou excluído.
As credenciais são criptografadas em repouso e nunca aparecem nas respostas. Para webhooks, forneça secret; para Splunk, Datadog ou Elastic, forneça token. Alterar um endpoint requer o fornecimento de sua credencial novamente. A configuração do CloudWatch não é suportada.
Um ambiente pode conter até 20 destinos. A exclusão de um destino remove as suas credenciais guardadas e os registos de entrega em fila. Desativar ou alterar um destino cancela as suas entregas pendentes; guarde qualquer evidência de entrega de que precise primeiro.
Consulte o guia de entrega SIEM para retentativas, configurações do provedor e verificação de webhook. Para ingestão de snapshot, use exportações de auditoria ou exportações de eventos de risco. Essas exportações não permitem streaming contínuo.
