Saltar para o conteúdo principal
POST
Criar destino SIEM
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.
Use a chave de API para o ambiente de sandbox ou produção pretendido. A listagem requer 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.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
provider
enum<string>
obrigatório

Tipo de provedor SIEM.

Opções disponíveis:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
obrigatório

Nome de host HTTPS público na porta 443, sem credenciais de usuário, parâmetros de consulta ou fragmento. Alterar o endpoint requer fornecer a credencial novamente. Salvar não valida a propriedade ou a entrega.

Maximum string length: 2048
token
string
write-only

Token para configuração Splunk, Datadog ou Elastic. Necessário na criação para esses provedores. Não forneça o segredo também.

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

Segredo compartilhado para configuração de webhook. Obrigatório na criação para webhook. Não forneça token também.

Required string length: 16 - 8192
enabled
boolean
padrão:false

Habilita a entrega de eventos de auditoria recém-registrados atribuídos ao ambiente. Requer delivery_available=true; caso contrário, true retorna 409. O padrão é false ao criar um destino.

Resposta

Destino SIEM criado.

id
string<uuid>
environment_id
string<uuid>
provider
enum<string>
Opções disponíveis:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
enabled
boolean
status
enum<string>
Opções disponíveis:
configured_delivery_unavailable,
disabled,
enabled
credential_configured
boolean
created_at
string<date-time>
updated_at
string<date-time>