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 amostra 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 ao 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.

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

Antes de começar

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Enable the reCAPTCHA Enterprise API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  3. Make sure that you have the following role or roles on the project: reCAPTCHA Enterprise Admin, reCAPTCHA Enterprise Agent

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM

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

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

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, adicione-os clicando em Adicionar outro papel.
    7. Clique em Salvar.

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

Implantar um site de demonstração

  1. No console 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 acessar 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