Autenticação da CLI

Entre localmente, forneça uma credencial de CI e confira qual identidade um comando usará.

A CLI usa a primeira credencial disponível, nesta ordem: a opção global --api-key da execução, LINGO_API_KEY e, por fim, a chave ou a sessão do navegador armazenada em ~/.lingo/credentials.json. Isso é importante ao alternar entre contas: um novo login salvo não substitui uma chave já fornecida pelo shell.

Entrar #

sh
lingo login
lingo whoami

Ao entrar sem uma chave, a CLI abre o fluxo OAuth no navegador e armazena uma sessão. A CLI renova as sessões quando estão perto de expirar; se a renovação falhar, entre novamente.

Entrar com sucesso não conclui a configuração da organização nem atende aos requisitos de SSO de todas as organizações. Se a vinculação levar você de volta ao aplicativo web, conclua a configuração ou o login por SSO dessa organização antes de tentar novamente.

lingo login --api-key <value> valida e armazena uma chave. Já a opção global --api-key usada em outro comando vale apenas para aquela execução. São aceitos tanto o formato separado quanto o formato --api-key=value. Prefira injetar segredos em vez de fornecê-los na linha de comando, pois eles podem ficar expostos no histórico do shell, na inspeção de processos ou em diagnósticos.

A CLI cria o diretório de credenciais com o modo 0700 e o arquivo de credenciais com o modo 0600.

Verificar identidade #

sh
lingo whoami --json

O resultado identifica o tipo de autenticação e o contexto disponível de organização e engine de localização. O comando whoami verifica as credenciais online. Se houver uma falha de conexão, ele poderá retornar informações limitadas armazenadas localmente; uma autenticação rejeitada não confirma uma identidade válida.

Confira essa identidade antes de vincular um checkout. Um ID de recurso salvo define qual recurso usar, mas não concede à credencial permissão para usá-lo.

Sair #

sh
lingo logout

Sair remove as credenciais salvas. Uma chave fornecida por variável de ambiente ou uma opção da execução ainda pode autenticar comandos posteriores. Quando quiser parar de usá-la, remova a configuração do shell que tem precedência. Sair não revoga chaves, não exclui recursos nem desvincula o projeto.

CI #

Forneça LINGO_API_KEY pelo mecanismo de segredos do executor e versione apenas configurações do projeto que não contenham segredos. Execute a CLI a partir da raiz do projeto desejado. Não copie para a CI uma sessão do diretório pessoal de um desenvolvedor.

A integração nativa com o GitHub tem permissões e aprovação de execuções próprias, independentes das de um executor de CLI autogerenciado.