במסמך הזה מפורטות בעיות נפוצות בשילוב של reCAPTCHA, שמפתחים עשויים להיתקל בהן כשהם משתמשים ב-reCAPTCHA בסביבה שלהם.
מפתח אתר לא תקין או סוג מפתח לא תקין
אם מופיעה השגיאה Invalid site key או Invalid key type, צריך לבדוק את הדברים הבאים:
- מוודאים שגרסת המפתח במסוף Google Cloud תואמת לגרסה שהוגדרה באתר או בפלאגין של מערכת ניהול התוכן של צד שלישי (לדוגמה,
Website • scoreל-v3אוWebsite • checkboxל-v2 Checkbox). כדי לבדוק את גרסת המפתח, אפשר לעיין בקטע הצגת גרסת המפתח במסוףGoogle Cloud . - אם מפתח האתר של reCAPTCHA נמחק או כבר לא תקף, צרו מפתח חדש ועדכנו את הפלאגין של מערכת ניהול התוכן או התקינו את המפתח בדפי האינטרנט שלכם.
העברת המפתחות נכשלה
יכול להיות שההעברה של מפתחות האתר תיכשל באחד מהמקרים הבאים:
חרגת ממספר הפרויקטים שמותר לך או לארגון שלך ליצור.
כדי לפתור את הבעיה, אפשר להשתמש שוב בפרויקט קיים, לבקש להגדיל את מכסת יצירת הפרויקטים או להמתין עד שההעברה האוטומטית תסתיים.
הארגון שלך ב-Workspace הגביל את היצירה של פרויקטים חדשים ב- 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.