MQTT 即時儀表板 06:連線安全與斷線偵測

這是「MQTT 即時儀表板」系列的最後一篇。前五篇把功能做出來了,但為了方便學習,我們留下了幾個安全上的缺口。這一篇要一一補起來:把帳號權限分開、讓 ESP32 驗證伺服器的身分,並用 LWT(遺囑訊息)讓「裝置是否在線」變成可靠的資訊,而不是靠資料過期來猜。

本篇重點
・在 HiveMQ Cloud 建立權限分離的帳號:裝置、唯讀儀表板、可控制的儀表板
・讓 ESP32 改用根憑證驗證伺服器,取代 setInsecure()
・用 LWT 與 retained 狀態主題,偵測裝置上線與離線
・更新儀表板:顯示裝置狀態,並加入唯讀模式
難度:中等到進階 預估時間:75 分鐘

一、盤點目前的缺口

缺口 風險 本篇的做法
所有程式共用一組萬能帳號 帳密外洩,就能對所有主題收發 依用途拆成多組帳號,限制主題與權限
ESP32 使用 setInsecure() 不確認對方身分,可能被冒充而洩漏帳密 載入根憑證並驗證伺服器
只能用「資料過期」推測裝置離線 反應慢,也分不清是離線還是感測器壞了 LWT 遺囑訊息加上狀態主題

二、權限分離

最小權限原則:每個程式只拿到它做事所需要的權限。這樣即使其中一組帳密外洩,傷害也有限。

HiveMQ Cloud 免費方案的規則

我查閱官方文件,免費的 Serverless 方案有這些特點:

  • 內建三種權限類型:只能發布、只能訂閱、可發布也可訂閱。
  • 可以建立自訂權限,指定一個主題過濾條件(可以用 #、+ 萬用字元)。
  • 每組帳號只能套用一個權限,每個權限也只有一個主題過濾條件。
  • 權限變更不一定立刻生效,文件提到權限有快取,可能需要幾分鐘。

這代表免費方案無法做到「儀表板只能訂閱某幾個主題、同時只能發布 cmd/led」這種更細的設定,那需要付費方案。但我們仍然可以用現有的功能做出合理的分離。

我們的設計:三組帳號

三組帳號的權限分離 Broker iot/esp32-01/# ESP32 裝置 esp32-01-device 發布+訂閱 唯讀儀表板 dashboard-viewer 僅訂閱 可控制的儀表板 dashboard-operator 發布+訂閱 三組帳號的主題範圍都是 iot/esp32-01/#,不能碰其他裝置的主題
帳號名稱 權限類型 主題過濾條件 給誰用
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),這是免費方案單一過濾條件的限制。

建立步驟

  1. 進入叢集的「Access Management」。
  2. 先建立權限:在授權(Authorization)的「Permissions」區域按「Add New」,填入名稱(例如 esp32-01-rw)、說明、Topic Filter 填 iot/esp32-01/#,Permission Type 選「Publish and Subscribe」。再建立一個只能訂閱的(例如 esp32-01-ro,類型選「Subscribe Only」)。
  3. 建立三組憑證,建立時各自選擇對應的權限:device 與 operator 用 esp32-01-rw,viewer 用 esp32-01-ro。
  4. 把 ESP32 程式裡的帳密改成 device 帳號。
  5. 確認一切正常後,刪除第 1 篇建立的萬能帳號。

實際的欄位名稱與選項,請依你看到的畫面為準。因為權限有快取,改完後如果行為還是舊的,等幾分鐘再測。

驗證權限有效

  1. 在 Web Client 用 viewer 帳號連線,訂閱 iot/esp32-01/#,應該看得到資料。
  2. 再用 viewer 對 iot/esp32-01/cmd/led 發布 on,ESP32 的 LED 不應該有反應。(Broker 如何處理被拒絕的發布,可能是直接忽略,也可能中斷連線,依設定而定。)
  3. 改用 operator 帳號重複上一步,這次 LED 應該會亮。
  4. 試著用 viewer 訂閱別的裝置名稱的主題,例如 iot/esp32-02/#,應該收不到任何東西。

三、讓 ESP32 驗證伺服器身分

前幾篇為了簡化,ESP32 用了 setInsecure():連線雖然加密,但不確認對面真的是 HiveMQ。如果有人在網路中間冒充伺服器,ESP32 照樣會把帳號密碼交出去。

解法是讓 ESP32 內建一份「根憑證」,連線時檢查伺服器出示的憑證,是不是由這個根憑證簽發的。HiveMQ Cloud 使用 Let's Encrypt 簽發的憑證,根憑證是 ISRG Root X1。

取得根憑證

  1. 從官方來源下載 isrgrootx1.pem。HiveMQ 的常見問題頁面有提供連結(HiveMQ 說明頁),也可以從 Let's Encrypt 官方網站的憑證頁面取得。
  2. 用文字編輯器開啟,內容會是以 -----BEGIN CERTIFICATE----- 開頭、-----END CERTIFICATE----- 結尾的一大段文字。
  3. 把整份內容貼進 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
連線成功後ESP32online
意外斷線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 版本是同一個檔案,用新版取代即可。更新的重點如下,如果你想自己改:

  1. 畫面:在「資料時間」那一列加入裝置狀態標籤,並在連線設定區加入唯讀模式的勾選框。
    <label class="chk"><input type="checkbox" id="viewOnly"> 唯讀模式(停用控制按鈕)</label>
    
    <div>裝置:<span id="devStatus" class="badge" data-state="idle">未知</span></div>
  2. 主題與訂閱:新增 status 主題,並加入訂閱清單。
    status: 'iot/' + device + '/status',
    
    client.subscribe([topics.telemetry, topics.stateLed, topics.status], ...)
  3. 處理狀態訊息:在 onMessage 加入一個分支,並新增 setDevStatus 函式,把 online 顯示成綠色「線上」、offline 顯示成紅色「離線」,其他顯示「未知」。
  4. 唯讀模式:讓 setConnectedUi 在勾選唯讀時,一律停用三個控制按鈕。
    var canControl = connected && !$('viewOnly').checked;
  5. 斷線時重設:連線中斷或手動中斷後,把裝置狀態改回「未知」,因為這時我們已經不知道它的狀況了。
瀏覽器端不需要處理憑證
儀表板用的是 wss://,瀏覽器會自動驗證 HiveMQ 的憑證,所以這個部分已經是安全的,不用像 ESP32 一樣自己載入根憑證。

七、測試清單

  1. 正常連線:上傳新程式,序列埠應該顯示對時成功、MQTT 連線成功、已訂閱。
  2. 狀態主題:在 Web Client 訂閱 iot/esp32-01/#,應該看到 status 為 online。
  3. 離線偵測:直接拔掉 ESP32 的電源,約 20 到 30 秒後,會出現 status 變成 offline,儀表板的裝置標籤也變成紅色「離線」。
  4. 重新上線:接回電源,狀態變回 online。
  5. 憑證驗證確實有作用:故意把 MQTT_HOST 暫時改成一個你沒有的叢集網址(或把憑證內容刪掉一個字元),應該會連線失敗,而不是照樣連上去。測完記得改回來。
  6. 權限:照第二節的驗證步驟,確認 viewer 發布指令無效、operator 有效。
  7. 唯讀模式:用 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
02ESP32 發布溫濕度TLS 連線、JSON、斷線重連
03訂閱、除錯與保留訊息Retained、QoS、除錯流程
04接收指令控制 LED雙向通訊、指令與狀態分離
05即時網頁儀表板WebSocket、資料過期判斷
06連線安全與斷線偵測最小權限、憑證驗證、LWT

有了這套基礎,下一步可以往幾個方向走:增加更多種類的感測器、讓多台裝置共用一套架構、把 MQTT 的資料自動存進資料庫,或是接上 LINE Bot 做雙向互動。歡迎在留言告訴我你想看哪一個,也歡迎分享你的成果與遇到的問題。


系列:MQTT 即時儀表板
目錄:系列總整理 | 上一篇:即時網頁儀表板

留言

熱門文章