הוספת הערות למבדקים

בדף הזה מוסבר איך אפשר לשלוח משוב על רמת הדיוק של ההערכות שנוצרות על ידי Google Cloud Fraud Defense. בעזרת המידע הזה, Fraud Defense יכול לכוונן את המודל הספציפי לאתר ולשפר את הביצועים של האתר לאורך זמן.

מתי כדאי להוסיף הערות להערכות

Fraud Defense מספק ניקוד כשיוצרים הערכה, כדי לעזור לכם להבין את רמת הסיכון שנובעת מאינטראקציות של משתמשים. בהמשך, כשיש באתר יותר מידע על אינטראקציות של משתמשים כדי לקבוע אם האינטראקציה הייתה לגיטימית או שמקורה בתרמית, אתם יכולים לאשר או לתקן את ההערכה של reCAPTCHA. כדי לעשות זאת, שולחים את מזהי בדיקת reCAPTCHA בחזרה אל Google עם התווית LEGITIMATE או FRAUDULENT. אישור או תיקון של ההערכה של reCAPTCHA משפרים את הביצועים של Fraud Defense באתר שלכם.

כדי לשפר את הביצועים של Fraud Defense, אפשר לאשר את ההערות לגבי תוצאות חיוביות אמיתיות ותוצאות שליליות אמיתיות בנוסף להערות לגבי שגיאות אפשריות בהערכה. לדוגמה, אם משתמש עבר אימות באמצעות שיטת אימות דו-שלבי וקיבל ציון גבוה ב-reCAPTCHA, אפשר להוסיף הערה לבדיקה ולציין שהיא LEGITIMATE. לחלופין, אם הציון של Google Cloud Fraud Defense היה נמוך והאתר קבע שהאינטראקציה הייתה הונאה או התנהלות פוגעת, אפשר להוסיף הערה להערכה כFRAUDULENT.

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

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

לפני שמתחילים

אחזור של מזהה ההערכה

כדי להוסיף הערה להערכה, מאחזרים את מזהה ההערכה הייחודי באחת מהדרכים הבאות:

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

    אחרי שיוצרים הערכה, מקבלים תגובת JSON כמו בדוגמה הבאה.

    מאחזרים את מזהה ההערכה הייחודי מהשדה name בתגובת ה-JSON.

    {
'tokenProperties': {
  'valid': True,
  'hostname': 'www.google.com',
  'action': 'homepage',
  'createTime': u'2019-03-28T12:24:17.894Z'
},
'riskAnalysis': {
  'score': 0.1,
  'reasons': ['AUTOMATION']
},
'event': {
  'token': 'RESPONSE_TOKEN',
  'siteKey': 'KEY_ID'
},
'name': 'ASSESSMENT_ID'
}

  • בשילובים של WAF, אפשר לאחזר את מזהה ההערכה הייחודי מהאסימון של reCAPTCHA. מזהה ההערכה הייחודי הוא מחרוזת אלפאנומרית ייחודית בת 16 תווים שמופיעה בסוף טוקן reCAPTCHA אחרי :U=. לדוגמה, אם טוקן ה-reCAPTCHA הוא .................U=6ZZZZe73fZZZZZZ0, מזהה הבדיקה הוא 6ZZZZe73fZZZZZZ0.

הוספת הערות למטלה

  1. מחליטים איזה מידע ותוויות להוסיף לגוף בקשת ה-JSON, בהתאם לתרחיש לדוגמה.

    בטבלה הבאה מפורטות התוויות והערכים שאפשר להשתמש בהם כדי להוסיף הערות לאירועים:

    תווית תיאור דוגמה לבקשה
    reasons זה שינוי אופציונלי. תווית שתעזור לכם בבדיקות.

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

    רשימת הערכים האפשריים מופיעה במאמר ערכי הסיבות.

    דוגמה: כדי לזהות השתלטות על חשבון, מוסיפים הערה אם הסיסמה שהוזנה הייתה נכונה עם הערכים CORRECT_PASSWORD או INCORRECT_PASSWORD. אם פרסתם אימות רב-שלבי משלכם, אתם יכולים להוסיף את הערכים הבאים: INITIATED_TWO_FACTOR, וגם PASSED_TWO_FACTOR או FAILED_TWO_FACTOR. 

          {
      "reasons": ["INCORRECT_PASSWORD"]
      }
    annotation זה שינוי אופציונלי. תווית שמציינת את הלגיטימיות של ההערכות.

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

    ערכים אפשריים: LEGITIMATE או FRAUDULENT.

    אפשר לשלוח את המידע הזה בכל שלב או כחלק ממשימה באצווה. עם זאת, מומלץ לשלוח את המידע הזה תוך כמה שניות או דקות אחרי האירוע, כי הוא משפיע על הזיהוי בזמן אמת.

    		 
          {
       "annotation": "LEGITIMATE"
      }

  2. אפשר להוסיף הערה להערכה באמצעות השיטה projects.assessments.annotate עם ה-CLI של gcloud או מפתח API.

    ‫CLI של gcloud

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫ASSESSMENT_ID: הערך של השדה name שהוחזר מהקריאה ל-projects.assessments.create.
    • ‫ANNOTATION_LABEL: התווית שמציינת אם ההערכה לגיטימית או שמדובר בהונאה. הערכים האפשריים הם LEGITIMATE או FRAUDULENT.
    • ‫ANNOTATION_REASON: תיאור ההקשר של ההערה שנבחרה להערכה הזו. מידע על הערכים האפשריים זמין במאמר הסיבות להוספת הערות להערכה.

    ה-method של ה-HTTP וכתובת ה-URL: 

    POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate

    גוף בקשת JSON: 

    {
"annotation": "ANNOTATION_LABEL"
"reasons": "ANNOTATION_REASON"
}

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    curl

    שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate"

    PowerShell

    שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate" | Select-Object -Expand Content

    אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

    מפתח API

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫ASSESSMENT_ID: הערך של השדה name שמוחזר מהקריאה projects.assessments.create
    • ‫ANNOTATION_LABEL: התווית שמציינת אם הבדיקה לגיטימית או שמקורה בתרמית. הערכים האפשריים הם LEGITIMATE או FRAUDULENT.
    • ‫ANNOTATION_REASON: תיאור ההקשר של ההערה שנבחרה להערכה הזו. כדי לקבל מידע על הערכים האפשריים, קראו את המאמר סיבות להוספת הערות להערכה.

    ה-method של ה-HTTP וכתובת ה-URL: 

    POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments/ASSESSMENT_ID:annotate?key=API_KEY

    גוף בקשת JSON: 

    {
"annotation": "ANNOTATION_LABEL"
"reasons": "ANNOTATION_REASON"
}

    כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

    curl

    שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

    curl -X POST \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments/ASSESSMENT_ID:annotate?key=API_KEY"

    PowerShell

    שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

    $headers = @{  }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments/ASSESSMENT_ID:annotate?key=API_KEY" | Select-Object -Expand Content

    אתם אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

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