העברה מ-reCAPTCHA Classic

במאמר הזה נסביר איך להעביר מפתח אתר פעיל מגרסה קלאסית של reCAPTCHA ל-reCAPTCHA בGoogle Cloud פרויקט. אפשר להעביר את מפתח האתר באמצעות מסוף הניהול של reCAPTCHA (מומלץ) או באמצעות מסוף Google Cloud . תהליך ההעברה נמשך 5-10 דקות ולא דורש שינויים בקוד.

אם אתם מנהלים את המפתחות במסוף Admin של reCAPTCHA, אתם משתמשים ב-reCAPTCHA Classic. התכונות החדשות של reCAPTCHA זמינות רק למפתחות אתרים שמנוהלים בפרויקט ב- Google Cloud . מידע נוסף על התכונות הזמינות מופיע במאמר השוואה בין רמות reCAPTCHA.

אחרי שתשלימו את תהליך ההעברה, יחולו השינויים הבאים:

• מפתחות האתר שלכם זמינים ב Google Cloud פרויקט בלי לבצע שינויים.
• השילוב הקיים של reCAPTCHA ממשיך לפעול בלי שצריך לשנות את הקוד. אפשר לשמור את אותם כלי מדידה בדף האינטרנט ואת אותן קריאות לשרת. עם זאת, כדי לגשת לתכונות כמו "הגנה על החשבון" או "הגנה על הסיסמה", צריך לשנות את כלי המדידה של דף האינטרנט ואת הקריאות לקצה העורפי. מידע נוסף זמין במאמר שימוש בתכונות של reCAPTCHA אחרי ההעברה.
• החיוב יתבצע כשתחרגו מהמכסה החודשית החינמית של reCAPTCHA, שהיא 10,000 בדיקות בחודש. מידע נוסף זמין במאמר פרטי חיוב.

הערה: אי אפשר להעביר מפתחות Android של reCAPTCHA גרסה 2.

מעבר באמצעות מסוף Admin של reCAPTCHA

1. נכנסים למסוף Admin של reCAPTCHA.

   כניסה למסוף Admin של reCAPTCHA

2. בוחרים את הפרויקט שאליו רוצים להעביר את המפתחות.

3. בוחרים את המפתחות שרוצים להעביר.

4. לוחצים על שליחה.

המסוף Google Cloud ייפתח עם הפרויקט והמפתחות שהועברו.

הערה: כדי לפתור בעיות בהעברה, אפשר לעיין במאמר בנושא פתרון בעיות בהעברה.

העברה באמצעות מסוף Google Cloud

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

חשוב: אחרי שמבצעים מיגרציה של מפתח reCAPTCHA לפרויקטGoogle Cloud , אי אפשר להעביר אותו לפרויקטGoogle Cloud אחר. חשוב לוודא שבוחרים את פרויקט היעד הנכון למפתחות.

1. בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

   תפקידים שנדרשים כדי לבחור או ליצור פרויקט

   • Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
   • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

   כניסה לדף לבחירת הפרויקט

2. מוודאים שהחיוב מופעל בפרויקט Google Cloud .

   כדי להעביר את reCAPTCHA, צריך לקשר את החיוב ולהפעיל אותו בפרויקט. אפשר להפעיל את החיוב באמצעות כרטיס אשראי או מספר לקוח לחיוב של פרויקט קיים Google Cloud . אם אתם צריכים עזרה בנושא חיוב, אתם יכולים לפנות אל התמיכה בנושאי חיוב ב-Cloud.

3. כדי להריץ את ה-CLI של gcloud מחוץ למסוף Google Cloud , צריך להתקין ולהפעיל את ה-CLI של gcloud. הוראות מפורטות מופיעות במאמרים הבאים:

   התקינו את ה-CLI של Google Cloud. אחר כך, מאתחלים את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

   gcloud init

   אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

הפעלת reCAPTCHA Enterprise API

כל רמות השירות של reCAPTCHA‏ (Essentials,‏ Premium ו-Enterprise) פועלות על reCAPTCHA Enterprise API.

המסוף

1. במסוף Google Cloud , נכנסים לדף reCAPTCHA Enterprise API.

   מעבר אל reCAPTCHA Enterprise API

2. מוודאים ששם הפרויקט מופיע בבורר הפרויקטים בחלק העליון של הדף.

   אם שם הפרויקט לא מופיע, לוחצים על בורר הפרויקטים ובוחרים את הפרויקט.

3. לוחצים על Enable.

gcloud

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

   הפעלת Cloud Shell

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

2. כדי להגדיר את הפרויקט Google Cloud בסשן של gcloud, מריצים את הפקודה gcloud config set project. מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

          gcloud config set project PROJECT_ID
          

3. כדי להפעיל את reCAPTCHA Enterprise API, מריצים את הפקודה gcloud services enable:

            gcloud services enable recaptchaenterprise.googleapis.com
          

4. כדי לוודא ש-reCAPTCHA Enterprise API מופעל, מריצים את הפקודה gcloud services list:

            gcloud services list --enabled
          

   מוודאים ש-reCAPTCHA Enterprise API מופיע ברשימת ממשקי ה-API שמופעלים.

מעבר ל-reCAPTCHA

כדי להעביר את reCAPTCHA Classic ל-reCAPTCHA, בוחרים מפתח אתר פעיל ממסוף הניהול של reCAPTCHA ומעבירים את מפתח האתר. אפשר להעביר מפתח אתר פעיל אחד או יותר. עם זאת, אפשר להעביר רק מפתח אתר אחד בכל פעם.

כדי להריץ את תהליך ההעברה, צריך חשבון משתמש ב-reCAPTCHA שעומד בדרישות הבאות:

• במסוף Admin של reCAPTCHA, חשבון המשתמש רשום כבעלים של מפתח האתר שרוצים להעביר.
• לחשבון המשתמש יש אחד מהתפקידים הבאים ב-IAM בפרויקט Google Cloud שבו מופעל reCAPTCHA Enterprise API:
  • בעלי הפרויקט (roles/owner)
  • עריכת פרויקטים (roles/editor)
  • אדמין של reCAPTCHA‏ (roles/recaptchaenterprise.admin)
  אם לא הוקצה לחשבון המשתמש שלכם אחד מהתפקידים האלה, בקשו מהאדמין להקצות את התפקיד, או פעלו לפי ההוראות במאמר הענקה, שינוי וביטול הגישה.

1. מעבירים את מפתח האתר באמצעות מסוף Google Cloud , ‏Google Cloud CLI או reCAPTCHA Enterprise API.

   העברת מפתח האתר לא משפיעה על המפתח או על נקודות קצה ל-API, אלא מוסיפה את המפתח לרישיון הארגוני.

   מסוף Google Cloud

   1. נכנסים לדף reCAPTCHA במסוף Google Cloud .

      כניסה ל-reCAPTCHA

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

   3. לוחצים על הכרטיסייה Keys (מפתחות).

   4. בקטע Classic keys, מזהים את המפתח שרוצים להעביר ולוחצים על Upgrade key.

      

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

   ‫CLI של gcloud

   1. כדי להגדיר אימות, מריצים את הפקודה הבאה של gcloud:

      gcloud auth login
      

      מתחברים לחשבון המשתמש ב-reCAPTCHA שהוא הבעלים של מפתח האתר שנבחר, ושיש לו אחד מהתפקידים הבאים: בעלי הפרויקט, עריכת פרויקט או אדמין של reCAPTCHA Enterprise.

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

      1. נכנסים למסוף Admin של reCAPTCHA ולוחצים על .

      2. בוחרים מפתח אתר. אפשר להעביר את מפתחות האתרים הבאים של reCAPTCHA: תיבת סימון של reCAPTCHA גרסה 2, reCAPTCHA גרסה 2 בלתי נראה ו-reCAPTCHA גרסה 3.

      3. כדי להעתיק את מפתח האתר, לוחצים על העתקת מפתח האתר.

   3. מעבירים את מפתח האתר.

      משתמשים בפקודה gcloud recaptcha keys migrate, כמו בדוגמה הבאה:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      מספקים את הערכים הבאים:

      • ‫SITE_KEY: מפתח האתר הפעיל שהעתקתם ממסוף הניהול של reCAPTCHA.
      • ‫PROJECT-ID: המזהה של Google Cloud הפרויקט שבו מופעל reCAPTCHA Enterprise API.

   ‫API בארכיטקטורת REST

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

      1. נכנסים אל מסוף Admin של reCAPTCHA ולוחצים על .

      2. בוחרים מפתח אתר. מפתחות האתרים הבאים של reCAPTCHA נתמכים לצורך העברה: תיבת סימון reCAPTCHA גרסה 2, reCAPTCHA גרסה 2 בלתי נראה ו-reCAPTCHA גרסה 3.

      3. כדי להעתיק את מפתח האתר, לוחצים על העתקת מפתח האתר.

   2. מעבירים את מפתח האתר.

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

      • ‫PROJECT_ID: המזהה של הפרויקט ב- Google Cloud שבו פועל reCAPTCHA API.
      • ‫SITE_KEY: מפתח האתר הפעיל שהעתקתם ממסוף הניהול של reCAPTCHA.

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

      POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate

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

      curl

      הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

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

      curl -X POST \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           -H "Content-Type: application/json; charset=utf-8" \
           -d "" \
           "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate"

      PowerShell

      הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

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

      $cred = gcloud auth print-access-token
      $headers = @{ "Authorization" = "Bearer $cred" }
      
      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate" | Select-Object -Expand Content

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

      {
        "name": "projects/PROJECT-ID/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
        "displayName": "My site key",
        "webSettings": {
          "allowAllDomains": false,
          "allowedDomains": [
            recaptcha.net
          ],
          "allowAmpTraffic": false,
          "integrationType": "SCORE",
          "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
        }
      }
      

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

   מסוף Google Cloud

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

   מעבר אל reCAPTCHA

   ‫CLI של gcloud

   מריצים את הפקודה gcloud recaptcha keys list ומחפשים את מפתח האתר שהועבר ברשימת המפתחות.

אחרי המעבר ל-reCAPTCHA, אתם יכולים להמשיך להשתמש ב-method‏ siteverify כדי להעריך את טוקן התשובה של המשתמש ב-reCAPTCHA. מידע על התשובה מופיע במאמר תשובה של siteverify method.

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

הערה: לא מומלץ למחוק מפתחות אתרים ממסוף Admin של reCAPTCHA או מדף reCAPTCHA במסוף Google Cloud . כשמוחקים מפתח אתר, הוא נמחק משני המסופים וההגנה של reCAPTCHA מוסרת.

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

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

• שימוש בתכונות של reCAPTCHA אחרי ההעברה