Piekļuves atslēga

Lai lietojumprogrammai piešķirtu piekļuvi JSON (JavaScript Object Notation) saskarnes vai KOSTAL Smart Energy Meter tīmekļa lietotāja saskarnes, tai ir jāautorizējas KOSTAL Smart Energy Meter.

Autorizācija notiek, izmantojot piekļuves atslēgu, kas iepriekš ir izveidota KOSTAL Smart Energy Meter.

Piekļuves atslēgas izveide

Piekļuves atslēgas var izveidot izvēlnē Profili > Piekļuves atslēgas.

Noklikšķinot uz PIEVIENOT, atveras logs, kurā var noteikt piekļuves atslēgas nosaukumu, lomu un derīguma termiņu.

Parametri

Paskaidrojums

Nosaukums

Lietotāja, lietojumprogrammas vai ierīces nosaukums, kam jāizmanto saskarne.

Loma

  • api: ar to var pieprasīt mērījumu datus, izmantojot JSON interfeisu.
  • admin: ar to var veikt pieteikšanos tīmekļa saskarnē un veikt iestatījumus. Šim piekļuves atslēgai ir visas tiesības, kas ir arī pieteicies lietotājam.

Derīguma termiņš

Piekļuves atslēgas derīguma termiņa beigās.

Pēc izveidošanas piekļuves atslēga tiek parādīta vienreiz. To nevar atkārtoti saņemt vai parādīt, tāpēc pēc saņemšanas tā jākopē un jāuzglabā drošā vietā.

Piekļuves atslēgas autorizācija

Jaunizveidotā piekļuves atslēga ir jāautorizē. Noklikšķinot uz AUTORIZĒT, piekļuves atslēga tiek autentificēta un autorizēta JSON interfeisa vai tīmekļa lietotāja interfeisa izmantošanai.

Piekļuves atslēgas dzēšana

Piekļuves atslēgu var dzēst no sistēmas, noklikšķinot uz ATSAUKT.

 

API piekļuves atslēgas izmantošana

Pēc tam, kad lietotājs ir autentificējis un autorizējis API piekļuves atslēgu, to var izmantot lietojumprogramma JSON interfeisa pieprasījumiem.

Šim nolūkam piekļuves atslēga tiek pārraidīta kā daļa no HTTP galvenes:

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

Admin piekļuves atslēgas izmantošana

Pēc tam, kad lietotājs ir autentificējis un autorizējis administratora piekļuves atslēgu, to var izmantot lietojumprogrammā, lai parādītu tīmekļa lietotāja saskarni.

Šim nolūkam piekļuves atslēga tiek pārraidīta kā daļa no HTTP galvenes vai arī tā jāuzglabā pārlūka vietējā atmiņā, lai to varētu izlasīt no turienes.

Piekļuves atslēgas TTL

Piekļuves atslēgas darbības laiks var tikt ierobežots autentifikācijas pieprasījuma laikā. Šim nolūkam papildus lietojumprogrammas nosaukumam tiek definēts derīguma termiņš. Turklāt izsniegto piekļuves atslēgu reģistrēts lietotājs var atsaukt, izmantojot tīmekļa interfeisu. Visi turpmākie pieprasījumi, kas tiek veikti, izmantojot atsauktu piekļuves atslēgu, tiek noraidīti.