이 문서에는 개발자가 환경에서 reCAPTCHA를 사용할 때 발생할 수 있는 일반적인 reCAPTCHA 통합 문제가 나와 있습니다.
사이트 키 또는 키 유형이 잘못되었습니다.
Invalid site key 또는 Invalid key type 오류가 표시되면 다음을 확인하세요.
- Google Cloud 콘솔의 키 버전이 웹사이트 또는 서드 파티 CMS 플러그인에 구성된 버전과 일치하는지 확인합니다 (예:
v3의 경우Website • score,v2 Checkbox의 경우Website • checkbox). 키 버전을 확인하려면 Google Cloud 콘솔에서 키 버전 보기를 참조하세요. - reCAPTCHA 사이트 키가 삭제되었거나 더 이상 유효하지 않은 경우 새 키를 만들고 CMS 플러그인을 업데이트하거나 웹페이지에 키를 설치합니다.
키 이전 실패
다음 시나리오 중 하나에서 사이트 키를 이전하지 못할 수 있습니다.
사용자 또는 조직에서 만들 수 있는 프로젝트 수를 초과했습니다.
이 문제를 해결하려면 기존 프로젝트를 재사용하거나, 프로젝트 생성 할당량 상향을 요청하거나, 자동 이전이 완료될 때까지 기다리세요.
Workspace 조직에서 새 Google Cloud프로젝트 만들기를 제한했습니다.
Google 관리 콘솔에서 Google Cloud 서비스를 사용 설정하려면 관리자에게 문의하세요. 자세한 내용은 사용자별로 Google Cloud 사용/사용 중지하기를 참고하세요.
SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>"
이는 일반적으로 최종 사용자가 체크박스를 클릭한 후 어느 시점에 reCAPTCHA 위젯 HTML 요소가 프로그래매틱 방식으로 삭제되는 경우에 발생합니다. grecaptcha.enterprise.reset() JavaScript 함수를 사용하여 reCAPTCHA 위젯을 재설정하는 것이 좋습니다.
Localhost가 지원되는 도메인 목록에 없습니다.
localhost 도메인은 기본적으로 지원되지 않습니다. 개발을 위해 계속 지원하려면 사이트 키의 지원되는 도메인 목록에 추가하면 됩니다. Google Cloud Console로 이동하여 지원되는 도메인 목록을 업데이트합니다. 개발 및 프로덕션에 별도의 키를 사용하고 개발 사이트 키에 localhost만 허용하는 것이 좋습니다.
reCAPTCHA가 평가를 만들 때 BROWSER_ERROR를 반환했습니다.
BROWSER_ERROR 토큰은 reCAPTCHA 스크립트가 execute 작업을 실행할 수 없는 경우에 발생합니다. 대부분의 경우 클라이언트 측 네트워크 오류 또는 시간 초과로 인해 발생합니다. JavaScript를 사용하여 execute()를 다시 시도해야 합니다.