Kā atjaunot piekļuvi, ja aizmirsta IAMMETER administratora parole

Ja esat aizmirsis IAMMETER enerģijas skaitītāja vietējās tīmekļa saskarnes administratora lietotājvārdu vai paroli, piekļuves atjaunošanai vecie akreditācijas dati nav nepieciešami. IAMMETER parakstītā atkopšana pārbauda ierīces piederību, atspējo Admin Security un dzēš aizmirstos vietējā administratora akreditācijas datus.

Šī pamācība ir paredzēta aizmirstai Admin Security parolei. Ja pašreizējie akreditācijas dati ir zināmi, mainiet vai atspējojiet tos ierīces cilnē Security. Par iestatīšanu, aizsargāto API piekļuvi un pakalpojumu vadību skatiet Local Admin Security lietotāja pamācību.

Šajā lapā

Ko dara atkopšanas process
Pirms sākšanas
1. solis: Ģenerējiet vienreizēju atkopšanas payload
2. solis: Saņemiet parakstīto atkopšanas atbildi
3. solis: Nosūtiet payload un parakstu ierīcei
Paroles atkopšanas problēmu novēršana
Kāpēc atkopšanai vajadzīgs parakstīts vienreizējs izaicinājums
Saistītā IAMMETER drošības dokumentācija

Ko dara atkopšanas process

Atkopšanā tiek izmantoti trīs komponenti:

IAMMETER ierīce ģenerē ierīcei specifisku vienreizējas atkopšanas payload.
IAMMETER Contributor pakalpojums pārbauda, vai pieteiktajam kontam ir tiesības pārvaldīt ierīces SN, un paraksta tieši šo payload.
Ierīce pārbauda Ed25519 parakstu, dzēš aizmirstos akreditācijas datus un atspējo Admin Security.

Atkopšana nedzēš enerģijas datus, Wi-Fi iestatījumus vai ierīces konfigurāciju. Pēc atkopšanas varat atvērt vietējo tīmekļa saskarni un iestatīt jaunu administratora lietotājvārdu un paroli.

Pirms sākšanas

Nepieciešams:

piekļuve IAMMETER ierīcei tajā pašā vietējā tīklā;
ierīces vietējā IP adrese;
IAMMETER konts ar tiesībām pārvaldīt ierīces SN;
pārlūkprogramma datorā, kas var sasniegt ierīces vietējo tīmekļa saskarni. curl vai cits HTTP klients vajadzīgs tikai tad, ja izvēlaties manuālu nosūtīšanu.

Varat pārbaudīt, vai instalētā aparātprogrammatūra atbalsta parakstītu atkopšanu, atverot:

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

Atbildē meklējiet "recoverySupported":1. Ja atkopšanas galapunkts nav pieejams, pirms turpināšanas atjauniniet uz saderīgu aparātprogrammatūru vai sazinieties ar IAMMETER atbalstu.

Svarīgi: Izaicinājumā ir vienreizējs nonce. Saglabājiet ierīci ieslēgtu un nepieprasiet citu izaicinājumu, kamēr atkopšanas POST nav pabeigts. Jauns izaicinājums vai ierīces restartēšana padara iepriekšējo payload nederīgu.

1. solis: Ģenerējiet vienreizēju atkopšanas payload

Pārlūkprogrammā atveriet šo URL, aizstājot <device-ip> ar IAMMETER ierīces vietējo IP adresi:

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

Vai pieprasiet izaicinājumu ar curl:

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

Ierīce atgriež aptuveni šādu atbildi:

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

Nokopējiet visu payload vērtību. Nemainiet rakstzīmes, atdalītājus, burtu reģistru, ierīces SN, MAC adresi vai nonce.

Vienreizēja Admin Security atkopšanas payload ģenerēšana IAMMETER skaitītājā

Pēc payload kopēšanas neatjaunojiet izaicinājuma lapu un atkārtoti neizsauciet /api/admin/recovery_challenge. Katrs pieprasījums nekavējoties anulē iepriekšējo izaicinājumu.

2. solis: Saņemiet parakstīto atkopšanas atbildi

Piesakieties IAMMETER Contributor sistēmā un atveriet:

IAMMETER Admin Recovery

Ielīmējiet pilno payload no 1. soļa un nosūtiet to. Pakalpojums pārbauda, vai payload ietvertais ierīces SN ir saistīts ar jūsu kontu. Pēc pārbaudes tas atgriež Ed25519 parakstu tieši šim payload.

Ed25519 atkopšanas paraksta ģenerēšana IAMMETER Admin Recovery lietotnē

Paraksts der tikai nemainītajam payload, ko ierīce ģenerēja 1. solī. Ja sūtīsiet pieprasījumu manuāli ar curl, nokopējiet parakstu tieši atgrieztajā formā. Ja tā pati pārlūkprogramma vietējā tīklā var sasniegt ierīci, nākamo soli var pabeigt tieši Contributor lapā.

3. solis: Nosūtiet payload un parakstu ierīcei

A variants: Pabeidziet atkopšanu tieši pārlūkprogrammā

Ja dators ar pārlūkprogrammu ir tajā pašā tīklā kā IAMMETER ierīce un pārlūkprogramma var atvērt tās vietējo tīmekļa saskarni, parakstīto rezultātu var nosūtīt tieši no Contributor Admin Recovery lapas:

Sadaļā Step 3: Send to your device ievadiet ierīces vietējo IP adresi.
Izmantojiet lapas atkopšanas darbību, lai nosūtītu parakstīto payload ierīcei.
Sagaidiet Recovery completed. Tas apstiprina, ka ierīce pieņēma parakstīto rezultātu, dzēsa esošo vietējā administratora lietotājvārdu un paroli un atspējoja Admin Security.

IAMMETER Admin Security paroles atkopšana tieši Contributor lapā, ja pārlūkprogramma un ierīce ir vienā vietējā tīklā

Šī pārlūkprogrammas metode ļauj nekopēt atkopšanas JSON atsevišķā komandā. Tā darbojas tikai tad, ja pārlūkprogramma var tieši savienoties ar ierīces vietējo IP adresi.

B variants: Nosūtiet atkopšanas pieprasījumu manuāli ar curl

Izpildiet šo komandu. Aizstājiet:

<device-ip> ar ierīces vietējo IP adresi;
<original-payload> ar pilno payload no 1. soļa;
<signature> ar 2. solī saņemto parakstu.

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

Piemērs:

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"}'

Šī pieprasījuma payload jābūt identiskam payload, ko parakstīja Contributor pakalpojums.

To pašu atkopšanas pieprasījumu var nosūtīt no IAMMETER WEM API Test - Admin Security Public lapas. Atveriet darbību POST /api/admin/recovery, ievadiet to pašu atkopšanas JSON un nosūtiet no pārlūkprogrammas, kas sasniedz ierīces vietējo IP adresi. Swagger pieprasījums tiek sūtīts tieši ierīcei, nevis caur IAMMETER Cloud starpniekserveri.

Pēc veiksmīgas pārbaudes ierīce:

dzēš esošo vietējā administratora lietotājvārdu un paroli;
atspējo Admin Security;
anulē atkopšanas nonce, lai to pašu payload un parakstu nevarētu izmantot atkārtoti.

Atveriet ierīces vietējo tīmekļa saskarni, dodieties uz cilni Security un konfigurējiet jaunu administratora lietotājvārdu un paroli, ja vēlaties atkal ieslēgt Admin Security.

Paroles atkopšanas problēmu novēršana

Paraksts tiek noraidīts

Visbiežākais iemesls ir jauna atkopšanas izaicinājuma pieprasīšana pēc pirmā payload ģenerēšanas. Pieprasiet vienu jaunu payload, saņemiet tā parakstu un nosūtiet atbilstošo pāri, neatjaunojot izaicinājuma lapu.

Paraksts tiek noraidīts arī tad, ja:

ierīce pēc payload ģenerēšanas restartēta;
payload ir rediģēts;
paraksts pieder citam payload vai ierīcei;
tas pats payload un paraksts jau veiksmīgi izmantots.

Ierīce ziņo par nepietiekamu atmiņu

Ed25519 pārbaudei vajag pietiekami daudz brīvas atmiņas. Ierīce var atgriezt aptuveni šādu atbildi:

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

Restartējiet ierīci, lai atbrīvotu pagaidu atmiņu, tad ģenerējiet jaunu payload un nekavējoties pabeidziet atkopšanu. Pirms restartēšanas izveidotu payload nevar izmantot atkārtoti.

Kāpēc atkopšanai vajadzīgs parakstīts vienreizējs izaicinājums

IAMMETER nepiedāvā neautentificētu rūpnīcas atiestatīšanas komandu administratora aizsardzības apiešanai. Tā vietā:

ierīce izveido payload ar atkopšanas darbību, ierīces SN, MAC adresi un nejaušu vienreizēju nonce;
Contributor pakalpojums pārbauda pieteiktā IAMMETER konta tiesības uz šo ierīces SN;
IAMMETER paraksta tieši šo payload ar Ed25519 privāto atslēgu;
ierīce pārbauda parakstu ar aparātprogrammatūrā iebūvēto publisko atslēgu;
jauns izaicinājums, restartēšana vai veiksmīga atkopšana anulē pašreizējo nonce.

Autorizācijas piesaiste gan ierīces identitātei, gan vienreizējam nonce novērš iepriekš pārtverta payload un paraksta atkārtotu izmantošanu vēlāk.

Saistītā IAMMETER drošības dokumentācija

EN 18031 rakstā skaidrots ar drošību saistītais aparātprogrammatūras darbs. Tas nav apgalvojums, ka konkrētam skaitītājam sertifikāts jau izsniegts; sertifikācijas informācija tiks publicēta atsevišķi, kad būs pieejama.