שאלות נפוצות

כדאי להשתמש ב-reCAPTCHA Enterprise?

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

אפשר להשתמש ב-reCAPTCHA עם פתרונות של צד שלישי?

כן, אפשר להשתמש גם ב-reCAPTCHA (גרסה שאינה Enterprise) וגם ב-reCAPTCHA Enterprise. בדרך כלל, הפתרון של הצד השלישי מבקש את המפתח הציבורי שלכם ואת המפתח הסודי או את מפתח ה-API. חשוב לספק את המפתח הסודי ואת מפתח ה-API רק לצדדים שלישיים מהימנים.

איך עוברים ל-reCAPTCHA Enterprise מגרסה 2 או 3?

תהליך ההעברה נמשך 5-10 דקות ואין צורך לשנות את הקוד.

באיזו גרסה של reCAPTCHA כדאי להשתמש – גרסה 2 או גרסה 3?

‫reCAPTCHA גרסה 3 מיועדת לבעלי אתרים שרוצים לקבל יותר נתונים על תנועת הגולשים באתר. מידע נוסף זמין במדריך למפתחים של reCAPTCHA גרסה 3.

אנחנו תומכים באבטחה ובשימושיות של גרסה 2.

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

האם reCAPTCHA משתמש בקובצי Cookie?

‫reCAPTCHA מגדיר קובץ Cookie נחוץ (‎_GRECAPTCHA) כשהוא מופעל כדי לספק את ניתוח הסיכונים שלו. אם אתם מעדיפים לא להשתמש בדומיין www.google.com, שבו יכולים להיות מוגדרים קובצי Cookie אחרים, אתם יכולים להשתמש ב-www.recaptcha.net במקום זאת.

האם יש מגבלות יומיות או מגבלות על מספר השאילתות לשנייה (QPS) בשימוש ב-reCAPTCHA?

אם אתם רוצים לבצע יותר מ-1,000 קריאות בשנייה או 1,000,000 קריאות בחודש, אתם צריכים להשתמש ב-reCAPTCHA Enterprise או למלא את הטופס הזה ולהמתין לאישור חריגה. אם מפתח אתר חורג מ-1,000 שאילתות לשנייה, יכול להיות שחלק מהבקשות לא יעובדו. אם מפתח אתר בגרסה 3 חורג מהמכסה החודשית, יכול להיות שהפעולה `site_verify` תמשיך לפעול במקרה שגיאה ותחזיר ציון סטטי של 0.9 והודעת שגיאה `"Over free quota."‎` עד סוף החודש. אין אינדיקציות שגלויות למשתמשים כשהאתרים בגרסה 3 חורגים מהמכסה. אם מפתח אתר בגרסה 2 חורג מהמכסה החודשית, יכול להיות שתוצג למשתמשים ההודעה הבאה או הודעה דומה בווידג'ט של reCAPTCHA עד סוף החודש: "באתר הזה יש חריגה מהמכסה של reCAPTCHA". לפני שהמכסה תיאכף, בעלי האתר יקבלו שלוש התראות באימייל ויינתנו להם לפחות 90 ימים כדי לעבור ל-reCAPTCHA Enterprise. מפתחות אתר נחשבים כחורגים מהמכסה אם נעשה שימוש ביותר ממיליון קריאות בחודש לכל דומיין. זה כולל גם מצב שבו הנפח הזה מתפרס על פני כמה מפתחות באותו דומיין.

אני רוצה להסתיר את תג ה-reCAPTCHA. מה מותר?

מותר להסתיר את התג, בתנאי שאתם כוללים את המיתוג של reCAPTCHA באופן גלוי במסלול המשתמש. צריך לכלול את הטקסט הבא:

This site is protected by reCAPTCHA.

לדוגמה:

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

.grecaptcha-badge { visibility: hidden; }

אני רוצה להריץ בדיקות אוטומטיות באמצעות reCAPTCHA. מה לעשות?

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

ב-reCAPTCHA גרסה 2, משתמשים במפתחות הבדיקה הבאים. תמיד תקבלו No CAPTCHA וכל בקשות האימות יעברו.

• מפתח האתר: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• מפתח סודי: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

בווידג'ט של reCAPTCHA תוצג הודעת אזהרה כדי לוודא שהוא לא משמש לתנועה בסביבת הייצור.

איך אפשר להימנע מכניסה לקוד של reCAPTCHA במהלך ניפוי באגים באתר?

כדי להימנע מכניסה לקוד של reCAPTCHA בזמן ניפוי באגים של קוד JavaScript אחר באתר, הוסיפו את הסקריפט של reCAPTCHA‏ /recaptcha__.+\.js$ לרשימת קטעי הקוד להתעלמות בדפדפן. הוראות ל-Chrome מפורטות במאמר התעלמות מרשימה מותאמת אישית של סקריפטים. תכונות דומות זמינות בדפדפנים אחרים.

איך אפשר לראות מידע נוסף על התנועה באתר?

ב-reCAPTCHA מדווחים נתונים סטטיסטיים יומיים במסוף Admin.

אפשר להשתמש ב-reCAPTCHA בכל העולם?

כן, השתמשו ב-"www.recaptcha.net" בקוד שלכם במקרים שבהם אין גישה ל-"www.google.com".

• קודם כל, מחליפים את <script src="https://www.google.com/recaptcha/api.js"></script> ב-<script src="https://www.recaptcha.net/recaptcha/api.js"></script>
• לאחר מכן, צריך להחיל את אותו שינוי בכל מקום אחר באתר שבו נעשה שימוש בכתובת "www.google.com/recaptcha/‎".

אפשר להתאים אישית את הווידג'ט או התג של reCAPTCHA?

כן. ל-reCAPTCHA יש שני עיצובים, בהיר וכהה, כמו שמוצג בהמשך. כדי לבחור עיצוב, פשוט מגדירים את המאפיין data-theme בפרמטר grecaptcha.render.

עיצוב בהיר:

עיצוב כהה:

איך אפשר להתאים אישית את reCAPTCHA גרסה 3?

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

כשמעבדים את reCAPTCHA גרסה 3 באמצעות השיטה הזו, חשוב להגדיר את הפרמטר size לערך 'invisible' ולהשתמש במזהה הלקוח שמוחזר על ידי grecaptcha.render כששולחים קריאה ל-grecaptcha.execute במקום למפתח האתר.

לאחרונה, בווידג'ט reCAPTCHA שלי התחילה להופיע ההודעה "מפתח אתר לא חוקי". מה קורה?

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

מופיעה השגיאה Uncaught SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>". מה צריך לעשות?

בדרך כלל זה קורה אם רכיב ה-HTML של הווידג'ט של reCAPTCHA מוסר באופן פרוגרמטי זמן מה אחרי שמשתמש הקצה לוחץ על תיבת הסימון. אנחנו ממליצים להשתמש בפונקציית JavaScript‏ grecaptcha.reset() כדי לאפס את הווידג'ט של reCAPTCHA.

אני משתמש/ת ב-Content-Security-Policy ‏(CSP) באתר שלי. איך אפשר להגדיר אותו כך שיעבוד עם reCAPTCHA?

מומלץ להשתמש בגישה שמבוססת על מספר חד-פעמי (nonce) שמתועדת ב-CSP3. הקפידו לכלול את ה-nonce בתג הסקריפט api.js של reCAPTCHA, ואנחנו נטפל בכל השאר.

הערה: reCAPTCHA פועל גם עם 'strict-dynamic' בדפדפנים שתומכים בכך.

לחלופין, אפשר להוסיף את הערכים הבאים להוראות:

• script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/‎
• frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/‎
• connect-src https://www.google.com/recaptcha/‎

מופיעה השגיאה "Localhost is not in the list of supported domains" (מארח מקומי לא נמצא ברשימת הדומיינים הנתמכים). מה לעשות?

כברירת מחדל, אין תמיכה בדומיינים של localhost. כדי להמשיך לתמוך בהם לצורך פיתוח, אפשר להוסיף אותם לרשימת הדומיינים הנתמכים של מפתח האתר. כדי לעדכן את רשימת הדומיינים הנתמכים, נכנסים למסוף reCAPTCHA Enterprise או למסוף reCAPTCHA, לפי הצורך. מומלץ להשתמש במפתחות נפרדים לפיתוח ולייצור, ולאפשר רק את localhost במפתח של אתר הפיתוח.

רק ב-iOS 10, הדף נגלל לתחתית כשהמשתמש משלים את האתגר?

זה באג במיקוד בצד של אפל, ודיווחנו להם עליו. היא משפיעה על משתמשים רק ב-iOS 10 ורק באתרים מסוימים. אם הבעיה הזו משפיעה עליכם, אתם יכולים להזיז את הווידג'ט של reCAPTCHA למעלה או למטה בדף, או להשתמש ב-reCAPTCHA גרסה 3.

יכול להיות שהמחשב או הרשת שלי שולחים שאילתות אוטומטיות?

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

לצערנו, זה יכול לקרות למשתמשים טובים מכמה סיבות:

• יכול להיות שאתם מחוברים לרשת משותפת שנעשה בה שימוש לרעה
• יכול להיות שספק האינטרנט הקצה לכם לאחרונה כתובת IP חשודה
• יכול להיות שהאתר שניסית לגשת אליו נמצא כרגע תחת מתקפה כבדה

כדי לפתור את הבעיות האלה, אפשר לעיין בדף העזרה בנושא תנועה חריגה או לנסות שוב מאוחר יותר.

אילו שמות של פעולות הם תקינים?

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