Webhook 可讓外部應用程式在平台發生特定事件時,即時接收通知。
如要使用 Webhook,必須先啟用並產生權杖。為單一 Webhook 網址使用兩個不同的密鑰,即可多添一層安全防護。如果機密資訊遭盜用或因故需要輪替,您可以更新及輪替機密資訊,不會中斷 Webhook 服務或危害資料安全。
開啟 Webhook
如要啟用 Webhook,請按照下列步驟操作:
在 CCAI Platform 入口網站中,依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單,請按一下「選單」圖示 。
前往「Webhooks」窗格,然後點選「Webhooks」切換按鈕,將其設為開啟。
在「URL」(網址) 部分輸入 Webhook 網址。這個網址是接收即時通知的端點。請確認這個 Webhook 可以接收 HTTP 要求。
點選「產生」,這會產生主要密鑰,也就是用於驗證及驗證傳入 Webhook 酬載的主要安全權杖。這是保護 Webhook 通訊的主要方式。
複製權杖並儲存在安全的地方。
產生次要密鑰。次要密碼是備份或容錯移轉安全權杖。這項功能是額外的安全措施,可提高網路鉤子通知的可靠性和可用性。如果主要密鑰因任何原因遭到入侵,或使用時發生問題,次要密鑰可以接管並繼續確保通訊。
複製權杖並儲存在安全的地方。
按一下 [儲存]。
輪替密鑰
為確保最佳安全性,請定期輪替 Webhook 密鑰。這個程序包括為主要和次要 Webhook 產生新密鑰,並在應用程式中更新這些密鑰,確保持續順暢接收通知。
完成 Webhook 的初始設定後,您無法直接產生新的主要密鑰,但可以產生新的次要密鑰並輪替密鑰,藉此變更密鑰。
如要輪替密鑰,請按照下列步驟操作:
在 CCAI Platform 入口網站中,依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單,請按一下「選單」圖示 。
按一下「輪替密鑰」
按一下 [儲存]。
產生新密鑰
如要輪替密鑰,產生兩組新密鑰,請按照下列步驟操作:
在 CCAI Platform 入口網站中,依序點選「Settings」>「Developer Settings」。 如果沒有看到「設定」選單,請按一下「選單」圖示 。
按一下「產生」,產生新的次要密鑰。
按一下「輪替密鑰」,將新的次要密鑰設為主要密鑰。
按一下「產生」,產生第二個新的次要密鑰,取代舊的主要密鑰。
按一下 [儲存]。