SIEM-Ziel erstellen
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 & Protokolle
SIEM-Ziel erstellen
Verwalten Sie geschützte, umgebungsbezogene Audit-Zustellungsziele.
POST
/
v1
/
audit
/
siem
SIEM-Ziel erstellen
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"
}Ü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.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
Body
application/json
Ö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:
2048Antwort
SIEM-Ziel erstellt.

