Lag en API-nøkkel

Nøkkelen fungerer som et passord, og kan både hente data og skrive til datapunkter gjennom Evolo sitt API. Du bestemmer hva den kan gjøre, hvilke bygg den gjelder for og hvor lenge den varer.

Slik gjør du det

Felter

• Navn: et kort navn så du kjenner igjen nøkkelen, for eksempel navnet på systemet som skal bruke den.

• Beskrivelse: valgfri tekst om hva nøkkelen brukes til.

• Tilganger: hva nøkkelen får lov til. Du kan velge Les datapunkter, Skriv datapunkter, Les alarmer, Les gatewayer, Les enheter og Les systemer. Velg minst én.

• Velg bygg: byggene nøkkelen gir tilgang til. Velg minst ett.

• Utløpsdato: når nøkkelen slutter å virke. Velg 7, 30, 60 eller 90 dager, en egendefinert dato, eller Ingen utløpsdato.

Hvilke tilganger kan du gi?

Du kan bare gi nøkkelen tilganger du selv har. Velger du flere bygg, ser du bare tilgangene du har på alle byggene. Har du for eksempel lesetilgang til alarmer på ett bygg, men ikke på et annet, kan du ikke gi nøkkelen Les alarmer for begge.

Bygg som krever tofaktorautentisering

Krever et bygg tofaktorautentisering (2FA), gjelder kravet også for nøkkelen. Da må du ha slått på autentiseringsapp på kontoen din. Pålogging med passkey eller Microsoft er ikke nok, fordi nøkkelen ikke har noen pålogging. Uten autentiseringsapp kan du ikke velge bygget, og nøkkelen virker ikke for det.

Bruk nøkkelen

Klikk API-dokumentasjon øverst på siden. Der ser du hvilke data du kan hente, og hvordan du sender nøkkelen med i forespørselen.

I tabellen ser du når nøkkelen sist ble brukt, under Sist brukt.

Endre eller slette en nøkkel

1. Klikk på de tre prikkene til høyre for nøkkelen i tabellen.

2. Velg Endre for å endre navn, tilganger, bygg eller utløpsdato. Velg Slett for å slette nøkkelen.

3. Bekreft at du vil slette.

Systemer som bruker en slettet nøkkel, mister tilgangen med en gang.

Neste steg