Dialogflow 針對 Webhook 要求啟動的網路流量,會透過公用網路傳送。為確保雙向流量安全且可信,Dialogflow 支援相互 TLS 驗證 (mTLS)。在 Dialogflow 的標準 TLS 握手期間,您的 Webhook 伺服器會提供可由 Dialogflow 驗證的憑證,驗證方式包括遵循憑證授權單位鏈結,或將憑證與自訂 CA 憑證進行比較。在 Webhook 伺服器上啟用 mTLS 後,伺服器就能驗證 Dialogflow 提供的用戶端憑證,完成雙向信任關係的建立。
根據預設,Dialogflow 會提供 SSL.com (CN=Google LLC) 核發的用戶端憑證。
要求 mTLS
如要要求 mTLS,請按照下列步驟操作:
- 準備 Webhook HTTPS 伺服器,在 TLS 握手期間要求用戶端憑證。
- 設定 Webhook 伺服器的 mTLS 信任存放區,信任 SSL.com Root Certification Authority RSA 根憑證,您可以直接從 SSL.com 下載:
- 根 CA:
SSL.com Root Certification Authority RSA - SHA-256 指紋:
85:66:6A:56:2E:E0:BE:5C:E9:25:C1:D8:89:0A:6F:76:A8:7E:C1:6D:4D:7D:5F:29:EA:74:19:CF:20:12:3B:69 - 驗證深度:將 TLS 用戶端憑證驗證深度設為至少
2。Dialogflow 會在 TLS 握手期間自動傳送中繼憑證 (SSL.com Client Certificate Intermediate CA RSA R2),因此您只需將根 CA 新增至信任存放區。
- 根 CA:
請設定 Webhook 伺服器,在收到用戶端憑證時進行驗證。如果伺服器或 API 閘道依主體或一般名稱 (CN) 將用戶端憑證加入許可清單,請允許下列憑證屬性 (憑證不含主體別名 (SAN) 擴充功能):
- 主旨:
C=US, ST=California, L=Mountain View, O=Google, OU=Applied Ai, CN=Google LLC - 核發者:
C=US, ST=Texas, L=Houston, O=SSL Corp, CN=SSL.com Client Certificate Intermediate CA RSA R2
如要強化驗證,請比對完整主體和核發者,而非僅比對
CN。- 主旨:
使用 mTLS 呼叫 Webhook 伺服器的範例
這個範例使用快速入門導覽課程中顯示的代理,並搭配執行 openssl 的 Webhook 伺服器。
- 設定範例
- Dialogflow ES 代理,可向使用者打招呼,並查詢指向獨立網路伺服器的 Webhook。
- 用於 TLS 通訊的私密金鑰,位於名為
key.pem的檔案中。 - 由公開信任的 CA (憑證授權單位) 簽署的憑證鏈結,位於名為
fullchain.pem的檔案中。 - SSL.com 根憑證,位於名為
SSLcomRootCertificationAuthorityRSA.pem的檔案中,從 SSL.com 下載。
-
在伺服器機器中執行
openssl s_server程式。sudo openssl s_server -key key.pem -cert fullchain.pem -CAfile SSLcomRootCertificationAuthorityRSA.pem -accept 443 -verify 2 - 要求會從用戶端機器傳送至代理程式。在本例中,要求為「Hi」。這項要求可以透過 Dialogflow 控制台或 API 呼叫傳送。
-
伺服器機器中
openssl s_server的輸出內容。verify depth is 2 Using default temp DH parameters ACCEPT depth=2 C = US, ST = Texas, L = Houston, O = SSL Corporation, CN = SSL.com Root Certification Authority RSA verify return:1 depth=1 C = US, ST = Texas, L = Houston, O = SSL Corp, CN = SSL.com Client Certificate Intermediate CA RSA R2 verify return:1 depth=0 C = US, ST = California, L = Mountain View, O = Google, OU = Applied Ai, CN = Google LLC verify return:1 -----BEGIN SSL SESSION PARAMETERS----- MII... -----END SSL SESSION PARAMETERS----- Client certificate -----BEGIN CERTIFICATE----- MII... -----END CERTIFICATE----- subject=C = US, ST = California, L = Mountain View, O = Google, OU = Applied Ai, CN = Google LLC issuer=C = US, ST = Texas, L = Houston, O = SSL Corp, CN = SSL.com Client Certificate Intermediate CA RSA R2 Shared ciphers:TLS_AES_128_GCM_SHA256:... Signature Algorithms: ECDSA+SHA256:... Shared Signature Algorithms: ECDSA+SHA256:... Peer signing digest: SHA256 Peer signature type: RSA-PSS Supported Elliptic Groups: 0x6A6A:... Shared Elliptic groups: X25519:... CIPHER is TLS_AES_128_GCM_SHA256 Secure Renegotiation IS NOT supported POST /dialogflowFulfillment HTTP/1.1 authorization: Bearer ey... content-type: application/json Host: www.example.com Content-Length: 1011 Connection: keep-alive Accept: */* User-Agent: Google-Dialogflow Accept-Encoding: gzip, deflate, br { "responseId": "96c0029a-149d-4f5d-b225-0b0bb0f0c8d9-afbcf665", "queryResult": { "queryText": "Hi", "action": "input.welcome", "parameters": { }, "allRequiredParamsPresent": true, "outputContexts": [{ "name": "projects/PROJECT-ID/agent/sessions/58ab33f3-b57a-aae9-fb23-8306242d4871/contexts/__system_counters__", "parameters": { "no-input": 0.0, "no-match": 0.0 } }], "intent": { "name": "projects/PROJECT-ID/agent/intents/399277d6-2ed7-4329-840d-8baa0f60480e", "displayName": "Default Welcome Intent" }, "intentDetectionConfidence": 1.0, "languageCode": "en", "sentimentAnalysisResult": { "queryTextSentiment": { "score": 0.2, "magnitude": 0.2 } } }, "originalDetectIntentRequest": { "source": "DIALOGFLOW_CONSOLE", "payload": { } }, "session": "projects/PROJECT-ID/agent/sessions/58ab33f3-b57a-aae9-fb23-8306242d4871" }ERROR shutting down SSL CONNECTION CLOSED
最佳做法
為確保 Webhook 要求是由您自己的 Dialogflow 代理啟動,請驗證要求授權標頭中的 Bearer 服務身分權杖。或者,您也可以驗證先前由驗證伺服器提供的階段參數。
錯誤
如果用戶端憑證驗證失敗 (例如 Webhook 伺服器不信任用戶端憑證),TLS 握手就會失敗,工作階段也會終止。
常見錯誤訊息:
| 錯誤訊息 | 說明 |
|---|---|
| 無法驗證用戶端憑證:x509:憑證由不明授權單位簽署 | Dialogflow 會將用戶端憑證傳送至外部 Webhook,但外部 Webhook 無法驗證憑證。請確認 Webhook 信任存放區包含 SSL.com 根憑證授權單位 RSA 根憑證,且伺服器的驗證深度至少為 2。 |