Autentisering
API-nøkkel for integrasjoner, ID-token for apper der brukeren logger inn.
API-nøkkel
Send nøkkelen i headeren x-api-key.
En sk_live_-nøkkel leser og skriver ekte data. En sk_test_-nøkkel leser og skriver bare i et eget testområde.
En live-nøkkel kan bindes til en organisasjon, for eksempel et regnskapsbyrå. En testnøkkel kan ikke bindes til en organisasjon ennå.
GET /api/v1/bilag HTTP/1.1
Host: finance.ketl.no
x-api-key: sk_live_...Tilganger
Hver nøkkel har en liste med tilganger (scopes), for eksempel bilag:read eller klienter:read. Du velger dem når du lager nøkkelen.
Kaller du en rute nøkkelen ikke har tilgang til, får du 403 med meldingen «Mangler scope: …».
ID-token
Apper der brukeren logger inn med KETL-kontoen sin, sender Firebase ID-tokenet i headeren Authorization.
Authorization: Bearer <ID-token>Roter og tilbakekall
Du kan rotere en nøkkel i dashbordet. Den gamle slutter å virke etter 24 timer.
Tilbakekall nøkler du ikke bruker lenger.
Behandle nøkkelen som et passord. Legg den aldri i kode som kjører i nettleseren.