התנועה ברשת שנוצרת על ידי 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 שלכם מאפשרים הוספה של אישורי לקוח לרשימת ההיתרים לפי נושא או שם נפוץ (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.- נושא:
דוגמה לקריאה לשרת webhook באמצעות mTLS
בדוגמה הזו נעשה שימוש בנציג שמוצג במדריך למתחילים, עם שרת webhook שפועל ב-openssl.
- הגדרה לדוגמה
- סוכן Dialogflow CX שמקבל הזמנות של חולצות ושולח אותן ל-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 - בקשה נשלחת לסוכן ממכונה של לקוח. בדוגמה הזו, הבקשה היא "אני רוצה לקנות חולצה אדומה גדולה". אפשר לשלוח את הבקשה הזו באמצעות מסוף 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: 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
אישור לקוח בהתאמה אישית
אפשר להגדיר אישורי לקוח מותאמים אישית ברמת הנציג, כדי שכל ה-webhooks ישתמשו בהם. בזמן ההפעלה של ה-webhook, האישורים שהוגדרו יוצגו במהלך לחיצת היד.
המפתח הפרטי וביטוי הסיסמה מוגדרים כמשאב של Secret Manager. צריך לתת לסוכן השירות של Dialogflow הרשאות גישה לסוד ב-Secret Manager.
כדי שהלחיצת היד תצליח, אישורי הלקוח צריכים להיות חתומים על ידי רשות אישורים.
שיטה מומלצת
כדי לוודא שבקשות ה-webhook מגיעות מסוכני Dialogflow שלכם, אתם צריכים לאמת את אסימון זהות השירות של ה-Bearer מהכותרת Authorization של הבקשה. לחלופין, אתם יכולים לאמת פרמטר של סשן שסופק בעבר על ידי שרת אימות (AS) בצד שלכם.
שגיאות
אם אימות אישור הלקוח נכשל (לדוגמה, שרת ה-webhook לא נותן אמון באישור הלקוח), לחיצת היד בפרוטוקול TLS נכשלת והסשן מסתיים.
הודעות שגיאה נפוצות:
| הודעת השגיאה | הסבר |
|---|---|
| אימות אישור הלקוח נכשל: x509: האישור נחתם על ידי רשות לא ידועה | Dialogflow שולח את אישור הלקוח שלו ל-webhook החיצוני, אבל ה-webhook החיצוני לא יכול לאמת אותו. חשוב לוודא שמאגר האישורים של ה-webhook כולל את אישור הבסיס של RSA של רשות אישורי הבסיס של SSL.com, ושרמת האימות של השרת היא לפחות 2. |