-
reCAPTCHA Enterprise를 사용해야 하나요?
-
reCAPTCHA Enterprise는 매달 최대 10,000건의 평가를 무료로 제공 추가 기능도 제공합니다 <ph type="x-smartling-placeholder"></ph> 기타 기능 이러한 서비스는 대부분의 개발자에게 가장 좋은 출발점이 됩니다. <ph type="x-smartling-placeholder"></ph> 여기에서 시작하세요.
-
reCAPTCHA를 서드 파티 솔루션과 함께 사용할 수 있나요?
-
예. reCAPTCHA (Enterprise가 아닌 버전)와 reCAPTCHA를 모두 사용할 수 있습니다. 엔터프라이즈. 일반적으로 서드 파티 솔루션에서 공개 키를 요청합니다. 보안 비밀 키 또는 API 키 중 하나를 사용해야 합니다. 반드시 API 키를 신뢰할 수 있는 서드 파티에 제공합니다.
-
v2 또는 v3에서 reCAPTCHA Enterprise로 마이그레이션하는 방법
-
마이그레이션 프로세스 완료하는 데 5~10분 정도 걸리며 코드를 변경할 필요가 없습니다.
-
reCAPTCHA v2와 v3 중 무엇을 사용해야 하나요?
-
reCAPTCHA v3는 트래픽에 대한 더 많은 데이터를 원하는 사이트 소유자를 위한 것입니다. 자세한 내용은 reCAPTCHA v3 개발자 가이드를 참고하세요.
Google은 v2의 보안 및 사용성을 지원합니다.
reCAPTCHA v2와 v3의 차이점에 대한 자세한 내용은 버전 비교를 참조하세요.
- reCAPTCHA는 실행될 때 위험 분석을 제공하기 위해 필요한 쿠키 (_GRECAPTCHA)를 설정합니다. 다른 쿠키가 설정되어 있을 수 있는 www.google.com 도메인을 사용하지 않으려면 www.recaptcha.net 을 사용할 수 있습니다.
-
reCAPTCHA 사용에 QPS 또는 일일 한도가 있나요?
- 초당 1,000회 또는 월 1000,000회를 초과하는 호출을 하려면 <ph type="x-smartling-placeholder"></ph> reCAPTCHA Enterprise 또는 이 양식을 제출하고 예외 승인을 받을 때까지 기다립니다. 사이트 키가 1, 000QPS를 초과하면 일부 요청이 처리되지 않을 수 있습니다. v3 사이트 키가 월별 할당량을 초과하면 site_verify가 실패할 수 있습니다. 이를 위해 정적 점수 0.9 및 '무료 할당량 초과'라는 오류 메시지를 반환합니다. 할 수 있습니다. 사용자가 볼 수 있는 v3 사이트가 할당량을 초과했습니다. v2 사이트 키가 월별 할당량을 초과하면 다음과 유사한 오류 메시지가 표시됩니다. 남은 시간 동안 reCAPTCHA 위젯에서 사용자에게 메시지가 표시될 수 있습니다. '이 사이트가 reCAPTCHA 할당량을 초과했습니다.' 할당량이 적용되기 전에 사이트 소유자에게 이메일 알림이 3번 전송됩니다. reCAPTCHA Enterprise로 마이그레이션하는 데 최소 90일이 주어졌습니다. 사이트 키가 할당량 초과로 간주되며, 월 100만 회 이상의 호출이 사용됩니다. 여기에는 볼륨이 여러 영역에 분산되어 있거나 키를 사용하는 것이 좋습니다
-
reCAPTCHA 배지를 숨기고 싶습니다. 허용사항
-
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를 사용하여 자동 테스트를 실행하고 싶습니다. 어떻게 해야 하나요?
-
reCAPTCHA v3의 경우 테스트 환경을 위한 별도의 키를 만듭니다. reCAPTCHA v3는 실제 트래픽을 확인하므로 점수가 정확하지 않을 수 있습니다.
reCAPTCHA v2의 경우 다음 테스트 키를 사용합니다. 항상 보안문자가 표시되지 않으며 모든 인증 요청을 통과합니다.
- 사이트 키: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- 보안 키: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
reCAPTCHA 위젯은 프로덕션 트래픽에 사용되지 않도록 경고 메시지를 표시합니다.
-
내 사이트를 디버깅할 때 reCAPTCHA 코드가 들어가지 않도록 하려면 어떻게 해야 하나요?
-
사이트에서 다른 JavaScript를 디버깅하는 동안 reCAPTCHA 코드를 실행하지 않으려면 브라우저의 무시 목록에 reCAPTCHA 스크립트
/recaptcha__.+\.js$
를 추가합니다. Chrome 관련 안내는 커스텀 스크립트 목록 무시를 참고하세요. 다른 브라우저에서도 유사한 기능을 사용할 수 있습니다. -
내 웹사이트의 트래픽을 더 자세히 보려면 어떻게 해야 하나요?
-
reCAPTCHA는 관리 콘솔에서 일일 통계를 보고합니다.
-
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는 아래와 같이 밝은 테마와 어두운 테마라는 두 가지 테마를 제공합니다. 테마를 선택하려면 grecaptcha.render에서 데이터 테마 속성 설정 매개변수를 입력합니다.
밝은 테마:
어두운 테마:
-
reCAPTCHA v3를 맞춤설정하려면 어떻게 해야 하나요?
-
표시되지 않는 reCAPTCHA에서 사용할 수 있는 JavaScript API는 v3에서도 작동합니다. JavaScript API를 사용하여 v3 사이트 키로 reCAPTCHA를 명시적으로 렌더링하면 배지 위치 변경이나 테마 변경과 같은 옵션에 액세스할 수 있습니다.
이 메서드로 reCAPTCHA v3를 렌더링할 때는
size
매개변수를'invisible'
로 설정하고grecaptcha.execute
를 호출할 때 사이트 키 대신grecaptcha.render
에서 반환한 클라이언트 ID를 사용해야 합니다. -
최근에 reCAPTCHA 위젯에 '잘못된 사이트 키'가 표시되기 시작했습니다. 어떤 상황인가요?
-
이 오류가 표시되면 reCAPTCHA 사이트 키가 더 이상 유효하지 않은 것입니다. 활성화하려면 새 키를 등록하고 해당 페이지의 안내를 따릅니다.
-
확인할 수 없는 SecurityError: 출처가 'https://www.google.com'인 프레임이 차단되었습니다. 출처가 "<your domain>"인 프레임에 액세스하지 못하도록 할 수 있습니다. 어떻게 해야 하나요?
-
이는 일반적으로 최종 사용자가 체크박스를 클릭한 후 reCAPTCHA 위젯 HTML 요소가 프로그래매틱 방식으로 삭제된 경우에 발생합니다. grecaptcha.reset() 자바스크립트 함수를 사용하여 reCAPTCHA 위젯을 재설정하는 것이 좋습니다.
-
웹사이트에서 콘텐츠 보안 정책 (CSP)을 사용하고 있습니다. reCAPTCHA와 호환되도록 구성하려면 어떻게 해야 하나요?
-
CSP3에 설명된 nonce 기반 접근 방식을 사용하는 것이 좋습니다. reCAPTCHA api.js 스크립트 태그에 nonce를 포함하면 나머지는 자동으로 처리됩니다.
참고: 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만 허용해야 합니다.
-
iOS 10에서만 사용자가 챌린지를 완료하면 페이지가 하단으로 스크롤되나요?
-
Google에서 신고한 Apple 측에 초점을 맞춘 버그입니다. 이 문제는 iOS 10 사용자 및 일부 사이트의 사용자에게만 영향을 미칩니다. 영향을 받는 경우 페이지에서 reCAPTCHA 위젯을 위 또는 아래로 이동하거나 reCAPTCHA v3를 사용하여 해결할 수 있습니다.
-
내 컴퓨터 또는 네트워크에서 자동화된 검색어를 전송할 수 있습니다.
-
reCAPTCHA 위젯에서 이 페이지로 이동하면 '죄송합니다. 컴퓨터 또는 네트워크에서 자동 쿼리를 전송하고 있을 수 있습니다. 사용자를 보호하기 위해 지금은 요청을 처리할 수 없습니다."
이는 선량한 사용자에게 일어날 수 있는 몇 가지 이유입니다.
- 악용되고 있는 공유 네트워크를 사용 중일 수 있습니다.
- 인터넷 서비스 제공업체(ISP)에서 최근에 의심스러운 IP 주소를 할당했을 수 있습니다.
- 액세스하려는 사이트가 현재 심각한 공격을 받고 있을 수 있습니다.
문제를 해결하려면 비정상적인 트래픽 도움말 페이지를 확인하거나 나중에 다시 시도하세요.
-
올바른 작업 이름은 무엇인가요?
-
작업에는 영숫자 문자, 슬래시, 밑줄만 포함할 수 있습니다. 작업이 사용자별로 지정되어서는 안 됩니다.
자주 묻는 질문(FAQ)
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003ereCAPTCHA Enterprise offers a free tier with 10,000 assessments per month and advanced features like real-time analytics.\u003c/p\u003e\n"],["\u003cp\u003eYou can migrate to reCAPTCHA Enterprise from v2 or v3 in 5-10 minutes without code changes.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA v3 provides website traffic insights while v2 focuses on security and usability.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA sets a necessary cookie but you can use www.recaptcha.net instead of www.google.com to avoid other potential Google cookies.\u003c/p\u003e\n"],["\u003cp\u003eTo hide the reCAPTCHA badge, ensure the reCAPTCHA branding is visible in the user flow with the provided text snippet.\u003c/p\u003e\n"]]],["reCAPTCHA offers Enterprise and non-Enterprise versions, with the former providing 10,000 free assessments monthly and features like real-time analytics. Migration to Enterprise is quick and doesn't require code changes. reCAPTCHA v3 provides more traffic data than v2. Both versions are compatible with third-party solutions, using public and secret/API keys. reCAPTCHA sets a necessary cookie, but an alternative domain is available. There are rate and volume limits; exceeding them may cause errors. You can hide the badge with specific text included, set testing keys, and use multiple ways to customize its behaviour.\n"],null,["# Frequently Asked Questions\n\n### Should I use reCAPTCHA Enterprise?\n\n\n:\n reCAPTCHA Enterprise offers up to 10,000 assessments per month at no cost\n and also provides additional features.\n [Other features](https://cloud.google.com/recaptcha-enterprise/docs/compare-versions)\n such as real time analytics provide the best place to start for most developers.\n [Get started here.](https://www.google.com/recaptcha/admin/enterprise)\n\n\n### Can I use reCAPTCHA with third party solutions?\n\n\n:\n Yes, you can use both reCAPTCHA (non-Enterprise version) and reCAPTCHA\n Enterprise. Typically the third party solution asks for your public key\n and either your secret key or your API key. Make sure to only provide your\n secret key and API key to trusted third parties.\n\n\n### How to migrate to reCAPTCHA Enterprise from v2 or v3?\n\n\n:\n The [migration process](http://cloud.google.com/recaptcha-enterprise/docs/migrate-recaptcha)\n takes 5-10 minutes to complete and requires no code changes.\n\n\n### Should I use reCAPTCHA v2 or v3?\n\n\n:\n reCAPTCHA v3 is for site owners who want more data about their traffic.\n For more information, see the [reCAPTCHA v3 developer guide](/recaptcha/docs/v3).\n\n We support security and usability for v2.\n\n\n For more information about reCAPTCHA v2 and v3 differences, see [versions comparison](/recaptcha/docs/versions).\n\n\n### Does reCAPTCHA use cookies?\n\n\n:\n reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.\n If you prefer to not use the www.google.com domain which may have other cookies set, you can use www.recaptcha.net instead.\n\n\n### Are there any QPS or daily limits on my use of reCAPTCHA?\n\n\n:\n If you wish to make more than 1000 calls per second or 1000000 calls per month, you must use\n [reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise) or fill out\n [this form](https://forms.gle/caCX5Sgkz2N1maGa9) and wait for an exception approval.\n If a site key exceeds 1000 QPS, then some requests may not be processed.\n If a v3 site key exceeds its monthly quota, then site_verify may fail open\n by returning a static score 0.9 and an error message \\`\"Over free quota.\"\\`\n for the remainder of the month. There are no user-visible indications when\n v3 sites are over quota.\n If a v2 site key exceeds its monthly quota, then the following or a similar\n message may be displayed to users in the reCAPTCHA widget for the remainder\n of the month: \\`This site is exceeding reCAPTCHA quota.\\`\n Before quota is enforced, site owners will be notified by email three times\n and given at least 90 days to migrate to reCAPTCHA Enterprise.\n Site keys are considered over quota if more than 1000000 calls per month are\n used for any domain. This includes if this volume is spread across multiple\n keys on the same domain.\n\n\n### I'd like to hide the reCAPTCHA badge. What is allowed?\n\n\n: You are allowed to hide the badge as long as you include the reCAPTCHA branding visibly in the user flow. Please include the following text:\n\n ```html\n This site is protected by reCAPTCHA and the Google\n \u003ca href=\"https://policies.google.com/privacy\"\u003ePrivacy Policy\u003c/a\u003e and\n \u003ca href=\"https://policies.google.com/terms\"\u003eTerms of Service\u003c/a\u003e apply.\n ```\n\n For example:\n\n **Note:** if you choose to hide the badge, please use \n\n ```css\n .grecaptcha-badge { visibility: hidden; }\n ```\n\n \u003cbr /\u003e\n\n\n### I'd like to run automated tests with reCAPTCHA. What should I do?\n\n\n: For reCAPTCHA v3, create a separate key for testing environments. Scores may not be accurate as reCAPTCHA v3 relies on seeing real traffic.\n\n For reCAPTCHA v2, use the following test keys. You will always get No CAPTCHA and all verification requests will pass.\n\n - Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI\n - Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe\n\n The reCAPTCHA widget will show a warning message to ensure it's not used for production traffic.\n\n\n### How can I avoid stepping into reCAPTCHA code when debugging my site?\n\n\n: To avoid stepping into the reCAPTCHA code while debugging other JavaScript on your site, add the reCAPTCHA script `/recaptcha__.+\\.js$` to your browser's ignore list. For instructions for Chrome, refer to [Ignore a custom list of scripts](https://developer.chrome.com/docs/devtools/settings/ignore-list). Similar features are available in other browsers.\n\n\n### How can I see more about my website's traffic?\n\n\n: reCAPTCHA reports daily stats in the [admin console](https://www.google.com/recaptcha/admin).\n\n\n### Can I use reCAPTCHA globally?\n\n\n: Yes, please use \"www.recaptcha.net\" in your code in circumstances when \"www.google.com\" is not accessible.\n\n - First, replace \\\u003cscript src=\"https://**www.google.com** /recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e with \\\u003cscript src=\"https://**www.recaptcha.net**/recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e\n - After that, apply the same to everywhere else that uses \"www.google.com/recaptcha/\" on your site.\n\n\n### Can I customize the reCAPTCHA widget or badge?\n\n\n: Yes. reCAPTCHA offers two themes, light and dark, as shown below. To choose a theme, simply\n set the data-theme attribute in the [grecaptcha.render\n parameter](/recaptcha/docs/display#render_param).\n\n Light theme:\n\n Dark theme:\n\n\n### How can I customize reCAPTCHA v3?\n\n\n: The [JavaScript API](/recaptcha/docs/invisible#js_api) available for Invisible reCAPTCHA also works for v3. Simply use the JavaScript API to explicitly render reCAPTCHA with a v3 site key to access options such as repositioning the badge or changing the theme.\n\n When rendering reCAPTCHA v3 with this method, remember to set the `size` parameter to `'invisible'` and use the client ID returned by `grecaptcha.render` when calling `grecaptcha.execute` instead of the site key.\n\n\n### Recently my reCAPTCHA widget started displaying \"Invalid site key\". What's happening?\n\n\n:\n\n If you are seeing this error, your reCAPTCHA site key is no longer valid. To activate, please\n [register a new key](https://www.google.com/recaptcha/admin) and follow the [instructions](/recaptcha/intro) on that page.\n\n\n### I'm getting an uncaught SecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\". What should I do?\n\n\n: This typically occurs if the reCAPTCHA widget HTML element is programmatically removed sometime after the end user clicks on the checkbox. We recommend using the [grecaptcha.reset()](/recaptcha/docs/display#js_api) javascript function to reset the reCAPTCHA widget.\n\n\n### I'm using Content-Security-Policy (CSP) on my website. How can I configure it to work with reCAPTCHA?\n\n\n: We recommend using the nonce-based approach documented with [CSP3](https://w3c.github.io/webappsec-csp/#framework-directive-source-list).\n Make sure to include your nonce in the reCAPTCHA [api.js](/recaptcha/docs/display#auto_render) script tag, and we'll handle the rest.\n\n Note: reCAPTCHA also works with ['strict-dynamic'](https://w3c.github.io/webappsec-csp/#strict-dynamic-usage) on browsers that support it.\n\n Alternatively, please add the following values to the directives:\n\n - **script-src** https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/\n - **frame-src** https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/\n\n\n### I'm getting an error \"Localhost is not in the list of supported domains\". What should I do?\n\n\n: localhost domains are not supported by default. If you wish to continue supporting them for\n development you can add them to the list of supported domains for your site key. Go to the\n [reCAPTCHA Enterprise console](https://console.cloud.google.com/security/recaptcha)\n or to the [reCAPTCHA console](https://www.google.com/recaptcha/admin), as appropriate,\n to update your list of supported domains. We advise to use separate keys for development and\n production, and to only allow localhost on your development site key.\n\n\n### Only on iOS 10, the page scrolls to the bottom when the user completes the challenge?\n\n\n: This is a focusing bug on Apple's side that we've reported to them. It affects users only on iOS 10 and only on some sites. If you are affected, a workaround is to move the reCAPTCHA widget higher or lower on the page, or use [reCAPTCHA v3](/recaptcha/docs/v3).\n\n\n### My computer or network may be sending automated queries?\n\n\n: If you were directed to this page from the reCAPTCHA widget, you would have seen a message that said \"We're sorry, but your computer or network may be sending automated queries. To protect our users, we can't process your request right now.\"\n\n This can unfortunately happen to good users for a few reasons:\n\n - You may be on a shared network that is being used abusively\n - Your internet service provider may have recently assigned you a suspicious IP address\n - The site you are trying to access may be currently under heavy attack\n\n To troubleshoot these issues, please look at the [unusual traffic help page](https://support.google.com/websearch/answer/86640), or try again later.\n\n\n### What action names are valid?\n\n\n: Actions might contain only alphanumeric characters, slashes, and underscores.\n Actions must not be user-specific."]]