Inicio de sesión interactivo
credentials.json, dentro del directorio de
configuración, con permisos 0600. Puedes revisarlo en
cualquier momento:
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:
Autenticación con clave de API
ConfiguraCHAINPATROL_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.
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.
¿Qué identidad estoy usando?
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 salida5cuando 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.