Vdelana programska oprema IAMMETER i.91.065.17 prinaša varno obnovitev skrbniškega dostopa ter podporo za Swagger API in WEM3063T

Vdelana programska oprema IAMMETER i.91.065.17 nadgrajuje varnostne funkcije iz serije i.91.065 ter dodaja varen mehanizem za obnovitev dostopa ob pozabljenih poverilnicah Admin Security, izboljšano preizkušanje API v brskalniku s HTTP Basic Authentication in podporo za novi števec električne energije WEM3063T.

Prenesi vdelano programsko opremo i.91.065.17

Ta izdaja je tudi del stalnih prizadevanj IAMMETER za izpolnjevanje zahtev kibernetske varnosti za radijsko opremo, povezano z internetom, po EN 18031-1:2024. Stanje skladnosti in certificiranja posameznih modelov števcev IAMMETER bo objavljeno ločeno, ko bo uradno na voljo.

Posodobitev uporabnikom prinaša štiri praktične izboljšave:

• obnovitev dostopa, kadar pozabijo lokalno geslo Admin Security;
• preizkušanje zaščitenih API naprave iz zunanjega vmesnika Swagger UI;
• podporo za trifazni števec WEM3063T za ameriški trg;
• lažji dostop do navodil za varnostni modul.

Varna obnovitev dostopa ob pozabljenem skrbniškem geslu

Če pozabite geslo Admin Security, lahko preverite, da je naprava povezana z vašim računom IAMMETER, in obnovite lokalni dostop, ne da bi se moral IAMMETER Cloud neposredno povezati s števcem ali ga ponastaviti. Naprava ustvari enkratni izziv za obnovitev, storitev za obnovitev pa po preverjanju računa podpiše natanko ta izziv.

Postopek je naslednji:

1. Od naprave zahtevajte enkratni izziv za obnovitev.
2. Prijavite se v sistem IAMMETER Contributor z računom IAMMETER Cloud.
3. Oddajte podatkovno vsebino izziva. Storitev za obnovitev preveri, da je serijska številka naprave povezana z vašim računom IAMMETER.
4. Prejmite podpis Ed25519 za natanko to podatkovno vsebino.
5. Podpisano zahtevo za obnovitev pošljite napravi prek njenega lokalnega naslova IP.
6. Po uspešnem preverjanju naprava onemogoči Admin Security, da lahko nastavite novo uporabniško ime in geslo Admin Security.

Podatkovna vsebina za obnovitev je vezana na serijsko številko naprave, naslov MAC in enkratno vrednost nonce. Vdelana programska oprema vsebuje le javni ključ za preverjanje, ne pa zasebnega ključa za podpisovanje. Storitev za obnovitev po preverjanju podpiše izziv, ki ga ustvari naprava; s števcem se ne povezuje neposredno in ga ne ponastavlja.

Celoten postopek je opisan v članku Kako obnoviti dostop ob pozabljenem skrbniškem geslu IAMMETER.

Podpora za WEM3063T za ameriški trg

Vdelana programska oprema i.91.065.17 vključuje podporo za WEM3063T, trifazni števec električne energije IAMMETER, razvit za ameriški trg.

WEM3063T je zasnovan za zunanje tokovne transformatorje s standardnim izhodom 5 A. V okviru potekajočega postopka certificiranja UL je prestal preizkuse izdelka in varnosti, vključno s preizkusi, ki jih je izvedel SGS. Stanje certificiranja UL bo objavljeno ločeno, ko bo uradno na voljo. Vdelana programska oprema prepozna WEM3063T in uporabi ustrezno logiko preračuna toka, moči in energije.

Pred nadgradnjo preverite model števca, specifikacije tokovnega transformatorja in regionalne zahteve za namestitev na svoji lokaciji.

Preizkušanje API s Swaggerjem in Basic Auth

Vdelana programska oprema i.91.065.17 omogoča brskalniškim orodjem za API, kot je Swagger UI v IAMMETER WEM API Test, klicanje API, zaščitenih z Admin Security, prek HTTP Basic Authentication. Vdelana programska oprema zdaj dovoljuje glavo Authorization v predhodnih zahtevah CORS.

Odpri IAMMETER WEM API Test

Potek dela s Swaggerjem še vedno zahteva:

• brskalnik, ki lahko doseže lokalni naslov IP števca;
• veljavne poverilnice Basic Auth;
• operacijo API, ki jo podpira vdelana programska oprema naprave.

Zahteva se pošlje neposredno:

Browser → loads Swagger UI from iammeter.github.io
Browser → sends an authenticated API request directly to the meter's local IP

Spletno mesto Swagger ni strežnik, ki se povezuje z vašim števcem. Brskalnik mora doseči števec v lokalnem omrežju, vsaka zaščitena zahteva pa še vedno zahteva veljavne poverilnice Basic Auth. Sprememba CORS ne odstrani preverjanja pristnosti in ne izpostavi API naprave prek IAMMETER Cloud.

Druge varnostne izboljšave

Stran Security zdaj vsebuje opaznejšo povezavo za pomoč Enable/Disable Security Module (Omogoči/onemogoči varnostni modul). Uporabnike usmeri na uporabniški priročnik za Local Admin Security, vključno z navodili za nastavitev in obnovitev.

Preverjanje potrdil MQTTS in HTTPS

Serija vdelane programske opreme i.91.065 podpira tudi tri načine preverjanja potrdil za MQTTS in HTTPS:

• builtin — uporaba vgrajenih zaupanja vrednih korenskih potrdil;
• custom — uporaba naloženega korenskega potrdila CA v obliki PEM;
• none — izklop preverjanja potrdil zaradi združljivosti ali v nadzorovanih preizkusnih okoljih. Ta način ni priporočljiv za običajne namestitve, povezane z internetom.

Vgrajena shramba potrdil vključuje DigiCert Global Root G2 in ISRG Root X1. Za namestitve z zasebnim overiteljem potrdil je mogoče naložiti lastno korensko potrdilo CA v obliki PEM. MQTTS in HTTPS si delita isto konfiguracijo preverjanja TLS.

Podrobnosti o nastavitvah najdete v članku Preverjanje potrdil MQTTS in HTTPS.

Nastavitve Admin Security opisuje uporabniški priročnik za Local Admin Security.

Opombe o nadgradnji in združljivosti

Ta izdaja ohranja obstoječe varnostno delovanje osnovnih protokolov:

• zaščiteni API še vedno zahtevajo preverjanje pristnosti Basic Auth;
• obstoječa varnostna preverjanja OTA ostajajo v veljavi;
• ta izdaja ne spreminja obstoječega delovanja povezav TLS ali preverjanja potrdil;
• vdelana programska oprema še vedno preverja podpis za obnovitev glede na natanko določeno enkratno podatkovno vsebino.

Pred nadgradnjo preverite, da paket vdelane programske opreme ustreza modelu vašega števca IAMMETER, in sledite navodilom za lokalno nadgradnjo ali nadgradnjo prek aplikacije na strani Posodobitve vdelane programske opreme IAMMETER.

Popravki napak in izboljšave zanesljivosti

Ta izdaja vključuje tudi popravke zanesljivosti, zbrane v seriji vdelane programske opreme i.91.065:

• Okrepljeno preverjanje slike OTA, vključno s strukturo paketa, dolžino slike, mejami particij in preverjanjem celovitosti.
• Neuspešno preverjanje OTA zdaj vrne določeno napako JSON, ne nastavi zastavice za nadgradnjo in ne zažene števca znova.
• Izboljšana obravnava napak OTA v spletnem vmesniku, vključno z omrežnimi napakami XHR in časovnimi omejitvami.
• Popravljeni odgovori OTA, ki jih je brskalnik lahko javljal kot omrežne napake, ko je bil omogočen Admin Security.
• Izboljšana obravnava teles zahtev HTTP POST, prejetih v več paketih TCP, vključno z zahtevami Admin Security, potrdil TLS, naprednih nastavitev in OTA.
• Odpravljena težava, pri kateri spletni vmesnik po uspešni posodobitvi OTA morda ni prikazal pravilne strani z rezultatom.
• Popravljen preračun jalove moči za WEM3046T in WEM3063T.
• Dodana logika prikaza stanja povezave z lučko Wi-Fi LED na WEM3063T.

Povezani viri

• Posodobitve vdelane programske opreme IAMMETER
• Uporabniški priročnik za Local Admin Security
• Obnovitev ob pozabljenem skrbniškem geslu IAMMETER
• Preverjanje potrdil MQTTS in HTTPS
• Orodje IAMMETER WEM API Test