Paquetes de inscripción e instalación
Un paquete de instalación es la unidad que usted construye para implementar el agente. Incluye la plataforma, las etiquetas y el grupo al que debe unirse un dispositivo, y una clave de inscripción dedicada, por lo que el comando de instalación es autónomo.Creando un paquete
En Admin → Registro de agentes → Agentes del sistema operativo, cree un paquete con:
Al guardar, SecureAI genera automáticamente una clave API dedicada con alcance
agent:enroll y la almacena como clave de inscripción del paquete, por lo que el comando de instalación no necesita una credencial separada. Al eliminar el paquete se desactiva esa clave.
Grupos de inscripción (pin automático)
El grupo de inscripción del paquete es un pin fijo: un dispositivo que se inscribe en el paquete está vinculado a ese grupo en el primer contacto. La pertenencia al grupo determina qué política resuelve el dispositivo.El apretón de manos de inscripción
Cuando el agente se ejecuta por primera vez, llama aPOST /enroll usando la clave de inscripción y envía la identificación de su máquina, nombre de host, sistema operativo, arquitectura, versión, huella digital y capacidades. El backend:
- Registra (o coincide) el dispositivo.
- Emite un token por dispositivo, que se muestra una vez, que autentica todas las llamadas posteriores.
- Devuelve la configuración del tiempo de ejecución (política resuelta, configuración de salida, enrutamiento, etc.).
revoked: true y el dispositivo permanece desconectado hasta que un administrador lo vuelve a habilitar.
Resolución de URL de backend
El agente llama a casa deBACKEND_URL. En el lado del servidor, la URL efectiva se resuelve a partir de encabezados de origen de solicitud/reenviados y se puede anular con la variable de entorno SECUREAI_AGENT_URL, que es útil detrás de servidores proxy inversos.