CLI

Authentifizierung

Melde dich per Browser oder mit einem persönlichen API-Schlüssel an und erfahre, welcher gilt, wenn beide gesetzt sind.

Die CLI kennt zwei Anmeldewege: über deinen Browser oder mit einem persönlichen API-Schlüssel. Der Browser ist auf dem eigenen Rechner am einfachsten, der Schlüssel passt zu CI und Servern.

Mit dem Browser anmelden

auth:login öffnet Sofia in deinem Browser. Du bestätigst den Zugriff, und die CLI empfängt ihn auf einer lokalen Adresse (http://127.0.0.1:<port>/callback). Es ist der OAuth2-Authorization-Code-Flow mit PKCE; du musst keinen Schlüssel kopieren.

sofia auth:login

--scopes "<s1 s2>": die angeforderten Scopes. Standard: alle Ressourcen-Scopes plus offline_access.
--no-browser: gibt die Adresse aus, statt sie zu öffnen, für Rechner ohne Browser.

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

Wo die Zugangsdaten liegen

Nach auth:login speichert die CLI deine Sitzung in ~/.sofia/credentials.json (Ordner 0700, Datei 0600). Ein abgelaufenes Token wird selbstständig erneuert und die Datei neu geschrieben.

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

Prüfen und abmelden

auth:status zeigt das Konto, für das die CLI handelt. auth:logout löscht die Datei mit den Zugangsdaten.

sofia auth:status
sofia auth:logout

auth:logout vergisst nur die Zugangsdaten auf diesem Rechner: Die Sofia API hat keinen Endpunkt zum Widerrufen, der Zugriff bleibt gültig, bis du ihn in Sofia unter Einstellungen › Verbundene Anwendungen widerrufst.

Persönlichen API-Schlüssel verwenden

Erstelle in Sofia unter Einstellungen › API › Persönlicher Zugriff einen Schlüssel und exportiere ihn als SOFIA_API_KEY. Ein auth:login ist nicht nötig: ideal für CI und Server. Mehr zu Schlüsseln unter Authentifizierung.

export SOFIA_API_KEY="sk_live_…"
sofia establishments:list

Was Vorrang hat

Die Browser-Zugangsdaten haben Vorrang vor SOFIA_API_KEY. Um den Schlüssel auf einem Rechner zu nutzen, an dem du angemeldet bist, führe zuerst sofia auth:logout aus.

Umgebungsvariablen

Variable	Standard	Zweck
`SOFIA_API_KEY`	—	Persönlicher API-Schlüssel (Einstellungen › API › Persönlicher Zugriff).
`SOFIA_API_URL`	`https://api.sofia-post.com`	Eine andere Instanz der API (Staging, lokal).
`SOFIA_CLIENT_ID`	Der Client „Sofia CLI“	Ein anderer öffentlicher OAuth-Client für `auth:login`.

Bereit zum Veröffentlichen? Weiter zu den Beiträgen.

War diese Seite hilfreich?