Autenticación de la CLI

Inicia sesión en tu equipo, proporciona una credencial para CI y comprueba qué identidad utilizará un comando.

La CLI utiliza la primera credencial disponible: primero el --api-key global de la invocación, después LINGO_API_KEY y, por último, la clave o la sesión del navegador guardada en ~/.lingo/credentials.json. Tenlo en cuenta al cambiar de cuenta: un nuevo inicio de sesión guardado no puede sustituir una clave que ya hayas proporcionado a través del shell.

Iniciar sesión #

sh
lingo login
lingo whoami

Al iniciar sesión sin una clave, se abre el flujo OAuth en el navegador y se guarda una sesión. La CLI renueva las sesiones cuando están a punto de caducar; si la renovación falla, vuelve a iniciar sesión.

Iniciar sesión correctamente no completa la configuración de la organización ni cumple todos los requisitos de SSO de cada organización. Si la vinculación te devuelve a la aplicación web, completa la configuración de esa organización o inicia sesión mediante SSO antes de volver a intentarlo.

lingo login --api-key <value> valida y guarda una clave. En cambio, el --api-key global de otro comando solo se aplica a esa invocación. Se aceptan tanto la forma separada como la forma --api-key=value. Es preferible inyectar los secretos en lugar de pasarlos por la línea de comandos, ya que pueden quedar expuestos en el historial del shell, al inspeccionar los procesos o en los datos de diagnóstico.

La CLI crea su directorio de credenciales con el modo 0700 y su archivo de credenciales con el modo 0600.

Consultar la identidad #

sh
lingo whoami --json

El resultado indica el tipo de autenticación y el contexto disponible de la organización y del motor de localización. La consulta de identidad verifica las credenciales en línea. Si falla la conexión, puede devolver información limitada de los datos guardados; si se rechaza la autenticación, no se puede establecer una identidad válida.

Comprueba esta identidad antes de vincular un checkout. Un ID de recurso guardado determina qué recurso se utiliza, pero no concede a la credencial permiso para usarlo.

Cerrar sesión #

sh
lingo logout

Al cerrar sesión, se eliminan las credenciales guardadas de forma persistente. Una clave del entorno o una opción de la invocación pueden seguir autenticando comandos posteriores. Elimina la configuración del shell que tiene prioridad cuando quieras dejar de usarla. Cerrar sesión no revoca una clave, no elimina recursos ni desvincula el proyecto.

CI #

Proporciona LINGO_API_KEY mediante el mecanismo de secretos del ejecutor y guarda en el repositorio únicamente la configuración del proyecto que no contenga secretos. Ejecuta la CLI desde el directorio raíz del proyecto que quieras utilizar. No copies en CI la sesión guardada en el directorio personal de alguien del equipo de desarrollo.

La integración nativa con GitHub tiene sus propios permisos y su propio sistema de aprobación de ejecuciones, independientes de los de un ejecutor de CLI autogestionado.