reCAPTCHA Enterprise API를 사용한 Identity Platform 통합 문제 해결

이 문서에서는 reCAPTCHA 봇 보호 및 reCAPTCHA SMS 방어 기능을 포함하여 reCAPTCHA Enterprise API와 Identity Platform 통합을 사용할 때 발생할 수 있는 잠재적인 문제를 해결하는 방법을 안내합니다.

통합 온보딩 문제 해결

reCAPTCHA Enterprise API와 Identity Platform 통합을 온보딩할 때 실수로 인해 사용자에게 문제가 발생할 수 있습니다. 일반적인 이유는 다음과 같습니다.

  • reCAPTCHA Enterprise API 설정과 Identity Platform 통합 단계에서 누락된 부분이 있을 수 있습니다. 예를 들어 서비스 계정을 설정하지 않거나 프로젝트에서 reCAPTCHA Enterprise API를 사용 설정하지 않는 경우입니다. 모든 통합 요구사항을 완료했는지 확인합니다. 설정 안내는 reCAPTCHA Enterprise API와 Identity Platform 통합을 참조하세요.
  • reCAPTCHA에 사용할 자체 키를 가져오는 경우 업로드한 해당 reCAPTCHA 키가 유효하지 않거나 작동이 중지되었을 수 있습니다. 키가 작동하고 Identity Platform에서 액세스할 수 있는지 확인합니다.
  • 사용자가 이전 버전의 앱을 사용 중일 수 있습니다. 클라이언트 SDK를 사용하는 업데이트된 버전의 앱을 제공하고 사용자에게 앱을 업데이트하도록 요청하세요. 앱의 클라이언트 SDK를 설정하려면 클라이언트 SDK 구성을 참고하세요.

사용자가 reCAPTCHA Enterprise API 지원 흐름을 통해 인증할 수 없음

reCAPTCHA 봇 방어 또는 reCAPTCHA SMS 방어와 같은 reCAPTCHA Enterprise API 지원 흐름에 문제가 있는 경우 다음 섹션에서 기능별 안내를 참조하세요.

reCAPTCHA 봇 보호 문제 해결

다음 주제에서는 봇 보호를 사용할 때 발생할 수 있는 문제와 해결 방법을 설명합니다.

이메일 비밀번호 또는 전화 제공업체에 봇 보호를 사용할 때 사용자가 인증할 수 없음

reCAPTCHA Enterprise API와의 Identity Platform 통합이 올바르게 설정되었다고 판단한 경우 현재 구성에 따라 사용자가 이메일 비밀번호 또는 전화 제공업체를 통해 인증 작업을 수행하지 못하도록 차단될 수 있습니다. 예를 들어 사용자가 다음 작업을 수행하지 못할 수 있습니다.

  • 이메일 주소를 통해 로그인, 가입 또는 비밀번호를 재설정합니다.
  • 전화번호를 통해 로그인하기 위해 SMS 코드를 요청합니다.
  • SMS 기반 다중 인증(MFA)에 등록하거나 로그인합니다.

이러한 인증 문제를 해결하려면 다음을 시도해 보세요.

  • 사용자 요청이 ERROR_CAPTCHA_CHECK_FAILED로 실패하는 경우 managedRules에 설정한 기준점을 조정하여 더 허용적인 구성을 고려하세요. 설정한 기준점보다 낮은 점수를 받은 요청은 봇으로 간주됩니다. 예를 들어 기준점을 0.6로 설정하면 reCAPTCHA는 0.5 이하의 요청을 실패로 처리합니다. 따라서 점수를 높게 설정할수록 규칙이 더 엄격해집니다.
  • 사용자에게 다른 기기, 브라우저, 네트워크를 사용하도록 요청
  • 이메일 비밀번호 인증 흐름의 경우 ENFORCE 모드를 다시 사용 설정하기 전에 emailPasswordEnforcementState를 AUDIT 모드로 되돌리고 측정항목을 모니터링합니다.
  • 전화 인증 흐름의 경우 문제를 해결하는 동안 managedRules 점수 임곗값을 조정하거나 전화 제공업체의 봇 보호를 사용 중지합니다. reCAPTCHA SMS 방어도 사용 설정되어 있고 활성 상태로 유지하려면 useSmsBotScore를 false로 설정하고 phoneEnforcementState를 ENFORCE로 설정합니다. 모든 전화 reCAPTCHA 보호를 사용 중지하려면 phoneEnforcementState를 OFF로, useSmsBotScore를 false로, useSmsTollFraudProtection를 false로 설정합니다.

reCAPTCHA SMS 방어 문제 해결

다음 주제에서는 reCAPTCHA SMS 방어를 사용할 때 발생할 수 있는 문제와 해결 방법을 설명합니다.

전화 제공업체에 reCAPTCHA SMS 방어를 사용하는 경우 사용자가 인증할 수 없음

reCAPTCHA Enterprise API와의 Identity Platform 통합이 올바르게 설정되었다고 판단한 경우 현재 구성에 따라 사용자가 전화 제공업체를 통해 SMS 기반 인증 작업을 수행하지 못하도록 차단될 수 있습니다. 예를 들어 사용자가 전화번호로 로그인하거나 다중 인증으로 등록 또는 로그인하기 위해 SMS 코드를 요청하지 못할 수 있습니다. 설정한 reCAPTCHA SMS 방어 점수가 너무 엄격하면 이 문제가 발생할 수 있습니다.

이 문제를 해결하려면 tollFraudManagedRules에 설정한 기준점을 조정하여 보다 허용적인 구성을 고려하세요. 설정한 기준점을 초과하는 점수는 SMS 전화 결제 사기로 간주됩니다. 예를 들어 기준을 0.3로 설정하면 reCAPTCHA는 0.4 이상의 요청을 실패로 처리합니다. 따라서 점수를 낮게 설정할수록 규칙이 더 엄격해집니다.

점수 기준점을 조정한 후 프로젝트에서 내보내는 reCAPTCHA 측정항목을 모니터링하여 앱이 허용되는 사용자 트래픽을 수신하는지 확인합니다.

다음 단계