Testar o reCAPTCHA em um site de demonstração

Neste documento, mostramos como implantar um site de demonstração no Google Cloud, que é um site de exemplo integrado ao reCAPTCHA, para entender como ele funciona.

Um site de demonstração ajuda você a:

  • Entenda a experiência dos usuários com o reCAPTCHA.
  • Use como referência para integrar o reCAPTCHA no seu próprio aplicativo.
  • Teste diferentes abordagens de front-end e back-end editando o código-fonte do aplicativo de amostra.

É possível implantar um site de demonstração em uma das seguintes linguagens: Java, Node.js ou Python.

Para um projeto Google Cloud , só é possível implantar um site de demonstração por vez.

Antes de começar

  1. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .

    Funções necessárias para selecionar ou criar um projeto

    • Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

    Acessar o seletor de projetos

  2. Ative a API reCAPTCHA Enterprise.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

  3. Verifique se você tem os seguintes papéis no projeto: Administrador do reCAPTCHA Enterprise, agente do reCAPTCHA Enterprise

    Verificar os papéis

    1. No console do Google Cloud , acesse a página IAM.

      Acessar IAM
    2. Selecione o projeto.

    3. Na coluna Principal, encontre todas as linhas que identificam você ou um grupo no qual você está incluído. Para saber em quais grupos você está incluído, entre em contato com o administrador.

    4. Em todas as linhas que especificam ou incluem você, verifique a coluna Papel para ver se a lista de papéis inclui os papéis necessários.

    Conceder os papéis

    1. No console do Google Cloud , acesse a página IAM.

      Acessar IAM
    2. Selecione o projeto.
    3. Clique em Conceder acesso.

    4. No campo Novos principais, digite seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

    5. Clique em Selecionar um papel e pesquise o papel.
    6. Para conceder outros papéis, adicione-os clicando em Adicionar outro papel.
    7. Clique em Salvar.

  4. Se você já implantou um site de demonstração, exclua a chave relevante.

Implantar um site de demonstração

  1. No console do Google Cloud , acesse a página do site de demonstração.

    Acessar o site de demonstração

  2. Na lista Idioma, selecione uma opção.

    Todo o processo de implantação pode levar cerca de um minuto.

  3. Se necessário, autorize o Cloud Shell a fazer chamadas usando suas credenciais.

  4. Para navegar até a nova página de Detalhes da chave da demonstração, clique em Ver site.

  5. Para acessar o site de demonstração, no card Frontend, clique em View sample web page.

    O site de demonstração é aberto em uma guia separada.

  6. Para conhecer os padrões de integração do reCAPTCHA ao seu site, clique nos exemplos.

  7. Se você quiser fazer mudanças no site de demonstração, faça o seguinte:

    1. Na página Detalhes principais, clique em Editar fonte.

    2. No editor do Cloud Shell, encontre os arquivos necessários no Explorer e edite-os conforme necessário.

      As mudanças salvas no código-fonte são recarregadas no site de demonstração.

    Não feche o editor do Cloud Shell, porque isso fecha o Cloud Shell e interrompe o site de demonstração.

A seguir