자주 묻는 질문(FAQ)

reCAPTCHA Enterprise는 매월 최대 10,000회의 평가를 무료로 제공하며 추가 기능도 제공합니다. 실시간 분석과 같은 다른 기능은 대부분의 개발자에게 가장 적합한 시작점입니다. 여기에서 시작해 보세요.

예, reCAPTCHA(Enterprise 버전이 아님)와 reCAPTCHA Enterprise를 모두 사용할 수 있습니다. 일반적으로 서드 파티 솔루션에서 공개 키를 요청합니다. 보안 비밀 키 또는 API 키 중 하나를 사용해야 합니다. 보안 비밀 키와 API 키는 신뢰할 수 있는 서드 파티에만 제공해야 합니다.

마이그레이션 프로세스 완료하는 데 5~10분 정도 걸리며 코드를 변경할 필요가 없습니다.

reCAPTCHA v3는 트래픽에 관한 더 많은 데이터를 원하는 사이트 소유자를 위해 마련되었습니다. 자세한 내용은 reCAPTCHA v3 개발자 가이드를 참고하세요.

v2는 보안과 사용성을 지원합니다.

reCAPTCHA v2와 v3의 차이점에 대한 자세한 내용은 버전 비교를 참조하세요.

사용자 플로우에 reCAPTCHA 브랜딩을 눈에 띄게 포함하는 한 배지를 숨기는 것이 허용됩니다. 다음 텍스트를 포함하세요.

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

예를 들면 다음과 같습니다.

참고: 배지를 숨기려면 다음을 사용하세요.

.grecaptcha-badge { visibility: hidden; }

reCAPTCHA v3의 경우 테스트 환경을 위한 별도의 키를 만듭니다. reCAPTCHA v3는 실제 트래픽을 확인하므로 점수가 정확하지 않을 수 있습니다.

reCAPTCHA v2의 경우 다음 테스트 키를 사용합니다. 항상 보안문자가 표시되지 않으며 모든 인증 요청을 통과합니다.

• 사이트 키: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• 보안 비밀 키: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

reCAPTCHA 위젯은 프로덕션 트래픽에 사용되지 않도록 경고 메시지를 표시합니다.

사이트에서 다른 JavaScript를 디버깅하는 동안 reCAPTCHA 코드를 실행하지 않으려면 브라우저의 무시 목록에 reCAPTCHA 스크립트 /recaptcha__.+\.js$를 추가합니다. Chrome 관련 안내는 커스텀 스크립트 목록 무시를 참고하세요. 다른 브라우저에서도 유사한 기능을 사용할 수 있습니다.

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는 아래와 같이 밝은 테마와 어두운 테마라는 두 가지 테마를 제공합니다. 테마를 선택하려면 grecaptcha.render에서 data-theme 속성 설정 매개변수를 입력합니다.

밝은 테마:

어두운 테마:

표시되지 않는 reCAPTCHA에서 사용할 수 있는 JavaScript API는 v3에서도 작동합니다. JavaScript API를 사용하여 v3 사이트 키로 reCAPTCHA를 명시적으로 렌더링하면 배지 위치 변경이나 테마 변경과 같은 옵션에 액세스할 수 있습니다.

이 메서드로 reCAPTCHA v3를 렌더링할 때는 size 매개변수를 'invisible'로 설정하고 grecaptcha.execute를 호출할 때 사이트 키 대신 grecaptcha.render에서 반환한 클라이언트 ID를 사용해야 합니다.

이 오류가 표시되면 reCAPTCHA 사이트 키가 더 이상 유효하지 않은 것입니다. 활성화하려면 새 키를 등록하고 해당 페이지의 안내를 따르세요.

이는 일반적으로 최종 사용자가 체크박스를 클릭한 후 언젠가 reCAPTCHA 위젯 HTML 요소가 프로그래매틱 방식으로 삭제된 경우에 발생합니다. grecaptcha.reset() 자바스크립트 함수를 사용하여 reCAPTCHA 위젯을 재설정하는 것이 좋습니다.

CSP3에 설명된 nonce 기반 접근 방식을 사용하는 것이 좋습니다. reCAPTCHA api.js 스크립트 태그에 nonce를 포함하면 나머지는 Google에서 처리합니다.

참고: 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/

localhost 도메인은 기본적으로 지원되지 않습니다. 다음 기간 동안 계속 지원하려는 경우 사이트 키의 지원되는 도메인 목록에 추가할 수 있습니다. 다음으로 이동: reCAPTCHA Enterprise 콘솔 또는 reCAPTCHA 콘솔로 이동합니다(해당하는 경우). 를 클릭하여 지원되는 도메인 목록을 업데이트하세요. 개발 및 개발 시 별도의 키를 사용하는 것이 좋습니다. 개발 사이트 키에서 localhost만 허용해야 합니다.

이 버그는 Apple 측의 포커싱 버그이며 Apple에 신고했습니다. 이 문제는 iOS 10을 사용하는 일부 사이트의 사용자에게만 영향을 미칩니다. 이 문제가 발생하는 경우 해결 방법은 reCAPTCHA 위젯을 페이지에서 위 또는 아래로 이동하거나 reCAPTCHA v3을 사용하는 것입니다.

reCAPTCHA 위젯에서 이 페이지로 이동하면 '죄송합니다. 컴퓨터 또는 네트워크에서 자동 쿼리를 전송하고 있을 수 있습니다. 사용자를 보호하기 위해 지금은 요청을 처리할 수 없습니다."

이는 선량한 사용자에게 일어날 수 있는 몇 가지 이유입니다.

• 악의적인 활동이 사용되고 있을 수 있습니다.
• 인터넷 서비스 제공업체에서 최근에 의심스러운 IP 주소를 할당했을 수 있습니다.
• 액세스하려는 사이트가 현재 심각한 공격을 받고 있을 수 있습니다.

이 문제를 해결하려면 비정상적인 트래픽 도움말 페이지를 참고하거나 나중에 다시 시도해 보세요.

작업에는 영숫자 문자, 슬래시, 밑줄만 포함할 수 있습니다. 사용자에게 특정 작업이 수행되어서는 안 됩니다.