Autenticazione

La CLI accede in due modi: dal browser o con una chiave API personale. Il browser è il più semplice sul tuo computer; la chiave va bene per CI e server.

Accedere dal browser

auth:login apre Sofia nel browser. Approvi l’accesso e la CLI lo riceve su un indirizzo locale (http://127.0.0.1:<port>/callback). È il flusso OAuth2 authorization code con PKCE; nessuna chiave da copiare.

sofia auth:login

• --scopes "<s1 s2>": gli scope richiesti. Di default, tutti gli scope di risorsa più offline_access.
• --no-browser: mostra l’indirizzo invece di aprirlo, per una macchina senza browser.

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

Dove sono salvate le credenziali

Dopo auth:login, la CLI conserva la sessione in ~/.sofia/credentials.json (cartella 0700, file 0600). Un token scaduto viene rinnovato da solo e il file viene riscritto.

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

Verificare e uscire

auth:status mostra l’account per cui agisce la CLI. auth:logout elimina il file delle credenziali.

sofia auth:status
sofia auth:logout

auth:logout dimentica solo le credenziali su questa macchina: l'API di Sofia non ha un endpoint di revoca, quindi l'accesso resta valido finché non lo revochi in Sofia, in Impostazioni › Applicazioni connesse.

Usare una chiave API personale

Crea una chiave in Sofia in Impostazioni › API › Accesso personale, poi esportala come SOFIA_API_KEY. Non serve auth:login: è la via giusta per CI e server. Altri dettagli sulle chiavi in Autenticazione.

export SOFIA_API_KEY="sk_live_…"
sofia establishments:list

Quale prevale

Le credenziali del browser hanno la precedenza su SOFIA_API_KEY. Per usare la chiave su una macchina dove hai già effettuato l’accesso, esegui prima sofia auth:logout.

Variabili d’ambiente

Pronto a pubblicare? Vai ai post.