Prieigos raktas

Norint suteikti programai prieigą prie JSON sąsajos (JavaScript Object Notation) arba KOSTAL Smart Energy Meter interneto vartotojo sąsajos, ji turi būti autorizuota KOSTAL Smart Energy Meter.

Autorizacija atliekama naudojant prieigos raktą, kuris buvo iš anksto sukurtas KOSTAL Smart Energy Meter.

Prieigos rakto sukūrimas

Prieigos raktus galima sukurti meniu punkte „Profiliai > Prieigos raktai “.

Spustelėjus PRIDĖTI atsidaro langas, kuriame galima nustatyti prieigos rakto pavadinimą, funkciją ir galiojimo datą.

Parametrai

Paaiškinimas

Pavadinimas

Vartotojo, programos arba įrenginio, kuris turės naudoti sąsają, pavadinimas.

Vaidmuo

  • api: Tai leidžia užklausti matavimo duomenis per JSON sąsają.
  • admin: Tai leidžia prisijungti prie žiniatinklio sąsajos ir atlikti nustatymus. Šis prieigos raktas turi visas teises, kurias turi prisijungęs vartotojas.

Galiojimo pabaiga

Prieigos rakto galiojimo pabaigos data.

Sukūrus prieigos raktą, jis rodomas vieną kartą. Jo negalima gauti ar peržiūrėti dar kartą, todėl gavus jį reikia nukopijuoti ir saugiai išsaugoti.

Prieigos rakto autorizavimas

Naujai išduotas prieigos raktas turi būti autorizuotas. Spustelėjus AUTORIZUOTI, prieigos raktas yra autentiškumo patvirtinamas ir autorizuojamas naudoti JSON sąsają arba interneto vartotojo sąsają.

Prieigos rakto ištrinimas

Prieigos raktas gali būti ištrintas iš sistemos spustelėjus ATŠAUKTI.

 

API prieigos rakto naudojimas

Kai API prieigos raktas yra autentiškas ir autorizuotas, jis gali būti naudojamas JSON sąsajos užklausoms.

Tam prieigos raktas perduodamas kaip HTTP antraštės dalis:

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

Admin prieigos rakto naudojimas

Kai vartotojas patvirtina ir autorizuoja administratoriaus prieigos raktą, jis gali būti naudojamas programoje, skirtoje rodyti žiniatinklio vartotojo sąsają.

Tam prieigos raktas perduodamas kaip HTTP antraštės dalis arba turi būti saugomas naršyklės vietinėje atmintyje, kad būtų galima jį iš ten išskaityti.

Prieigos rakto TTL

Prieigos rakto galiojimo laikas gali būti apribotas autentiškumo patvirtinimo užklausos metu. Tam be programos pavadinimo papildomai nustatoma galiojimo pabaigos data. Be to, išduotas prieigos raktas gali būti atšauktas prisijungusio vartotojo per žiniatinklio sąsają. Visi vėlesni užklausimai, pateikti naudojant atšauktą prieigos raktą, bus atmesti.