Firmware IAMMETER i.91.065.17 bổ sung khôi phục quyền quản trị an toàn, hỗ trợ Swagger API và WEM3063T

Firmware IAMMETER i.91.065.17 kế thừa các tính năng bảo mật của dòng i.91.065, bổ sung cơ chế khôi phục an toàn khi quên thông tin đăng nhập Admin Security, cải thiện kiểm thử API trên trình duyệt bằng HTTP Basic Authentication và hỗ trợ công tơ điện WEM3063T mới.

Tải firmware i.91.065.17

Bản phát hành này cũng nằm trong nỗ lực liên tục của IAMMETER nhằm đáp ứng các yêu cầu an ninh mạng áp dụng cho thiết bị vô tuyến kết nối Internet theo EN 18031-1:2024. Tình trạng tuân thủ và chứng nhận của từng mẫu công tơ IAMMETER sẽ được công bố riêng khi có thông tin chính thức.

Đối với người dùng, bản cập nhật mang lại bốn cải tiến thiết thực:

• khôi phục quyền truy cập khi quên mật khẩu Admin Security cục bộ;
• kiểm thử các API được bảo vệ của thiết bị từ Swagger UI bên ngoài;
• hỗ trợ công tơ điện ba pha WEM3063T dành cho thị trường Mỹ;
• giúp dễ tìm hướng dẫn về mô-đun bảo mật hơn.

Khôi phục quyền truy cập an toàn khi quên mật khẩu quản trị

Nếu quên mật khẩu Admin Security, bạn có thể xác minh rằng thiết bị được liên kết với tài khoản IAMMETER của mình và khôi phục quyền truy cập cục bộ mà không cần IAMMETER Cloud trực tiếp kết nối hoặc đặt lại công tơ. Thiết bị tạo một thử thách khôi phục dùng một lần, sau đó dịch vụ khôi phục ký chính xác thử thách đó sau khi xác minh tài khoản.

Quy trình như sau:

1. Yêu cầu thiết bị tạo thử thách khôi phục dùng một lần.
2. Đăng nhập vào hệ thống IAMMETER Contributor bằng tài khoản IAMMETER Cloud.
3. Gửi payload của thử thách. Dịch vụ khôi phục xác minh rằng số sê-ri của thiết bị được liên kết với tài khoản IAMMETER của bạn.
4. Nhận chữ ký Ed25519 cho chính xác payload đó.
5. Gửi yêu cầu khôi phục đã ký đến thiết bị qua địa chỉ IP cục bộ của thiết bị.
6. Sau khi xác minh thành công, thiết bị tắt Admin Security để bạn có thể cấu hình tên người dùng và mật khẩu Admin Security mới.

Payload khôi phục được ràng buộc với số sê-ri, địa chỉ MAC của thiết bị và một nonce dùng một lần. Firmware chỉ chứa khóa công khai dùng để xác minh, không chứa khóa riêng dùng để ký. Dịch vụ khôi phục ký thử thách do thiết bị tạo sau khi xác minh; dịch vụ không trực tiếp kết nối hoặc đặt lại công tơ.

Xem toàn bộ quy trình tại Cách khôi phục quyền truy cập khi quên mật khẩu quản trị IAMMETER.

Hỗ trợ WEM3063T cho thị trường Mỹ

Firmware i.91.065.17 hỗ trợ WEM3063T, công tơ điện ba pha IAMMETER được phát triển cho thị trường Mỹ.

WEM3063T được thiết kế để sử dụng biến dòng CT bên ngoài có đầu ra tiêu chuẩn 5 A. Thiết bị đã trải qua các thử nghiệm sản phẩm và an toàn trong khuôn khổ quy trình chứng nhận UL đang diễn ra, bao gồm thử nghiệm do SGS thực hiện. Tình trạng chứng nhận UL sẽ được công bố riêng khi có thông tin chính thức. Firmware nhận diện WEM3063T và áp dụng logic quy đổi tương ứng cho dòng điện, công suất và điện năng.

Trước khi nâng cấp, hãy xác nhận mẫu công tơ, thông số CT và các yêu cầu lắp đặt của khu vực áp dụng cho địa điểm của bạn.

Kiểm thử Swagger API với Basic Auth

Firmware i.91.065.17 cho phép các công cụ API chạy trên trình duyệt, chẳng hạn Swagger UI của IAMMETER WEM API Test, gọi API được Admin Security bảo vệ bằng HTTP Basic Authentication. Firmware hiện cho phép header Authorization trong các yêu cầu kiểm tra trước CORS.

Mở IAMMETER WEM API Test

Quy trình Swagger vẫn yêu cầu:

• trình duyệt có thể truy cập địa chỉ IP cục bộ của công tơ;
• thông tin xác thực Basic Auth hợp lệ;
• thao tác API được firmware thiết bị hỗ trợ.

Yêu cầu được gửi trực tiếp:

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

Trang web Swagger không phải là máy chủ kết nối đến công tơ của bạn. Trình duyệt phải truy cập được công tơ trên mạng cục bộ và mọi yêu cầu được bảo vệ vẫn cần thông tin xác thực Basic Auth hợp lệ. Thay đổi CORS không loại bỏ xác thực và không mở API của thiết bị qua IAMMETER Cloud.

Các cải tiến bảo mật khác

Trang Security hiện có mục trợ giúp Enable/Disable Security Module (Bật/tắt mô-đun bảo mật) rõ ràng hơn. Mục này dẫn đến Hướng dẫn sử dụng Local Admin Security, bao gồm hướng dẫn cấu hình và khôi phục.

Xác minh chứng chỉ MQTTS và HTTPS

Dòng firmware i.91.065 cũng hỗ trợ ba chế độ xác minh chứng chỉ cho MQTTS và HTTPS:

• builtin — sử dụng các chứng chỉ gốc đáng tin cậy tích hợp sẵn;
• custom — sử dụng chứng chỉ CA gốc định dạng PEM được tải lên;
• none — tắt xác minh chứng chỉ để tương thích hoặc dùng trong môi trường thử nghiệm được kiểm soát. Không khuyến nghị chế độ này cho các triển khai thông thường có kết nối Internet.

Kho chứng chỉ tích hợp gồm DigiCert Global Root G2 và ISRG Root X1. Có thể tải lên chứng chỉ CA gốc PEM tùy chỉnh cho triển khai sử dụng tổ chức chứng thực riêng. MQTTS và HTTPS dùng chung một cấu hình xác minh TLS.

Để biết chi tiết cấu hình, xem Xác minh chứng chỉ MQTTS và HTTPS.

Để thiết lập Admin Security, xem Hướng dẫn sử dụng Local Admin Security.

Lưu ý về nâng cấp và khả năng tương thích

Bản phát hành này giữ nguyên hành vi bảo mật hiện có của các giao thức nền tảng:

• API được bảo vệ vẫn yêu cầu xác thực Basic Auth;
• các kiểm tra bảo mật OTA hiện có vẫn được giữ nguyên;
• bản phát hành này không thay đổi hành vi kết nối TLS hoặc xác minh chứng chỉ hiện có;
• firmware vẫn xác minh chữ ký khôi phục đối với chính xác payload dùng một lần.

Trước khi nâng cấp, hãy xác nhận gói firmware phù hợp với mẫu công tơ IAMMETER và làm theo hướng dẫn nâng cấp cục bộ hoặc qua ứng dụng trên trang Cập nhật firmware IAMMETER.

Sửa lỗi và cải thiện độ tin cậy

Bản phát hành này cũng bao gồm các bản sửa lỗi về độ tin cậy được tích lũy trong dòng firmware i.91.065:

• Tăng cường xác thực ảnh firmware OTA, bao gồm cấu trúc gói, độ dài ảnh, giới hạn phân vùng và kiểm tra tính toàn vẹn.
• Khi xác thực OTA thất bại, hệ thống hiện trả về lỗi JSON cụ thể, không đặt cờ nâng cấp và không khởi động lại công tơ.
• Cải thiện xử lý lỗi OTA trong giao diện web, bao gồm lỗi mạng XHR và hết thời gian chờ.
• Sửa các phản hồi OTA có thể bị trình duyệt báo là lỗi mạng khi bật Admin Security.
• Cải thiện xử lý phần thân yêu cầu HTTP POST nhận qua nhiều gói TCP, bao gồm yêu cầu Admin Security, chứng chỉ TLS, cài đặt nâng cao và OTA.
• Sửa lỗi giao diện web có thể không hiển thị đúng trang kết quả sau khi cập nhật OTA thành công.
• Sửa quy đổi công suất phản kháng cho WEM3046T và WEM3063T.
• Bổ sung logic đèn LED Wi-Fi hiển thị trạng thái kết nối cho WEM3063T.

Tài nguyên liên quan

• Cập nhật firmware IAMMETER
• Hướng dẫn sử dụng Local Admin Security
• Khôi phục quyền truy cập khi quên mật khẩu quản trị IAMMETER
• Xác minh chứng chỉ MQTTS và HTTPS
• Công cụ IAMMETER WEM API Test