התנועה ברשת שנוצרת על ידי Dialogflow לבקשות של webhook נשלחת ברשת ציבורית. כדי לוודא שהתנועה מאובטחת ומהימנה בשני הכיוונים, Dialogflow תומך באימות TLS בו-זמני (mTLS). במהלך לחיצת היד בפרוטוקול TLS הסטנדרטית של Dialogflow, שרת ה-webhook מציג אישור ש-Dialogflow יכול לאמת, באמצעות מעקב אחרי שרשרת רשות האישורים או באמצעות השוואה של האישור לאישור CA בהתאמה אישית. אם תפעילו mTLS בשרת ה-webhook, הוא יוכל לאמת את אישור הלקוח ש-Dialogflow מציג לשרת ה-webhook, וכך להשלים את יצירת האמון ההדדי.
כברירת מחדל, Dialogflow מציג אישור לקוח שהונפק על ידי SSL.com (CN=Google LLC).
בקשת mTLS
כדי לבקש mTLS:
- מכינים את שרת ה-HTTPS של ה-webhook לבקש את אישור הלקוח במהלך לחיצת היד בפרוטוקול TLS.
- מגדירים את מאגר האישורים של 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, כך שאתם צריכים להוסיף רק את רשות האישורים הבסיסית למאגר האישורים.
- רשות אישורים בסיסית:
מגדירים את שרת ה-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.
- הגדרה לדוגמה
- נציג Dialogflow ES שמברך את משתמש הקצה ושולח שאילתה ל-webhook שמפנה לשרת אינטרנט עצמאי.
- מפתח פרטי לתקשורת TLS בקובץ בשם
key.pem. - שרשרת אישורים שחתומה על ידי רשות אישורים (CA) מהימנה באופן ציבורי בקובץ בשם
fullchain.pem. - אישור הבסיס של 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
שיטה מומלצת
כדי לוודא שבקשות ה-webhook נשלחות מסוכני Dialogflow שלכם, צריך לאמת את אסימון הזהות של השירות מסוג Bearer מכותרת ה-Authorization של הבקשה. לחלופין, אתם יכולים לאמת פרמטר של סשן שסופק בעבר על ידי שרת אימות (AS) בצד שלכם.
שגיאות
אם אימות אישור הלקוח נכשל (לדוגמה, שרת ה-webhook לא נותן אמון באישור הלקוח), לחיצת היד בפרוטוקול TLS נכשלת והסשן מסתיים.
הודעות שגיאה נפוצות:
| הודעת השגיאה | הסבר |
|---|---|
| אימות אישור הלקוח נכשל: x509: האישור נחתם על ידי רשות לא ידועה | Dialogflow שולח את אישור הלקוח שלו ל-webhook החיצוני, אבל ה-webhook החיצוני לא יכול לאמת אותו. חשוב לוודא שמאגר האישורים של ה-webhook כולל את אישור הבסיס של RSA של רשות אישורי הבסיס של SSL.com, ושעומק האימות של השרת הוא לפחות 2. |