אימות TLS בו-זמני (mTLS)

התנועה ברשת שנוצרת על ידי Dialogflow לבקשות של webhook נשלחת ברשת ציבורית. כדי לוודא שהתנועה מאובטחת ומהימנה בשני הכיוונים, Dialogflow תומך באימות TLS בו-זמני (mTLS). במהלך לחיצת היד בפרוטוקול TLS הסטנדרטית של Dialogflow, שרת ה-webhook מציג אישור ש-Dialogflow יכול לאמת, באמצעות מעקב אחרי שרשרת רשות האישורים או באמצעות השוואה של האישור לאישור CA בהתאמה אישית. אם תפעילו mTLS בשרת ה-webhook, הוא יוכל לאמת את אישור הלקוח ש-Dialogflow מציג לשרת ה-webhook, וכך להשלים את יצירת האמון ההדדי.

כברירת מחדל, Dialogflow מציג אישור לקוח שהונפק על ידי SSL.com (CN=Google LLC).

בקשת mTLS

כדי לבקש mTLS:

  1. מכינים את שרת ה-HTTPS של ה-webhook לבקש את אישור הלקוח במהלך לחיצת היד בפרוטוקול TLS.
  2. מגדירים את מאגר האישורים של mTLS בשרת ה-webhook כך שיסמוך על אישור הבסיס SSL.com Root Certification Authority RSA, שאותו אפשר להוריד ישירות מ-SSL.com:
    • רשות אישורים בסיסית: 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 שולח באופן אוטומטי את אישור הביניים (SSL.com Client Certificate Intermediate CA RSA R2) במהלך לחיצת היד בפרוטוקול TLS, כך שאתם צריכים להוסיף רק את רשות האישורים הבסיסית למאגר האישורים.
  3. מגדירים את שרת ה-webhook כך שיאמת את אישור הלקוח כשהוא מקבל אותו. אם השרת או API Gateway שלכם מאפשרים הוספה של אישורי לקוח לרשימת ההיתרים לפי בעלים (subject) או שם נפוץ (CN), צריך לאפשר את מאפייני האישור הבאים (האישור לא כולל תוסף של שם חלופי של בעלים (subject) (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.

דוגמה לקריאה לשרת webhook באמצעות mTLS

בדוגמה הזו נעשה שימוש בנציג שמוצג במדריך למתחילים, עם שרת webhook שפועל ב-openssl.

  1. הגדרה לדוגמה
    1. נציג Dialogflow ES שמברך את משתמש הקצה ושולח שאילתה ל-webhook שמפנה לשרת אינטרנט עצמאי.
    2. מפתח פרטי לתקשורת TLS בקובץ בשם key.pem.
    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 שלכם, צריך לאמת את אסימון הזהות של השירות מסוג Bearer מכותרת ה-Authorization של הבקשה. לחלופין, אתם יכולים לאמת פרמטר של סשן שסופק בעבר על ידי שרת אימות (AS) בצד שלכם.

שגיאות

אם אימות אישור הלקוח נכשל (לדוגמה, שרת ה-webhook לא נותן אמון באישור הלקוח), לחיצת היד בפרוטוקול TLS נכשלת והסשן מסתיים.

הודעות שגיאה נפוצות:

הודעת השגיאה הסבר
אימות אישור הלקוח נכשל: x509: האישור נחתם על ידי רשות לא ידועה ‫Dialogflow שולח את אישור הלקוח שלו ל-webhook החיצוני, אבל ה-webhook החיצוני לא יכול לאמת אותו. חשוב לוודא שמאגר האישורים של ה-webhook כולל את אישור הבסיס של RSA של רשות אישורי הבסיס של SSL.com, ושעומק האימות של השרת הוא לפחות 2.