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
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+Cpara cancelar um login que está aguardando aprovação. - Se esta máquina já estiver conectada a outra conta, o
auth loginpergunta antes de substituí-la. Passe-ypara 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
SQUARECLOUD_API_KEY, avisa isso no lugar.
Saída
--json, imprime a conta (ID, nome, e-mail, idioma, plano e data de criação) em JSON.
squarecloud auth logout
Uso
SQUARECLOUD_API_KEY está definida, os comandos continuam a usá-la depois de um logout.
Saída
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.
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 ambienteSQUARECLOUD_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 loginnão pede nada: ele sai com uma dica. Use--with-token,--tokenouSQUARECLOUD_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 escoposblob:readeblob:write.
Quando a chave para de funcionar
Se um comando disser que a sua sessão expirou ou que a chave de API foi revogada, executesquarecloud 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.

