Autenticação da CLI

Inicie sessão localmente, forneça uma credencial de CI e confirme que identidade um comando vai utilizar.

A CLI utiliza a primeira credencial disponível: primeiro, a opção global --api-key da invocação, depois LINGO_API_KEY e, por fim, a chave ou a sessão do navegador guardada em ~/.lingo/credentials.json. Esta ordem é importante ao mudar de conta: um novo início de sessão guardado não se sobrepõe a uma chave já fornecida pela shell.

Iniciar sessão #

sh
lingo login
lingo whoami

Ao iniciar sessão sem uma chave, o fluxo OAuth abre-se no navegador e a sessão fica guardada. A CLI renova as sessões quando estão prestes a expirar; se a renovação falhar, volte a iniciar sessão.

Iniciar sessão com êxito não conclui a configuração da organização nem cumpre os requisitos de SSO de todas as organizações. Se a associação o redirecionar para a aplicação Web, conclua a configuração dessa organização ou o início de sessão com SSO antes de voltar a tentar.

lingo login --api-key <value> valida e guarda uma chave. Já a opção global --api-key utilizada noutro comando aplica-se apenas a essa invocação. São reconhecidas tanto a forma separada como a forma --api-key=value. Prefira a injeção de segredos à sua inclusão na linha de comandos, pois podem ficar visíveis no histórico da shell, na inspeção de processos ou nos diagnósticos.

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

Verificar a identidade #

sh
lingo whoami --json

O resultado identifica o tipo de autenticação e o contexto disponível da organização e do motor de localização. O comando de verificação de identidade valida as credenciais online. Se a ligação falhar, pode devolver apenas algumas informações guardadas; uma autenticação rejeitada não confirma uma identidade válida.

Verifique esta identidade antes de associar um checkout. Um ID de recurso guardado define o recurso a utilizar, mas não concede à credencial permissão para o utilizar.

Terminar sessão #

sh
lingo logout

Terminar sessão remove as credenciais guardadas. Uma chave definida no ambiente ou uma opção da invocação pode continuar a autenticar os comandos seguintes. Quando pretender deixar de utilizar essa credencial, remova a definição que lhe dá prioridade na shell. Terminar sessão não revoga chaves, não elimina recursos nem remove a associação do projeto.

CI #

Forneça LINGO_API_KEY através do mecanismo de segredos do executor e inclua nos commits apenas configurações do projeto que não contenham segredos. Execute a CLI a partir da raiz do projeto pretendido. Não copie para a CI uma sessão guardada no diretório pessoal de alguém da equipa de desenvolvimento.

A integração nativa com o GitHub tem a sua própria autorização e aprovação de execuções, independentes das de um executor da CLI gerido por si.