Autenticación de la CLI
Inicia sesión localmente, proporciona una credencial de CI y verifica qué identidad usará un comando.
La CLI usa 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 almacenada en ~/.lingo/credentials.json. Ten esto en cuenta al cambiar de cuenta: un nuevo inicio de sesión almacenado no puede reemplazar una clave que tu shell ya haya proporcionado.
Iniciar sesión #
lingo login
lingo whoamiAl iniciar sesión sin una clave, se abre el flujo de OAuth en el navegador y se almacena una sesión. La CLI renueva las sesiones cuando están por vencer; si la renovación falla, vuelve a iniciar sesión.
Iniciar sesión correctamente no completa la configuración de la organización ni satisface los requisitos de SSO de todas las organizaciones. Si la vinculación te lleva de vuelta a la aplicación web, completa la configuración o el inicio de sesión con SSO de esa organización antes de volver a intentarlo.
lingo login --api-key <value> valida y almacena una clave. En cambio, el --api-key global usado en otro comando se aplica solo a esa invocación. Se reconocen tanto la forma separada como la forma --api-key=value. Es preferible inyectar secretos en lugar de pasarlos por la línea de comandos, ya que pueden quedar expuestos en el historial del shell, al inspeccionar procesos o en los diagnósticos.
La CLI crea su directorio de credenciales con el modo 0700 y su archivo de credenciales con el modo 0600.
Consultar identidad #
lingo whoami --jsonEl resultado muestra el tipo de autenticación y el contexto disponible de la organización y del motor de localización. El comando de consulta de identidad verifica las credenciales en línea. Si falla la conexión, puede devolver información almacenada limitada; si se rechaza la autenticación, no se establece una identidad válida.
Verifica esta identidad antes de vincular un checkout. Un ID de recurso guardado determina qué recurso usar; no le otorga a la credencial permiso para usarlo.
Cerrar sesión #
lingo logoutCerrar sesión elimina las credenciales almacenadas. Una clave de entorno o una opción de invocación todavía puede autenticar comandos posteriores. Elimina la configuración del shell que tiene prioridad cuando quieras dejar de usarla. Cerrar sesión no revoca claves, no elimina recursos ni desvincula el proyecto.
CI #
Proporciona LINGO_API_KEY mediante el mecanismo de secretos del ejecutor y guarda en el repositorio solo la configuración del proyecto que no contenga secretos. Ejecuta la CLI desde el directorio raíz del proyecto que quieras usar. No copies en CI la sesión almacenada en el directorio personal de un desarrollador.
La integración nativa con GitHub tiene sus propios permisos y su propia aprobación de ejecuciones, independientes de los de un ejecutor de CLI autogestionado.