Use funcionalidades do reCAPTCHA após a migração

Esta página explica como modificar uma integração do reCAPTCHA existente para usar funcionalidades do reCAPTCHA, como a autenticação multifator (MFA) e a defesa de palavras-passe, após a migração do reCAPTCHA clássico. A modificação de uma integração do reCAPTCHA existente envolve a instrumentação das páginas Web e a migração das chamadas de back-end.

Antes de começar

Migre para o reCAPTCHA.

Instrumente as páginas Web

Para instrumentar as páginas Web com os scripts e as chamadas do reCAPTCHA, faça o seguinte:

  1. Confirme se tem o seguinte script incluído nas suas páginas Web: https://www.google.com/recaptcha/api.js.

  2. Nas suas páginas Web, substitua https://www.google.com/recaptcha/api.js por https://www.google.com/recaptcha/enterprise.js.

  3. Se invocar a API de forma programática, substitua as seguintes chamadas:

    • 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()

Migre as chamadas de back-end

Para usar as funcionalidades do reCAPTCHA, tem de migrar as chamadas de back-end para os novos pontos finais e configurar a autenticação:

  1. Substitua as chamadas de back-end para https://www.google.com/recaptcha/api/siteverify por chamadas equivalentes para recaptchaenterprise.googleapis.com. Para ver o URL completo e o formato dos dados POST, consulte o artigo Crie uma avaliação para o seu Website.

  2. Configure a autenticação para o reCAPTCHA.

    O método de autenticação que escolher depende do ambiente onde o reCAPTCHA está configurado. A tabela seguinte ajuda a escolher o método de autenticação adequado e a interface suportada para configurar a autenticação:

    Ambiente Interface Método de autenticação
    Google Cloud
    • REST
    • Bibliotecas cliente
    		 Use contas de serviço anexadas.
    Nas instalações ou num fornecedor de nuvem diferente REST Use chaves da API ou a Workload Identity Federation.

    Se quiser usar chaves da API, recomendamos que as proteja aplicando restrições de chaves da API.
    Bibliotecas cliente

    Use o seguinte:

O que se segue?