Skip to main content
1

Iniciar sesión

Ejecuta el comando de inicio de sesión en tu terminal:
La CLI muestra un código corto y abre la página de autorización en tu navegador.
2

Aprobar en el navegador

Escribe el código en la página y aprueba. La CLI recibe su propia API key, sin necesidad de copiar y pegar, y la guarda en esta máquina.
Salida
Una API key emitida de esta forma solo tiene los permisos que usan los comandos de la CLI y expira después de 90 días. auth whoami muestra la fecha; ejecuta squarecloud auth login de nuevo para renovarla. La clave se guarda en un archivo config.json que solo tú puedes leer: en %APPDATA%\Square Cloud CLI en Windows, y en $XDG_CONFIG_HOME/squarecloud o ~/.config/squarecloud en macOS y Linux.

​
squarecloud auth login

Uso
Salida con una API key
  • Presiona Ctrl+C para cancelar un inicio de sesión que está esperando aprobación.
  • Si esta máquina ya tiene una sesión iniciada con otra cuenta, auth login pregunta antes de reemplazarla. Pasa -y para omitir la pregunta.
  • Si tu cuenta alcanzó su límite de API keys, el inicio de sesión por navegador lo indica y continúa solo en cuanto revocas una clave en el dashboard.
  • Sin una terminal, el comando no pregunta nada: sale con una sugerencia. Con CI=true, el inicio de sesión por navegador se niega a ejecutarse. Consulta CI y scripts.

​
squarecloud auth whoami

Uso
Muestra la cuenta con la que iniciaste sesión, su plan y cuántos días faltan para que el plan expire. Para una clave emitida por el inicio de sesión en el navegador, también muestra cuándo expira la clave y sus permisos (scopes); cuando la clave viene de SQUARECLOUD_API_KEY, lo indica en su lugar.
Salida
Con --json, muestra la cuenta (ID, nombre, email, idioma, plan y fecha de creación) como JSON.

​
squarecloud auth logout

Uso
Elimina la API key guardada de esta máquina. No revoca la clave: para eso, elimínala en el dashboard. Cuando SQUARECLOUD_API_KEY está definida, los comandos siguen usándola después de un logout.
Salida
Cuando no hay ninguna cuenta conectada, muestra No account is connected on this machine. y sale con código 0.

​
CI y scripts

En CI, no inicies sesión: crea una API key en el dashboard y defínela en la variable de entorno SQUARECLOUD_API_KEY. Todos los comandos la usan en lugar de la clave guardada, y la CLI funciona incluso en máquinas sin carpeta personal.
  • Sin una terminal, auth login no pide nada: sale con una sugerencia. Usa --with-token, --token o SQUARECLOUD_API_KEY.
  • Con CI=true, el inicio de sesión por navegador se niega a ejecutarse, ya que su clave expira en 90 días y solo una persona puede renovarla.
Más sobre los códigos de salida y la salida JSON en Flags globales y CI.

​
Cuando la clave deja de funcionar

Si un comando indica que tu sesión expiró o que la API key fue revocada, ejecuta squarecloud auth login de nuevo. Los comandos que necesitan una cuenta muestran You need to be logged in to run this command. y salen con código 1 cuando no hay ninguna clave guardada ni definida.

​
Relacionado