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 の継続的な活動の一部でもあります。各電力量計モデルの適合性・認証状況は、正式に利用可能になり次第、別途発表します。

利用者にとって次の4つの実用的な改善があります。

ローカル 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 ヘルプ項目を設けました。設定と復旧の案内を含むローカル Admin Security ユーザーガイドへ移動できます。

MQTTS と HTTPS の証明書検証

i.91.065 系列は MQTTS と HTTPS の3つの証明書検証モードにも対応します。

builtin — 内蔵の信頼済みルート証明書を使用；
custom — アップロードした PEM ルート CA 証明書を使用；
none — 互換性確認や管理された試験環境で検証を無効化。通常のインターネット接続環境には推奨しません。

内蔵証明書ストアには DigiCert Global Root G2 と ISRG Root X1 が含まれます。プライベート認証局を使う環境では独自の PEM ルート CA をアップロードできます。MQTTS と HTTPS は同じ TLS 検証設定を共有します。

設定の詳細は MQTTS と HTTPS の証明書検証を参照してください。

Admin Security の設定はローカル 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 接続状態ロジックを追加。