רכיב מוכן מראש לאימות

הרכיב המוגדר מראש לאימות אוסף מידע מהמשתמש כדי להגיע לרמת האימות הנדרשת. הרכיב הזה כולל דרישות אימות שרלוונטיות לתעשיית השירותים הפיננסיים (FSI), אבל לא רק לה.

הרכיב הזה משתמש ברכיבים המוכנים מראש איסוף תאריך תפוגה של כרטיס אשראי,‏ איסוף תאריך לידה ו-איסוף מספר טלפון כדי לאסוף ולאמת את פרטי המשתמש.

רמות אימות

רכיבים שונים שנוצרו מראש דורשים רמות שונות של אימות, ורמות גבוהות יותר דורשות יותר פרטי משתמש כדי לבצע אימות.

רכיב האימות מאפשר למשתמש לבצע אימות ברמה 0 (התאמת ANI), ברמה 1 (בסיסי) או ברמה 2 (אימות רב-שלבי), כפי שמתואר בטבלה הבאה:

רמת האימות דרישות
רמה 0: התאמה של ANI המשתמש מאומת באמצעות שיחה ממספר טלפון שתואם לחשבון רשום, או באמצעות הזנה של מספר כזה.

המשתמש יכול לבצע אימות לרמה 0 באמצעות הרכיב המובנה "ברכת שלום".
רמה 1: בסיסית מאמת את המשתמש באמצעות קוד סיסמה חד-פעמית (OTP) שנשלח לכתובת האימייל או למספר הטלפון שלו. אם האימות באמצעות OTP נכשל, המשתמש יכול לענות על שלוש מתוך ארבע שאלות אבטחה כדי לאמת את הזהות שלו: תאריך לידה, ארבע הספרות האחרונות של כרטיס החיוב המיידי או תאריך התפוגה של כרטיס האשראי (בהתאם לסוג החשבון או הכרטיס), סכום העסקה האחרונה ואמצעי התשלום האחרון של חשבון כרטיס האשראי.
רמה 2: אימות רב-שלבי בנוסף, מאמת את המשתמש על ידי אימות של מפתח אבטחה שנוצר על ידי אפליקציה לאימות חשבונות חיצונית או התראה.

סוגי המשתמשים הנתמכים

רכיב האימות תומך בלקוחות בנק רשומים שהם בעלי חשבון, בעלי כרטיס או שניהם. הרכיב תומך גם באימות של משתמשים שלא רשומים כלקוחות של הבנק, אבל יש להם ייפוי כוח לחשבונות שרשומים בבנק. למשתמש יכולים להיות חשבון אחד או יותר או כרטיסים שרשומים בבנק.

סוגי אימות

הרכיב הזה מאפשר לכם להגדיר אם המשתמש צריך לעבור אימות כבעל החשבון, כבעל הכרטיס או כשניהם. אפשר להגדיר את האפשרויות האלה באמצעות הפרמטרים של הקלט $session.params.account_auth_enabled ו-$session.params.card_auth_enabled.

בטבלה הבאה מתוארת ההתנהגות של הרכיב בשילובים שונים של ערכים בדגלי האימות של החשבון והכרטיס:

account_auth_enabled card_auth_enabled סוג אימות
true false המשתמש מאומת כבעל החשבון, ומוודא שיש לו חשבון אחד או יותר בבנק. בנוסף, הוא מאשר את שאלות האבטחה, כולל ארבע הספרות האחרונות של כרטיס החיוב המיידי הרשום.
false true המשתמש מאומת כמחזיק כרטיס, מאמת שהוא מחזיק בכרטיס אשראי אחד או יותר בבנק ומאשר שאלות אבטחה, כולל תאריך התפוגה של כרטיס אשראי רשום.
true true הרכיב בודק קודם אם המשתמש הוא בעל חשבון רשום. אם למשתמש יש חשבון אחד או יותר בבנק, הרכיב מאמת את המשתמש באמצעות פרטי החשבון. אם למשתמש אין חשבונות בבנק, הרכיב מנסה לאמת את המשתמש באמצעות פרטי בעל הכרטיס.
false false הרכיב בודק קודם אם המשתמש הוא בעל חשבון רשום. אם למשתמש יש חשבון אחד או יותר בבנק, הרכיב מאמת את המשתמש לאימות ברמה 0. אם למשתמש אין חשבונות בבנק, הרכיב בודק אם המשתמש הוא בעל כרטיס. אם למשתמש יש כרטיס אשראי אחד או יותר בבנק, הרכיב מאמת את המשתמש לאימות ברמה 0.

מגבלות

בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:

  • הסיסמאות החד-פעמיות נשלחות רק למספר טלפון נייד או לכתובת אימייל שנרשמו בעבר בחשבון. הרכיב לא משתמש ב-OTP כדי לאמת לקוחות שמתקשרים ממספר טלפון חלופי שלא רשום בחשבון שלהם. כשמתקשרים ממספר טלפון חלופי, שאלות האבטחה מאמתות את המשתמש.
  • הרכיב הזה לא מצפין נתונים.

דוגמאות לדו-שיח

בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.

אימות מוצלח ברמה 1: סיסמה חד-פעמית (OTP)

  1. הרכיב מוודא שהמשתמש אומת ברמה 0.
  2. הרכיב שולח סיסמה חד-פעמית לערוץ שהמשתמש בחר.
  3. הרכיב מבקש מהמשתמש לאשר את הסיסמה החד-פעמית.
  4. המשתמש מספק סיסמה חד-פעמית (OTP) תקינה כדי לאמת את רמה 1.
הטקסט של המשתמש התשובה של הסוכן
מטעמי אבטחה, אנחנו צריכים לאמת את הזהות שלך, ולכן נשלח לך קוד. איך אתם מעדיפים לקבל את הקוד, בטלפון או באימייל?
טלפון
שלחנו קוד למספר הטלפון הרשום שלך שמסתיים ב-0000. התהליך יכול להימשך כמה שניות. יש לך אפשרות לאשר את הקוד?
הקוד הוא 123457
תודה, האימות הסתיים בהצלחה.

אימות מוצלח ברמה 1: שאלות אבטחה

  1. הרכיב מאשר את האימות ברמה 0 של המשתמש על ידי איסוף ואימות של מספר הטלפון שסופק.
  2. הרכיב מבקש מהמשתמש לענות על שלוש שאלות אבטחה ומאמת את התשובות הנכונות, כולל תאריך הלידה, ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי של המשתמש וסכום העסקה האחרונה.
  3. המשתמש מאמת את הזהות שלו בהצלחה ברמה 1.
הטקסט של המשתמש התשובה של הסוכן
האם יש לך חשבון בבנק שלנו, או שיש לך ייפוי כוח? כדי לאשר, צריך להגיד "כן" או "לא".
כן
בסדר, אנחנו צריכים את מספר הטלפון שלך כדי לאחזר את פרטי החשבון.
הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש Telephone number collection.
הבנתי. המספר שציינת הוא פלוס 1 6502530000, נכון?
כן
מעולה, סיימנו לאסוף את מספר הטלפון.
אוקיי, מטעמי אבטחה נצטרך עוד מידע כדי לאמת את הזהות שלך.
הנציג אוסף את תאריך הלידה של המשתמש באמצעות הרכיב המוגדר מראש Date of birth collection.
אוקיי, תאריך הלידה שלך הוא 3 בפברואר 1995, נכון?
כן
מעולה, קיבלנו את תאריך הלידה שלך.
עכשיו צריך להזין את ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי.
It's 1234
מה היה הסכום של העסקה האחרונה שלך? לדוגמה, אם סכום העסקה האחרונה היה 100.30$, אומרים "100".
זה היה 500 דולר
תודה, האימות הסתיים בהצלחה.

אימות מוצלח ברמה 2: אימות דו-שלבי

  1. המשתמש כבר אומת בעבר ברמה 1.
  2. המשתמש יוצר מפתח אבטחה באמצעות אפליקציית הבנק או אפליקציה לאימות חשבונות.
  3. המשתמש מספק את מפתח האבטחה לרכיב כדי לאמת את רמה 2.
הטקסט של המשתמש התשובה של הסוכן
צריך לשתף את מפתח האבטחה.
יוצרים את מפתח האבטחה בן 6 הספרות באפליקציה של הבנק או באפליקציה לאימות חשבונות. לאחר מכן אומרים או מזינים את הספרות.
232425
תודה, האימות הסתיים בהצלחה.

הכחשת מידע

  1. המשתמש מסרב לספק את המידע שנדרש לאימות.
  2. הרכיב נסגר ומוצגת הודעת שגיאה.
הטקסט של המשתמש התשובה של הסוכן
מטעמי אבטחה, אנחנו צריכים לאמת את הזהות שלך, ולכן נשלח לך קוד. איך אתם מעדיפים לקבל את הקוד, בטלפון או באימייל?
לא, אני לא רוצה לשתף
בסדר, מטעמי אבטחה אנחנו צריכים עוד מידע כדי לאמת את הזהות שלך.
הנציג אוסף את תאריך הלידה של המשתמש באמצעות הרכיב המוגדר מראש Date of birth collection.
אוקיי, תאריך הלידה שלך הוא 3 בפברואר 1995, נכון?
כן
מעולה, קיבלנו את תאריך הלידה שלך.
עכשיו צריך להזין את ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי.
It's 1234
מה היה הסכום של העסקה האחרונה שלך? לדוגמה, אם סכום העסקה האחרונה היה 100.30$, אומרים "100".
אני לא רוצה לשתף את הפרטים
לא הצלחנו לאמת את הזהות שלך, ולכן אנחנו לא יכולים להשלים את הפעולה הזו. אנו מתנצלים על אי הנוחות.

מוסכמות למתן שמות

הרכיב הזה משתמש במוסכמות הבאות למתן שמות:

תכונה פורמט דוגמה
Flow [שם הרכיב] אימות
כוונה ספציפית לרכיב prebuilt_components_[component_name]_[intent_name] prebuilt_components_authentication_power_of_attorney
סוג ישות prebuilt_components_[component_name]_[entity_type] prebuilt_components_authentication_payment_mode
תגובה לפעולה מאתר אחר (webhook) prebuilt_components_[component_name]:[webhook_action] prebuilt_components_authentication:telephony_verification

פרמטרים של קלט

פרמטרים של קלט קובעים התנהגויות מסוימות של הרכיב. תנאי אחד או יותר בתהליך משתמשים בפרמטרים האלה כדי לקבוע את ההתנהגות של הרכיב. צריך להגדיר פרמטרים ברמת התהליך בדף הפתיחה של הרכיב. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך שיחה או בדף ההתחלה של הרכיב הזה.

הרכיב הזה מקבל את הפרמטרים הבאים:

שם הפרמטר תיאור פורמט הקלט
$session.params.auth_level (אופציונלי) מציין את רמת האימות הנוכחית של המשתמש. מספר שלם
$session.params.auth_level_req מגדירה את רמת האימות של המשתמש. הערכים התקינים הם 0,‏ 1 או 2. מספר שלם
$session.params.account_auth_enabled מציין אם המשתמש צריך לעבור אימות כבעל החשבון. ההתנהגות של הרכיב תלויה בערך הזה ובערך של $session.params.card_auth_enabled, כפי שמתואר בקטע רמות אימות. בוליאני
$session.params.card_auth_enabled מציין אם המשתמש צריך לעבור אימות כבעל הכרטיס. ההתנהגות של הרכיב תלויה בערך הזה ובערך של $session.params.account_auth_enabled, כפי שמתואר בקטע רמות אימות. בוליאני
‎$session.params.phone_number (אופציונלי) מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. אם לא תספקו את הפרמטר הזה, הרכיב יאסוף את מספר הטלפון מהמשתמש. מחרוזת
$flow.max_retry_telephone_counter מציינת את מספר הניסיונות החוזרים המותרים לאיסוף מספר הטלפון של המשתמש. ערך ברירת המחדל הוא 1. מספר שלם
$flow.max_retry_security_ans_count מציינת את מספר הניסיונות החוזרים המותרים כשמזינים תשובות לשאלות אבטחה. ערך ברירת המחדל הוא 3. מספר שלם
$flow.max_retry_security_key מציינת את מספר הניסיונות החוזרים המותרים כשמנסים לאסוף את מפתח האבטחה. ערך ברירת המחדל הוא 3. מספר שלם
$flow.max_retry_otp_not_received מציינת את מספר הניסיונות החוזרים המותרים כשלא מתקבלת סיסמה חד-פעמית (OTP). ערך ברירת המחדל הוא 1. מספר שלם
$flow.max_retry_otp_count מציינת את מספר הניסיונות החוזרים שמותרים כשמבקשים את הסיסמה החד-פעמית (OTP). ערך ברירת המחדל הוא 3. מספר שלם
$flow.security_ans_denial_count מציינת את מספר הניסיונות החוזרים המותרים כשמשתמש מסרב לספק את המידע המבוקש. ערך ברירת המחדל הוא 1. מספר שלם
$flow.security_ans_mid_count המדיניות הזו מציינת את מספר התשובות השגויות לשאלות האבטחה שמשתמש יכול לספק. ערך ברירת המחדל הוא 2, כלומר אם המתקשר מספק תשובות שגויות לשתי שאלות שונות, הרכיב יוצא עם כשל. מספר שלם
$flow.max_retry_card_counter מציין את מספר הניסיונות החוזרים המותרים כשמבקשים מהמשתמש להזין את ארבע הספרות האחרונות של כרטיס החיוב המיידי שלו. ערך ברירת המחדל הוא 2. מספר שלם
$flow.security_key_length המדיניות הזו מציינת את האורך התקין של מפתח האבטחה שסופק על ידי האפליקציה לאימות חשבונות עבור אימות ברמה 2. ערך ברירת המחדל הוא 6. מספר שלם
‎$flow.otp_length מציינת את האורך התקין של הסיסמה החד-פעמית (OTP) לאימות ברמה 1. ערך ברירת המחדל הוא 6. מספר שלם

כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה יצירה.
  5. לוחצים על הרכיב המיובא בקטע Flows.
  6. בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
  7. לוחצים על המסלול true בדף הפתיחה.
  8. בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
  9. לוחצים על Save.

פרמטרים של פלט

פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב.

הרכיב המוגדר מראש הזה מספק ערכים לפרמטרים הבאים של הפלט:

שם הפרמטר תיאור פורמט הפלט
auth_level מציין את רמת האימות הנוכחית של המשתמש. מספר שלם
phone_number מספר הטלפון המקומי שהמשתמש סיפק, בלי קוד המדינה. מחרוזת
transfer_reason הפרמטר הזה מציין את הסיבה ליציאה מהתהליך, אם הוא לא הושלם בהצלחה. הערך שמוחזר הוא אחד מהבאים:

agent: המשתמש ביקש נציג אנושי בשלב כלשהו במהלך השיחה.

denial_of_information: המשתמש סירב לשתף מידע שהרכיב ביקש.

max_no_input: השיחה הגיעה למספר המקסימלי של ניסיונות חוזרים לאירועים ללא קלט. אפשר לעיין באירועים מובנים ללא קלט.

max_no_match: השיחה הגיעה למספר המקסימלי של ניסיונות חוזרים לאירועים ללא התאמה. אפשר לעיין באירועים מובנים ללא התאמה.

webhook_error: אירעה שגיאת webhook. אפשר לעיין באירוע המובנה webhook.error. ‫

webhook_not_found: לא הייתה גישה לכתובת URL של webhook. אפשר לעיין באירוע המובנה webhook.error.not-found.
מחרוזת

הגדרה בסיסית

כדי להגדיר את הרכיב המוכן מראש:

  1. מייבאים את הרכיב המוגדר מראש.
  2. מגדירים את ה-webhooks הגמישים שסופקו עם הגדרות שמתארות את השירותים החיצוניים. מידע נוסף זמין בקטע הגדרת תגובה לפעולה מאתר אחר (Webhook).

הגדרת תגובה לפעולה מאתר אחר (webhook)

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

אימות טלפוני

ה-webhook‏ prebuilt_components_authentication:telephony_verification משמש את הרכיב כדי לאחזר את פרטי חשבון המשתמש על סמך מספר הטלפון שסופק.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. מחרוזת

פרמטרים של תגובה מה-API

הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר תיאור פורמט הפלט
account_count מספר החשבונות שמשויכים למספר הטלפון הרשום. החשבונות האלה כוללים חשבונות עצמיים וחשבונות שלמשתמש יש ייפוי כוח לגביהם. מספר שלם
last_four_digit_of_account_number אם למשתמש יש חשבון אחד, יוחזרו ארבע הספרות האחרונות של מספר החשבון. אם למשתמש יש יותר מחשבון אחד, הערך של הפרמטר הזה הוא null. מחרוזת
אימייל כתובת האימייל שרשומה בחשבון. אם אין כתובת אימייל שרשומה בחשבון, הערך של הפרמטר הזה הוא null. מחרוזת

כדי להגדיר את ה-webhook לאימות טלפוני ברכיב הזה, צריך להרחיב את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_authentication:telephony_verification.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

קבלת פרטי כרטיס אשראי

הרכיב משתמש ב-webhook של prebuilt_components_account_services:get_credit_card_details כדי לאחזר מידע על כרטיסי האשראי שרשומים למשתמש.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. מחרוזת

פרמטרים של תגובה מה-API

הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר תיאור פורמט הפלט
credit_card_count מספר כרטיסי האשראי שמשויכים למספר הטלפון הרשום. מספר שלם
last_four_digit_of_credit_card_number אם למשתמש יש כרטיס אשראי אחד, יוחזרו ארבע הספרות האחרונות של מספר הכרטיס. אם למשתמש יש כמה כרטיסי אשראי, הערך של הפרמטר הזה הוא null. מחרוזת
אימייל כתובת האימייל שרשומה בחשבון. אם אין כתובת אימייל שרשומה בחשבון, הערך של הפרמטר הזה הוא null. מחרוזת

כדי להגדיר את ה-webhook "קבלת פרטי כרטיס אשראי" לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_account_services:get_credit_card_details.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

שליחת סיסמה חד-פעמית (OTP)

ה-webhook של prebuilt_components_authentication:send_otp שולח סיסמה חד-פעמית (OTP) לערוץ רשום שאתם בוחרים.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. מחרוזת
$flow.channel הערוץ שהמשתמש בחר לקבל בו את הסיסמה החד-פעמית. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_authentication_channel. כברירת מחדל, יש תמיכה ב-email וב-mobile. מחרוזת

פרמטרים של תגובה מה-API

הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר תיאור פורמט הפלט
generated_otp הערך של ה-OTP שנוצר ונשלח למשתמש בערוץ שנבחר. מחרוזת

כדי להגדיר את ה-webhook של שליחת OTP לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_authentication:send_otp.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

תשובות לשאלות אבטחה

ה-webhook של prebuilt_components_authentication:security_answers מאחזר את התשובות לשאלות האבטחה של המשתמש מהחשבון הרשום שלו.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, בלי קוד המדינה, שמשמש לזיהוי החשבון של המשתמש. מחרוזת

פרמטרים של תגובה מה-API

הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר תיאור פורמט הפלט
security_last_trans_amount מציין את הסכום המלא של העסקה האחרונה של המשתמש, ללא סמל מטבע. לדוגמה, אם סכום העסקה האחרונה של המשתמש הוא 100.30 דולר ארה"ב, הערך הצפוי של השדה הזה הוא "100.30". מחרוזת
last_payment_mode אמצעי התשלום ששימש לעסקה האחרונה של המשתמש, עם ערכים חוקיים שמוגדרים על ידי הישות המותאמת אישית prebuilt_components_authentication_payment_mode. כברירת מחדל, הערכים האלה כוללים את mobile,‏ upi,‏ online,‏ debit,‏ credit ו-account. מחרוזת
security_card_number ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי של המשתמש. מחרוזת
user_dob תאריך הלידה של המשתמש בפורמט YYYY-MM-DD. מחרוזת
cards_exp_date_all תאריכי התפוגה של כל כרטיסי האשראי שרשומים אצל המשתמש בפורמט MMYYYY. רשימה (מחרוזת)

כדי להגדיר את ה-webhook של Security answers לרכיב הזה, צריך להרחיב את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_authentication:security_answers.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

אימות דו-שלבי

ה-webhook של prebuilt_components_authentication:2fa_validation מאפשר לרכיב לאמת את מפתח האבטחה שהמשתמש סיפק לאימות דו-שלבי.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, בלי קוד המדינה, שמשמש לזיהוי החשבון של המשתמש. מחרוזת
$flow.security_key מפתח האבטחה שהמשתמש סיפק, שנוצר באמצעות אפליקציה של בנק או אפליקציה לאימות חשבונות. מחרוזת

פרמטרים של תגובה מה-API

הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר תיאור פורמט הפלט
security_key_verified מציין אם מפתח האבטחה שהמשתמש סיפק תקין. true מציין שמפתח האבטחה שסופק תקין. השגיאה false מציינת שמפתח האבטחה שסופק לא תקין. בוליאני

כדי להגדיר את ה-webhook לאימות דו-שלבי ברכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_authentication:2fa_validation.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

הושלמה

הרכיב שהוגדר מראש וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.