הגדרה של רשימת היתרים של כתובות IP

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

אפשר גם להסיר כתובות IP או רשתות משנה מרשימת ההיתרים ולראות את כתובות ה-IP ואת רשתות המשנה ברשימת ההיתרים.

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

לפני שמתחילים, חשוב לוודא שביצעתם את הפעולות הבאות:

  • אוספים את כל כתובות ה-IP ורשתות המשנה שרוצים להוסיף לרשימת ההיתרים.

  • מזהים את כתובות ה-IP ורשתות המשנה שרוצים להסיר מרשימת ההיתרים.

  • חשוב לוודא שיש לכם את התפקיד הבא בממשק של ניהול זהויות והרשאות גישה (IAM): אדמין ב-reCAPTCHA Enterprise‏ (roles/recaptchaenterprise.admin).

הוספת כתובת IP או רשת משנה לרשימת ההיתרים

כשמוסיפים כתובת IP או רשת משנה לרשימת ההיתרים, Fraud Defense מדלגת על האימות ונותנת תמיד ציון של 0.9 לבקשות שמגיעות מכתובת ה-IP או מהרשת המשנה האלה. אפשר להוסיף לרשימת ההיתרים עד 1,000 כתובות IP ורשתות משנה.

gcloud

  1. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

    בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

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

    • ‫KEY: מפתח reCAPTCHA שמשויך לאתר שלכם.
    • ‫IP_ADDRESS_OR_SUBNET: כתובת ה-IP או רשת המשנה שצריך להוסיף לרשימת ההיתרים.

    מריצים את הפקודה הבאה:

    ‫Linux,‏ macOS או Cloud Shell

    gcloud recaptcha keys add-ip-override
KEY \
--ip=IP_ADDRESS_OR_SUBNET \
--override=ALLOW

    ‏Windows (PowerShell)

    gcloud recaptcha keys add-ip-override
KEY `
--ip=IP_ADDRESS_OR_SUBNET `
--override=ALLOW

    Windows‏ (cmd.exe)

    gcloud recaptcha keys add-ip-override
KEY ^
--ip=IP_ADDRESS_OR_SUBNET ^
--override=ALLOW

REST

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

  • ‫KEY: מפתח reCAPTCHA שמשויך לאתר שלכם.
  • ‫IP_ADDRESS_OR_SUBNET: כתובת ה-IP או רשת המשנה שצריך להוסיף לרשימת ההיתרים.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

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

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride

גוף בקשת JSON: 


{
  "ip_override_data": {
    "ip": "IP_ADDRESS_OR_SUBNET",
    "override_type": "ALLOW"
  }
}

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

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/projects/PROJECT_ID/keys/KEY:addIpOverride"

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/projects/PROJECT_ID/keys/KEY:addIpOverride" | Select-Object -Expand Content

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

אחרי שמוסיפים כתובת IP או רשת משנה לרשימת ההיתרים, השינויים נכנסים לתוקף תוך כמה דקות.

אימות ההגדרות של רשימת ההיתרים

כדי לוודא שרשימת ההיתרים של כתובות ה-IP פועלת כמו שצריך, מבצעים את הפעולות הבאות:

  1. מוודאים שהוספתם את כתובת ה-IP או את רשת המשנה לרשימת ההיתרים של מפתח reCAPTCHA הספציפי.

  2. מפעילים עסקה מלאה ב-Fraud Defense ממכונה או מסביבה שמשתמשת בכתובת ה-IP שברשימת ההיתרים.

  3. בודקים את תוצאת ההערכה. אם רשימת ההיתרים פעילה לכתובת ה-IP שממנה נשלחה הבקשה, הערך של riskAnalysis.score בתגובת ה-JSON הוא 0.9.

הסרת כתובת IP או רשת משנה מרשימת ההיתרים

gcloud

  1. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

    בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

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

    • ‫KEY: מפתח reCAPTCHA שמשויך לאתר שלכם.
    • ‫IP_ADDRESS_OR_SUBNET: כתובת ה-IP או רשת המשנה שצריך להוסיף לרשימת ההיתרים.

    מריצים את הפקודה הבאה:

    ‫Linux,‏ macOS או Cloud Shell

    gcloud recaptcha keys remove-ip-override
KEY \
--ip=IP_ADDRESS_OR_SUBNET \
--override=ALLOW

    ‏Windows (PowerShell)

    gcloud recaptcha keys remove-ip-override
KEY `
--ip=IP_ADDRESS_OR_SUBNET `
--override=ALLOW

    Windows‏ (cmd.exe)

    gcloud recaptcha keys remove-ip-override
KEY ^
--ip=IP_ADDRESS_OR_SUBNET ^
--override=ALLOW

REST

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

  • ‫KEY: מפתח reCAPTCHA שמשויך לאתר שלכם.
  • ‫IP_ADDRESS_OR_SUBNET: כתובת ה-IP או רשת המשנה שצריך להוסיף לרשימת ההיתרים.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

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

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride

גוף בקשת JSON: 


{
  "ip_override_data": {
    "ip": "IP_ADDRESS_OR_SUBNET",
    "override_type": "ALLOW"
  }
}

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

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/projects/PROJECT_ID/keys/KEY:removeIpOverride"

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/projects/PROJECT_ID/keys/KEY:removeIpOverride" | Select-Object -Expand Content

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

אחרי שמסירים כתובת IP או רשת משנה מרשימת ההיתרים, השינויים מתעדכנים תוך כמה דקות.

רשימה של כל כתובות ה-IP מרשימת ההיתרים

gcloud

  1. מפעילים את Cloud Shell במסוף Google Cloud .

    הפעלת Cloud Shell

    בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

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

    • ‫KEY: מפתח reCAPTCHA שמשויך לאתר שלכם.

    מריצים את הפקודה הבאה:

    ‫Linux,‏ macOS או Cloud Shell

    gcloud recaptcha keys list-ip-overrides KEY --format=json

    ‏Windows (PowerShell)

    gcloud recaptcha keys list-ip-overrides KEY --format=json

    Windows‏ (cmd.exe)

    gcloud recaptcha keys list-ip-overrides KEY --format=json

REST

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

  • ‫KEY: מפתח reCAPTCHA שמשויך לאתר שלכם.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

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

GET https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides

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

curl

מריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides"

PowerShell

מריצים את הפקודה הבאה: 

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:


{
  "ipOverrides": [
    {
      "ip": "1.2.3.4",
      "overrideType": "ALLOW"
    }
  ],
  "nextPageToken": ""
}

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