Referencia CLI

whatalo login

Autentica el CLI con tu cuenta de desarrollador de Whatalo usando Device Flow en el navegador.

Sintaxis

whatalo login [opciones]

Opciones

FlagTipoDescripción
--portal-url <url>stringURL del Portal del Desarrollador
--forcebooleanVolver a autenticarse aunque ya haya sesión activa

Cómo funciona

whatalo login utiliza el flujo RFC 8628 Device Authorization Grant para que tus credenciales se ingresen en el navegador, nunca en la terminal.

Flujo paso a paso

  1. Sin --force, el CLI verifica si ya existe una sesión válida. Si la hay, muestra:
    Already logged in as [email protected]. Use --force to re-authenticate.
  2. Si no hay sesión válida (o se usa --force), el CLI solicita un código de dispositivo al portal
  3. Tu navegador se abre automáticamente con el URI de verificación que muestra un código de usuario
  4. Aprueba la solicitud en el navegador
  5. El CLI consulta cada 5 segundos hasta que el navegador confirme la aprobación
  6. Al tener éxito, los tokens se guardan en ~/.whatalo/session.json

Almacenamiento de tokens

UbicaciónPermisos
~/.whatalo/ (directorio)700
~/.whatalo/session.json (archivo)600

El token de acceso tiene un TTL de 1 hora y se renueva automáticamente. El token de actualización dura 30 días y rota en cada uso.

Ejemplos

Autenticarse por primera vez:

whatalo login

Forzar la re-autenticación (útil al cambiar de cuenta):

whatalo login --force

Autenticarse contra un portal propio:

whatalo login --portal-url https://developers.tu-empresa.com

Mensajes de error

MensajeCausa
Already logged in as {email}. Use --force to re-authenticate.Ya existe una sesión válida
The confirmation code has expired. Please try again.La verificación en el navegador tardó demasiado
Access was denied. Please try again.El usuario rechazó la solicitud en el navegador
Login failed: {message}Error de red o respuesta inesperada del portal

Comandos relacionados

On this page