CLI

Autentificering

Log ind i CLI'en med din browser, en enhedskode eller en API-nøgle, og sæt legitimationsoplysninger op til scripts og CI.

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

MetodeKommandoBeskrivelse
Browserpolylane auth loginTil interaktiv brug. CLI'en åbner din browser, modtager tokens på et localhost-callback og fornyer dem, når de udløber.
Enhedskodepolylane auth login --no-browserTil 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øglepolylane auth login --api-key sk_xxxxxTil 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:

  1. Flaget --api-key på den aktuelle kommando
  2. Miljøvariablen POLYLANE_API_KEY
  3. OAuth-legitimationsoplysninger i ~/.polylane/credentials.json
  4. api_key i ~/.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

Terminal
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

VariabelBeskrivelse
POLYLANE_API_KEYAPI-nøgle til ikke-interaktiv autentificering
POLYLANE_WORKSPACE_IDStandardarbejdsområde (ws_-id)
POLYLANE_API_DOMAINTilsidesæ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.