reCAPTCHA 사이트 프로필 설정하기

1. 1.

   워크스페이스 확인

   작업 생성에 사용할 API 키가 속한 워크스페이스에 프로필을 설정하세요. 다른 워크스페이스의 프로필로는 충분하지 않습니다. 콘솔에 '계속하려면 크레딧 추가'가 표시되면 해당 안내에 따라 진행한 후 설정을 계속하세요.

2. 2.

   '사이트 추가' 열기

   '사이트 프로필'에서 '사이트 추가'를 선택하세요. '페이지 URL'에 대상 HTTPS 페이지를 입력하세요. 'reCAPTCHA 유형'에서 페이지에 맞게 Enterprise v3 또는 Regular v3를 선택하세요.

3. 3.

   캡처 입력값 설정

   '캡처 액션'은 필수입니다. 해결하려는 액션을 사용하세요. 확실하지 않다면 먼저 reCAPTCHA 액션을 찾으세요. 폼에는 선택 항목인 '탐색 URL', '사이트 키', 'Referer 값' 필드도 있습니다. 사이트 키는 자동으로 찾을 수 있습니다.

4. 4.

   폼 제출

   '사이트 추가'를 선택하세요. 검토된 시스템 프로필은 실시간 가져오기 없이 알려진 페이지 규약과 캡처 액션을 채울 수 있으며, 폼에 선택된 액션에 대한 설명이 표시됩니다. 그 외 제출 항목은 대기 중, 캡처 중, 검증 중 또는 검토 중 상태로 전환될 수 있습니다.

생성된 프로필의 상태를 확인하세요. ACTIVE는 active로 표시되며, 해결 요청에는 이 상태가 필요합니다. 캡처에 실패하면 콘솔에 이유가 표시되고 재시도할 수 있습니다.

이 작업 본문은 프로필의 호스트 이름과 액션을 사용합니다.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site는 '페이지 URL'의 호스트 이름이며, 스킴이나 경로는 포함하지 않습니다.
• action은 보호된 요청의 액션입니다. 사용하려는 프로필에 맞추세요.
• recaptchaType의 기본값은 enterprise-v3입니다. Regular v3 프로필에는 명시적으로 v3를 설정하세요.
• 프록시 자리표시자를 대상 요청에도 사용할 HTTP(S) 프록시로 바꾸세요.

Python 빠른 시작과 Node.js 빠른 시작에서 요청을 전송하고 결과를 사용하는 방법을 확인할 수 있습니다.

작업에 사용할 수 있는 프로필이 없습니다.

API 키에 연결된 워크스페이스와 작업의 호스트 이름을 설정한 프로필과 비교하세요.

다음을 시도해 보세요: 작업을 생성할 워크스페이스에 대상 사이트 프로필을 추가하세요. 작업 생성을 반복해도 누락된 프로필은 생성되지 않습니다.

프로필이 대기 중, 캡처 중, 검증 중 또는 검토 중입니다.

'사이트 프로필'에서 현재 상태를 확인하세요.

다음을 시도해 보세요: 해결 요청 전에 프로필이 활성 상태가 될 때까지 기다리세요. 이러한 상태는 활성 프로필을 대신할 수 없습니다.

캡처에 실패했습니다.

콘솔에 표시된 실패 이유를 확인하세요.

다음을 시도해 보세요: 해당 이유에 명시된 문제를 수정한 다음 캡처를 다시 시도하세요.

프로필이 활성 상태이지만 대상 액션에 맞는 프로필을 여전히 찾을 수 없습니다.

호스트 이름, 캡처 액션, reCAPTCHA 유형을 비교하세요. 실행 액션이 다르다면 명확하게 식별되는 단일 캡처 대상이 있는지 확인하세요.

다음을 시도해 보세요: 기존 프로필을 선택하려고 작업을 관련 없는 액션으로 변경하지 말고, 대상 호스트 이름, 액션, 유형에 맞는 프로필을 설정하세요.