双向 TLS 身份验证

Dialogflow 针对网络钩子请求发起的网络流量通过公共网络发送。为了确保每个方向的流量都安全可靠又可信任,Dialogflow 还可视需要支持双向 TLS 身份验证 (mTLS)。在 Dialogflow 的标准 TLS 握手期间,您的 webhook 服务器会提供一个可由 Dialogflow 验证的证书,验证方式可以是遵循证书授权机构链,也可以是将证书与自定义 CA 证书进行比较。通过在网络钩子服务器上启用 mTLS,它可以对 Dialogflow 向网络钩子服务器提供的客户端证书进行身份验证,从而完成相互信任的建立。

默认情况下,Dialogflow 会提供由 SSL.com (CN=Google LLC) 颁发的客户端证书。

请求 mTLS

如需请求 mTLS,请执行以下操作:

  1. 对您的 webhook HTTPS 服务器进行准备,以在 TLS 握手期间请求客户端证书。
  2. 将 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 添加到受信任证书存储区。
  3. 将网络钩子服务器配置为在收到客户端证书后对其进行验证。如果您的服务器或 API Gateway 按主体或通用名称 (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 服务器。

  1. 设置示例
    1. 一个 Dialogflow ES 代理,用于向最终用户致意并查询指向独立 Web 服务器的 webhook。
    2. 名为 key.pem 的文件中的 TLS 通信私钥。
    3. 由广受信任的 CA(证书授权机构)签名的证书链,位于名为 fullchain.pem 的文件中。
    4. 从 SSL.com 下载的名为 SSLcomRootCertificationAuthorityRSA.pem 的文件中的 SSL.com 根证书。
  2. 在服务器机器中执行 openssl s_server 程序。
    sudo openssl s_server -key key.pem -cert fullchain.pem -CAfile SSLcomRootCertificationAuthorityRSA.pem -accept 443 -verify 2
  3. 请求从客户端机器发送到代理。在此示例中,请求为“Hi”。您可以使用 Dialogflow 控制台或通过 API 调用发送此请求。
  4. 服务器机器中 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 代理发起的,您应验证请求的 Authorization 标头中的 Bearer 服务身份令牌。或者,您也可以验证之前由您这边的认证服务器提供的会话参数。

错误

如果客户端证书验证失败(例如,Webhook 服务器不信任客户端证书),则 TLS 握手失败,会话终止。

常见的错误消息:

出错提示 说明
Failed to verify client's certificate: x509: certificate signed by unknown authority(未能验证客户端的证书:x509:证书由未知授权机构签署) Dialogflow 将其客户端证书发送到了外部网络钩子,但外部网络钩子无法对其进行验证。确保您的 webhook 受信任证书存储区包含 SSL.com 根证书授权机构 RSA 根证书,并且服务器的验证深度至少为 2。