IAMMETER 펌웨어 i.91.065.17: 안전한 관리자 복구, Swagger API 및 WEM3063T 지원

IAMMETER 펌웨어 i.91.065.17은 i.91.065 계열의 보안 기능을 바탕으로, 잊어버린 Admin Security 자격 증명을 안전하게 복구하는 기능, HTTP Basic Authentication을 사용하는 브라우저 API 테스트 개선, 새 WEM3063T 전력량계 지원을 추가합니다.

i.91.065.17 펌웨어 다운로드

이번 릴리스는 인터넷 연결 무선 장비에 적용되는 EN 18031-1:2024의 사이버보안 요구사항을 다루기 위한 IAMMETER의 지속적인 작업이기도 합니다. 개별 전력량계 모델의 적합성 및 인증 상태는 공식적으로 준비되는 대로 별도로 발표합니다.

사용자에게 다음 네 가지 실용적인 개선을 제공합니다.

로컬 Admin Security 비밀번호를 잊었을 때 접근 복구;
외부 Swagger UI에서 보호된 기기 API 테스트;
미국 시장용 WEM3063T 삼상 전력량계 지원;
Security 모듈 가이드를 더 쉽게 찾을 수 있음.

안전한 관리자 비밀번호 복구

Admin Security 비밀번호를 잊으면 기기가 IAMMETER 계정과 연결되어 있음을 확인하고 로컬 접근을 복구할 수 있습니다. IAMMETER Cloud가 전력량계에 직접 연결하거나 초기화할 필요는 없습니다. 기기가 일회용 복구 챌린지를 생성하고, 복구 서비스가 계정 확인 후 정확히 그 챌린지에 서명합니다.

절차는 다음과 같습니다.

기기에서 일회용 복구 챌린지를 요청합니다.
IAMMETER Cloud 계정으로 IAMMETER Contributor 시스템에 로그인합니다.
챌린지 payload를 제출합니다. 복구 서비스가 기기 일련번호와 IAMMETER 계정의 연결을 확인합니다.
정확히 그 payload에 대한 Ed25519 서명을 받습니다.
기기의 로컬 IP로 서명된 복구 요청을 보냅니다.
검증 성공 후 기기가 Admin Security를 비활성화하므로 새 Admin Security 사용자 이름과 비밀번호를 설정할 수 있습니다.

복구 payload는 기기 일련번호, MAC 주소, 일회용 nonce에 연결됩니다. 펌웨어에는 검증용 공개 키만 있으며 서명용 개인 키는 없습니다. 복구 서비스는 검증 후 기기가 생성한 챌린지에 서명하며 전력량계에 직접 연결하거나 초기화하지 않습니다.

전체 절차는 잊어버린 IAMMETER 관리자 비밀번호 복구 방법을 참조하세요.

미국 시장용 WEM3063T 지원

펌웨어 i.91.065.17은 미국 시장을 위해 개발된 IAMMETER 삼상 전력량계 WEM3063T를 지원합니다.

WEM3063T는 표준 5A 출력 외부 CT를 사용하도록 설계되었습니다. 진행 중인 UL 인증 절차의 일환으로 SGS의 시험을 포함한 제품 및 안전 시험을 거쳤습니다. UL 인증 상태는 공식적으로 준비되는 대로 별도 발표합니다. 펌웨어는 WEM3063T를 식별하고 해당 전류, 전력, 전력량 스케일링 로직을 적용합니다.

업그레이드 전에 계량기 모델, CT 사양, 현장의 지역 설치 요구사항을 확인하세요.

Basic Auth를 사용하는 Swagger API 테스트

펌웨어 i.91.065.17은 IAMMETER WEM API Test Swagger UI 같은 브라우저 도구가 HTTP Basic Authentication으로 Admin Security 보호 API를 호출하도록 지원합니다. 이제 CORS 사전 요청에서 Authorization 헤더를 허용합니다.

IAMMETER WEM API Test 열기

Swagger 사용에는 여전히 다음이 필요합니다.

전력량계의 로컬 IP에 접근 가능한 브라우저;
유효한 Basic Auth 자격 증명;
기기 펌웨어가 지원하는 API 작업.

요청은 직접 연결됩니다.

Browser → loads Swagger UI from iammeter.github.io
Browser → sends an authenticated API request directly to the meter's local IP

Swagger 웹사이트는 전력량계에 연결하는 서버가 아닙니다. 브라우저가 로컬 네트워크에서 전력량계에 접근할 수 있어야 하며, 모든 보호 요청은 여전히 유효한 Basic Auth 자격 증명을 요구합니다. CORS 변경은 인증을 제거하거나 IAMMETER Cloud를 통해 기기 API를 공개하지 않습니다.

기타 보안 개선

Security 페이지에 더 명확한 Enable/Disable Security Module 도움말 항목이 추가되었습니다. 설정과 복구 안내가 있는 Local Admin Security 사용자 가이드로 연결됩니다.

MQTTS 및 HTTPS 인증서 검증

i.91.065 펌웨어 계열은 MQTTS와 HTTPS에 세 가지 인증서 검증 모드도 지원합니다.

builtin — 내장된 신뢰 루트 인증서 사용;
custom — 업로드한 PEM 루트 CA 인증서 사용;
none — 호환성 또는 통제된 시험 환경을 위해 검증 비활성화. 일반적인 인터넷 연결 배포에는 권장하지 않습니다.

내장 인증서 저장소에는 DigiCert Global Root G2와 ISRG Root X1이 있습니다. 사설 인증기관을 쓰는 배포에서는 사용자 PEM 루트 CA를 업로드할 수 있습니다. MQTTS와 HTTPS는 동일한 TLS 검증 설정을 공유합니다.

설정 세부사항은 MQTTS 및 HTTPS 인증서 검증을 참조하세요.

Admin Security 설정은 Local Admin Security 사용자 가이드를 참조하세요.

업그레이드 및 호환성 참고사항

이번 릴리스는 기본 프로토콜의 기존 보안 동작을 유지합니다.

보호 API에는 여전히 Basic Auth 검증이 필요합니다.
기존 OTA 보안 검사가 유지됩니다.
기존 TLS 연결이나 인증서 검증 동작을 변경하지 않습니다.
펌웨어는 여전히 정확히 일치하는 일회용 payload에 대해 복구 서명을 검증합니다.

업그레이드 전에 펌웨어 패키지가 IAMMETER 모델과 맞는지 확인하고 IAMMETER 펌웨어 업데이트의 로컬 또는 앱 기반 업그레이드 안내를 따르세요.

버그 수정 및 안정성 개선

이번 릴리스에는 i.91.065 계열에서 누적된 안정성 수정도 포함됩니다.

패키지 구조, 이미지 길이, 파티션 경계, 무결성 검사 등 OTA 이미지 검증 강화.
OTA 검증 실패 시 구체적인 JSON 오류를 반환하고 업그레이드 플래그를 설정하거나 전력량계를 재시작하지 않음.
XHR 네트워크 오류와 시간 초과를 포함한 Web UI OTA 오류 처리 개선.
Admin Security 활성화 시 OTA 응답이 브라우저 네트워크 오류로 표시될 수 있던 문제 수정.
Admin Security, TLS 인증서, 고급 설정, OTA 요청 등 여러 TCP 패킷으로 수신되는 HTTP POST 본문 처리 개선.
OTA 성공 후 Web UI가 올바른 결과 페이지를 표시하지 못할 수 있던 문제 수정.
WEM3046T 및 WEM3063T 무효전력 스케일링 수정.
WEM3063T Wi-Fi LED 연결 상태 로직 추가.