Autenticación

La CLI inicia sesión de dos formas: con el navegador o con una clave de API personal. El navegador es lo más simple en tu equipo; la clave va bien para CI y servidores.

Iniciar sesión con el navegador

auth:login abre Sofia en tu navegador. Apruebas el acceso y la CLI lo recibe en una dirección local (http://127.0.0.1:<port>/callback). Es el flujo OAuth2 de código de autorización con PKCE; no hay clave que copiar.

sofia auth:login

• --scopes "<s1 s2>": los permisos que se piden. Por defecto, todos los permisos de recursos más offline_access.
• --no-browser: muestra la dirección en lugar de abrirla, para un equipo sin navegador.

sofia auth:login --scopes "posts:read posts:write offline_access"
sofia auth:login --no-browser

Dónde se guardan las credenciales

Tras auth:login, la CLI guarda tu sesión en ~/.sofia/credentials.json (carpeta 0700, archivo 0600). Un token caducado se renueva solo y el archivo se reescribe.

{
  "apiUrl": "https://api.sofia-post.com",
  "clientId": "…",
  "accessToken": "…",
  "refreshToken": "…",
  "expiresAt": "…",
  "scope": "…"
}

Comprobar y cerrar sesión

auth:status muestra la cuenta en nombre de la que actúa la CLI. auth:logout borra el archivo de credenciales.

sofia auth:status
sofia auth:logout

auth:logout solo olvida las credenciales de este equipo: la API de Sofia no tiene un endpoint de revocación, así que el acceso sigue siendo válido hasta que lo revoques en Sofia, en Ajustes › Aplicaciones conectadas.

Usar una clave de API personal

Crea una clave en Sofia en Ajustes › API › Acceso personal y expórtala como SOFIA_API_KEY. No hace falta auth:login: es lo ideal para CI y servidores. Más sobre las claves en Autenticación.

export SOFIA_API_KEY="sk_live_…"
sofia establishments:list

Cuál prevalece

Las credenciales del navegador van antes que SOFIA_API_KEY. Para usar la clave en un equipo donde ya iniciaste sesión, ejecuta antes sofia auth:logout.

Variables de entorno

¿Listo para publicar? Pasa a las publicaciones.