Pacotes de inscrição e instalação
Um pacote de instalação é a unidade que você cria para implementar o agente. Ele agrupa a plataforma, as tags e o grupo ao qual um dispositivo deve ingressar e uma chave de registro dedicada – portanto, o comando de instalação é independente.Criando um pacote
Em Admin → Agent Registry → OS Agents, crie um pacote com:
Ao salvar, SecureAI gera automaticamente uma chave de API dedicada com escopo para
agent:enroll e a armazena como a chave de inscrição do pacote, portanto, o comando de instalação não precisa de credencial separada. Excluir o pacote desativa essa chave.
Grupos de inscrição (fixação automática)
O grupo de inscrição do pacote é um hard pin: um dispositivo que se inscreve no pacote é vinculado a esse grupo no primeiro contato. A associação ao grupo determina qual política o dispositivo resolve.O handshake de inscrição
Quando o agente é executado pela primeira vez, ele chamaPOST /enroll usando a chave de inscrição e envia seu ID de máquina, nome de host, sistema operacional, arquitetura, versão, impressão digital e recursos. O back-end:
- Registra (ou corresponde) o dispositivo.
- Emite um token por dispositivo, mostrado uma vez, que autentica todas as chamadas subsequentes.
- Retorna a configuração do tempo de execução (política resolvida, configurações de saída, roteamento, etc.).
revoked: true e o dispositivo permanece desligado até que um administrador o reative.
Resolução de URL de back-end
O agente liga para casa paraBACKEND_URL. No lado do servidor, o URL efetivo é resolvido a partir de cabeçalhos encaminhados/de origem da solicitação e pode ser substituído pela variável de ambiente SECUREAI_AGENT_URL, que é útil por trás de proxies reversos.