檢視次數:
雲端狀態 支援透過自訂 webhook 頻道發送通知。這些通知將發送到使用者建立的頻道,所有相關使用者都會收到通知。
  1. 點選Create a Webhook channel.
  2. 設定自動通知
  3. 設定觸發條件
  4. Configure now 將允許使用以下參數添加 Webhook 通道
    • WebhookURL: 請確保您輸入的 Webhook URL 是安全的,並且使用 'https'
      !!! note "" * URL 不能以 http:// 開頭(僅限 https://) * URL 不能包含 localhost * URL 不能包含 IP 位址
    • Webhook Security Token
      !!! 注意 "" 任何非 base64 字元將不被接受
    正在驗證來自 雲端狀態 的有效負載
    如果您決定設置可選的安全令牌,雲端狀態 會使用它來為每個有效負載創建一個雜湊簽章。雜湊簽章會與每個請求一起傳遞到您在標頭中指定的 URL,作為 X-雲端狀態-簽章。
    這個想法是使用您提供的安全令牌計算哈希值,並確保我們這邊的哈希值與您那邊的匹配。哈希簽章是從雲端狀態生成的,並使用 HMAC hexdigest (sha-256),因此您可以按照下面的示例設置您的伺服器:
    const signatureHash = request.headers["X-雲端狀態-Signature"];
       const hmac = crypto.createHmac("sha256", YOUR_SECURITY_TOKEN);
       const digest = Buffer.from(
          hmac.update(JSON.stringify(PAYLOAD_BODY)).digest("hex")
       );
       const checksum = Buffer.from(signatureHash, "utf8");
       if (
          checksum.length !== digest.length ||
          !crypto.timingSafeEqual(digest, checksum)
       ) {
          console.log('Request body digest(${ digest }) did not match X - 雲端狀態 - Signature(${ checksum })');
          throw new Error("Hashes do not match!");
       }
       console.log("Hashes match!");
  5. 複製通訊設定
    一旦頻道創建成功,您將能夠從您的Communication Settings中看到 Webhook 頻道。