마이그레이션 후 reCAPTCHA 기능 사용

이 페이지에서는 reCAPTCHA 클래식에서 마이그레이션한 후 다단계 인증(MFA) 및 비밀번호 유출 감지와 같은 reCAPTCHA 기능을 사용하도록 기존 reCAPTCHA 통합을 수정하는 방법을 설명합니다. 기존 reCAPTCHA 통합 수정에는 웹페이지 계측 및 백엔드 호출 마이그레이션이 포함되어 있습니다.

시작하기 전에

reCAPTCHA로 마이그레이션

웹페이지 계측

reCAPTCHA 스크립트와 호출로 웹페이지를 계측하려면 다음을 수행합니다.

  1. 웹페이지에 다음 스크립트가 포함되어 있는지 확인합니다. https://www.google.com/recaptcha/api.js

  2. 웹페이지에서 https://www.google.com/recaptcha/api.js를 https://www.google.com/recaptcha/enterprise.js로 바꿉니다.

  3. 프로그래매틱 방식으로 API를 호출하는 경우 다음 호출을 바꿉니다.

    • grecaptcha.execute() -> grecaptcha.enterprise.execute()
    • grecaptcha.getResponse() -> grecaptcha.enterprise.getResponse()
    • grecaptcha.ready() -> grecaptcha.enterprise.ready()
    • grecaptcha.render() -> grecaptcha.enterprise.render()
    • grecaptcha.reset() -> grecaptcha.enterprise.reset()

(선택사항) reCAPTCHA의 로드 성능을 향상시키려면 다음 안내를 따르세요.

  1. enterprise.js를 비동기적으로 로드하는지 확인합니다. 자세한 내용은 비동기적으로 reCAPTCHA 로드를 참조하세요.

  2. enterprise.js를 로드하는 페이지의 <head> 태그에 다음 리소스 힌트를 추가합니다.

    • <link rel="preconnect" href="https://www.google.com">
    • <link rel="preconnect" href="https://www.gstatic.com" crossorigin>

백엔드 호출 마이그레이션

reCAPTCHA 기능을 사용하려면 백엔드 호출을 새 엔드포인트로 마이그레이션하고 인증을 설정해야 합니다.

  1. https://www.google.com/recaptcha/api/siteverify에 대한 백엔드 호출을 recaptchaenterprise.googleapis.com에 대한 동일한 호출로 바꿉니다. 전체 URL과 POST 데이터 형식은 웹사이트 평가 만들기를 참조하세요.

  2. reCAPTCHA에 대한 인증을 설정합니다.

    reCAPTCHA가 설정된 환경에 따라 선택하는 인증 방법이 달라집니다. 다음 표는 인증을 설정하는 데 적합한 인증 방법과 지원되는 인터페이스를 선택하는 데 도움이 됩니다.

    환경 인터페이스 인증 방법
    Google Cloud
    • REST
    • 클라이언트 라이브러리
    		 연결된 서비스 계정을 사용합니다.
    온프레미스 또는 다른 클라우드 제공업체 REST API 키 또는워크로드 아이덴티티 제휴를 사용합니다.

    API 키를 사용하려면 API 키 제한사항을 적용하여 API 키를 보호하는 것이 좋습니다.
    클라이언트 라이브러리

    다음 중 하나를 사용합니다.

다음 단계