MQTT 即時儀表板 06:連線安全與斷線偵測
這是「MQTT 即時儀表板」系列的最後一篇。前五篇把功能做出來了,但為了方便學習,我們留下了幾個安全上的缺口。這一篇要一一補起來:把帳號權限分開、讓 ESP32 驗證伺服器的身分,並用 LWT(遺囑訊息)讓「裝置是否在線」變成可靠的資訊,而不是靠資料過期來猜。
・在 HiveMQ Cloud 建立權限分離的帳號:裝置、唯讀儀表板、可控制的儀表板
・讓 ESP32 改用根憑證驗證伺服器,取代
setInsecure()・用 LWT 與 retained 狀態主題,偵測裝置上線與離線
・更新儀表板:顯示裝置狀態,並加入唯讀模式
難度:中等到進階 預估時間:75 分鐘
一、盤點目前的缺口
| 缺口 | 風險 | 本篇的做法 |
|---|---|---|
| 所有程式共用一組萬能帳號 | 帳密外洩,就能對所有主題收發 | 依用途拆成多組帳號,限制主題與權限 |
ESP32 使用 setInsecure() |
不確認對方身分,可能被冒充而洩漏帳密 | 載入根憑證並驗證伺服器 |
| 只能用「資料過期」推測裝置離線 | 反應慢,也分不清是離線還是感測器壞了 | LWT 遺囑訊息加上狀態主題 |
二、權限分離
最小權限原則:每個程式只拿到它做事所需要的權限。這樣即使其中一組帳密外洩,傷害也有限。
HiveMQ Cloud 免費方案的規則
我查閱官方文件,免費的 Serverless 方案有這些特點:
- 內建三種權限類型:只能發布、只能訂閱、可發布也可訂閱。
- 可以建立自訂權限,指定一個主題過濾條件(可以用
#、+萬用字元)。 - 每組帳號只能套用一個權限,每個權限也只有一個主題過濾條件。
- 權限變更不一定立刻生效,文件提到權限有快取,可能需要幾分鐘。
這代表免費方案無法做到「儀表板只能訂閱某幾個主題、同時只能發布 cmd/led」這種更細的設定,那需要付費方案。但我們仍然可以用現有的功能做出合理的分離。
我們的設計:三組帳號
| 帳號名稱 | 權限類型 | 主題過濾條件 | 給誰用 |
|---|---|---|---|
esp32-01-device |
發布與訂閱 | iot/esp32-01/# |
只寫進 ESP32 的程式 |
dashboard-viewer |
只能訂閱 | iot/esp32-01/# |
只看數據的人,可以放心分享給家人或同事 |
dashboard-operator |
發布與訂閱 | iot/esp32-01/# |
只有你自己,需要按按鈕時才用 |
三組帳號各自獨立,帳號名稱只是建議,密碼請各自設定不同的強密碼。這樣的設計能達到:
- ESP32 和儀表板無法碰其他裝置(例如日後的
esp32-02)的主題。 - 只看數據的使用者,即使帳密外洩,也只能讀取、不能發出控制指令。
- 能控制 LED 的帳號只有一組,你可以只在需要時使用。
限制:operator 帳號在免費方案下仍然能對 iot/esp32-01/ 底下任何主題發布(包含偽造 telemetry),這是免費方案單一過濾條件的限制。
建立步驟
- 進入叢集的「Access Management」。
- 先建立權限:在授權(Authorization)的「Permissions」區域按「Add New」,填入名稱(例如
esp32-01-rw)、說明、Topic Filter 填iot/esp32-01/#,Permission Type 選「Publish and Subscribe」。再建立一個只能訂閱的(例如esp32-01-ro,類型選「Subscribe Only」)。 - 建立三組憑證,建立時各自選擇對應的權限:device 與 operator 用
esp32-01-rw,viewer 用esp32-01-ro。 - 把 ESP32 程式裡的帳密改成 device 帳號。
- 確認一切正常後,刪除第 1 篇建立的萬能帳號。
實際的欄位名稱與選項,請依你看到的畫面為準。因為權限有快取,改完後如果行為還是舊的,等幾分鐘再測。
驗證權限有效
- 在 Web Client 用 viewer 帳號連線,訂閱
iot/esp32-01/#,應該看得到資料。 - 再用 viewer 對
iot/esp32-01/cmd/led發布on,ESP32 的 LED 不應該有反應。(Broker 如何處理被拒絕的發布,可能是直接忽略,也可能中斷連線,依設定而定。) - 改用 operator 帳號重複上一步,這次 LED 應該會亮。
- 試著用 viewer 訂閱別的裝置名稱的主題,例如
iot/esp32-02/#,應該收不到任何東西。
三、讓 ESP32 驗證伺服器身分
前幾篇為了簡化,ESP32 用了 setInsecure():連線雖然加密,但不確認對面真的是 HiveMQ。如果有人在網路中間冒充伺服器,ESP32 照樣會把帳號密碼交出去。
解法是讓 ESP32 內建一份「根憑證」,連線時檢查伺服器出示的憑證,是不是由這個根憑證簽發的。HiveMQ Cloud 使用 Let's Encrypt 簽發的憑證,根憑證是 ISRG Root X1。
取得根憑證
- 從官方來源下載
isrgrootx1.pem。HiveMQ 的常見問題頁面有提供連結(HiveMQ 說明頁),也可以從 Let's Encrypt 官方網站的憑證頁面取得。 - 用文字編輯器開啟,內容會是以
-----BEGIN CERTIFICATE-----開頭、-----END CERTIFICATE-----結尾的一大段文字。 - 把整份內容貼進 ESP32 程式(見下一節)。
我不在文章裡直接貼憑證內容,因為憑證若有任何一個字元被複製錯誤,驗證就會失敗。更重要的是,這份憑證是信任的根基,應該從官方來源取得,不要從來路不明的程式碼或貼文裡複製。建議從 HiveMQ 與 Let's Encrypt 各下載一次,兩份內容應該完全相同。
驗證憑證需要正確的時間
憑證有有效期間,ESP32 驗證時會用現在的時間去比對。如果還沒對時(ESP32 認為現在是 1970 年),憑證會被判定為「尚未生效」而連線失敗。所以要先 NTP 對時成功,再連 MQTT。系列一第 5 篇已經介紹過 NTP,這次要把它放在連線之前。
四、LWT:可靠的離線偵測
LWT(Last Will and Testament,遺囑訊息)是 MQTT 的功能:裝置連線時先向 Broker 登記一則「遺言」。如果之後裝置意外斷線(斷電、WiFi 掛掉、當機),Broker 會偵測到,並代替裝置把這則遺言發布出去。
我們用它搭配 iot/esp32-01/status 主題,並全部使用 Retained:
| 時機 | 誰發布 | 內容 |
|---|---|---|
| 連線時登記遺言 | (預先交給 Broker) | offline |
| 連線成功後 | ESP32 | online |
| 意外斷線 | Broker 代發 | offline |
因為使用 Retained,新開啟的儀表板一連線,就會立刻拿到最新的上線或離線狀態。
Broker 是靠「保持連線」的心跳判斷裝置是否還活著。PubSubClient 預設每 15 秒一次,Broker 通常在大約 1.5 倍的時間沒收到訊號後,才判定斷線。所以從拔掉電源到畫面顯示離線,會有大約 20 到 30 秒的延遲,這是正常的。
LWT 只在「意外斷線」時才會發布。如果程式主動呼叫 mqtt.disconnect() 正常中斷,Broker 不會發出遺言,所以你必須在中斷之前,自己先發布 offline。本系列的程式不會主動中斷,這部分只需要知道就好。
五、ESP32 完整程式(最終版)
這份程式整合了前面五篇的所有功能,並加上本篇的三項改動:驗證根憑證、連線前先對時、LWT 狀態主題。請替換設定,並把 ROOT_CA 換成你下載的憑證內容。帳號請使用 esp32-01-device。
#include <WiFi.h>
#include <WiFiClientSecure.h>
#include <PubSubClient.h>
#include <time.h>
#include "DHT.h"
// ===== 需要修改的設定 =====
const char* WIFI_SSID = "你的WiFi名稱";
const char* WIFI_PASSWORD = "你的WiFi密碼";
const char* MQTT_HOST = "你的叢集網址.hivemq.cloud";
const int MQTT_PORT = 8883;
const char* MQTT_USER = "esp32-01-device"; // 裝置專用帳號
const char* MQTT_PASS = "你的裝置帳號密碼";
const char* DEVICE_ID = "esp32-01";
const int LED_PIN = 2;
// 把 isrgrootx1.pem 的完整內容貼在 R"EOF( 與 )EOF" 之間,
// 包含 BEGIN CERTIFICATE 與 END CERTIFICATE 兩行
const char* ROOT_CA = R"EOF(
【在這裡貼上 isrgrootx1.pem 的完整內容】
)EOF";
// ==========================
#define DHTPIN 4
#define DHTTYPE DHT11
DHT dht(DHTPIN, DHTTYPE);
WiFiClientSecure secureClient;
PubSubClient mqtt(secureClient);
String topicTelemetry;
String topicCmdLed;
String topicStateLed;
String topicStatus;
const unsigned long PUBLISH_INTERVAL = 5000;
const unsigned long RECONNECT_INTERVAL = 5000;
unsigned long lastPublish = 0;
unsigned long lastReconnect = 0;
bool ledState = false;
bool connectWiFi() {
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
unsigned long start = millis();
while (WiFi.status() != WL_CONNECTED && millis() - start < 15000) {
delay(500);
Serial.print(".");
}
Serial.println();
if (WiFi.status() == WL_CONNECTED) {
Serial.print("WiFi 已連線,IP:");
Serial.println(WiFi.localIP());
return true;
}
Serial.println("WiFi 連線失敗");
return false;
}
// NTP 對時。憑證驗證需要正確的時間,所以必須在連 MQTT 之前完成
bool timeOk() {
return time(nullptr) > 1600000000;
}
bool syncTime() {
configTime(8 * 3600, 0, "time.stdtime.gov.tw", "pool.ntp.org");
struct tm t;
return getLocalTime(&t, 10000); // 最多等 10 秒
}
void publishLedState() {
if (!mqtt.connected()) return;
mqtt.publish(topicStateLed.c_str(), ledState ? "on" : "off", true);
}
void setLed(bool on) {
ledState = on;
digitalWrite(LED_PIN, on ? HIGH : LOW);
Serial.print("LED:");
Serial.println(on ? "ON" : "OFF");
publishLedState();
}
void onMessage(char* topic, byte* payload, unsigned int length) {
char msg[16];
unsigned int n = (length < sizeof(msg) - 1) ? length : sizeof(msg) - 1;
memcpy(msg, payload, n);
msg[n] = '\0';
Serial.print("收到 [");
Serial.print(topic);
Serial.print("]:");
Serial.println(msg);
if (strcmp(topic, topicCmdLed.c_str()) == 0) {
if (strcasecmp(msg, "on") == 0) {
setLed(true);
} else if (strcasecmp(msg, "off") == 0) {
setLed(false);
} else if (strcasecmp(msg, "toggle") == 0) {
setLed(!ledState);
} else {
Serial.println("無法辨識的指令,已忽略");
}
}
}
bool connectMqtt() {
// 尚未對時就先對時,否則憑證驗證會失敗
if (!timeOk() && !syncTime()) {
Serial.println("尚未取得正確時間,暫不連線 MQTT");
return false;
}
Serial.print("連線 MQTT...");
// 連線時登記遺言:意外斷線時,Broker 會代替我們發布 offline(QoS 1、retained)
if (mqtt.connect(DEVICE_ID, MQTT_USER, MQTT_PASS,
topicStatus.c_str(), 1, true, "offline")) {
Serial.println("成功");
mqtt.publish(topicStatus.c_str(), "online", true); // 告知上線
if (mqtt.subscribe(topicCmdLed.c_str(), 1)) {
Serial.print("已訂閱:");
Serial.println(topicCmdLed);
}
publishLedState();
return true;
}
Serial.print("失敗,狀態碼:");
Serial.println(mqtt.state());
return false;
}
void publishTelemetry() {
float hum = dht.readHumidity();
float temp = dht.readTemperature();
if (isnan(hum) || isnan(temp)) {
Serial.println("DHT11 讀取失敗,這次不發布");
return;
}
char payload[96];
time_t now = time(nullptr);
if (now > 1600000000) {
snprintf(payload, sizeof(payload),
"{\"temp\":%.1f,\"hum\":%.1f,\"ts\":%lu}",
temp, hum, (unsigned long)now);
} else {
snprintf(payload, sizeof(payload),
"{\"temp\":%.1f,\"hum\":%.1f}", temp, hum);
}
bool ok = mqtt.publish(topicTelemetry.c_str(), payload, true);
Serial.print(ok ? "已發布:" : "發布失敗:");
Serial.println(payload);
}
void setup() {
Serial.begin(115200);
delay(1000);
pinMode(LED_PIN, OUTPUT);
digitalWrite(LED_PIN, LOW);
dht.begin();
topicTelemetry = String("iot/") + DEVICE_ID + "/telemetry";
topicCmdLed = String("iot/") + DEVICE_ID + "/cmd/led";
topicStateLed = String("iot/") + DEVICE_ID + "/state/led";
topicStatus = String("iot/") + DEVICE_ID + "/status";
connectWiFi();
if (!syncTime()) {
Serial.println("對時失敗,稍後連線 MQTT 前會再嘗試");
}
secureClient.setCACert(ROOT_CA); // 驗證伺服器憑證(取代 setInsecure)
mqtt.setServer(MQTT_HOST, MQTT_PORT);
mqtt.setBufferSize(256);
mqtt.setKeepAlive(15);
mqtt.setCallback(onMessage);
}
void loop() {
if (WiFi.status() != WL_CONNECTED) {
Serial.println("WiFi 已中斷,重新連線");
connectWiFi();
return;
}
if (!mqtt.connected()) {
if (millis() - lastReconnect >= RECONNECT_INTERVAL) {
lastReconnect = millis();
connectMqtt();
}
} else {
mqtt.loop();
if (millis() - lastPublish >= PUBLISH_INTERVAL) {
lastPublish = millis();
publishTelemetry();
}
}
}
這次改了哪些地方
- secureClient.setCACert(ROOT_CA):取代
setInsecure(),連線時會驗證伺服器憑證。 - syncTime() 與 timeOk():連線 MQTT 之前先確認時間正確,沒有的話先對時,對時不成功就暫不連線,避免白白失敗。
- mqtt.connect(…, 遺言主題, 1, true, "offline"):多出來的四個參數依序是遺言主題、QoS、是否保留、遺言內容。
- 連線成功後發布 online:搭配遺言,狀態主題永遠反映最新情況。
- mqtt.setKeepAlive(15):心跳間隔 15 秒,這也是預設值,明確寫出來是方便你需要時調整,調得越短,離線偵測越快,通訊量也越多。
六、更新儀表板
儀表板(第 5 篇的 dashboard.html)需要兩項更新:顯示裝置狀態,以及加入唯讀模式,讓使用 viewer 帳號時不會誤按控制按鈕。完整的 v2 版本是同一個檔案,用新版取代即可。更新的重點如下,如果你想自己改:
- 畫面:在「資料時間」那一列加入裝置狀態標籤,並在連線設定區加入唯讀模式的勾選框。
<label class="chk"><input type="checkbox" id="viewOnly"> 唯讀模式(停用控制按鈕)</label> <div>裝置:<span id="devStatus" class="badge" data-state="idle">未知</span></div>
- 主題與訂閱:新增
status主題,並加入訂閱清單。status: 'iot/' + device + '/status', client.subscribe([topics.telemetry, topics.stateLed, topics.status], ...)
- 處理狀態訊息:在
onMessage加入一個分支,並新增setDevStatus函式,把online顯示成綠色「線上」、offline顯示成紅色「離線」,其他顯示「未知」。 - 唯讀模式:讓
setConnectedUi在勾選唯讀時,一律停用三個控制按鈕。var canControl = connected && !$('viewOnly').checked; - 斷線時重設:連線中斷或手動中斷後,把裝置狀態改回「未知」,因為這時我們已經不知道它的狀況了。
儀表板用的是
wss://,瀏覽器會自動驗證 HiveMQ 的憑證,所以這個部分已經是安全的,不用像 ESP32 一樣自己載入根憑證。
七、測試清單
- 正常連線:上傳新程式,序列埠應該顯示對時成功、MQTT 連線成功、已訂閱。
- 狀態主題:在 Web Client 訂閱
iot/esp32-01/#,應該看到status為online。 - 離線偵測:直接拔掉 ESP32 的電源,約 20 到 30 秒後,會出現
status變成offline,儀表板的裝置標籤也變成紅色「離線」。 - 重新上線:接回電源,狀態變回
online。 - 憑證驗證確實有作用:故意把
MQTT_HOST暫時改成一個你沒有的叢集網址(或把憑證內容刪掉一個字元),應該會連線失敗,而不是照樣連上去。測完記得改回來。 - 權限:照第二節的驗證步驟,確認 viewer 發布指令無效、operator 有效。
- 唯讀模式:用 viewer 帳號連線,勾選唯讀模式,三個按鈕應該是灰色無法按。
八、常見問題
- 換成憑證驗證後,連線一直失敗(狀態碼 -2):依序檢查 ① 憑證是否完整貼上,包含 BEGIN 與 END 兩行,中間不能有多餘的字或遺漏;② 序列埠有沒有顯示對時成功,沒有對時,驗證一定失敗;③
MQTT_HOST是否正確。若想確認是不是憑證的問題,可以暫時改回setInsecure(),如果這樣就連得上,問題就在憑證或時間。 - 憑證貼上後編譯出錯:確認有用
R"EOF(與)EOF"包住,而且 BEGIN 行前面沒有多餘的空白字元。 - 離線狀態一直沒出現:確認遺言參數有帶入,且 Broker 方案與帳號權限允許發布到
status主題(我們的主題過濾條件iot/esp32-01/#涵蓋了它)。偵測需要 20 到 30 秒,請稍候。 - 換了權限之後,ESP32 連不上或收不到指令:權限有快取,等幾分鐘再試;並確認 device 帳號的主題過濾條件與
DEVICE_ID一致。 - 狀態停在 offline,但裝置其實在線:可能有舊的保留訊息。確認裝置連線後有發布
online,必要時用第 3 篇的方法清除舊的狀態主題再重連。 - 憑證有一天過期了怎麼辦:根憑證的有效期很長,但終究會到期,或是 HiveMQ 日後更換簽發機構。如果某天 ESP32 突然連不上,又沒有其他變動,請檢查 HiveMQ 目前使用的憑證是否有更新。
九、其他安全習慣
- 密碼不要重複使用:每組帳號各自使用強密碼,也不要和其他服務共用。
- 不要把機密放進公開的地方:程式碼、截圖、GitHub 都要檢查,包含 WiFi 密碼、MQTT 帳密、叢集網址。
- 定期檢查並刪除不用的帳號:學習時用過的萬能帳號、已經停用的裝置帳號,都應該刪掉。
- 每台裝置獨立的帳號與主題前綴:日後增加
esp32-02時,為它建立自己的帳號與權限,一台出事不會牽連其他台。 - 外洩了就立刻更換:懷疑密碼外洩,馬上到 Access Management 刪除或重設該憑證。
- 留意用量:叢集總覽可以看到流量。如果用量異常暴增,可能有人在濫用你的 Broker。
- 這是學習用的免費方案:如果要用在真正重要的場合,需要評估正式的方案、更完整的權限控管與備援。
十、延伸挑戰
- 為第二台 ESP32(
esp32-02)建立獨立的權限與帳號,讓儀表板可以切換兩台裝置,同時確認它們互相碰不到對方的主題。 - 把
status擴充成 JSON,例如加入 WiFi 訊號強度、韌體版本與開機後經過的時間。 - 讓 ESP32 在斷線超過一定時間後自動重新啟動(
ESP.restart()),並思考這樣做的利弊。 - 改用 MQTT 5 的功能或其他進階權限(需要升級方案),做到儀表板只能發布
cmd/led。
系列總結
這六篇走完了一條完整的即時 IoT 管線:
| 篇 | 主題 | 學到的觀念 |
|---|---|---|
| 01 | 認識 MQTT 與雲端 Broker | 發布訂閱、主題、Broker |
| 02 | ESP32 發布溫濕度 | TLS 連線、JSON、斷線重連 |
| 03 | 訂閱、除錯與保留訊息 | Retained、QoS、除錯流程 |
| 04 | 接收指令控制 LED | 雙向通訊、指令與狀態分離 |
| 05 | 即時網頁儀表板 | WebSocket、資料過期判斷 |
| 06 | 連線安全與斷線偵測 | 最小權限、憑證驗證、LWT |
有了這套基礎,下一步可以往幾個方向走:增加更多種類的感測器、讓多台裝置共用一套架構、把 MQTT 的資料自動存進資料庫,或是接上 LINE Bot 做雙向互動。歡迎在留言告訴我你想看哪一個,也歡迎分享你的成果與遇到的問題。
留言
張貼留言