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
| Flag | Tipo | Descripción |
|---|---|---|
--portal-url <url> | string | URL del Portal del Desarrollador |
--force | boolean | Volver 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
- 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. - Si no hay sesión válida (o se usa
--force), el CLI solicita un código de dispositivo al portal - Tu navegador se abre automáticamente con el URI de verificación que muestra un código de usuario
- Aprueba la solicitud en el navegador
- El CLI consulta cada 5 segundos hasta que el navegador confirme la aprobación
- Al tener éxito, los tokens se guardan en
~/.whatalo/session.json
Almacenamiento de tokens
| Ubicación | Permisos |
|---|---|
~/.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 loginForzar la re-autenticación (útil al cambiar de cuenta):
whatalo login --forceAutenticarse contra un portal propio:
whatalo login --portal-url https://developers.tu-empresa.comMensajes de error
| Mensaje | Causa |
|---|---|
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
whatalo logout— Cerrar sesiónwhatalo whoami— Verificar la sesión actual