Saltar para o conteúdo principal
POST
Botão de Desligamento de Emergência
Use este endpoint para uma emergência, como um agente comprometido. Forneça o identificador do agente e um incidente não vazio reason (máximo de 2000 bytes UTF-8). O espaço de trabalho e o ambiente autenticados determinam qual agente você pode revogar. A operação revoga o agente e seus descendentes delegados, encerra suas sessões ativas, revoga seus links de delegação ativos e persiste a decisão em uma transação de banco de dados. Se essa transação falhar, suas alterações de estado são revertidas.
A revogação é permanente. Registre um novo agente se o trabalho precisar ser retomado. As evidências de recibos emitidos anteriormente são preservadas; este endpoint não as apaga nem as reescreve.

Verificar o resultado

Uma resposta bem-sucedida tem status: "killed". agents_changed inclui o agente solicitado; cascade_count conta os descendentes recém-revogados. sessions_terminated e delegations_revoked relatam as sessões afetadas e os links de delegação. Quando a assinatura gerenciada é bem-sucedida, receipt_status é signed e receipt_id identifica um recibo de revogação assinado. Recupere-o através da API de recibos. A validade da assinatura e o status do ciclo de vida do agente revogado são verificações separadas. Quando a assinatura não está disponível, a revogação ainda é bem-sucedida: receipt_status é unavailable e receipt_id é null. A decisão de revogação durável permanece registrada. Nenhum recibo assinado ou nova tentativa automática de assinatura está implícito nessa resposta.

Comportamento de auditoria

O serviço registra um evento agent.killed e um evento de revogação juntamente com as mudanças de estado. Uma resposta não estabelece ancoragem de transparência externa, entrega de webhook ou entrega SIEM. Verifique esses canais separadamente se o seu processo de incidente depender deles. Um agente desconhecido no ambiente de espaço de trabalho selecionado retorna 404. Um agente já revogado retorna 409. Revise o estado existente antes de tentar novamente um pedido de emergência.

Autorizações

X-API-Key
string
header
obrigatório

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

Parâmetros de caminho

agentId
string
obrigatório

Identificador do agente

Corpo

application/json
reason
string
obrigatório

Motivo do incidente não vazio, no máximo 2000 bytes UTF-8

Required string length: 1 - 2000

Resposta

Agente morto

agent_id
string
tenant_id
string<uuid>
status
enum<string>
Opções disponíveis:
killed
agents_changed
integer
cascade_count
integer

Agentes descendentes recém-revogados, excluindo o agente solicitado.

sessions_terminated
integer
delegations_revoked
integer
reason
string
killed_at
string<date-time>
receipt_id
string | null

Identificador de recibo de revogação assinado, ou nulo quando a assinatura não estava disponível.

receipt_status
enum<string>

Indisponível não desfaz a revogação de emergência concluída.

Opções disponíveis:
signed,
unavailable