Como usar os recursos do reCAPTCHA Enterprise após a migração

Nesta página, você verá como modificar uma integração reCAPTCHA para usar os recursos do reCAPTCHA Enterprise, como autenticação multifator (MFA, na sigla em inglês) e detecção de vazamento de senha após a migração de uma versão não corporativa do reCAPTCHA. Modificar uma integração reCAPTCHA atual envolve instrumentar as páginas da Web e migrar as chamadas de back-end.

Antes de começar

Migrar para o reCAPTCHA Enterprise

Como instrumentar as páginas da Web

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

  1. Verifique se o script a seguir está incluído nas suas páginas: https://www.google.com/recaptcha/api.js.
  2. Mude o componente api.js para enterprise.js.
  3. Substitua as chamadas para grecaptcha.execute() por grecaptcha.enterprise.execute().

Como migrar as chamadas de back-end

Para usar os recursos do reCAPTCHA Enterprise, é necessário migrar as chamadas de back-end para os novos endpoints e configurar a autenticação:

  1. Substitua as chamadas de back-end para https://www.google.com/recaptcha/api/siteverify por https://recaptchaenterprise.googleapis.com.

  2. Escolha o endpoint e o método de autenticação que você quer usar para criar avaliações:

    Endpoint Método de autenticação Observações
    v1beta1 Chave de API

    Este é o método mais rápido para migrar a chamada de back-end.

    Embora esse método seja mais rápido, recomendamos que você use a API v1 quando possível porque alguns recursos, como a API Annotation estão disponíveis apenas para o v1 API.

    v1 Conta de serviço Este é o método preferido, mas leva mais tempo para migrar chamadas de back-end.
  3. Dependendo do endpoint escolhido, crie uma chave de API ou crie e configure uma conta de serviço.

A seguir