Dialogflow が Webhook リクエストに対して開始するネットワーク トラフィックは、パブリック ネットワークで送信されます。両方向のトラフィックの安全性と信頼性を確保するため、Dialogflow は相互 TLS 認証(mTLS)をオプションでサポートします。Dialogflow の標準 TLS handshake 中に、Webhook サーバーは認証局チェーンに従うか、証明書をカスタム CA 証明書と比較して、Dialogflow で検証できる証明書を提示します。Webhook サーバーで mTLS を有効にすると、Dialogflow が検証のために Webhook サーバーに提示したクライアント証明書を認証して、相互信頼の確立を完了します。
デフォルトでは、Dialogflow は SSL.com(CN=Google LLC)によって発行されたクライアント証明書を提示します。
mTLS のリクエスト
mTLS をリクエストするには:
- Webhook HTTPS サーバーが TLS handshake 中にクライアント証明書をリクエストするように、準備をします。
- SSL.com ルート認証局 RSA ルート証明書を信頼するように Webhook サーバーの mTLS トラストストアを構成します。この証明書は、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 handshake 中に中間証明書(SSL.com Client Certificate Intermediate CA RSA R2)を自動的に送信するため、ルート CA をトラストストアに追加するだけで済みます。
- ルート CA:
クライアント証明書の受信時に検証するように Webhook サーバーを構成します。サーバーまたは 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 サーバーで、クイックスタートに示されているエージェントを使用します。
- 設定例
- エンドユーザーに挨拶し、スタンドアロン ウェブサーバーを指す Webhook にクエリを実行する Dialogflow ES エージェント。
key.pemという名前のファイルの TLS 通信用の秘密鍵。fullchain.pemという名前のファイルで、公的に信頼できる CA(認証局)によって署名された証明書チェーン。- 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
ベスト プラクティス
独自の Dialogflow エージェントから確実に Webhook リクエストが行われるようにするには、リクエストの認証ヘッダーからの署名なしのサービス ID トークンを検証する必要があります。または、以前に認証サーバーによって提供されたセッション パラメータを確認することもできます。
エラー
クライアント証明書の検証が失敗した場合(たとえば、Webhook サーバーがクライアント証明書を信頼していない場合)、TLS handshake が失敗し、セッションが終了します。
一般的なエラー メッセージ:
| エラー メッセージ | 説明 |
|---|---|
| Failed to verify client's certificate: x509: certificate signed by unknown authority(クライアントの証明書を検証できませんでした: x509: 不明な権限で署名された証明書) | Dialogflow はクライアント証明書を外部 Webhook に送信しましたが、外部 Webhook で検証できませんでした。Webhook トラストストアに SSL.com Root Certification Authority RSA ルート証明書が含まれていること、サーバーの検証深度が 2 以上であることを確認してください。 |