Jak obnovit přístup při zapomenutém hesle správce IAMMETER
Pokud jste zapomněli uživatelské jméno nebo heslo správce místního webového rozhraní elektroměru IAMMETER, k obnovení přístupu nepotřebujete původní přihlašovací údaje. Podepsaná obnova IAMMETER ověří vlastnictví zařízení, vypne Admin Security a vymaže zapomenuté místní údaje správce.
Tento průvodce je určen pro zapomenuté heslo Admin Security. Pokud aktuální údaje znáte, změňte je nebo vypněte ochranu na kartě Security zařízení. Nastavení, přístup k chráněným API a ovládání služeb popisuje uživatelská příručka Local Admin Security.
Na této stránce
- Co proces obnovy provádí
- Než začnete
- Krok 1: Vygenerujte jednorázový obnovovací payload
- Krok 2: Získejte podepsanou obnovovací odpověď
- Krok 3: Odešlete payload a podpis zařízení
- Řešení problémů s obnovou hesla
- Proč obnova vyžaduje podepsanou jednorázovou výzvu
- Související bezpečnostní dokumentace IAMMETER
Co proces obnovy provádí
Obnova využívá tři části:
- Zařízení IAMMETER vygeneruje jednorázový obnovovací payload specifický pro dané zařízení.
- Služba IAMMETER Contributor ověří, že přihlášený účet smí spravovat SN zařízení, a podepíše přesně tento payload.
- Zařízení ověří podpis Ed25519, vymaže zapomenuté údaje a vypne Admin Security.
Obnova nevymaže energetická data, nastavení Wi-Fi ani konfiguraci zařízení. Poté můžete otevřít místní webové rozhraní a nastavit nové uživatelské jméno a heslo správce.
Než začnete
Potřebujete:
- přístup k zařízení IAMMETER ve stejné místní síti;
- místní IP adresu zařízení;
- účet IAMMETER oprávněný spravovat SN zařízení;
- prohlížeč v počítači, který dosáhne na místní webové rozhraní zařízení.
curlnebo jiný HTTP klient je nutný pouze při ručním odesílání.
Podporu podepsané obnovy v nainstalovaném firmwaru ověříte otevřením:
http://<device-ip>/api/admin/status
V odpovědi hledejte "recoverySupported":1. Pokud obnovovací endpoint není dostupný, před pokračováním aktualizujte na kompatibilní firmware nebo kontaktujte podporu IAMMETER.
Důležité: Výzva obsahuje jednorázový nonce. Nechte zařízení zapnuté a než se dokončí obnovovací POST, nežádejte další výzvu. Nová výzva nebo restart zařízení zneplatní předchozí payload.
Krok 1: Vygenerujte jednorázový obnovovací payload
V prohlížeči otevřete následující URL a nahraďte <device-ip> místní IP adresou zařízení IAMMETER:
http://<device-ip>/api/admin/recovery_challenge
Nebo si výzvu vyžádejte pomocí curl:
curl "http://<device-ip>/api/admin/recovery_challenge"
Zařízení vrátí odpověď podobnou této:
{
"successful": 1,
"alg": "ed25519",
"payload": "reset_admin|DEVICE_SN|DEVICE_MAC|ONE_TIME_NONCE"
}
Zkopírujte celou hodnotu payload. Neměňte znaky, oddělovače, velikost písmen, SN zařízení, MAC adresu ani nonce.
Po zkopírování payloadu neobnovujte stránku výzvy a znovu nevolejte
/api/admin/recovery_challenge. Každý požadavek ihned zneplatní předchozí výzvu.
Krok 2: Získejte podepsanou obnovovací odpověď
Přihlaste se do systému IAMMETER Contributor a otevřete:
Vložte celý payload z Kroku 1 a odešlete jej. Služba ověří, zda je SN zařízení v payloadu přiřazeno vašemu účtu. Po ověření vrátí podpis Ed25519 přesně pro tento payload.
Podpis platí pouze pro nezměněný payload vytvořený zařízením v Kroku 1. Pokud chcete požadavek odeslat ručně pomocí curl, zkopírujte podpis přesně, jak byl vrácen. Jestliže stejný prohlížeč dosáhne na zařízení v místní síti, další krok dokončíte přímo na stránce Contributor.
Krok 3: Odešlete payload a podpis zařízení
Možnost A: Dokončete obnovu přímo v prohlížeči
Pokud je počítač s prohlížečem ve stejné síti jako zařízení IAMMETER a prohlížeč otevře jeho místní webové rozhraní, můžete podepsaný výsledek odeslat přímo ze stránky Contributor Admin Recovery:
- V Step 3: Send to your device zadejte místní IP adresu zařízení.
- Použijte obnovovací akci na stránce k odeslání podepsaného payloadu zařízení.
- Vyčkejte na Recovery completed. To potvrzuje, že zařízení přijalo podepsaný výsledek, vymazalo dosavadní místní uživatelské jméno a heslo správce a vypnulo Admin Security.
Tato metoda nevyžaduje kopírování obnovovacího JSON do samostatného příkazu. Funguje pouze tehdy, když se prohlížeč může připojit přímo k místní IP adrese zařízení.
Možnost B: Odešlete obnovovací požadavek ručně pomocí curl
Spusťte následující příkaz. Nahraďte:
<device-ip>místní IP adresou zařízení;<original-payload>úplným payloadem z Kroku 1;<signature>podpisem vráceným v Kroku 2.
curl -X POST "http://<device-ip>/api/admin/recovery" \
-H "Content-Type: application/json" \
-d '{"payload":"<original-payload>","signature":"<signature>"}'
Příklad:
curl -X POST "http://192.168.1.100/api/admin/recovery" \
-H "Content-Type: application/json" \
-d '{"payload":"reset_admin|DEVICE_SN|DEVICE_MAC|ONE_TIME_NONCE","signature":"128_HEX_CHARACTER_SIGNATURE"}'
Payload v tomto požadavku musí být totožný s payloadem podepsaným službou Contributor.
Stejný požadavek můžete odeslat také ze stránky IAMMETER WEM API Test - Admin Security Public. Otevřete operaci POST /api/admin/recovery, zadejte stejný obnovovací JSON a odešlete jej z prohlížeče s přístupem k místní IP zařízení. Požadavek Swagger jde přímo do zařízení, nikoli přes proxy IAMMETER Cloud.
Po úspěšném ověření zařízení:
- vymaže stávající místní uživatelské jméno a heslo správce;
- vypne Admin Security;
- zneplatní obnovovací nonce, takže stejný payload a podpis nelze znovu použít.
Otevřete místní webové rozhraní zařízení, přejděte na kartu Security a nastavte nové uživatelské jméno a heslo správce, pokud chcete Admin Security znovu zapnout.
Řešení problémů s obnovou hesla
Podpis je odmítnut
Nejčastější příčinou je vyžádání nové obnovovací výzvy po vytvoření prvního payloadu. Vyžádejte jeden nový payload, získejte pro něj podpis a odešlete odpovídající dvojici bez obnovení stránky výzvy.
Podpis je odmítnut také tehdy, když:
- se zařízení po vytvoření payloadu restartovalo;
- byl payload upraven;
- podpis patří jinému payloadu nebo zařízení;
- stejný payload a podpis již byly úspěšně použity.
Zařízení hlásí nedostatek paměti
Ověření Ed25519 vyžaduje dostatek volné paměti. Zařízení může vrátit odpověď podobnou této:
{
"successful": 0,
"message": "low memory, please change to standalone mode",
"freeMemory": 18000,
"minFreeRequired": 28000
}
Restartujte zařízení pro uvolnění dočasné paměti, pak vytvořte nový payload a obnovu rychle dokončete. Payload vytvořený před restartem nelze znovu použít.
Proč obnova vyžaduje podepsanou jednorázovou výzvu
IAMMETER nezpřístupňuje neautentizovaný příkaz k továrnímu resetu pro obejití ochrany správce. Místo toho:
- zařízení vytvoří payload obsahující obnovovací operaci, SN, MAC adresu a náhodný jednorázový nonce;
- služba Contributor ověří oprávnění přihlášeného účtu IAMMETER pro dané SN;
- IAMMETER podepíše přesně tento payload soukromým klíčem Ed25519;
- zařízení ověří podpis veřejným klíčem zabudovaným do firmwaru;
- nová výzva, restart nebo úspěšná obnova zneplatní aktuální nonce.
Svázání oprávnění s identitou zařízení i jednorázovým nonce zabraňuje pozdějšímu opětovnému použití dříve zachyceného payloadu a podpisu.
Související bezpečnostní dokumentace IAMMETER
- Nastavení Local Admin Security, chráněných API, Modbus/TCP a SSDP
- Aktualizace firmwaru Admin Security a bezpečnostní kontext EN 18031-1:2024
Článek o EN 18031 vysvětluje bezpečnostní práce na firmwaru. Nelze jej chápat jako tvrzení, že konkrétnímu elektroměru již byl vydán certifikát; podrobnosti certifikace budou zveřejněny samostatně, až budou dostupné.
