Saltar al contenido principal
La CLI admite dos tipos de credenciales. Los usuarios interactivos inician sesión una sola vez con un navegador; los scripts, los jobs de CI y los agentes configuran una clave de API en el entorno.

Inicio de sesión interactivo

Esto inicia un flujo de código de dispositivo (device-code). La CLI muestra una URL de verificación y un código de usuario corto, abre tu navegador cuando puede y espera a que apruebes la solicitud:
Al aprobar, se escribe un token de sesión en credentials.json, dentro del directorio de configuración, con permisos 0600. Puedes revisarlo en cualquier momento:
Para cerrar sesión y eliminar el token guardado:
Los tokens de sesión expiran. Cuando eso ocurre, la CLI lo borra y te pide que ejecutes chainpatrol login de nuevo, y termina con el código 2.

Iniciar sesión sin navegador

En un shell remoto, un contenedor o un runner de CI, la CLI detecta que no está conectada a una terminal y recurre a texto plano: la URL de verificación se imprime en stdout de inmediato, en lugar de quedar oculta detrás de una interfaz interactiva. Ábrela en cualquier dispositivo. Para un programa que analiza la salida, --json emite un objeto JSON por cada hito:
chainpatrol login --no-input se rechaza a menos que también pases --json. Sin alguno de ellos no hay forma de mostrar el código de dispositivo, así que el comando parecería quedarse colgado.

Autenticación con clave de API

Configura CHAINPATROL_API_KEY y la CLI la usará en lugar de una sesión guardada: sin paso de inicio de sesión y sin escribir nada en disco. Es la opción correcta para CI, tareas cron y cuentas de servicio.
La clave se envía en el encabezado X-API-KEY, el mismo que usa la External API, así que una clave de API existente funciona con la CLI tal cual. Una clave con alcance de organización lleva consigo su organización. Los comandos que de otro modo necesitarían --org (threats list, takedowns list, orgs assets list, reports search, proposals review) la resuelven a partir de la clave.
CHAINPATROL_API_KEY tiene prioridad sobre cualquier sesión guardada, así que puedes apuntar un solo shell a una cuenta de servicio para un único comando:

¿Qué identidad estoy usando?

Con una clave de API, whoami valida la clave e informa a qué organización está vinculada. Con un token de sesión, devuelve el usuario que inició sesión. En cualquier caso, es la verificación más rápida antes de un comando que escribe.

Permisos

La CLI tiene exactamente los permisos de la credencial que la respalda; no los amplía. Dos consecuencias que vale la pena conocer:
  • Las funciones exclusivas para staff (por ejemplo queues snapshot --all) fallan con el código de salida 5 cuando se usan credenciales de cliente.
  • Las revisiones de Proposals (propuestas para bloquear o permitir un asset) deben atribuirse a un miembro de la organización con rol de cliente, por lo que ahí se rechazan las credenciales de staff.