IAMMETER-laiteohjelmisto i.91.065.17: turvallinen ylläpitäjän pääsyn palautus sekä Swagger API- ja WEM3063T-tuki

IAMMETER-laiteohjelmisto i.91.065.17 pohjautuu i.91.065-sarjan tietoturvaominaisuuksiin ja lisää turvallisen palautusmekanismin unohtuneille Admin Security -tunnuksille, parannetun selainpohjaisen API-testauksen HTTP Basic Authentication -todennuksella sekä uuden WEM3063T-energiamittarin tuen.

Lataa i.91.065.17-laiteohjelmisto

Julkaisu on myös osa IAMMETERin jatkuvaa työtä internetiin yhdistettyjä radiolaitteita koskevien EN 18031-1:2024 -standardin kyberturvallisuusvaatimusten täyttämiseksi. Yksittäisten IAMMETER-mittarimallien vaatimustenmukaisuudesta ja sertifiointitilanteesta tiedotetaan erikseen, kun tiedot ovat virallisesti saatavilla.

Päivitys tuo käyttäjille neljä käytännön parannusta:

paikallisen pääsyn palauttaminen, kun Admin Security -salasana on unohtunut;
suojattujen laite-APIen testaaminen ulkoisesta Swagger-käyttöliittymästä;
Yhdysvaltain markkinoille kehitetyn WEM3063T-kolmivaihe-energiamittarin tuki;
tietoturvamoduulin ohjeiden helpompi löydettävyys.

Turvallinen pääsyn palautus unohtuneen ylläpitäjän salasanan jälkeen

Jos unohdat Admin Security -salasanasi, voit varmistaa, että laite on liitetty IAMMETER-tiliisi, ja palauttaa paikallisen pääsyn ilman, että IAMMETER Cloudin tarvitsee muodostaa suoraa yhteyttä mittariin tai nollata sitä. Laite luo kertakäyttöisen palautushaasteen, ja palautuspalvelu allekirjoittaa juuri kyseisen haasteen tilin tarkistamisen jälkeen.

Toimi näin:

Pyydä laitteelta kertakäyttöinen palautushaaste.
Kirjaudu IAMMETER Contributor -järjestelmään IAMMETER Cloud -tililläsi.
Lähetä haasteen tietosisältö. Palautuspalvelu tarkistaa, että laitteen sarjanumero on liitetty IAMMETER-tiliisi.
Vastaanota Ed25519-allekirjoitus juuri kyseiselle tietosisällölle.
Lähetä allekirjoitettu palautuspyyntö laitteelle sen paikallisen IP-osoitteen kautta.
Onnistuneen tarkistuksen jälkeen laite poistaa Admin Securityn käytöstä, jotta voit määrittää uuden Admin Security -käyttäjänimen ja -salasanan.

Palautuksen tietosisältö on sidottu laitteen sarjanumeroon, MAC-osoitteeseen ja kertakäyttöiseen nonce-arvoon. Laiteohjelmisto sisältää vain julkisen tarkistusavaimen, ei yksityistä allekirjoitusavainta. Palautuspalvelu allekirjoittaa laitteen luoman haasteen tarkistuksen jälkeen; se ei muodosta suoraa yhteyttä mittariin eikä nollaa sitä.

Koko menettely kuvataan ohjeessa Unohtuneen IAMMETER-ylläpitäjäsalasanan palauttaminen.

WEM3063T-tuki Yhdysvaltain markkinoille

Laiteohjelmisto i.91.065.17 sisältää tuen WEM3063T-mittarille, joka on Yhdysvaltain markkinoille kehitetty IAMMETERin kolmivaihe-energiamittari.

WEM3063T on suunniteltu käytettäväksi ulkoisten virtamuuntajien kanssa, joiden vakiolähtö on 5 A. Sille on tehty tuote- ja turvallisuustestejä osana käynnissä olevaa UL-sertifiointiprosessia, mukaan lukien SGS:n suorittamat testit. UL-sertifioinnin tilanteesta tiedotetaan erikseen, kun tiedot ovat virallisesti saatavilla. Laiteohjelmisto tunnistaa WEM3063T:n ja käyttää sille tarkoitettua virran, tehon ja energian skaalauslogiikkaa.

Tarkista ennen päivitystä mittarin malli, virtamuuntajan tekniset tiedot ja kohteesi alueelliset asennusvaatimukset.

Swagger API -testaus Basic Auth -todennuksella

Laiteohjelmisto i.91.065.17 mahdollistaa Admin Securityllä suojattujen APIen kutsumisen HTTP Basic Authentication -todennuksella selainpohjaisista API-työkaluista, kuten IAMMETER WEM API Testin Swagger-käyttöliittymästä. Laiteohjelmisto sallii nyt Authorization-otsakkeen CORS-esitarkistuspyynnöissä.

Avaa IAMMETER WEM API Test

Swaggerin käyttö edellyttää edelleen:

selainta, josta on yhteys mittarin paikalliseen IP-osoitteeseen;
kelvollisia Basic Auth -tunnuksia;
laitteen laiteohjelmiston tukemaa API-toimintoa.

Pyyntö lähetetään suoraan:

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

Swagger-verkkosivusto ei ole palvelin, joka muodostaa yhteyden mittariisi. Selaimen täytyy tavoittaa mittari paikallisverkossa, ja jokainen suojattu pyyntö vaatii edelleen kelvolliset Basic Auth -tunnukset. CORS-muutos ei poista todennusta eikä avaa laitteen APIa IAMMETER Cloudin kautta.

Muut tietoturvaparannukset

Security-sivulla on nyt selkeämpi Enable/Disable Security Module -ohjelinkki (ota tietoturvamoduuli käyttöön tai poista se käytöstä). Se vie Local Admin Security -käyttöoppaaseen, jossa on määritys- ja palautusohjeet.

MQTTS- ja HTTPS-varmenteiden tarkistus

i.91.065-laiteohjelmistosarja tukee myös kolmea varmenteiden tarkistustilaa MQTTS- ja HTTPS-yhteyksille:

builtin — käytä sisäänrakennettuja luotettuja juurivarmenteita;
custom — käytä ladattua PEM-muotoista CA-juurivarmennetta;
none — poista varmenteiden tarkistus käytöstä yhteensopivuutta tai hallittuja testiympäristöjä varten. Tätä tilaa ei suositella tavallisiin internetiin yhdistettyihin käyttöönottoihin.

Sisäänrakennettu varmennevarasto sisältää DigiCert Global Root G2- ja ISRG Root X1 -varmenteet. Yksityistä varmentajaa käyttäviin ympäristöihin voidaan ladata oma PEM-muotoinen CA-juurivarmenne. MQTTS ja HTTPS käyttävät samaa yhteistä TLS-tarkistusasetusta.

Määritystiedot löytyvät ohjeesta MQTTS- ja HTTPS-varmenteiden tarkistus.

Admin Security -asetukset on kuvattu Local Admin Security -käyttöoppaassa.

Päivitys- ja yhteensopivuushuomiot

Tämä julkaisu säilyttää taustalla olevien protokollien nykyisen tietoturvakäyttäytymisen:

suojatut APIt vaativat edelleen Basic Auth -todennuksen;
nykyiset OTA-tietoturvatarkistukset säilyvät käytössä;
tämä julkaisu ei muuta nykyistä TLS-yhteyksien tai varmenteiden tarkistuksen toimintaa;
laiteohjelmisto tarkistaa edelleen palautusallekirjoituksen täsmälleen kyseistä kertakäyttöistä tietosisältöä vasten.

Varmista ennen päivitystä, että laiteohjelmistopaketti vastaa IAMMETER-mittarisi mallia. Noudata paikallisen tai sovelluspohjaisen päivityksen ohjeita IAMMETERin laiteohjelmistopäivitykset -sivulla.

Virhekorjaukset ja luotettavuusparannukset

Tämä julkaisu sisältää myös i.91.065-laiteohjelmistosarjaan kertyneet luotettavuuskorjaukset:

Tehostettu OTA-ohjelmistokuvan tarkistus, mukaan lukien paketin rakenne, kuvan pituus, osioiden rajat ja eheystarkistukset.
Epäonnistunut OTA-tarkistus palauttaa nyt täsmällisen JSON-virheen, ei aseta päivityslippua eikä käynnistä mittaria uudelleen.
Parannettu OTA-virheiden käsittely verkkokäyttöliittymässä, mukaan lukien XHR-verkkovirheet ja aikakatkaisut.
Korjattu OTA-vastaukset, jotka selain saattoi ilmoittaa verkkovirheiksi Admin Securityn ollessa käytössä.
Parannettu useassa TCP-paketissa vastaanotettavien HTTP POST -pyyntörunkojen käsittely, mukaan lukien Admin Security-, TLS-varmenne-, lisäasetus- ja OTA-pyynnöt.
Korjattu ongelma, jossa verkkokäyttöliittymä ei välttämättä näyttänyt oikeaa tulossivua onnistuneen OTA-päivityksen jälkeen.
Korjattu WEM3046T:n ja WEM3063T:n loistehon skaalaus.
Lisätty WEM3063T:n Wi-Fi-LEDin yhteystilan ilmaisulogiikka.