여러 reCAPTCHA 액션에 사용할 프로필 구성

사이트 프로필에서 호스트 이름, 캡처 액션, reCAPTCHA 유형의 조합마다 프로필을 하나씩 설정하세요. 이 예제에서는 두 프로필 모두 accounts.example.com과 Enterprise v3를 사용합니다.

1. 1.

   로그인 프로필 추가하기

   사이트 추가를 선택하세요. 로그인 액션이 실행되는 HTTPS 페이지 URL을 입력하고, Enterprise v3를 선택한 다음, 캡처 액션을 login으로 설정하세요. 양식에서는 탐색 URL, 사이트 키, Referer 값도 선택적으로 입력할 수 있습니다. 사이트 추가를 눌러 제출하세요.

2. 2.

   결제 프로필 추가하기

   동일한 호스트 이름의 결제 페이지에서도 같은 절차를 반복하되, Enterprise v3는 유지하고 캡처 액션을 checkout으로 설정하세요.

3. 3.

   두 프로필 모두 활성 상태인지 확인하기

   해결을 시작하려면 워크스페이스에서 활성 프로필을 사용할 수 있어야 합니다. 캡처가 실패하면 재시도하기 전에 표시된 사유를 확인하세요. 호스트 이름과 액션을 지정하여 작업을 전송해도 누락된 프로필이 생성되지는 않습니다.

아래의 각 객체를 별도의 POST /v1/tasks 요청으로 전송하세요. Authorization: Bearer를 사용하여 워크스페이스 API 키로 인증하고, 해당 키는 서버에 보관하세요.

[
  {
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "login-flow-001"
  },
  {
    "site": "accounts.example.com",
    "action": "checkout",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "checkout-flow-001"
  }
]

호스트 이름과 프록시 자리표시자를 대상 호스트 이름과 프록시 URL로 바꾸세요. 각 요청에는 proxy를 하나만 제공하며, proxyCandidates를 추가하지 마세요. 생략된 recaptchaType의 기본값은 enterprise-v3입니다. 이 reCAPTCHA 요청에는 type 또는 url 필드를 추가하지 마세요.

두 requestId 값은 서로 다른 논리적 작업을 식별합니다. 새 해결 작업에는 새 ID를 사용하세요. 작업 생성 중 시간 초과가 발생하면 동일한 요청에 동일한 ID를 재사용하여 기존 작업을 복구하세요. 입력이 다른데 ID를 재사용하면 충돌이 발생합니다.

호스트 이름과 reCAPTCHA 유형이 일치하면 실행 액션과 정확히 일치하는 프로필이 선택됩니다. login은 로그인 프로필을, checkout은 결제 프로필을 선택합니다.

다른 실행 액션을 사용하려면 모호하지 않은 단일 캡처 대상이 필요합니다. 가능한 대상이 여러 개라면 solvethree가 임의의 프로필을 선택한다고 가정하지 마세요. 가능하면 설정된 캡처 액션을 사용하세요. 선택이 모호하다는 응답이 나오면 작업의 호스트 이름, reCAPTCHA 유형, 액션을 콘솔의 프로필과 비교하고, 실제 콘솔/API 응답을 바탕으로 불일치를 진단하세요.

액션마다 고유한 사이트 키를 사용하는 것이 라우팅 규칙은 아닙니다. 사이트 키로 액션을 구분하려 하지 말고 호스트 이름, 캡처 액션, reCAPTCHA 유형을 기준으로 프로필을 설정하세요.