Autentificering
CLI'en logger ind gennem din browser, en enhedskode eller en API-nøgle, og i scripts og CI læser den legitimationen fra et flag eller en miljøvariabel. Kør polylane auth login for at vælge en metode interaktivt, eller send et flag med for at springe vælgeren over.
Login-metoder
| Metode | Kommando | Beskrivelse |
|---|---|---|
| Browser | polylane auth login | Til interaktiv brug. CLI'en åbner din browser, modtager tokens på et localhost-callback og fornyer dem, når de udløber. |
| Enhedskode | polylane auth login --no-browser | Til SSH- og headless-maskiner. CLI'en udskriver en URL og en kode; åbn URL'en på en vilkårlig enhed, indtast koden, og CLI'en poller, indtil du godkender. |
| API-nøgle | polylane auth login --api-key sk_xxxxx | Til scripts, CI og agenter. CLI'en validerer nøglen og gemmer den med et standardarbejdsområde. |
Efter login viser CLI'en, hvem du er, og hvis du er medlem af mere end ét arbejdsområde, beder den dig vælge et standardarbejdsområde, gemt som workspace_id i ~/.polylane/config.json. Gennemtving en tokenfornyelse med polylane auth refresh.
API-nøgler
Opret en nøgle under Settings > API Keys med Create an API key: giv den et navn, vælg dens scopes, og kopiér den, for den vises én gang. Nøgler begynder med sk_. I CI sætter du POLYLANE_API_KEY i miljøet i stedet for at køre login-trinnet, eller sender det globale flag --api-key <key> med på et enkelt kald.
Legitimationsrækkefølge
Når flere legitimationsoplysninger er til stede, vælger CLI'en dem i denne rækkefølge:
- Flaget
--api-keypå den aktuelle kommando - Miljøvariablen
POLYLANE_API_KEY - OAuth-legitimationsoplysninger i
~/.polylane/credentials.json api_keyi~/.polylane/config.json
En eksporteret POLYLANE_API_KEY slår altid en forældet ~/.polylane/credentials.json, så en CI-runner med variablen sat ikke samler efterladte OAuth-tokens op. polylane auth status viser, hvilken kilde der er i brug.
Kontrollér og skift
polylane auth status
polylane auth whoami
polylane auth logout
auth status viser den metode, der er i brug, et maskeret token, brugeren og arbejdsområdet; auth whoami viser den aktuelle bruger. auth logout tilbagekalder OAuth-tokens og rydder gemte legitimationsoplysninger efter en bekræftelse, som --yes springer over; for at skifte konto logger du ud og ind igen med den anden legitimation.
Miljøvariabler
| Variabel | Beskrivelse |
|---|---|
POLYLANE_API_KEY | API-nøgle til ikke-interaktiv autentificering |
POLYLANE_WORKSPACE_ID | Standardarbejdsområde (ws_-id) |
POLYLANE_API_DOMAIN | Tilsidesættelse af API-hostnavnet |
Brug dem i CI-jobs og containere, hvor du ikke vil skrive til ~/.polylane/. Konfiguration lister det fulde sæt.
Relateret
- Konfiguration: den fulde rækkefølge, hver miljøvariabel og filerne på disken.
- Scripting: JSON-output, exit codes og flagene til CI og agenter.
- API-nøgler og OAuth: scopes, nøglehåndtering og OAuth-klienter.