Authentifizierung
Die CLI meldet sich über deinen Browser, einen Gerätecode oder einen API-Schlüssel an, und in Skripten und CI liest sie die Zugangsdaten aus einem Flag oder einer Umgebungsvariable. Führe polylane auth login aus, um eine Methode interaktiv zu wählen, oder übergib ein Flag, um die Auswahl zu überspringen.
Anmeldemethoden
| Methode | Befehl | Beschreibung |
|---|---|---|
| Browser | polylane auth login | Für die interaktive Nutzung. Die CLI öffnet deinen Browser, empfängt die Tokens über einen localhost-Callback und erneuert sie, wenn sie ablaufen. |
| Gerätecode | polylane auth login --no-browser | Für SSH und Headless-Rechner. Die CLI gibt eine URL und einen Code aus; öffne die URL auf einem beliebigen Gerät, gib den Code ein, und die CLI fragt nach, bis du genehmigst. |
| API-Schlüssel | polylane auth login --api-key sk_xxxxx | Für Skripte, CI und Agents. Die CLI validiert den Schlüssel und speichert ihn mit einem Standard-Workspace. |
Nach der Anmeldung zeigt die CLI, wer du bist, und bittet dich, wenn du zu mehr als einem Workspace gehörst, einen Standard zu wählen, gespeichert als workspace_id in ~/.polylane/config.json. Erzwinge eine Token-Erneuerung mit polylane auth refresh.
API-Schlüssel
Erstelle einen Schlüssel unter Settings > API Keys mit Create an API key: Benenne ihn, wähle seine Scopes und kopiere ihn, denn er wird nur einmal angezeigt. Schlüssel beginnen mit sk_. Setze in der CI POLYLANE_API_KEY in der Umgebung, statt den Login-Schritt auszuführen, oder übergib das globale Flag --api-key <key> bei einem einzelnen Aufruf.
Vorrang der Zugangsdaten
Wenn mehrere Zugangsdaten vorhanden sind, löst die CLI sie in dieser Reihenfolge auf:
- Das Flag
--api-keyam aktuellen Befehl - Die Umgebungsvariable
POLYLANE_API_KEY - OAuth-Zugangsdaten in
~/.polylane/credentials.json api_keyin~/.polylane/config.json
Ein exportiertes POLYLANE_API_KEY schlägt immer eine veraltete ~/.polylane/credentials.json, sodass ein CI-Runner mit gesetzter Variable keine übrig gebliebenen OAuth-Tokens aufgreift. polylane auth status zeigt, welche Quelle in Gebrauch ist.
Prüfen und wechseln
polylane auth status
polylane auth whoami
polylane auth logout
auth status zeigt die genutzte Methode, einen maskierten Token, den Benutzer und den Workspace; auth whoami zeigt den aktuellen Benutzer. auth logout widerruft OAuth-Tokens und löscht gespeicherte Zugangsdaten nach einer Bestätigung, die --yes überspringt; um das Konto zu wechseln, melde dich ab und mit den anderen Zugangsdaten wieder an.
Umgebungsvariablen
| Variable | Beschreibung |
|---|---|
POLYLANE_API_KEY | API-Schlüssel für nicht-interaktive Authentifizierung |
POLYLANE_WORKSPACE_ID | Standard-Workspace (ws_-ID) |
POLYLANE_API_DOMAIN | Überschreibt den API-Hostnamen |
Nutze sie in CI-Jobs und Containern, in denen du nicht nach ~/.polylane/ schreiben willst. Konfiguration listet den vollständigen Satz auf.
Verwandt
- Konfiguration: die vollständige Vorrangreihenfolge, jede Umgebungsvariable und die Dateien auf der Festplatte.
- Scripting: JSON-Ausgabe, Exit-Codes und die Flags für CI und Agents.
- API-Schlüssel und OAuth: Scopes, Schlüsselverwaltung und OAuth-Clients.