웹사이트에 정책 기반 테스트 키 설치

이 페이지에서는 웹사이트에 정책 기반 챌린지 키를 설치하는 방법을 설명합니다. 정책 기반 챌린지 키를 사용하면 reCAPTCHA가 점수 기준점과 챌린지 난이도에 따라 보안문자 챌린지를 결정적으로 트리거할 수 있습니다.

시작하기 전에

  1. reCAPTCHA 환경을 준비합니다.

  2. 정책 기반 챌린지 키를 만듭니다.

    또는 다음 단계 중 하나를 수행하여 기존 정책 기반 챌린지 키의 ID를 복사할 수 있습니다.

    • Google Cloud 콘솔에서 기존 키의 ID를 복사하려면 다음을 수행합니다.

      1. reCAPTCHA 페이지로 이동합니다.

        reCAPTCHA로 이동

      2. reCAPTCHA 키 목록에서 복사할 키 위에 마우스 포인터를 올려놓고 를 클릭합니다.
    • REST API를 사용하여 기존 키의 ID를 복사하려면 projects.keys.list 메서드를 사용합니다.
    • gcloud CLI를 사용하여 기존 키의 ID를 복사하려면 gcloud recaptcha keys list 명령어를 사용합니다.

정책 기반 테스트 키 구성

정책 기반 챌린지 키의 경우 보안문자 챌린지의 복잡성과 빈도를 결정하는 챌린지 난이도를 지정하고 기본 기준점을 재정의하는 특정 작업의 맞춤 점수 기준점을 정의해야 합니다.

  1. Google Cloud 콘솔에서 reCAPTCHA 페이지로 이동합니다.

    reCAPTCHA로 이동

    reCAPTCHA 페이지에는 테이블과 카드라는 두 가지 뷰가 있습니다. 프로젝트에 reCAPTCHA 키가 많은 경우 테이블 뷰만 사용할 수 있습니다.

  2. 페이지 상단의 리소스 선택기에 프로젝트 이름이 표시되는지 확인합니다.

    프로젝트 이름이 표시되지 않으면 리소스 선택기를 클릭한 후 프로젝트를 선택합니다.

  3. reCAPTCHA 키 섹션에서 구성하려는 정책 기반 챌린지 키를 식별하고 키를 클릭합니다.

  4. 주요 세부정보 페이지에서 개요 탭으로 이동합니다.

  5. 구성 섹션에서 챌린지 설정의 구성을 클릭합니다.

  6. 챌린지 설정 구성 페이지에서 챌린지 난이도를 선택합니다.

  7. 보안문자 챌린지를 트리거하려면 슬라이더를 사용하여 기본 기준점 값을 지정합니다.

    0.0의 기본 기준점은 챌린지를 트리거하지 않습니다. 1.0는 모든 요청에 대해 챌린지를 트리거합니다.

  8. 기본 임곗값을 재정의하는 개별 작업의 맞춤 점수 임곗값을 구성하려면 다음 단계를 따르세요.

    1. 작업 이름을 입력합니다.

    2. 맞춤 점수 기준을 지정하려면 작업 기준 설정 슬라이더를 사용하세요.

    3. 완료를 클릭합니다.

  9. 저장을 클릭합니다.

HTML 버튼에 reCAPTCHA 추가

  1. 웹페이지에서 reCAPTCHA를 로드하려면 웹페이지의 <head></head> 요소 내에 정책 기반 챌린지 키가 있는 JavaScript API를 추가합니다.

        <head>
    <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
    ....
    </head>

    reCAPTCHA는 기본적으로 브라우저의 언어를 사용합니다. 다른 언어를 지정하려면 스크립트에서 hl=LANG 속성을 사용합니다. 예를 들어 프랑스어를 사용하려면 <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>를 지정합니다. 지원되는 언어에 대한 자세한 내용은 reCAPTCHA 언어 코드를 참조하세요.

  2. 간단한 HTML 버튼에 reCAPTCHA를 추가하려면 다음을 수행합니다.

    1. 토큰을 처리할 콜백 함수를 정의합니다.

      <script>
   function onSubmit(token) {
     document.getElementById("demo-form").submit();
   } // Use `requestSubmit()` for extra features like browser input validation.
</script>

      자세한 내용은 requestSubmit() 메서드를 참조하세요.

    2. html 버튼에 속성을 추가합니다.

      <button class="g-recaptcha"
data-sitekey="KEY_ID"
data-callback="onSubmit"
data-action="submit">Submit</button>

      배지 위치를 지정하려면 class=g-recaptcha가 있는 요소에서 data-badge=LOCATION 속성을 사용합니다. 기본적으로 위치가 bottomright로 설정됩니다. 다른 가능한 값은 inline 및 bottomleft입니다.

    3. 이 버튼을 사용하여 사이트의 양식을 제출하면 g-recaptcha-response POST 매개변수에 응답 토큰이 포함됩니다.

  3. 토큰이 생성되면 reCAPTCHA 토큰을 백엔드로 보내고 2분 내에 평가를 만듭니다.

다음 단계