Sådan gendanner du adgang med en glemt IAMMETER-administratoradgangskode

Hvis du har glemt administratorbrugernavnet eller adgangskoden til IAMMETER-energimålerens lokale webgrænseflade, behøver du ikke de gamle legitimationsoplysninger for at gendanne adgangen. IAMMETERs signerede gendannelse verificerer enhedens tilhørsforhold, deaktiverer Admin Security og sletter de glemte lokale administratoroplysninger.

Denne vejledning er specifikt til en glemt Admin Security-adgangskode. Kender du stadig de aktuelle oplysninger, skal du ændre dem eller deaktivere beskyttelsen fra enhedens Security-fane. Se brugervejledningen til Local Admin Security for opsætning, beskyttet API-adgang og tjenestestyring.

På denne side

Hvad gendannelsen gør
Før du begynder
Trin 1: Generér en engangs-payload til gendannelse
Trin 2: Hent det signerede gendannelsessvar
Trin 3: Send payload og signatur til enheden
Fejlfinding ved adgangskodegendannelse
Hvorfor gendannelse kræver en signeret engangsudfordring
Relateret IAMMETER-sikkerhedsdokumentation

Hvad gendannelsen gør

Gendannelsen bruger tre komponenter:

IAMMETER-enheden genererer en enhedsspecifik engangs-payload til gendannelse.
IAMMETER Contributor-tjenesten kontrollerer, at den indloggede konto har ret til at administrere enhedens SN, og signerer derefter præcis denne payload.
Enheden verificerer Ed25519-signaturen, sletter de glemte oplysninger og deaktiverer Admin Security.

Gendannelsen sletter ikke energidata, Wi-Fi-indstillinger eller enhedens konfiguration. Bagefter kan du åbne den lokale webgrænseflade og angive et nyt administratorbrugernavn og en ny adgangskode.

Før du begynder

Du skal bruge:

adgang til IAMMETER-enheden på det samme lokale netværk;
enhedens lokale IP-adresse;
en IAMMETER-konto med ret til at administrere enhedens SN;
en browser på en computer, der kan nå enhedens lokale webgrænseflade. curl eller en anden HTTP-klient kræves kun, hvis du vælger manuel indsendelse.

Du kan kontrollere, om den installerede firmware understøtter signeret gendannelse, ved at åbne:

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

Se efter "recoverySupported":1 i svaret. Hvis gendannelsesendpointet ikke er tilgængeligt, skal du opdatere til kompatibel firmware eller kontakte IAMMETER-support, før du fortsætter.

Vigtigt: Udfordringen indeholder en engangs-nonce. Hold enheden tændt, og anmod ikke om en ny udfordring, før gendannelsens POST er afsluttet. En ny udfordring eller genstart af enheden gør den tidligere payload ugyldig.

Trin 1: Generér en engangs-payload til gendannelse

Åbn følgende URL i en browser, og erstat <device-ip> med IAMMETER-enhedens lokale IP-adresse:

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

Eller anmod om udfordringen med curl:

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

Enheden returnerer et svar som dette:

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

Kopiér hele værdien af payload. Du må ikke ændre tegn, separatorer, store og små bogstaver, enhedens SN, MAC-adresse eller nonce.

Generér engangs-payload til Admin Security-gendannelse fra en IAMMETER-energimåler

Opdatér ikke udfordringssiden, og kald ikke /api/admin/recovery_challenge igen efter kopiering af payloaden. Hver anmodning gør straks den tidligere udfordring ugyldig.

Trin 2: Hent det signerede gendannelsessvar

Log ind i IAMMETER Contributor-systemet, og åbn:

IAMMETER Admin Recovery

Indsæt hele payloaden fra Trin 1, og indsend den. Tjenesten kontrollerer, om enhedens SN i payloaden er tilknyttet din konto. Efter verificering returnerer den en Ed25519-signatur for præcis denne payload.

Generér en Ed25519-gendannelsessignatur i IAMMETER Admin Recovery

Signaturen gælder kun for den uændrede payload, som enheden genererede i Trin 1. Vil du indsende anmodningen manuelt med curl, skal du kopiere signaturen nøjagtigt som returneret. Kan samme browser nå enheden på lokalnetværket, kan næste trin udføres direkte fra Contributor-siden.

Trin 3: Send payload og signatur til enheden

Mulighed A: Fuldfør gendannelsen direkte i browseren

Hvis computeren med browseren er på samme netværk som IAMMETER-enheden, og browseren kan åbne enhedens lokale webgrænseflade, kan du sende det signerede resultat direkte fra Contributor Admin Recovery-siden:

Indtast enhedens lokale IP-adresse i Step 3: Send to your device.
Brug sidens gendannelseshandling til at sende den signerede payload til enheden.
Vent på Recovery completed. Det bekræfter, at enheden har accepteret det signerede resultat, slettet det eksisterende lokale administratorbrugernavn og adgangskoden samt deaktiveret Admin Security.

Gendan IAMMETER Admin Security-adgangskoden direkte fra Contributor, når browser og enhed er på samme lokalnetværk

Med browsermetoden behøver du ikke kopiere gendannelsens JSON til en separat kommando. Den virker kun, når browseren kan forbinde direkte til enhedens lokale IP-adresse.

Mulighed B: Indsend gendannelsesanmodningen manuelt med curl

Kør følgende kommando. Erstat:

<device-ip> med enhedens lokale IP-adresse;
<original-payload> med hele payloaden fra Trin 1;
<signature> med signaturen fra Trin 2.

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

Eksempel:

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

Payloaden i denne anmodning skal være identisk med den payload, Contributor-tjenesten signerede.

Du kan også sende samme anmodning fra IAMMETER WEM API Test - Admin Security Public. Åbn operationen POST /api/admin/recovery, angiv samme gendannelses-JSON, og send fra en browser, der kan nå enhedens lokale IP-adresse. Swagger-anmodningen sendes direkte til enheden, ikke via IAMMETER Cloud som proxy.

Efter vellykket verificering vil enheden:

slette det eksisterende lokale administratorbrugernavn og adgangskoden;
deaktivere Admin Security;
gøre gendannelsens nonce ugyldig, så samme payload og signatur ikke kan genbruges.

Åbn enhedens lokale webgrænseflade, gå til Security-fanen, og konfigurér et nyt administratorbrugernavn og en ny adgangskode, hvis du vil aktivere Admin Security igen.

Fejlfinding ved adgangskodegendannelse

Signaturen afvises

Den mest almindelige årsag er, at en ny udfordring blev anmodet efter genereringen af den første payload. Anmod om én ny payload, hent en signatur til den, og indsend det matchende par uden at opdatere udfordringssiden.

En signatur afvises også, når:

enheden genstartede efter genereringen af payloaden;
payloaden blev redigeret;
signaturen tilhører en anden payload eller enhed;
samme payload og signatur allerede er brugt med succes.

Enheden rapporterer for lidt hukommelse

Ed25519-verificering kræver tilstrækkelig ledig hukommelse. Enheden kan returnere et svar som:

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

Genstart enheden for at frigive midlertidig hukommelse, generér derefter en ny payload, og fuldfør hurtigt gendannelsen. En payload fra før genstarten kan ikke genbruges.

Hvorfor gendannelse kræver en signeret engangsudfordring

IAMMETER stiller ikke en uautentificeret fabriksnulstillingskommando til rådighed for at omgå administratorbeskyttelsen. I stedet:

opretter enheden en payload med gendannelsesoperationen, enhedens SN, MAC-adresse og en tilfældig engangs-nonce;
verificerer Contributor-tjenesten, at den indloggede IAMMETER-konto har rettigheder til enhedens SN;
signerer IAMMETER præcis denne payload med en privat Ed25519-nøgle;
verificerer enheden signaturen med den offentlige nøgle indbygget i firmwaren;
gør en ny udfordring, en genstart eller en vellykket gendannelse den aktuelle nonce ugyldig.

Når autorisationen bindes til både enhedens identitet og engangs-noncen, kan en tidligere opsnappet payload og signatur ikke genbruges senere.

Relateret IAMMETER-sikkerhedsdokumentation

EN 18031-artiklen forklarer det sikkerhedsrelaterede firmwarearbejde. Den må ikke læses som en meddelelse om, at et certifikat til en bestemt måler allerede er udstedt; certificeringsoplysninger offentliggøres separat, når de er tilgængelige.