작업이 준비되었습니다. reCAPTCHA 토큰이 거부되는 이유는 무엇인가요?

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

이 예시에서 solution.token은 대상 사이트가 reCAPTCHA 토큰을 요구하는 위치에 제출할 값입니다. id는 solvethree 작업을 식별하며 토큰이 아닙니다. 전체 솔루션 객체도 전송하지 마세요.

응답을 담은 변수만 보지 말고 최종 전송 요청을 검사하세요. 빈 값이나 폼에 남아 있는 이전 토큰이 아니라 현재 토큰이 포함되어 있는지 확인하세요. 공유 로그에 토큰을 남기지 마세요.

제출한 토큰이 올바른데도 대상 사이트에서 계속 거부합니다.

작업의 site 호스트 이름을 보호된 요청의 호스트 이름과 비교하세요. 하위 도메인이나 환경이 다른지 확인하세요.

다음을 시도해 보세요: 사용하려는 호스트 이름에 대한 토큰을 요청하고 해당 대상에 제출하세요. 대상 사이트에는 워크스페이스에서 사용할 수 있는 활성 프로필이 있어야 합니다.

한 상호작용에 대해 요청한 토큰을 다른 상호작용에 사용합니다.

작업의 action이 이 보호된 요청에서 요구하는 정확한 action과 일치하는지 확인하세요.

다음을 시도해 보세요: 제출하는 상호작용에 연결된 action을 사용하세요.

통합에서 잘못된 reCAPTCHA 유형을 사용합니다.

작업 요청의 recaptchaType을 확인하세요. 기본값은 enterprise-v3이며, 게이트웨이는 v3도 허용합니다.

다음을 시도해 보세요: 대상의 제품 유형을 명시적으로 일치시키세요. Enterprise v3에는 enterprise-v3를 사용하세요.

기존 reCAPTCHA와 reCAPTCHA Enterprise의 웹사이트 응답 토큰은 모두 2분 후에 만료되며 한 번만 사용할 수 있습니다. 기존 토큰은 한 번만 검증할 수 있고, Enterprise 토큰은 한 번만 평가할 수 있습니다. 사용 가능한 토큰을 비축하지 말고 보호된 요청을 보내기 직전에 해결하세요.

• 제출이 지연됐다면 해결 시점부터 토큰 전송 시점까지 얼마나 시간이 지났는지 확인하세요.
• 이미 검증되거나 평가된 토큰은 다른 제출에 재사용하지 마세요.
• 대상에 토큰을 보내기 전에 테스트만을 목적으로 별도의 검증이나 Enterprise 평가를 실행하지 마세요. 테스트 과정에서 토큰이 소모될 수 있습니다.

해결에는 성공했지만 제출할 때 다른 연결을 사용합니다.

해결에 성공한 프록시와 보호된 요청에 사용한 프록시를 비교하세요. proxyCandidates를 제공했다면 첫 번째 후보가 성공했다고 가정하지 마세요.

다음을 시도해 보세요: 성공한 프록시를 통해 제출하세요. 해결과 제출 사이에 IP를 바꾸면 요청이 실패할 수 있습니다.

제출하는 클라이언트가 자체 기본 브라우저 헤더를 사용합니다.

전송되는 User-Agent 및 Sec-CH-UA 값을 solution.userAgent 및 solution.secChUa와 비교하세요.

다음을 시도해 보세요: 반환된 브라우저 식별 정보를 성공한 프록시와 함께 사용하세요. 토큰을 관련 없는 user-agent 또는 클라이언트 힌트 값과 조합하지 마세요.

대상의 HTTP 상태뿐 아니라 응답 본문도 확인하세요. 403만으로는 어떤 보호 기능이 요청을 거부했는지 알 수 없습니다. 다른 토큰을 요청하기 전에 명시적인 토큰 오류나 호스트 이름/action 불일치를 확인하세요.

검증 세부 정보를 확인할 수 있다면 기존 reCAPTCHA의 success 결과와 반환된 컨텍스트/오류 정보를 확인하세요. Enterprise에서는 토큰 유효성과 관련 평가 사유를 확인하세요. 점수만으로 거부 이유를 알 수 있다고 가정하지 마세요. 평가를 어떻게 활용할지는 웹사이트가 결정합니다.

그래도 원인을 찾을 수 없다면 작업 ID, 사용한 경우 requestId, 제품, 타임스탬프, 대상 호스트 이름/action, HTTP 상태 또는 작업 오류, 민감한 정보를 제거한 응답 설명을 [email protected]으로 보내세요. API 키, 프록시 비밀번호, 토큰, 쿠키, 고객 데이터는 제거하세요.