Autenticazione TLS reciproca

Il traffico di rete avviato da Dialogflow per le richieste webhook viene inviato su una rete pubblica. Per garantire che il traffico sia sicuro e affidabile in entrambe le direzioni, Dialogflow supporta facoltativamente Autenticazione TLS reciproca (mTLS). Durante l'handshake TLS standard di Dialogflow, il server webhook presenta un certificato che può essere convalidato da Dialogflow seguendo la catena di autorità di certificazione o confrontandolo con un certificato CA personalizzato. Se attivi mTLS sul server webhook, questo potrà autenticare il certificato Google presentato da Dialogflow al server webhook per la convalida, completando l'istituzione della fiducia reciproca.

Richiesta di mTLS

Per richiedere mTLS:

  1. Prepara il server HTTPS del webhook per richiedere il certificato client durante l'handshake TLS.
  2. Il server webhook deve verificare il certificato del client al momento della ricezione.
  3. Installa una catena di certificati per il server webhook che possono essere reciprocamente attendibili sia dal client che dal server. Applicazioni che si connettono ai servizi Google devono fidarsi di tutte le autorità di certificazione elencate Google Trust Services. Puoi scaricare i certificati radice da: https://pki.goog/.

Chiamata di esempio a un server webhook utilizzando mTLS

Questo esempio utilizza l'agente mostrato nella guida rapida con un webhook in esecuzione su openssl.

  1. Configurazione di esempio
    1. Un agente Dialogflow ES che saluta l'utente finale ed esegue query su un webhook che rimanda a un server web autonomo.
    2. Una chiave privata per la comunicazione TLS in un file denominato key.pem.
    3. Una catena di certificati firmata da un'autorità di certificazione (CA) ritenuta attendibile pubblicamente in un file denominato fullchain.pem.
  2. Esegui il programma openssl s_server nella macchina server.
    sudo openssl s_server -key key.pem -cert fullchain.pem -accept 443 -verify 1
  3. Viene inviata una richiesta all'agente da un computer client. Per questo esempio, la richiesta "Ciao." Questa richiesta può essere inviata utilizzando la console Dialogflow oppure mediante una chiamata API.
  4. Output di openssl s_server nella macchina server.
    verify depth is 1
    Using default temp DH parameters
    ACCEPT
    depth=2 C = US, O = Google Trust Services LLC, CN = GTS Root R1
    verify return:1
    depth=1 C = US, O = Google Trust Services LLC, CN = GTS CA 1D4
    verify return:1
    depth=0 CN = *.dialogflow.com
    verify return:1
    -----BEGIN SSL SESSION PARAMETERS-----
    MII...
    -----END SSL SESSION PARAMETERS-----
    Client certificate
    -----BEGIN CERTIFICATE-----
    MII...
    -----END CERTIFICATE-----
    subject=CN = *.dialogflow.com
    
    issuer=C = US, O = Google Trust Services LLC, CN = GTS CA 1D4
    
    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
          

Best practice

Per assicurarti che le richieste webhook vengano avviate dai tuoi agenti Dialogflow, devi verificare l'identità token di identità del servizio dall'intestazione Autorizzazione della richiesta. In alternativa, puoi verificare un parametro sessione fornito in precedenza da un server di autenticazione di tua proprietà.

Errori

Se la convalida del certificato client non va a buon fine (ad esempio, il server webhook non considera attendibile il certificato client), la procedura di handshake TLS non va a buon fine e la sessione termina.

Messaggi di errore comuni:

Messaggio di errore Spiegazione
Impossibile verificare il certificato del client: x509: certificato firmato da un'autorità sconosciuta Dialogflow invia il proprio certificato client al webhook esterno, ma quest'ultimo non può verificarlo. Il motivo potrebbe essere che il webhook esterno non ha installato correttamente la catena di CA. Tutte le CA radice di Google devono essere attendibili.