השוואה בין המינוחים במסוף Admin ובמסוף Google Cloud

במאמר הזה מוסבר איך לזהות את גרסת המפתח של reCAPTCHA (v2 או v3), למפות את המונחים הקודמים של מסוף הניהול של reCAPTCHA לGoogle Cloud , ולאחזר את מפתחות האתר והמפתחות הסודיים שנדרשים לפלטפורמות של מערכות ניהול תוכן (CMS) ולפלאגינים של צד שלישי, כמו שילובים של WordPress או Shopify.

מיפוי המונחים הקודמים למסוף Google Cloud

אם אתם מנהלים את המפתחות רק במסוף Admin של reCAPTCHA, אתם משתמשים ב-reCAPTCHA Classic. אם אתם מנהלים את המפתחות בדף Google Cloud Fraud Defense במסוף Google Cloud , אתם משתמשים ב-Fraud Defense. שני מסופי הניהול תומכים במפתחות אתר בגרסאות v2 ו-v3.

בפלאגינים ובפלטפורמות רבות של CMS, מפתחות reCAPTCHA נקראים לפי מספרי גרסאות קודמות, כמו v2 Checkbox,‏ v2 Invisible ו-v3. במסוףGoogle Cloud נעשה שימוש בתיאורים שמבוססים על פלטפורמה במקום במספרי גרסאות.

בטבלה הבאה מופיעים המונחים של מסוף ה-CMS ומסוף Admin מהדור הקודם, והמונחים המקבילים במסוףGoogle Cloud :

מונחים במערכת ניהול התוכן או במסוף Admin מסוףGoogle Cloud (פרטי הפלטפורמה) עריכת המפתח (השדה סוג) מנגנון האימות ותאימות למערכת ניהול התוכן (CMS)
על סמך ציון (גרסה 3) Website • score Website • Score אימות חלק, מבוסס-ציון. משתמשים בה לפלאגינים של מערכת ניהול תוכן (CMS) שדורשים את reCAPTCHA גרסה 3.
אתגר (גרסה 2) Website • checkbox Website • Checkbox challenge המשתמש צריך לסמן את התיבה "אני לא רובוט". משתמשים בה לפלאגינים של מערכות ניהול תוכן (CMS) שדורשים תיבת סימון של reCAPTCHA גרסה 2.
בלתי נראה (גרסה 2) Website • invisible Website • Invisible integration מנתח את הסיכון ברקע ויכול להיות שיציג אתגר. משתמשים בגרסה הזו בשביל פלאגינים של CMS שדורשים את reCAPTCHA גרסה 2 Invisible.
לא רלוונטי Website • policy-based challenge Website • Policy-based challenge הפעלת אתגרים על סמך סף ניקוד שהוגדר. צריך שילוב מותאם אישית של CreateAssessment.
לא רלוונטי iOS iOS app מפתח נייד ל-iOS ללא אימות.
לא רלוונטי Android Android app מפתח נייד ל-Android בלי אתגר.

הצגת גרסת המפתח במסוף Google Cloud

כדי לראות את גרסת המפתח במסוף Google Cloud :

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

    מעבר אל Fraud Defense

  2. לוחצים על הכרטיסייה Keys.

  3. אם המפתחות מוצגים בתצוגת כרטיסים, עוברים לתצוגת טבלה.

  4. בודקים את העמודה פרטי הפלטפורמה כדי למצוא את המפתח. לדוגמה, Website • score תואם ל-v3 ו-Website • checkbox תואם ל-v2 Checkbox.

  5. זה שינוי אופציונלי. בתצוגה Cards, לוחצים על Key details בכרטיס של המפתח ואז על Edit key. בשדה Type מוצגת הגדרת המפתח, למשל Website • Score ל-v3 או Website • Checkbox challenge ל-v2 Checkbox.

איך למצוא את מפתח האתר ואת המפתח הסודי

בפלאגינים של צד שלישי ובמערכות ניהול תוכן (CMS) בדרך כלל נדרשים מפתח אתר ומפתח סודי כדי לשלב את reCAPTCHA:

  • מפתח אתר: במסוף Google Cloud , מזהה המפתח תואם למפתח האתר.
  • מפתח סודי: כברירת מחדל, המפתח הסודי לא מוצג במסוף Google Cloud כי בדרך כלל האימות ב- Google Cloud מתבצע באמצעות מפתחות API או תפקידים של ניהול זהויות והרשאות גישה (IAM). עם זאת, אתם יכולים לאחזר את המפתח הסודי הקודם בשביל פלאגינים שדורשים אותו. בחלק מהספריות או מהמסמכים של צד שלישי, המפתח הסודי הקודם נקרא מפתח פרטי.

אחזור המפתח הסודי במסוף Google Cloud

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

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

    מעבר אל Fraud Defense

  2. לוחצים על הכרטיסייה Keys.

  3. בקטע reCAPTCHA Keys, עוברים למפתח שרוצים לקבל את המפתח הסודי שלו:

    • אם אתם בתצוגת כרטיסים, לוחצים על פרטים עיקריים בכרטיס המפתח. מזהה המפתח מופיע בחלק העליון של הדף.
    • אם אתם בתצוגת Table, הערך של Key ID מופיע בטבלה. לוחצים על המפתח כדי לעבור לדף הפרטים שלו.

  4. מעתיקים את מזהה המפתח שמופיע בחלק העליון של הדף. הערך הזה הוא מפתח האתר שלכם.

  5. עוברים לכרטיסייה Integration (שילוב).

  6. בהתאם לסטטוס של המפתח, מבצעים אחת מהפעולות הבאות:

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

  7. תופיע תיבת דו-שיח עם המפתח הסודי. העתיקו את הערך הזה בצורה מאובטחת. התייחסו לסוד הזה כאל מידע אישי רגיש.

    אפשר גם ללחוץ על Edit key בדף Key details, ואז ללחוץ על Reveal ליד השדה Secret key.

שילוב עם WordPress, ‏Shopify או פלטפורמות אחרות של מערכות ניהול תוכן (CMS)

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

כדי להגדיר את reCAPTCHA במערכת ניהול תוכן (CMS) או בפלאגין של צד שלישי:

  1. בודקים את גרסת ה-reCAPTCHA שנדרשת על ידי מערכת ניהול התוכן או הפלאגין: פותחים את הגדרות השילוב של reCAPTCHA במערכת ניהול התוכן או בפלאגין ובודקים באיזה סוג מפתח יש תמיכה (בדרך כלל reCAPTCHA גרסה 3 או תיבת הסימון של reCAPTCHA גרסה 2).

  2. בוחרים או יוצרים מפתח תואם:

    • אם כבר יש לכם מפתח, בדקו את גרסת המפתח כדי לוודא שהיא תואמת לגרסה שנבחרה בפלאגין (Website • score ל-v3 או Website • checkbox ל-v2 Checkbox).
    • אם אתם צריכים מפתח חדש, צרו מפתח לאתר שתואם לגרסה הנדרשת, והוסיפו את הדומיין של האתר (לדוגמה, example.com) לרשימת הדומיינים של המפתח.

  3. מעתיקים את מפתח האתר ואת המפתח הסודי הקודם: פועלים לפי השלבים שמפורטים בקטע אחזור המפתח הסודי במסוףGoogle Cloud כדי לקבל את מזהה המפתח (מפתח האתר) ואת המפתח הסודי.

  4. מזינים את המפתחות בהגדרות של מערכת ניהול התוכן או הפלאגין:

    • מדביקים את מזהה המפתח בשדה מפתח האתר.
    • מדביקים את המפתח הסודי בשדה Secret key (או מפתח פרטי) ושומרים את ההגדרות.

שילוב אתרים בהתאמה אישית באמצעות הערכות

ה-method‏ CreateAssessment מספקת ניתוח סיכונים מפורט וקודי סיבות, ומאפשרת גישה לתכונות מתקדמות של Fraud Defense. אפשר להפעיל את השיטה CreateAssessment באמצעות ספריות הלקוח של reCAPTCHA או באמצעות ה-API בארכיטקטורת REST.

מידע נוסף זמין במאמר יצירת הערכה לאתר.

שיטת SiteVerify מדור קודם

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

אם אתם צריכים לשלב מערכת שדורשת את ה-API הקודם של SiteVerify, עיינו במאמר אימות טוקנים של תגובות משתמשים באמצעות SiteVerify הקודם.

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