Como configurar o reCAPTCHA Enterprise

Neste guia de início rápido, você verá como ativar a API reCAPTCHA Enterprise, configurar a autenticação necessária, definir as variáveis de ambiente e instalar e inicializar o SDK do Cloud.

Antes de começar

  1. Criar um projeto do Google Cloud. Saiba como criar um projeto do Google Cloud.
  2. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

Ative a API

  1. Ative a API reCAPTCHA Enterprise.

    Ative a API

  2. Configure a autenticação:
    1. No Console do Cloud, acesse a página Criar chave da conta de serviço.

      Acessar página "Criar chave da conta de serviço"
    2. Na lista Conta de serviço, selecione Nova conta de serviço.
    3. No campo Nome da conta de serviço, insira um nome.
    4. Na lista Papel, selecione reCAPTCHA Enterprise > Agente do reCAPTCHA Enterprise.

      Observação: o campo Papel autoriza a conta de serviço a acessar recursos. É possível visualizar e alterar esse campo mais tarde usando o Console do Cloud. O papel sugerido, Agente do reCAPTCHA Enterprise, permitirá que a conta de serviço crie e edite avaliações.

      Saiba mais sobre o controle de acesso com o reCAPTCHA Enterprise
    5. Clique em Criar. O download de um arquivo JSON com a chave é feito no computador.
    6. Modifique as permissões de IAM para qualquer pessoa na sua equipe que precise de acesso ao reCAPTCHA Enterprise. Os membros da equipe que visualizam as chaves precisam ter o Revisor Enterprise ReCAPTCHA. Os membros da equipe que criam chaves precisam ter Administrador do ReCAPTCHA Enterprise.
  3. Forneça credenciais de autenticação ao código do aplicativo definindo a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Essa variável se aplica somente à sessão de shell atual. Se você quiser que a variável seja aplicada em sessões de shell futuras, defina a variável no arquivo de inicialização de shell, por exemplo, no arquivo ~/.bashrc ou ~/.profile.

    Linux ou macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

    Exemplo:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Windows

    Para PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

    Exemplo:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Para prompt de comando:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

  4. Instale e inicialize o SDK do Cloud..

A seguir