Autenticación
La CLI inicia sesión a través de tu navegador, un código de dispositivo o una clave de API, y en scripts y CI lee la credencial de un flag o una variable de entorno. Ejecuta polylane auth login para elegir un método de forma interactiva, o pasa un flag para saltarte el selector.
Métodos de inicio de sesión
| Método | Comando | Descripción |
|---|---|---|
| Navegador | polylane auth login | Para uso interactivo. La CLI abre tu navegador, recibe los tokens en un callback de localhost y los renueva a medida que caducan. |
| Código de dispositivo | polylane auth login --no-browser | Para SSH y máquinas sin interfaz gráfica. La CLI imprime una URL y un código; abre la URL en cualquier dispositivo, introduce el código y la CLI sondea hasta que apruebas. |
| Clave de API | polylane auth login --api-key sk_xxxxx | Para scripts, CI y agentes. La CLI valida la clave y la guarda con un espacio de trabajo por defecto. |
Tras iniciar sesión la CLI muestra quién eres y, si perteneces a más de un espacio de trabajo, te pide que elijas uno por defecto, guardado como workspace_id en ~/.polylane/config.json. Fuerza una renovación del token con polylane auth refresh.
Claves de API
Crea una clave en Settings > API Keys con Create an API key: dale un nombre, elige sus ámbitos y cópiala, porque se muestra una sola vez. Las claves empiezan por sk_. En CI, define POLYLANE_API_KEY en el entorno en lugar de ejecutar el paso de inicio de sesión, o pasa el flag global --api-key <key> en una sola llamada.
Precedencia de credenciales
Cuando hay varias credenciales presentes, la CLI las resuelve en este orden:
- El flag
--api-keyen el comando actual - La variable de entorno
POLYLANE_API_KEY - Las credenciales OAuth en
~/.polylane/credentials.json api_keyen~/.polylane/config.json
Una POLYLANE_API_KEY exportada siempre gana a un ~/.polylane/credentials.json obsoleto, así que un runner de CI con la variable definida no recoge tokens OAuth sobrantes. polylane auth status muestra qué origen está en uso.
Comprobar y cambiar
polylane auth status
polylane auth whoami
polylane auth logout
auth status muestra el método en uso, un token enmascarado, el usuario y el espacio de trabajo; auth whoami muestra el usuario actual. auth logout revoca los tokens OAuth y borra las credenciales guardadas tras una confirmación, que --yes omite; para cambiar de cuenta, cierra sesión e inicia sesión con la otra credencial.
Variables de entorno
| Variable | Descripción |
|---|---|
POLYLANE_API_KEY | Clave de API para autenticación no interactiva |
POLYLANE_WORKSPACE_ID | Espacio de trabajo por defecto (id ws_) |
POLYLANE_API_DOMAIN | Sobrescribe el nombre de host de la API |
Úsalas en trabajos de CI y contenedores donde no quieras escribir en ~/.polylane/. Configuración lista el conjunto completo.
Relacionado
- Configuración: el orden de precedencia completo, cada variable de entorno y los archivos en disco.
- Scripting: salida JSON, códigos de salida y los flags para CI y agentes.
- Claves de API y OAuth: ámbitos, gestión de claves y clientes OAuth.