Firmware IAMMETER i.91.065.17 přidává bezpečné obnovení přístupu správce, podporu Swagger API a WEM3063T

Firmware IAMMETER i.91.065.17 navazuje na bezpečnostní funkce řady i.91.065 a přidává bezpečný mechanismus obnovení přístupu při zapomenutí přihlašovacích údajů Admin Security, vylepšené testování API v prohlížeči s HTTP Basic Authentication a podporu nového elektroměru WEM3063T.

Stáhnout firmware i.91.065.17

Tato verze je také součástí průběžné práce společnosti IAMMETER na plnění požadavků kybernetické bezpečnosti pro rádiová zařízení připojená k internetu podle EN 18031-1:2024. Stav shody a certifikace jednotlivých modelů elektroměrů IAMMETER bude oznámen samostatně, jakmile bude oficiálně dostupný.

Uživatelům aktualizace přináší čtyři praktická vylepšení:

obnovení přístupu při zapomenutí místního hesla Admin Security;
testování chráněných API zařízení z externího rozhraní Swagger UI;
podporu třífázového elektroměru WEM3063T pro americký trh;
snazší přístup k pokynům k bezpečnostnímu modulu.

Bezpečné obnovení přístupu při zapomenutí hesla správce

Pokud zapomenete heslo Admin Security, můžete ověřit, že je zařízení přiřazeno k vašemu účtu IAMMETER, a obnovit místní přístup, aniž by se IAMMETER Cloud musel přímo připojit k elektroměru nebo jej resetovat. Zařízení vytvoří jednorázovou výzvu pro obnovení a služba pro obnovení po ověření účtu podepíše právě tuto výzvu.

Postup je následující:

Vyžádejte si od zařízení jednorázovou výzvu pro obnovení.
Přihlaste se do systému IAMMETER Contributor pomocí účtu IAMMETER Cloud.
Odešlete datový obsah výzvy. Služba pro obnovení ověří, že je sériové číslo zařízení přiřazeno k vašemu účtu IAMMETER.
Získejte podpis Ed25519 pro přesně tento datový obsah.
Odešlete podepsaný požadavek na obnovení zařízení prostřednictvím jeho místní IP adresy.
Po úspěšném ověření zařízení vypne Admin Security, abyste mohli nastavit nové uživatelské jméno a heslo Admin Security.

Datový obsah pro obnovení je svázán se sériovým číslem zařízení, adresou MAC a jednorázovým nonce. Firmware obsahuje pouze veřejný ověřovací klíč, nikoli soukromý podpisový klíč. Služba pro obnovení po ověření podepíše výzvu vytvořenou zařízením; k elektroměru se přímo nepřipojuje ani jej neresetuje.

Úplný postup najdete v článku Jak obnovit přístup při zapomenutí hesla správce IAMMETER.

Podpora WEM3063T pro americký trh

Firmware i.91.065.17 zahrnuje podporu WEM3063T, třífázového elektroměru IAMMETER vyvinutého pro americký trh.

WEM3063T je určen pro externí proudové transformátory se standardním výstupem 5 A. V rámci probíhajícího procesu certifikace UL prošel zkouškami výrobku a bezpečnosti, včetně zkoušek provedených SGS. Stav certifikace UL bude oznámen samostatně, jakmile bude oficiálně dostupný. Firmware rozpoznává WEM3063T a používá odpovídající přepočty proudu, výkonu a energie.

Před aktualizací ověřte model elektroměru, specifikace proudových transformátorů a místní požadavky na instalaci.

Testování API přes Swagger s Basic Auth

Firmware i.91.065.17 umožňuje nástrojům API v prohlížeči, například rozhraní Swagger UI nástroje IAMMETER WEM API Test, volat API chráněná funkcí Admin Security pomocí HTTP Basic Authentication. Firmware nyní povoluje hlavičku Authorization v předběžných požadavcích CORS.

Otevřít IAMMETER WEM API Test

Postup se Swaggerem nadále vyžaduje:

prohlížeč, který má přístup k místní IP adrese elektroměru;
platné přihlašovací údaje Basic Auth;
operaci API podporovanou firmwarem zařízení.

Požadavek se odesílá přímo:

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

Web Swagger není server, který se připojuje k vašemu elektroměru. Prohlížeč musí mít přístup k elektroměru v místní síti a každý chráněný požadavek nadále vyžaduje platné přihlašovací údaje Basic Auth. Změna CORS neodstraňuje ověřování ani nezpřístupňuje API zařízení prostřednictvím IAMMETER Cloud.

Další bezpečnostní vylepšení

Stránka Security nyní nabízí výraznější odkaz nápovědy Enable/Disable Security Module (Zapnout/vypnout bezpečnostní modul). Odkazuje na uživatelskou příručku Local Admin Security, včetně pokynů ke konfiguraci a obnovení přístupu.

Ověřování certifikátů MQTTS a HTTPS

Řada firmwaru i.91.065 také podporuje tři režimy ověřování certifikátů pro MQTTS a HTTPS:

builtin — použití vestavěných důvěryhodných kořenových certifikátů;
custom — použití nahraného kořenového certifikátu CA ve formátu PEM;
none — vypnutí ověřování certifikátů kvůli kompatibilitě nebo v řízeném testovacím prostředí. Tento režim se nedoporučuje pro běžná nasazení připojená k internetu.

Vestavěné úložiště certifikátů obsahuje DigiCert Global Root G2 a ISRG Root X1. Pro nasazení se soukromou certifikační autoritou lze nahrát vlastní kořenový certifikát CA ve formátu PEM. MQTTS a HTTPS sdílejí stejné nastavení ověřování TLS.

Podrobnosti konfigurace najdete v článku Ověřování certifikátů MQTTS a HTTPS.

Nastavení Admin Security popisuje uživatelská příručka Local Admin Security.

Poznámky k aktualizaci a kompatibilitě

Tato verze zachovává stávající bezpečnostní chování základních protokolů:

chráněná API nadále vyžadují ověřování Basic Auth;
stávající bezpečnostní kontroly OTA zůstávají zachovány;
tato verze nemění stávající chování připojení TLS ani ověřování certifikátů;
firmware nadále ověřuje podpis pro obnovení vůči přesnému jednorázovému datovému obsahu.

Před aktualizací ověřte, že balíček firmwaru odpovídá modelu vašeho elektroměru IAMMETER, a postupujte podle pokynů pro místní aktualizaci nebo aktualizaci pomocí aplikace na stránce Aktualizace firmwaru IAMMETER.

Opravy chyb a vylepšení spolehlivosti

Tato verze obsahuje také opravy spolehlivosti shromážděné v řadě firmwaru i.91.065:

Posílené ověřování obrazu OTA, včetně struktury balíčku, délky obrazu, hranic oddílů a kontrol integrity.
Neúspěšné ověření OTA nyní vrací konkrétní chybu JSON, nenastavuje příznak aktualizace a nerestartuje elektroměr.
Vylepšené zpracování chyb OTA ve webovém rozhraní, včetně síťových chyb XHR a vypršení časového limitu.
Opraveny odpovědi OTA, které prohlížeč mohl při zapnutém Admin Security hlásit jako síťové chyby.
Vylepšené zpracování těl požadavků HTTP POST přijatých v několika paketech TCP, včetně požadavků Admin Security, certifikátů TLS, pokročilých nastavení a OTA.
Opravena chyba, kvůli které webové rozhraní nemuselo po úspěšné aktualizaci OTA zobrazit správnou výsledkovou stránku.
Opraven přepočet jalového výkonu pro WEM3046T a WEM3063T.
Přidána logika indikace stavu připojení pomocí Wi-Fi LED pro WEM3063T.