פתרון בעיות בשילוב של Identity Platform עם reCAPTCHA Enterprise API

במסמך הזה מוסבר איך לפתור בעיות שעשויות לצוץ כשמשתמשים בשילוב של Identity Platform עם reCAPTCHA Enterprise API, כולל התכונות "הגנה מפני בוטים" ו"הגנה על סמס" של reCAPTCHA.

פתרון בעיות בתהליך ההצטרפות וההטמעה

יכול להיות שהמשתמשים נתקלים בבעיות בגלל טעויות בהגדרת השילוב של Identity Platform עם reCAPTCHA Enterprise API. הנה כמה סיבות נפוצות:

  • יכול להיות שפספסתם שלב בהגדרה של שילוב Identity Platform עם reCAPTCHA Enterprise API. לדוגמה, אם לא הגדרתם את חשבון השירות או לא הפעלתם את reCAPTCHA Enterprise API בפרויקט. מוודאים שהשלמתם את כל דרישות השילוב. הוראות להגדרה מופיעות במאמר שילוב של Identity Platform עם reCAPTCHA Enterprise API.
  • אם אתם משתמשים במפתח משלכם ב-reCAPTCHA, יכול להיות שמפתח reCAPTCHA התואם שהעליתם לא תקין או הפסיק לפעול. מוודאים שהמפתח פועל ושל-Identity Platform יש גישה אליו.
  • יכול להיות שהמשתמשים משתמשים בגרסה מיושנת של האפליקציה. ודאו שאתם מספקים גרסה מעודכנת של האפליקציה שמשתמשת ב-SDK של הלקוח, ובקשו מהמשתמשים לעדכן את האפליקציה. כדי להגדיר את ה-SDK של הלקוח לאפליקציה, עיינו במאמר הגדרת ה-SDK של הלקוח.

המשתמשים לא יכולים לבצע אימות באמצעות תהליכים שנתמכים ב-reCAPTCHA Enterprise API

אם נתקלתם בבעיות בתהליכים שנתמכים על ידי reCAPTCHA Enterprise API, כמו הגנה מפני בוטים של reCAPTCHA או הגנה על סמס של reCAPTCHA, עיינו בקטעים הבאים לקבלת הנחיות ספציפיות לתכונות.

פתרון בעיות בהגנה מפני בוטים של reCAPTCHA

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

המשתמשים לא יכולים לבצע אימות כשהם משתמשים בהגנה מפני בוטים לספקי האימייל והסיסמה או הטלפון

אם בדקתם שהשילוב של Identity Platform עם reCAPTCHA Enterprise API הוגדר בצורה נכונה, יכול להיות שהמשתמשים לא יכולים לבצע פעולות אימות דרך ספקי האימייל והסיסמה או הטלפון, בהתאם להגדרות הנוכחיות שלכם. לדוגמה, יכול להיות שהמשתמשים לא יוכלו לבצע את הפעולות הבאות:

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

כדי לפתור את בעיות האימות האלה, נסו את הפתרונות הבאים:

  • אם בקשות של משתמשים נכשלות עם ERROR_CAPTCHA_CHECK_FAILED, כדאי לשקול הגדרה פחות מחמירה על ידי שינוי ערכי הסף שהגדרתם ל-managedRules. כל בקשה שהניקוד שלה נמוך מהסף שהגדרתם תיחשב כבוט. לדוגמה, אם מגדירים סף של 0.6, שירות reCAPTCHA ידחה כל בקשה עם ציון של 0.5 או פחות. לכן, ככל שתגדירו ציון גבוה יותר, כך הכללים יהיו מחמירים יותר.
  • מבקשים מהמשתמש לנסות מכשיר, דפדפן או רשת אחרים.
  • בתהליכי אימות של אימייל וסיסמה, צריך להחזיר את emailPasswordEnforcementState למצב AUDIT ולעקוב אחרי המדדים לפני שמפעילים מחדש את מצב ENFORCE.
  • בתהליכי אימות של טלפונים, צריך לשנות את ערכי הסף של הניקוד ב-managedRules או להשבית את ההגנה מפני בוטים אצל ספק הטלפון בזמן פתרון הבעיות. אם גם ההגנה על סמס של reCAPTCHA מופעלת ואתם רוצים להשאיר אותה פעילה, מגדירים את useSmsBotScore לערך false ומשאירים את phoneEnforcementState בערך ENFORCE. כדי להשבית את כל ההגנות של reCAPTCHA בטלפון, מגדירים את phoneEnforcementState ל-OFF, את useSmsBotScore ל-false ואת useSmsTollFraudProtection ל-false.

פתרון בעיות בהגנה על סמס ב-reCAPTCHA

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

המשתמשים לא יכולים לבצע אימות כשהם משתמשים בהגנה על סמס של reCAPTCHA לספק הטלפון

אם בדקתם שהשילוב של Identity Platform עם reCAPTCHA Enterprise API הוגדר בצורה נכונה, יכול להיות שהמשתמשים לא יכולים לבצע פעולות אימות שמבוססות על SMS דרך ספק הטלפון, בהתאם להגדרות הנוכחיות שלכם. לדוגמה, יכול להיות שהמשתמשים לא יוכלו לבקש קוד ב-SMS כדי להיכנס באמצעות מספר טלפון, או להירשם לאימות רב-שלבי או להיכנס באמצעותו. זה יכול לקרות אם הניקוד שהגדרתם להגנה על סמס ב-reCAPTCHA מחמיר מדי.

כדי לפתור את הבעיה, כדאי לשקול הגדרה פחות מחמירה על ידי שינוי הסף שהגדרתם ל-tollFraudManagedRules. כל ניקוד שגבוה מהסף שהגדרתם ייחשב להונאת תשלום קבוע ב-SMS. לדוגמה, אם מגדירים סף של 0.3, בקשות עם ציון של 0.4 ומעלה ייכשלו ב-reCAPTCHA. לכן, ככל שהניקוד שתגדירו יהיה נמוך יותר, כך הכללים יהיו מחמירים יותר.

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

המאמרים הבאים