Authentification TLS mutuelle

Le trafic réseau amorcé par Dialogflow pour les requêtes de webhook est envoyé sur un réseau public. Pour garantir la sécurité et la fiabilité du trafic dans les deux sens, Dialogflow offre la possibilité d'utiliser l'authentification TLS mutuelle (mTLS). Lors du handshake TLS standard de Dialogflow, votre serveur de webhook présente un certificat qui peut être validé par Dialogflow, soit en suivant la chaîne d'autorité de certification, soit en comparant le certificat à un certificat d'autorité de certification personnalisé. En activant mTLS sur votre serveur de webhook, celui-ci peut authentifier le certificat client présenté par Dialogflow à votre serveur de webhook pour validation, ce qui permet d'établir une confiance mutuelle.

Par défaut, Dialogflow présente un certificat client émis par SSL.com (CN=Google LLC).

Demander l'authentification mTLS

Pour demander l'authentification mTLS, procédez comme suit :

  1. Préparez votre serveur HTTPS de webhook de sorte qu'il demande le certificat client lors du handshake TLS.
  2. Configurez le magasin de confiance mTLS de votre serveur de webhook pour qu'il approuve le certificat racine de l'autorité de certification racine RSA SSL.com, que vous pouvez télécharger directement depuis SSL.com :
    • Autorité de certification racine : SSL.com Root Certification Authority RSA
    • Empreinte 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
    • Profondeur de validation : définissez la profondeur de validation du certificat client TLS sur au moins 2. Dialogflow envoie automatiquement le certificat intermédiaire (SSL.com Client Certificate Intermediate CA RSA R2) lors du handshake TLS. Il vous suffit donc d'ajouter l'autorité de certification racine à votre magasin de confiance.
  3. Configurez votre serveur de webhook pour qu'il valide le certificat client dès sa réception. Si votre serveur ou votre passerelle d'API ajoutent des certificats clients à la liste d'autorisation par objet ou par nom commun (CN), autorisez les attributs de certificat suivants (le certificat n'inclut pas d'extension d'autre nom de l'objet (SAN)) :

    • Objet : C=US, ST=California, L=Mountain View, O=Google, OU=Applied Ai, CN=Google LLC
    • Émetteur : C=US, ST=Texas, L=Houston, O=SSL Corp, CN=SSL.com Client Certificate Intermediate CA RSA R2

    Pour une validation plus stricte, faites correspondre l'objet complet et l'émetteur plutôt que CN seul.

Exemple d'appel à un serveur de webhook à l'aide de mTLS

Cet exemple utilise l'agent présenté dans le guide de démarrage rapide avec un serveur de webhook exécutant openssl.

  1. Exemple de configuration
    1. Un agent Dialogflow CX qui prend les commandes de t-shirts et les envoie à un webhook pointant vers un serveur Web autonome.
    2. Une clé privée pour la communication TLS dans un fichier nommé key.pem.
    3. Une chaîne de certificats signée par une autorité de certification (CA) publiquement approuvée dans un fichier nommé fullchain.pem.
    4. Le certificat racine SSL.com dans un fichier nommé SSLcomRootCertificationAuthorityRSA.pem, téléchargé depuis SSL.com.
  2. Exécutez le programme openssl s_server sur la machine du serveur.
    sudo openssl s_server -key key.pem -cert fullchain.pem -CAfile SSLcomRootCertificationAuthorityRSA.pem -accept 443 -verify 2
  3. Une requête est envoyée à l'agent depuis une machine cliente. Dans cet exemple, la requête est "Je veux acheter un grand t-shirt rouge". Cette requête peut être envoyée à l'aide de la console Dialogflow ou via un appel d'API.
  4. Sortie de openssl s_server sur le serveur.
    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
          

Certificat client personnalisé

Les certificats client personnalisés peuvent être configurés au niveau de l'agent pour être utilisés par tous les webhooks. Au moment de l'appel du webhook, les certificats configurés sont présentés lors du handshake.

La clé privée et la phrase secrète sont configurées en tant que ressource Secret Manager. L'agent de service Dialogflow doit disposer des autorisations d'accesseur de secrets Secret Manager pour le secret.

Les certificats client doivent être signés par une autorité de certification pour que le handshake réussisse.

Bonnes pratiques

Pour vous assurer que les requêtes de webhook sont initiées à partir de vos propres agents Dialogflow, vous devez valider le jeton d'identité du service du porteur à partir de l'en-tête d'autorisation de la requête. Vous pouvez également vérifier un paramètre de session fourni précédemment par un serveur d'authentification de votre côté.

Erreurs

Si la validation du certificat client échoue (par exemple, si le serveur de webhook ne fait pas confiance au certificat client), l'établissement de liaison TLS échoue et la session se termine.

Messages d'erreur fréquents :

Message d'erreur Explication
Échec de la validation du certificat du client : x509 : certificat signé par une autorité inconnue Dialogflow envoie son certificat client au webhook externe, qui ne peut pas le valider. Assurez-vous que votre magasin de confiance de webhook inclut le certificat racine RSA de l'autorité de certification racine SSL.com et que la profondeur de validation de votre serveur est d'au moins 2.