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 固件

本次发布也是 IAMMETER 持续推进 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 支持 WEM3063T，这是一款针对美国市场开发的 IAMMETER 三相电能表。

WEM3063T 使用标准 5A 输出的外接 CT。作为正在进行的 UL 认证流程的一部分，它已接受产品及安全测试，包括 SGS 进行的测试。UL 认证状态将在正式可用时另行公布。固件能够识别 WEM3063T，并应用相应的电流、功率和电量缩放逻辑。

升级前，请确认电表型号、CT 规格以及现场适用的地区安装要求。

使用 Basic Auth 进行 Swagger API 测试

固件 i.91.065.17 允许 IAMMETER WEM API Test Swagger UI 等浏览器 API 工具，通过 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 的三种证书验证模式：

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 固件更新页面中的本地或 App 升级说明操作。

问题修复与可靠性改进

本次发布还包含 i.91.065 系列积累的可靠性修复：

加强 OTA 镜像验证，包括包结构、镜像长度、分区边界和完整性检查。
OTA 验证失败时返回具体 JSON 错误，不设置升级标志，也不重启电表。
改进 Web UI 的 OTA 错误处理，包括 XHR 网络错误和超时。
修复启用 Admin Security 时 OTA 响应可能被浏览器报告为网络错误的问题。
改进跨多个 TCP 包接收 HTTP POST 请求体的处理，覆盖 Admin Security、TLS 证书、高级设置和 OTA 请求。
修复 OTA 成功后 Web UI 可能无法显示正确结果页的问题。
修复 WEM3046T 和 WEM3063T 的无功功率缩放。
增加 WEM3063T Wi-Fi LED 连接状态逻辑。