התקנת מפתחות אתגר מבוססי-מדיניות באתרים

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

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

  1. הכנת הסביבה ל-Google Cloud Fraud Defense.

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

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

  3. יצירת מפתח אתגר שמבוסס על מדיניות.

    לחלופין, אתם יכולים להעתיק את המזהה של מפתח אימות קיים שמבוסס על מדיניות, באחת מהדרכים הבאות:

    • כדי להעתיק את המזהה של מפתח קיים ממסוףGoogle Cloud :

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

        כניסה ל-Google Cloud Fraud Defense

      2. לוחצים על הכרטיסייה Keys.
      3. ברשימת מפתחות ה-reCAPTCHA, מוצאים את המפתח שרוצים להעתיק ולוחצים על .
    • כדי להעתיק את המזהה של מפתח קיים באמצעות API בארכיטקטורת REST, משתמשים ב-method‏ projects.keys.list.
    • כדי להעתיק את המזהה של מפתח קיים באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud recaptcha keys list.

הגדרת מפתח האתגר שמבוסס על מדיניות

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

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

    מעבר אל reCAPTCHA

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

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

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

    בכרטיסייה Keys יש שתי תצוגות: Table ו-Cards. אם בפרויקט יש הרבה מפתחות reCAPTCHA, אפשר להשתמש רק בתצוגת Table.

  4. בקטע reCAPTCHA keys, מזהים את מפתח האתגר מבוסס-המדיניות שרוצים להגדיר ולוחצים עליו.

  5. בדף Key details, לוחצים על הכרטיסייה Overview.

  6. בקטע הגדרה, לוחצים על הגדרה ליד הגדרות אתגר.

  7. בדף Configure challenge settings, בוחרים את רמת הקושי של האתגר.

  8. כדי להפעיל אתגרי CAPTCHA, משתמשים בפס ההזזה כדי לציין את ערך הסף שמוגדר כברירת מחדל.

    סף ברירת המחדל של 0.0 לא מפעיל שום אתגר. סף של 1.0 מפעיל אתגר לכל בקשה.

  9. כדי להגדיר סף ניקוד בהתאמה אישית לפעולות ספציפיות, שמחליף את ערך הסף שמוגדר כברירת מחדל:

    1. מזינים שם לפעולה.

    2. כדי לציין סף ניקוד מותאם אישית, משתמשים בפס ההזזה Set action threshold.

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

  10. לוחצים על Save.

הוספת reCAPTCHA ללחצן HTML

  1. כדי לטעון את reCAPTCHA בדף האינטרנט, מוסיפים את JavaScript API עם מפתח האתגר שמבוסס על המדיניות בתוך הרכיב <head></head> של דף האינטרנט.

        <head>
        <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
        ....
        </head>
      

    כברירת מחדל, reCAPTCHA משתמש בשפת הדפדפן. אם רוצים לציין שפה אחרת, משתמשים במאפיין hl=LANG בסקריפט. לדוגמה, כדי להשתמש בצרפתית, מציינים את הערך הבא: <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>. קודי השפה של reCAPTCHA

  2. כדי להוסיף את reCAPTCHA ללחצן HTML:

    1. מגדירים פונקציית קריאה חוזרת (callback) כדי לטפל בטוקן.

      <script>
         function onSubmit(token) {
           document.getElementById("demo-form").submit();
         } // Use `requestSubmit()` for extra features like browser input validation.
      </script>

      מידע נוסף זמין במאמר בנושא השיטה requestSubmit()‎.

    2. מוסיפים מאפיינים ללחצן ה-HTML.

      <button class="g-recaptcha"
      data-sitekey="KEY_ID"
      data-callback="onSubmit"
      data-action="submit">Submit</button>

      אם רוצים לציין מיקום לתג, משתמשים במאפיין data-badge=LOCATION ברכיב שכולל את class=g-recaptcha. כברירת מחדל, המיקום מוגדר כ-bottomright. הערכים האפשריים האחרים הם inline ו-bottomleft.

    3. כשמשתמשים בלחצן הזה כדי לשלוח טופס באתר, פרמטר ה-POST מסוג g-recaptcha-response מכיל את אסימון התגובה.

  3. אחרי שהטוקן נוצר, שולחים את הטוקן של reCAPTCHA לקצה העורפי ויוצרים הערכה תוך שתי דקות.

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