reCAPTCHA v2, v3, Enterprise: 필요한 유형 파악하기
먼저 페이지가 v2와 v3 중 무엇을 사용하는지 확인한 다음, Enterprise를 사용하는지 확인하세요. Enterprise는 체크박스 키와 점수 기반 키를 모두 사용할 수 있으므로 이름만으로는 어떤 흐름인지 알 수 없습니다. solvethree는 일반 v3와 Enterprise v3를 해결하지만 v2는 지원하지 않습니다.
이 페이지의 내용
페이지에서 실제로 알 수 있는 정보
| 발견한 항목 | 알 수 있는 정보 |
|---|---|
| reCAPTCHA 체크박스 위젯 | 체크박스 흐름이며, 점수 기반 v3라는 증거는 아닙니다. 통합에 기존 라이브러리와 Enterprise 라이브러리 중 무엇이 사용되는지 확인하세요. |
| 체크박스 없음 | 이것만으로는 판단할 수 없습니다. v2도 보이지 않게 실행될 수 있으므로, 페이지에 표시되는 것이 없다고 해서 v3라고 단정할 수 없습니다. |
| 이름이 지정된 액션을 사용하는 점수 기반 실행 | v3라는 근거입니다. 실행에 사용되는 라이브러리와 키 설정을 확인하세요. |
| api.js | 기존 reCAPTCHA 라이브러리입니다. 파일 이름만으로는 v2와 v3를 구분할 수 없습니다. |
| enterprise.js | Enterprise 라이브러리입니다. 키 유형과 흐름을 추가로 확인해야 하며, 이것만으로 v3라고 단정할 수 없습니다. |
<!-- Classic script: investigate whether the page uses v2 or v3. -->
<script src="https://www.google.com/recaptcha/api.js?render=PUBLIC_SITE_KEY"></script>
<!-- Enterprise script: investigate which Enterprise key type is in use. -->
<script src="https://www.google.com/recaptcha/enterprise.js?render=PUBLIC_SITE_KEY"></script>이 스크립트 태그는 식별용 예시이며, 해결 요청이 아닙니다. 스크립트 파일 이름만 보고 작업을 선택하지 말고, 보호된 상호작용에 사용되는 코드를 살펴보세요. 토큰 문자열만으로는 어떤 흐름에서 생성되었는지 알 수 없습니다.
호스트 이름과 액션 확인
점수 기반 통합이라면 완료해야 하는 상호작용에 사용되는 액션을 찾으세요. 버튼 레이블로 추측하거나 다른 페이지의 액션을 재사용하지 마세요. 웹사이트는 백엔드에서 예상 액션을 확인할 수 있으므로, 다른 상호작용용 토큰으로 대체할 수 없습니다.
대상 호스트 이름과 환경도 확인하세요. 통합을 직접 관리한다면 키 설정을 확인해 페이지의 모호한 단서를 명확히 판단하세요. 공개 사이트 키는 웹사이트 통합을 식별하며, 웹사이트의 검증용 비밀 키나 solvethree API 키가 아닙니다.
페이지의 액션이 명확하지 않다면 reCAPTCHA 액션 찾기를 참고하세요.
일치하는 작업 선택
| 확인된 통합 | 조치 방법 |
|---|---|
| 점수 기반 reCAPTCHA Enterprise | reCAPTCHA v3 Enterprise 작업을 사용하세요. recaptchaType의 기본값은 enterprise-v3이며, 명시적으로 선택할 수도 있습니다. |
| 기존 점수 기반 reCAPTCHA v3 | 게이트웨이는 recaptchaType을 v3로 설정한 요청을 허용합니다. Enterprise 기본값에 의존하지 말고 명시적으로 선택하세요. |
| Enterprise 체크박스 흐름을 포함한 체크박스 또는 보이지 않는 reCAPTCHA v2 | solvethree에서 지원하지 않습니다. recaptchaType을 변경해도 v2 흐름이 v3로 바뀌지 않습니다. |
| Enterprise 스크립트이지만 흐름이 아직 불명확함 | 작업을 생성하기 전에 키 유형과 실행 흐름을 확인하세요. |
유형을 확인했다면 첫 해결 요청 전에 해당 사이트 프로필을 설정하세요.
사이트 프로필 설정과 reCAPTCHA API 통합을 이어서 진행하세요.
출처 및 API 레퍼런스
첫 작업을 실행하세요.
워크스페이스 크레딧 $5로 시작하세요.