במסמך הזה מפורטות בעיות נפוצות בשילוב של reCAPTCHA, שמפתחים עשויים להיתקל בהן במהלך השימוש ב-reCAPTCHA בסביבה שלהם.
מפתח אתר לא תקין
אם מופיעה השגיאה Invalid site key, מפתח האתר של reCAPTCHA כבר לא תקף. יוצרים מפתח חדש ומטמיעים אותו בדפי האינטרנט.
העברת המפתחות נכשלה
התרחישים הבאים עלולים לגרום לכך שמפתחות האתר לא יועברו:
חרגת ממספר הפרויקטים שמותר לך או לארגון שלך ליצור.
כדי לפתור את הבעיה, אפשר להשתמש שוב בפרויקט קיים, לבקש להגדיל את מכסת יצירת הפרויקטים או להמתין עד שההעברה האוטומטית תסתיים.
הארגון שלכם במרחב העבודה הגביל את היצירה של פרויקטים חדשים של Google Cloud.
כדי להפעיל את Google Cloud השירות במסוף Google Admin, צריך לפנות לאדמין. מידע נוסף מופיע במאמר בנושא הפעלה או השבתה של Google Cloud למשתמשים.
SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>"
בדרך כלל זה קורה אם רכיב ה-HTML של ווידג'ט ה-reCAPTCHA מוסר באופן פרוגרמטי בשלב כלשהו אחרי שמשתמש הקצה לוחץ על תיבת הסימון. מומלץ להשתמש בפונקציית JavaScript grecaptcha.enterprise.reset() כדי לאפס את הווידג'ט של reCAPTCHA.
Localhost לא נמצא ברשימת הדומיינים הנתמכים
כברירת מחדל, אין תמיכה בדומיינים של localhost. אם רוצים להמשיך לתמוך בהם לצורך פיתוח, אפשר להוסיף אותם לרשימת הדומיינים הנתמכים של מפתח האתר. כדי לעדכן את רשימת הדומיינים הנתמכים, עוברים אל Google Cloud המסוף. מומלץ להשתמש במפתחות נפרדים לפיתוח ולייצור, ולאפשר רק את localhost במפתח של אתר הפיתוח.
מערכת reCAPTCHA החזירה BROWSER_ERROR כשנוצרת הערכה
טוקנים מסוג BROWSER_ERROR נוצרים כשהסקריפט של reCAPTCHA לא יכול לבצע פעולה מסוג execute. ברוב המקרים, הסיבה לכך היא כשל או פסק זמן ברשת בצד הלקוח. צריך לנסות שוב להשתמש ב-execute() באמצעות JavaScript.