Testar o reCAPTCHA em um site de demonstração

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

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

  • Entender a experiência dos usuários com o reCAPTCHA.
  • Usar como referência para integrar o reCAPTCHA ao seu aplicativo.
  • Experimente diferentes abordagens de front-end e back-end editando o código-fonte do aplicativo de exemplo.

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

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

Antes de começar

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

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. É possível selecionar qualquer projeto em que você 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 resourcemanager.projects.create permissão. 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 as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. 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 Google Cloud console, 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 em que você está incluído. Para saber em quais grupos você está incluído, entre em contato com o administrador.

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

    Conceder os papéis

    1. No Google Cloud console, 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 de demonstração relevante.

Implantar um site de demonstração

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

    Acessar o site de demonstração

  2. Na lista Idioma, selecione um idioma.

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

  3. Se solicitado, autorize o Cloud Shell a fazer chamadas usando suas credenciais.

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

  5. Para visualizar o site de demonstração, no card Front-end, clique em Visualizar página da Web de exemplo.

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

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

  7. Se você quiser fazer alterações no site de demonstração, faça o seguinte:

    1. Na página Detalhes da chave, clique em Editar origem.

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

      As alterações salvas no código-fonte são recarregadas no site de demonstração.

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

A seguir