자주 묻는 질문(FAQ)

reCAPTCHA Enterprise 사용 중에 발생할 수 있는 일반적인 문제나 질문에 대해 알아보세요.

구현

reCAPTCHA Enterprise를 전지역에서 사용할 수 있나요?

예, 사용자가 www.google.com에 액세스할 수 없는 상황에서 프런트엔드 코드에서 www.recaptcha.net을 사용할 수 있습니다.

  • 먼저 <script src="https://www.google.com/recaptcha/enterprise.js?render=<SITE_KEY>" async defer></script><script src="https://www.recaptcha.net/recaptcha/enterprise.js?render=<SITE_KEY>" async defer></script>로 바꾼 다음 사이트 키를 <SITE_KEY>로 대체합니다.
  • 그런 다음 사이트에서 www.google.com/recaptcha/를 사용하는 다른 모든 곳에 동일한 로직을 적용합니다.

reCAPTCHA Enterprise는 쿠키를 사용하나요?

reCAPTCHA Enterprise는 위험 분석을 제공하기 위해 실행 시 필요한 쿠키(_GRECAPTCHA)를 설정합니다. 다른 쿠키가 설정되어 있을 수 있는 www.google.com 도메인을 사용하지 않으려면 www.recaptcha.net을 대신 사용할 수 있습니다.

reCAPTCHA Enterprise의 점수를 사용하여 챌린지/체크박스 위젯을 표시하고 싶습니다. 어떻게 하면 될까요?

이 작업은 권장하지 않습니다. reCAPTCHA Enterprise는 구현 시 사용자의 좋고 나쁜 행동을 모두 파악할 것으로 기대합니다. 그런데 reCAPTCHA Enterprise 점수를 기반으로 reCAPTCHA Enterprise 체크박스 위젯을 트리거하게 되면 체크박스 위젯운 잘못된 트래픽에만 노출됩니다. 이로 인해 위젯이 챌린지 표시 여부를 판단하는 데 더욱 어려움을 겪게 될 것입니다. 그러면 판별에 문제가 생겨 사기성 사용자 또는 봇에게 NO CAPTCHAs를 발행하는(챌린지가 전혀 나타나지 않음) 결과를 초래할 수 있습니다.

이러한 경우 모든 페이지에 점수 사이트 키를 설치하고 grecaptcha.enterprise.execute를 실행하여 모델을 학습하는 것이 좋습니다. 점수 토큰에 대해서는 앞에서 설명한 평가를 합니다. 그런 다음 체크박스 사이트 키를 사용하여 민감한 작업으로 페이지를 보호할 수 있으며, 이렇게 하면 챌린지가 나타날 가능성이 적습니다.

reCAPTCHA Enterprise 배지를 숨기고 싶습니다. 어떤 경우에 허용됩니까?

reCAPTCHA Enterprise를 사용하여 사이트를 보호하고 사용자 플로우에서 'Google의 서비스 약관 및 개인정보처리방침 적용됨'이 확실히 표시되는 경우에는 배지를 숨기는 것이 허용됩니다. 다음 텍스트를 포함하세요.

This site is protected by reCAPTCHA Enterprise 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.

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

용어 표시 방법 예

reCAPTCHA Enterprise 위젯 또는 배지를 맞춤설정할 수 있나요?

예. reCAPTCHA Enterprise는 다음과 같이 밝은 테마와 어두운 테마를 제공합니다. 테마를 선택하려면 grecaptcha.enterprise.render 매개변수에서 data-theme 속성을 설정합니다.

  • 밝은 테마:

  • 어두운 테마:

Google Cloud Console의 '도메인 확인' 목록에 도메인을 몇 개 추가할 수 있나요?

사이트 키당 도메인이 250개로 제한됩니다.

공식적으로 reCAPTCHA Enterprise를 지원하지 않는 타사 플러그인/구현을 사용하고 있습니다. reCAPTCHA Enterprise를 계속 사용할 수 있나요?

예, reCAPTCHA Enterprise를 사용할 수 있습니다. 다음 단계를 따르세요.

  1. reCAPTCHA 관리 콘솔에서 reCAPTCHA v2/v3 사이트 키를 만듭니다.
  2. 빠른 시작: reCAPTCHA에서 마이그레이션의 안내에 따라 reCAPTCHA Enterprise로 사이트 키를 마이그레이션합니다.

사용

reCAPTCHA Enterprise 대시보드에서 사용되는 시간대는 무엇인가요? 이 시간대를 변경할 수 있나요?

이 시간대는 브라우저의 클라이언트 시간대를 기준으로 합니다. 지금은 변경할 수 없습니다.

reCAPTCHA Enterprise가 반환하는 점수의 품질을 어떻게 측정하나요?

궁극적으로는 사용 사례와 원하는 결과에 따라 다릅니다. 일반적으로 사용자 행동에 대한 자체적인 내부 측정항목을 사용하여 다음과 같이 점수가 정확한지 확인하는 것이 좋습니다.

  • 비밀번호를 재설정하고 높은 점수를 받은 사용자가 나중에 자신의 계정이 도용당했다고 보고했나요?
  • 낮은 점수로 로그인한 사용자가 다른 사용자를 스팸으로 처리했나요?
  • 로그인에 실패하고 낮은 점수를 받은 사용자가 여러 다른 사용자 이름에 로그인을 시도했나요?

reCAPTCHA Enterprise를 사용하여 자동 테스트를 실행하고 싶습니다. 어떻게 해야 하나요?

Google Cloud CLI를 사용하여 테스트용으로 설계된 reCAPTCHA Enterprise 사이트 키를 만들 수 있습니다. 자세한 내용은 recaptcha keys create reference 페이지의 --testing-challenge--testing-score 옵션을 참조하세요.

예:

  • 항상 '보안문자 없음'(챌린지 없음)과 1.0을 반환하는 체크박스 사이트 키를 생성합니다(아래 --domains--display-name 변경).
gcloud recaptcha keys create --testing-challenge=nocaptcha --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always No CAPTCHA" --integration-type=checkbox
  • 항상 해결할 수 없는 챌린지를 반환하는 체크박스 사이트 키를 생성합니다(아래의 --domains--display-name 변경).
gcloud recaptcha keys create --testing-score=0.0 --testing-challenge=challenge --web --domains="domain1.com,domain2.com" --display-name="Unsolvable Challenge" --integration-type=checkbox
  • 항상 설정된 점수를 반환하는 점수 기반 사이트 키를 생성합니다(아래의 --domains, --display-name, --testing-score 변경).
gcloud recaptcha keys create --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always 1" --integration-type=score

reCAPTCHA Enterprise REST API로 통신하고 싶습니다. 향후 응답 형식이 변경되지 않는다고 가정해도 되나요?

제품이 발전함에 따라 API에 새 필드 추가와 같은 이전 버전과 호환되지 않는 변경사항을 적용할 수도 있습니다. JSON을 사용하는 경우, 향후 API에 추가되는 사항과의 호환성을 유지하기 위해 응답 형식을 엄격하게 검증하지 마세요.

서비스 약관

reCAPTCHA Enterprise에서 수집하는 세션 데이터는 무엇이며 Google에서는 데이터를 어떻게 보호하나요?

reCAPTCHA Enterprise에서 수집하는 세부정보, 개인정보처리방침, 약관에 대한 자세한 내용은 서비스 약관을 참조하세요.

Google의 데이터 보호 방법에 대한 자세한 내용은 보안 백서를 참조하세요.