Dialogflow 针对网络钩子请求发起的网络流量通过公共网络发送。为了确保每个方向的流量都安全可靠又可信任,Dialogflow 还可视需要支持双向 TLS 身份验证 (mTLS)。在 Dialogflow 的标准 TLS 握手期间,您的 webhook 服务器会提供一个可由 Dialogflow 验证的证书,验证方式可以是遵循证书授权机构链,也可以是将证书与自定义 CA 证书进行比较。通过在网络钩子服务器上启用 mTLS,它可以对 Dialogflow 向网络钩子服务器提供的客户端证书进行身份验证,从而完成相互信任的建立。
默认情况下,Dialogflow 会提供由 SSL.com (CN=Google LLC) 颁发的客户端证书。
请求 mTLS
如需请求 mTLS,请执行以下操作:
- 对您的 webhook HTTPS 服务器进行准备,以在 TLS 握手期间请求客户端证书。
- 将 webhook 服务器的 mTLS 受信任证书存储区配置为信任 SSL.com 根证书授权机构 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:
将网络钩子服务器配置为在收到客户端证书后对其进行验证。如果您的服务器或 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 CX 智能体,用于接收衬衫订单,并将其发送到指向独立 Web 服务器的网络钩子。
- 名为
key.pem的文件中的 TLS 通信私钥。 - 由广受信任的 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 - 请求从客户端机器发送到代理。在此示例中,请求为“我想买一件大号红色衬衫”。您可以使用 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: 0xEAEA:... Shared Elliptic groups: X25519:... CIPHER is TLS_AES_128_GCM_SHA256 Secure Renegotiation IS NOT supported POST /shirts-agent-webhook HTTP/1.1 authorization: Bearer ey... content-type: application/json Host: www.example.com Content-Length: 1595 Connection: keep-alive Accept: */* User-Agent: Google-Dialogflow Accept-Encoding: gzip, deflate, br { "detectIntentResponseId": "a7951ce2-2f00-4af5-a508-4c2cb45698b0", "intentInfo": { "lastMatchedIntent": "projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/intents/0adebb70-a727-4687-b8bc-fbbc2ac0b665", "parameters": { "color": { "originalValue": "red", "resolvedValue": "red" }, "size": { "originalValue": "large", "resolvedValue": "large" } }, "displayName": "order.new", "confidence": 0.9978873 }, "pageInfo": { "currentPage": "projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/flows/00000000-0000-0000-0000-000000000000/pages/06e6fc4d-c2f2-4830-ab57-7a318f20fd90", "displayName": "Order Confirmation" }, "sessionInfo": { "session": "projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/sessions/session-test-001", "parameters": { "color": "red", "size": "large" } }, "fulfillmentInfo": { "tag": "confirm" }, "messages": [{ "text": { "text": ["Ok, let\u0027s start a new order."], "redactedText": ["Ok, let\u0027s start a new order."] }, "responseType": "ENTRY_PROMPT", "source": "VIRTUAL_AGENT" }, { "text": { "text": ["You have selected a large, red shirt."], "redactedText": ["You have selected a large, red shirt."] }, "responseType": "HANDLER_PROMPT", "source": "VIRTUAL_AGENT" }], "text": "I want to buy a large red shirt", "languageCode": "en" }ERROR shutting down SSL CONNECTION CLOSED
自定义客户端证书
您可以在代理级别配置自定义客户端证书,以供所有 webhook 使用。在调用 webhook 时,系统会在握手期间提供配置的证书。
私钥和口令配置为 Secret Manager 资源。需要向 Dialogflow 服务代理授予对该 Secret 的 Secret Manager Secret Accessor 权限。
客户端证书需要由证书授权机构签名,握手才能成功。
最佳做法
为确保 webhook 请求是由您自己的 Dialogflow 代理发起的,您应验证请求的 Authorization 标头中的 Bearer 服务身份令牌。或者,您也可以验证之前由您这边的认证服务器提供的会话参数。
错误
如果客户端证书验证失败(例如,Webhook 服务器不信任客户端证书),则 TLS 握手失败,会话终止。
常见的错误消息:
| 出错提示 | 说明 |
|---|---|
| Failed to verify client's certificate: x509: certificate signed by unknown authority(未能验证客户端的证书:x509:证书由未知授权机构签署) | Dialogflow 将其客户端证书发送到了外部网络钩子,但外部网络钩子无法对其进行验证。确保您的网络钩子受信任证书存储区包含 SSL.com 根证书授权机构 RSA 根证书,并且服务器的验证深度至少为 2。 |