Skip to main content
1

Avvia il login

Esegui il comando di login nel tuo terminale:
La CLI mostra un codice breve e apre la pagina di autorizzazione nel tuo browser.
2

Approva nel browser

Digita il codice nella pagina e approva. La CLI riceve una propria chiave API, senza bisogno di copiare e incollare nulla, e la salva su questa macchina.
Output
Una chiave emessa in questo modo ha solo i permessi usati dai comandi della CLI e scade dopo 90 giorni. auth whoami mostra la data; esegui di nuovo squarecloud auth login per rinnovarla. La chiave viene salvata in un file config.json leggibile solo da te: in %APPDATA%\Square Cloud CLI su Windows, e in $XDG_CONFIG_HOME/squarecloud o ~/.config/squarecloud su macOS e Linux.

​
squarecloud auth login

Utilizzo
Output con una chiave API
  • Premi Ctrl+C per annullare un login in attesa di approvazione.
  • Se su questa macchina è già stato effettuato l’accesso con un altro account, auth login chiede conferma prima di sostituirlo. Passa -y per saltare la domanda.
  • Se il tuo account ha raggiunto il limite di chiavi API, il login tramite browser lo segnala e prosegue da solo non appena revochi una chiave nella dashboard.
  • Senza un terminale, il comando non chiede nulla: termina con un suggerimento. Con CI=true, il login tramite browser si rifiuta di partire. Vedi CI e script.

​
squarecloud auth whoami

Utilizzo
Mostra l’account con cui hai effettuato l’accesso, il suo piano e quanti giorni mancano alla scadenza del piano. Per una chiave emessa dal login tramite browser, mostra anche quando scade la chiave e i suoi scope; quando la chiave proviene da SQUARECLOUD_API_KEY, lo indica al loro posto.
Output
Con --json stampa l’account (ID, nome, email, lingua, piano e data di creazione) in formato JSON.

​
squarecloud auth logout

Utilizzo
Rimuove la chiave API salvata da questa macchina. Non revoca la chiave: per farlo, eliminala nella dashboard. Quando SQUARECLOUD_API_KEY è impostata, i comandi continuano a usarla anche dopo il logout.
Output
Quando nessun account è connesso, stampa No account is connected on this machine. e termina con codice 0.

​
CI e script

In CI non serve effettuare il login: crea una chiave API nella dashboard e impostala nella variabile d’ambiente SQUARECLOUD_API_KEY. Ogni comando la usa al posto della chiave salvata, e la CLI funziona anche su macchine senza una cartella home.
  • Senza un terminale, auth login non chiede nulla: termina con un suggerimento. Usa --with-token, --token o SQUARECLOUD_API_KEY.
  • Con CI=true, il login tramite browser si rifiuta di partire, perché la sua chiave scade in 90 giorni e solo una persona può rinnovarla.
Exit code e output JSON sono spiegati in Flag globali e CI.

​
Quando la chiave smette di funzionare

Se un comando indica che la sessione è scaduta o che la chiave API è stata revocata, esegui di nuovo squarecloud auth login. I comandi che richiedono un account stampano You need to be logged in to run this command. e terminano con codice 1 quando nessuna chiave è salvata o impostata.

​
Correlati