IAMMETER-firmware i.91.065.17 tilføjer sikker gendannelse af administratoradgang samt understøttelse af Swagger API og WEM3063T
IAMMETER-firmware i.91.065.17 bygger videre på sikkerhedsfunktionerne i i.91.065-serien og tilføjer en sikker gendannelsesmekanisme til glemte Admin Security-loginoplysninger, forbedret browserbaseret API-test med HTTP Basic Authentication samt understøttelse af den nye WEM3063T-energimåler.
Denne udgivelse er også en del af IAMMETERs løbende arbejde med cybersikkerhedskravene til internetforbundet radioudstyr under EN 18031-1:2024. Status for overensstemmelse og certificering af de enkelte IAMMETER-målermodeller offentliggøres særskilt, når den foreligger officielt.
Opdateringen giver brugerne fire praktiske forbedringer:
- gendannelse af adgang, hvis den lokale Admin Security-adgangskode er glemt;
- test af beskyttede enheds-API'er fra en ekstern Swagger UI;
- understøttelse af den trefasede WEM3063T-energimåler til det amerikanske marked;
- lettere adgang til vejledningen til sikkerhedsmodulet.
Sikker gendannelse ved glemt administratoradgangskode
Hvis du glemmer din Admin Security-adgangskode, kan du bekræfte, at enheden er knyttet til din IAMMETER-konto, og gendanne lokal adgang, uden at IAMMETER Cloud skal oprette direkte forbindelse til eller nulstille måleren. Enheden genererer en engangsudfordring til gendannelse, og gendannelsestjenesten signerer netop denne udfordring efter kontobekræftelse.
Fremgangsmåden er:
- Anmod enheden om en engangsudfordring til gendannelse.
- Log ind på IAMMETER Contributor-systemet med din IAMMETER Cloud-konto.
- Indsend udfordringens payload. Gendannelsestjenesten kontrollerer, at enhedens serienummer er knyttet til din IAMMETER-konto.
- Modtag en Ed25519-signatur til netop denne payload.
- Send den signerede gendannelsesanmodning til enheden via dens lokale IP-adresse.
- Efter vellykket kontrol deaktiverer enheden Admin Security, så du kan konfigurere et nyt Admin Security-brugernavn og en ny adgangskode.
Gendannelsens payload er bundet til enhedens serienummer, MAC-adresse og en engangs-nonce. Firmwaren indeholder kun den offentlige verifikationsnøgle, ikke en privat signeringsnøgle. Gendannelsestjenesten signerer den enhedsgenererede udfordring efter kontrol; den opretter ikke direkte forbindelse til og nulstiller ikke måleren.
Se hele fremgangsmåden i Sådan gendannes adgang ved en glemt IAMMETER-administratoradgangskode.
Understøttelse af WEM3063T til det amerikanske marked
Firmware i.91.065.17 understøtter WEM3063T, en trefaset IAMMETER-energimåler udviklet til det amerikanske marked.
WEM3063T er konstrueret til eksterne strømtransformere med standardudgang på 5 A. Den har gennemgået produkt- og sikkerhedstest som led i den igangværende UL-certificeringsproces, herunder test udført af SGS. Status for UL-certificeringen offentliggøres særskilt, når den foreligger officielt. Firmwaren identificerer WEM3063T og anvender den tilsvarende skaleringslogik for strøm, effekt og energi.
Kontrollér målerens model, strømtransformerens specifikationer og de regionale installationskrav på stedet før opdatering.
Swagger API-test med Basic Auth
Firmware i.91.065.17 gør det muligt for browserbaserede API-værktøjer såsom IAMMETER WEM API Tests Swagger UI at kalde API'er beskyttet af Admin Security med HTTP Basic Authentication. Firmwaren tillader nu headeren Authorization i CORS-preflight-anmodninger.
Swagger-arbejdsgangen kræver stadig:
- en browser, der kan nå målerens lokale IP-adresse;
- gyldige Basic Auth-loginoplysninger;
- en API-handling, som enhedens firmware understøtter.
Anmodningen sendes direkte:
Browser → loads Swagger UI from iammeter.github.io
Browser → sends an authenticated API request directly to the meter's local IP
Swagger-webstedet er ikke en server, der opretter forbindelse til din måler. Browseren skal kunne nå måleren på det lokale netværk, og hver beskyttet anmodning kræver stadig gyldige Basic Auth-loginoplysninger. CORS-ændringen fjerner ikke godkendelse og gør ikke enhedens API tilgængelig gennem IAMMETER Cloud.
Andre sikkerhedsforbedringer
Siden Security har nu et tydeligere hjælpelink, Enable/Disable Security Module (Aktivér/deaktivér sikkerhedsmodulet). Det fører til brugervejledningen til Local Admin Security, herunder vejledning i konfiguration og gendannelse.
Certifikatvalidering for MQTTS og HTTPS
Firmware-serien i.91.065 understøtter også tre certifikatvalideringstilstande for MQTTS og HTTPS:
builtin— brug de indbyggede, betroede rodcertifikater;custom— brug et uploadet PEM-rod-CA-certifikat;none— deaktivér certifikatvalidering af hensyn til kompatibilitet eller i kontrollerede testmiljøer. Denne tilstand anbefales ikke til normal brug med internetforbindelse.
Det indbyggede certifikatlager omfatter DigiCert Global Root G2 og ISRG Root X1. Et brugerdefineret PEM-rod-CA-certifikat kan uploades til installationer med en privat certifikatudsteder. MQTTS og HTTPS deler den samme TLS-valideringskonfiguration.
Se konfigurationsoplysninger i Certifikatvalidering for MQTTS og HTTPS.
Se Admin Security-indstillinger i brugervejledningen til Local Admin Security.
Bemærkninger om opdatering og kompatibilitet
Denne udgivelse bevarer de underliggende protokollers eksisterende sikkerhedsadfærd:
- beskyttede API'er kræver fortsat Basic Auth-godkendelse;
- eksisterende OTA-sikkerhedskontroller bevares;
- denne udgivelse ændrer ikke den eksisterende TLS-forbindelses- eller certifikatvalideringsadfærd;
- firmwaren validerer stadig gendannelsessignaturen mod den præcise engangs-payload.
Kontrollér før opdatering, at firmwarepakken passer til din IAMMETER-målermodel, og følg vejledningen til lokal eller appbaseret opdatering på siden IAMMETER Firmware Updates.
Fejlrettelser og forbedret driftssikkerhed
Udgivelsen omfatter også driftssikkerhedsrettelser, der er samlet i firmware-serien i.91.065:
- Styrket validering af OTA-image, herunder pakkestruktur, image-længde, partitionsgrænser og integritetskontroller.
- Fejl ved OTA-validering returnerer nu en konkret JSON-fejl, sætter ikke opdateringsflaget og genstarter ikke måleren.
- Forbedret OTA-fejlhåndtering i webgrænsefladen, herunder XHR-netværksfejl og timeout.
- Rettet OTA-svar, som browseren kunne rapportere som netværksfejl, når Admin Security var aktiveret.
- Forbedret håndtering af HTTP POST-indhold modtaget i flere TCP-pakker, herunder anmodninger til Admin Security, TLS-certifikater, avancerede indstillinger og OTA.
- Rettet et problem, hvor webgrænsefladen ikke altid viste den korrekte resultatside efter en vellykket OTA-opdatering.
- Rettet skalering af reaktiv effekt for WEM3046T og WEM3063T.
- Tilføjet logik for Wi-Fi-LED'ens visning af forbindelsesstatus på WEM3063T.
