CLI

Autentisering

Logg inn i CLI-en med nettleseren, en enhetskode eller en API-nøkkel, og sett opp legitimasjon for skript og CI.

CLI-en logger inn gjennom nettleseren din, en enhetskode eller en API-nøkkel, og i skript og CI leser den legitimasjonen fra et flagg eller en miljøvariabel. Kjør polylane auth login for å velge en metode interaktivt, eller send et flagg for å hoppe over velgeren.

Innloggingsmetoder

MetodeKommandoBeskrivelse
Nettleserpolylane auth loginFor interaktiv bruk. CLI-en åpner nettleseren din, mottar tokenene på en localhost-callback og fornyer dem når de utløper.
Enhetskodepolylane auth login --no-browserFor SSH og maskiner uten skjerm. CLI-en skriver ut en URL og en kode; åpne URL-en på en hvilken som helst enhet, skriv inn koden, og CLI-en spør til du godkjenner.
API-nøkkelpolylane auth login --api-key sk_xxxxxFor skript, CI og agenter. CLI-en validerer nøkkelen og lagrer den med et standard-workspace.

Etter innlogging viser CLI-en hvem du er og, hvis du tilhører mer enn ett workspace, ber deg velge et standardvalg, lagret som workspace_id i ~/.polylane/config.json. Tving frem en tokenfornyelse med polylane auth refresh.

API-nøkler

Opprett en nøkkel under Settings > API Keys med Create an API key: gi den et navn, velg omfangene dens og kopier den, for den vises én gang. Nøkler starter med sk_. I CI setter du POLYLANE_API_KEY i miljøet i stedet for å kjøre innloggingssteget, eller sender det globale flagget --api-key <key> på ett enkelt kall.

Legitimasjonsrekkefølge

Når flere legitimasjoner er til stede, løser CLI-en dem i denne rekkefølgen:

  1. Flagget --api-key på den gjeldende kommandoen
  2. Miljøvariabelen POLYLANE_API_KEY
  3. OAuth-legitimasjon i ~/.polylane/credentials.json
  4. api_key i ~/.polylane/config.json

En eksportert POLYLANE_API_KEY slår alltid en utdatert ~/.polylane/credentials.json, så en CI-runner med variabelen satt plukker ikke opp gjenglemte OAuth-tokener. polylane auth status viser hvilken kilde som er i bruk.

Sjekk og bytt

Terminal
polylane auth status
polylane auth whoami
polylane auth logout

auth status viser metoden i bruk, et maskert token, brukeren og workspacet; auth whoami viser den gjeldende brukeren. auth logout trekker tilbake OAuth-tokener og sletter lagret legitimasjon etter en bekreftelse, som --yes hopper over; for å bytte konto logger du ut og inn igjen med den andre legitimasjonen.

Miljøvariabler

VariabelBeskrivelse
POLYLANE_API_KEYAPI-nøkkel for ikke-interaktiv autentisering
POLYLANE_WORKSPACE_IDStandard-workspace (ws_-ID)
POLYLANE_API_DOMAINOverstyring av API-vertsnavn

Bruk disse i CI-jobber og containere der du ikke vil skrive til ~/.polylane/. Konfigurasjon lister hele settet.

Relatert

  • Konfigurasjon: hele prioriteringsrekkefølgen, hver miljøvariabel og filene på disk.
  • Skripting: JSON-utdata, avslutningskoder og flaggene for CI og agenter.
  • API-nøkler og OAuth: omfang, nøkkeladministrasjon og OAuth-klienter.