Pular para o conteúdo principal
1

Inicie o login

Execute o comando de login no seu terminal:
A CLI mostra um código curto e abre a página de autorização no seu navegador.
2

Aprove no navegador

Digite o código na página e aprove. A CLI recebe a própria chave de API, sem precisar copiar e colar nada, e a salva nesta máquina.
Saída
Uma chave emitida dessa forma tem apenas as permissões que os comandos da CLI usam, incluindo blob:read e blob:write para os comandos blob, e expira após 90 dias. O auth whoami mostra a data; execute squarecloud auth login novamente para renová-la. A chave fica salva no chaveiro do sistema: o Gerenciador de Credenciais do Windows, as Chaves (Keychain) do macOS ou o Secret Service no Linux (GNOME Keyring, KWallet). Onde não há um (containers, WSL sem D-Bus), ela fica em um arquivo config.json que só você pode ler, e o auth login avisa isso: em %APPDATA%\Square Cloud CLI no Windows, e em $XDG_CONFIG_HOME/squarecloud ou ~/.config/squarecloud no macOS e no Linux. Uma chave que uma versão anterior salvou nesse arquivo passa para o chaveiro na próxima vez que for usada.

squarecloud auth login

Uso
Saída com uma chave de API
  • Pressione Ctrl+C para cancelar um login que está aguardando aprovação.
  • Se esta máquina já estiver conectada a outra conta, o auth login pergunta antes de substituí-la. Passe -y para pular a pergunta.
  • Se a sua conta atingiu o limite de chaves de API, o login pelo navegador avisa e continua sozinho assim que você revogar uma chave no dashboard.
  • Sem um terminal, o comando não pede nada: ele sai com uma dica. Com CI=true, o login pelo navegador se recusa a rodar. Veja CI e scripts.

squarecloud auth whoami

Uso
Mostra a conta em que você está autenticado, o plano dela e quantos dias faltam para o plano expirar. Para uma chave emitida pelo login no navegador, também mostra quando a chave expira e os escopos dela; quando a chave vem da SQUARECLOUD_API_KEY, avisa isso no lugar.
Saída
Com --json, imprime a conta (ID, nome, e-mail, idioma, plano e data de criação) em JSON.

squarecloud auth logout

Uso
Remove a chave de API salva desta máquina, tanto do chaveiro quanto do arquivo de configuração. Ele não revoga a chave: para isso, exclua-a no dashboard. Quando a SQUARECLOUD_API_KEY está definida, os comandos continuam a usá-la depois de um logout.
Saída
Quando nenhuma conta está conectada, ele imprime No account is connected on this machine. e sai com código 0.

Várias contas

--profile <name>, ou a variável de ambiente SQUARECLOUD_PROFILE, escolhe um login separado, com a própria entrada no chaveiro. Sem nenhum dos dois, a CLI usa o perfil default. Um nome de perfil tem de 1 a 32 letras, dígitos, - ou _, e começa com uma letra ou um dígito.
O auth login e o auth whoami informam o perfil quando ele não é o padrão. A SQUARECLOUD_API_KEY, quando definida, tem prioridade sobre qualquer perfil.

CI e scripts

No CI, não faça login: crie uma chave de API no dashboard e defina-a na variável de ambiente SQUARECLOUD_API_KEY. Todo comando a usa no lugar da chave salva, e a CLI funciona até em máquinas sem pasta home.
  • Sem um terminal, o auth login não pede nada: ele sai com uma dica. Use --with-token, --token ou SQUARECLOUD_API_KEY.
  • Com CI=true, o login pelo navegador se recusa a rodar, já que a chave dele expira em 90 dias e só uma pessoa pode renová-la.
  • Para os comandos blob, a chave precisa dos escopos blob:read e blob:write.
Veja mais sobre códigos de saída e saída em JSON em Flags globais e CI.

Quando a chave para de funcionar

Se um comando disser que a sua sessão expirou ou que a chave de API foi revogada, execute squarecloud auth login novamente. Faça o mesmo quando ele disser que a chave não tem a permissão de que o comando precisa (MISSING_SCOPE): uma chave de um login pelo navegador anterior à versão 3.2.0 não tem os escopos do Blob, e o novo login emite uma chave que os tem. Os comandos que precisam de uma conta imprimem You need to be logged in to run this command. e saem com código 1 quando nenhuma chave está salva ou definida.

Relacionados