Kako obnoviti dostop ob pozabljenem skrbniškem geslu IAMMETER

Če ste pozabili skrbniško uporabniško ime ali geslo za lokalni spletni vmesnik števca IAMMETER, za obnovitev dostopa ne potrebujete starih prijavnih podatkov. Podpisani postopek IAMMETER preveri pripadnost naprave, onemogoči Admin Security in izbriše pozabljene lokalne skrbniške podatke.

Ta vodič je namenjen pozabljenemu geslu Admin Security. Če trenutne podatke še poznate, jih spremenite ali onemogočite na zavihku Security naprave. Za nastavitev, dostop do zaščitenih API-jev in upravljanje storitev glejte uporabniški vodič Local Admin Security.

Na tej strani

Kaj naredi postopek obnovitve
Pred začetkom
Korak 1: Ustvarite enkratni obnovitveni payload
Korak 2: Pridobite podpisani obnovitveni odgovor
Korak 3: Pošljite payload in podpis napravi
Odpravljanje težav pri obnovitvi gesla
Zakaj obnovitev zahteva podpisani enkratni izziv
Povezana varnostna dokumentacija IAMMETER

Kaj naredi postopek obnovitve

Obnovitev uporablja tri sestavne dele:

Naprava IAMMETER ustvari enkratni obnovitveni payload, vezan na napravo.
Storitev IAMMETER Contributor preveri, ali je prijavljeni račun pooblaščen za upravljanje SN naprave, nato podpiše prav ta payload.
Naprava preveri podpis Ed25519, izbriše pozabljene podatke in onemogoči Admin Security.

Obnovitev ne izbriše energetskih podatkov, nastavitev Wi-Fi ali konfiguracije naprave. Po obnovitvi lahko odprete lokalni spletni vmesnik ter nastavite novo skrbniško uporabniško ime in geslo.

Pred začetkom

Potrebujete:

dostop do naprave IAMMETER v istem lokalnem omrežju;
lokalni naslov IP naprave;
račun IAMMETER s pooblastilom za upravljanje SN naprave;
brskalnik na računalniku, ki lahko doseže lokalni spletni vmesnik naprave. curl ali drug odjemalec HTTP je potreben samo pri ročnem pošiljanju.

Podporo podpisani obnovitvi v nameščeni strojni programski opremi preverite tako, da odprete:

http://<device-ip>/api/admin/status

V odgovoru poiščite "recoverySupported":1. Če obnovitvena končna točka ni na voljo, pred nadaljevanjem posodobite na združljivo različico ali se obrnite na podporo IAMMETER.

Pomembno: Izziv vsebuje enkratni nonce. Naprava naj ostane vklopljena; do zaključka obnovitvenega POST ne zahtevajte novega izziva. Nov izziv ali ponovni zagon naprave razveljavi prejšnji payload.

Korak 1: Ustvarite enkratni obnovitveni payload

V brskalniku odprite naslednji URL in zamenjajte <device-ip> z lokalnim naslovom IP naprave IAMMETER:

http://<device-ip>/api/admin/recovery_challenge

Ali zahtevajte izziv z curl:

curl "http://<device-ip>/api/admin/recovery_challenge"

Naprava vrne odgovor, podoben temu:

{
  "successful": 1,
  "alg": "ed25519",
  "payload": "reset_admin|DEVICE_SN|DEVICE_MAC|ONE_TIME_NONCE"
}

Kopirajte celotno vrednost payload. Ne spreminjajte znakov, ločil, velikosti črk, SN naprave, naslova MAC ali nonce.

Ustvarjanje enkratnega obnovitvenega payloada Admin Security iz števca IAMMETER

Po kopiranju payloada ne osvežujte strani izziva in ne kličite /api/admin/recovery_challenge znova. Vsaka zahteva takoj razveljavi prejšnji izziv.

Korak 2: Pridobite podpisani obnovitveni odgovor

Prijavite se v sistem IAMMETER Contributor in odprite:

IAMMETER Admin Recovery

Prilepite celoten payload iz Koraka 1 in ga pošljite. Storitev preveri, ali je SN naprave v payloadu povezan z vašim računom. Po preverjanju vrne podpis Ed25519 za točno ta payload.

Ustvarjanje obnovitvenega podpisa Ed25519 v aplikaciji IAMMETER Admin Recovery

Podpis velja samo za nespremenjeni payload, ki ga je naprava ustvarila v Koraku 1. Če boste zahtevo poslali ročno z curl, kopirajte podpis natanko v vrnjeni obliki. Če isti brskalnik doseže napravo prek lokalnega omrežja, lahko naslednji korak opravite neposredno na strani Contributor.

Korak 3: Pošljite payload in podpis napravi

Možnost A: Obnovitev dokončajte neposredno v brskalniku

Če je računalnik z brskalnikom v istem omrežju kot naprava IAMMETER in lahko odpre njen lokalni spletni vmesnik, lahko podpisani rezultat pošljete neposredno s strani Contributor Admin Recovery:

V Step 3: Send to your device vnesite lokalni naslov IP naprave.
Z obnovitvenim dejanjem na strani pošljite podpisani payload napravi.
Počakajte na Recovery completed. To potrdi, da je naprava sprejela podpisani rezultat, izbrisala obstoječe lokalno skrbniško uporabniško ime in geslo ter onemogočila Admin Security.

Neposredna obnovitev gesla IAMMETER Admin Security s strani Contributor, ko sta brskalnik in naprava v istem lokalnem omrežju

Ta način ne zahteva kopiranja obnovitvenega JSON v ločen ukaz. Deluje samo, če se brskalnik lahko neposredno poveže z lokalnim naslovom IP naprave.

Možnost B: Ročno pošljite obnovitveno zahtevo s curl

Izvedite naslednji ukaz. Zamenjajte:

<device-ip> z lokalnim naslovom IP naprave;
<original-payload> s celotnim payloadom iz Koraka 1;
<signature> s podpisom, vrnjenim v Koraku 2.

curl -X POST "http://<device-ip>/api/admin/recovery" \
  -H "Content-Type: application/json" \
  -d '{"payload":"<original-payload>","signature":"<signature>"}'

Primer:

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 tej zahtevi mora biti enak payloadu, ki ga je podpisala storitev Contributor.

Isto zahtevo lahko pošljete tudi s strani IAMMETER WEM API Test - Admin Security Public. Odprite operacijo POST /api/admin/recovery, podajte isti obnovitveni JSON in ga pošljite iz brskalnika, ki doseže lokalni naslov IP naprave. Zahteva Swagger gre neposredno v napravo, ne prek posrednika IAMMETER Cloud.

Po uspešnem preverjanju naprava:

izbriše obstoječe lokalno skrbniško uporabniško ime in geslo;
onemogoči Admin Security;
razveljavi obnovitveni nonce, da istega payloada in podpisa ni mogoče ponovno uporabiti.

Odprite lokalni spletni vmesnik naprave, pojdite na zavihek Security ter nastavite novo skrbniško uporabniško ime in geslo, če želite znova omogočiti Admin Security.

Odpravljanje težav pri obnovitvi gesla

Podpis je zavrnjen

Najpogostejši vzrok je zahteva za nov obnovitveni izziv po ustvarjenem prvem payloadu. Zahtevajte en nov payload, pridobite podpis zanj in pošljite ujemajoči se par brez osveževanja strani izziva.

Podpis je zavrnjen tudi, ko:

se je naprava po ustvarjanju payloada ponovno zagnala;
je bil payload spremenjen;
podpis pripada drugemu payloadu ali napravi;
sta bila isti payload in podpis že uspešno uporabljena.

Naprava javlja premalo pomnilnika

Preverjanje Ed25519 potrebuje dovolj prostega pomnilnika. Naprava lahko vrne odgovor, podoben temu:

{
  "successful": 0,
  "message": "low memory, please change to standalone mode",
  "freeMemory": 18000,
  "minFreeRequired": 28000
}

Znova zaženite napravo, da sprostite začasni pomnilnik, nato ustvarite nov payload in obnovitev hitro dokončajte. Payloada, ustvarjenega pred ponovnim zagonom, ni mogoče ponovno uporabiti.

Zakaj obnovitev zahteva podpisani enkratni izziv

IAMMETER ne izpostavlja neavtenticiranega ukaza za tovarniško ponastavitev, ki bi obšel skrbniško zaščito. Namesto tega:

naprava ustvari payload z obnovitveno operacijo, SN naprave, naslovom MAC in naključnim enkratnim nonce;
storitev Contributor preveri pooblastilo prijavljenega računa IAMMETER za ta SN;
IAMMETER podpiše točno ta payload z zasebnim ključem Ed25519;
naprava preveri podpis z javnim ključem v strojni programski opremi;
nov izziv, ponovni zagon ali uspešna obnovitev razveljavi trenutni nonce.

Vezava pooblastila na identiteto naprave in enkratni nonce preprečuje poznejšo ponovno uporabo prej prestreženega payloada in podpisa.

Povezana varnostna dokumentacija IAMMETER

Članek EN 18031 pojasnjuje varnostno delo na strojni programski opremi. Ne pomeni, da je certifikat za določen števec že izdan; podrobnosti certificiranja bodo objavljene ločeno, ko bodo na voljo.