Herramienta de línea de comandos (CLI)

Instale la CLI de ZeusLock desde npm, inicie sesión con un token de acceso personal del panel y gestione incidentes, agentes, usuarios y análisis desde su terminal.

Qué es la CLI

La CLI de ZeusLock (zeuslock) lleva el panel a su terminal: incidentes, estadísticas, agentes, usuarios, claves API, monitorización de Shadow AI y MCP, exportación SIEM, análisis DLP y anonimización — todo automatizable. Se comunica con el mismo backend que el panel.

Instalación

La CLI está publicada en npm como @zeuslock/cli y requiere Node.js 22.12 o más reciente. Instálela globalmente y compruebe la versión:

npm install -g @zeuslock/cli
zeuslock --version

Inicio de sesión con un token de acceso CLI

La CLI se autentica con un token de acceso personal (zlu_…) que actúa en su nombre, con su rol. La contraseña y el captcha se quedan en el navegador — el terminal nunca los pide.

  1. En el panel, abra la página CLI desde la barra lateral.
  2. Haga clic en Generar token, asígnele un nombre (por ejemplo portatil-trabajo) y copie el valor zlu_….
  3. En su terminal, defina el token y verifique su identidad:

macOS / Linux

export ZEUSLOCK_API_TOKEN="zlu_...your-token..."
zeuslock whoami

Windows (PowerShell)

$env:ZEUSLOCK_API_TOKEN = "zlu_...your-token..."
zeuslock whoami

Los tokens caducan a los 90 días por defecto y pueden revocarse en cualquier momento desde la misma página. Desde la CLI v0.2.0, zeuslock auth login --token zlu_… guarda el token por usted; la variable de entorno funciona con todas las versiones.

Comandos útiles

Algunos comandos para empezar:

zeuslock status
zeuslock incidents list --days 7
zeuslock incidents stats
zeuslock agents list --status online
zeuslock users list
zeuslock shadow-ai stats --days 30

Todos los comandos aceptan --help, y la mayoría aceptan --json para scripts.

El análisis y el SIEM usan una clave API de organización

Los comandos de contenido — scan, anonymize, los hooks de Git pre-commit — y la exportación SIEM se autentican con una clave API de organización (zl_…) en lugar de su token personal, porque actúan para la organización y no para una persona:

zeuslock auth api-key set zl_your_org_api_key
zeuslock scan ./document.txt
zeuslock anonymize ./dataset.txt --output dataset.safe.txt
zeuslock hook install

Las claves de organización se crean en la página Claves API del panel — consulte Gestionar claves API.

Solución de problemas

  • zeuslock: comando no encontrado — Node.js 22.12+ y npm deben estar instalados, y el directorio global de npm debe estar en su PATH. Vuelva a ejecutar npm install -g @zeuslock/cli y abra un terminal nuevo.
  • 401 Unauthorized — El token fue revocado, caducó o se pegó de forma incompleta. Genere un token nuevo en la página CLI del panel y defínalo de nuevo.
  • scan pide una clave API — Los comandos de contenido necesitan la clave de organización: ejecute zeuslock auth api-key set zl_… con una clave de la página Claves API.

Referencia completa de comandos

Esta guía cubre solo la instalación y el inicio de sesión. Para todos los comandos — incidentes, agentes, usuarios, claves, Shadow AI, MCP, exportación SIEM, artefactos de despliegue y políticas como código — con todas las opciones, valores y predeterminados, consulte la Referencia de comandos de la CLI.