כדי להחריג כתובות IP מהימנות מאכיפת reCAPTCHA, צריך ליצור רשימת היתרים למפתח reCAPTCHA שמשויך לאתר. לאחר מכן, מוסיפים את כתובות ה-IP ואת רשתות המשנה לרשימת ההיתרים הזו.
אפשר גם להסיר כתובות IP או רשתות משנה מרשימת ההיתרים ולראות את כתובות ה-IP ואת רשתות המשנה ברשימת ההיתרים.
לפני שמתחילים
לפני שמתחילים, חשוב לבצע את הפעולות הבאות:
אוספים את כל כתובות ה-IP ורשתות המשנה שרוצים להוסיף לרשימת ההיתרים.
מזהים את כתובות ה-IP ואת רשתות המשנה שרוצים להסיר מהרשימה הלבנה.
חשוב לוודא שהוקצה לכם התפקיד הבא בניהול זהויות והרשאות גישה (IAM): אדמין של reCAPTCHA Enterprise (
roles/recaptchaenterprise.admin).
הוספת כתובת IP או רשת משנה לרשימת ההיתרים
כשמוסיפים כתובת IP או רשת משנה לרשימת ההיתרים, reCAPTCHA מדלג על האימות ונותן תמיד ציון של 0.9 לבקשות שמגיעות מכתובת ה-IP או מהרשת המשנה האלה.
אפשר להוסיף עד 1,000 כתובות IP ורשתות משנה לרשימת ההיתרים.
gcloud
במסוף Google Cloud , מפעילים את Cloud Shell.
בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- 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 המותרות פועלת כמצופה, מבצעים את השלבים הבאים:
מוודאים שהוספתם את כתובת ה-IP או את רשת המשנה לרשימת ההיתרים של מפתח reCAPTCHA הספציפי.
מתחילים עסקה מלאה של reCAPTCHA ממכונה או מסביבה שמשתמשת בכתובת ה-IP שמופיעה ברשימת ההיתרים.
בודקים את תוצאת ההערכה. אם הרשימה הלבנה פעילה עבור כתובת ה-IP שממנה מגיעה הבקשה, הערך של
riskAnalysis.scoreבתגובת ה-JSON הוא0.9.
הסרת כתובת IP או תת-רשת מרשימת ההיתרים
gcloud
במסוף Google Cloud , מפעילים את Cloud Shell.
בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- 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
במסוף Google Cloud , מפעילים את Cloud Shell.
בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- 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": ""
}