Ligipääsuluba

Rakenduse ligipääsu võimaldamiseks JSON-liidesele (JavaScript Object Notation) või KOSTAL Smart Energy Meteri veebi kasutajaliidesele peab see KOSTAL Smart Energy Meteris end autoriseerima.

Autoriseerimine toimub sealjuures ligipääsuloaga, mis on eelnevalt loodud KOSTAL Smart Energy Meteris.

Ligipääsuloa loomine

Ligipääsulubasid saab luua menüüpunktis Profiles > Access tokens (Profiilid > Ligipääsuload).

Klõpsates ADD (LISA) avaneb aken, milles saab määrata ligipääsuloa nime, rolli ja aegumiskuupäeva.

Parameeter	Seletus
Nimi	Kasutaja, rakenduse või seadme nimi, mis peab liidest kasutama.
Roll	api: Sellega saab küsida mõõteandmeid JSON-liidese kaudu. admin: Sellega saab teha sisselogimisi veebiliidesel ning teha seadistusi. Sellel ligipääsuloal on kõik õigused, mis on ka sisselogitud kasutajal.
Kaotab kehtivuse	Ligipääsuloa aegumise kuupäev.

Pärast loomist kuvatakse ligipääsuluba üks kord. Seda ei saa veelkord vastu võtta ega kuvada ja see tuleks seetõttu pärast saamist kopeerida ja turvaliselt salvestada.

Ligipääsuloa autoriseerimine

Uus loodud ligipääsuluba tuleb autoriseerida. Klõpsates AUTHORISE (AUTOREISEERIMINE) ligipääsuluba autenditakse ja autoriseeritakse JSON-liidese või veebi kasutajaliidese kasutamiseks.

Ligipääsuloa kustutamine

Ligipääsuloa saab klõpsates REVOKE (TÜHISTAMINE) süsteemist kustutada.

API-ligipääsuloa kasutamine

Pärast API-ligipääsuloa autentimist ja autoriseerimist kasutaja poolt saab seda JSON-liideste päringute rakendusega kasutada.

Selleks edastatakse ligipääsuluba HTTP-päise osana:

GET /api/json/<resource> HTTP/1.1
Host: <energy manager>
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9[..]

Administraatori ligipääsuloa kasutamine

Pärast administraatori ligipääsuloa autentimist ja autoriseerimist kasutaja poolt saab seda veebi kasutajaliidese näidu rakendusega kasutada.

Selleks edastatakse ligipääsuluba HTTP-päise osana või see peab olema lugemiseks salvestatud brauseri lokaalsesse mällu.

Ligipääsuluba TTL

Ligipääsuloa kasutusiga saab autentimispäringu ajal piirata. Selleks defineeritakse lisaks rakenduse nimele aegumiskuupäev. Lisaks sellele saab sisselogitud kasutaja väljastatud kasutusloa veebiliidese kaudu tühistada. Kõik järgnevad päringud, mis teostatakse tühistatud ligipääsuloa abil, lükatakse tagasi.