Teste o reCAPTCHA num Website de demonstração

Este documento mostra como implementar um Website de demonstração no Google Cloud, que é um Website de exemplo integrado com o reCAPTCHA, para compreender como o reCAPTCHA funciona.

Um Website de demonstração ajuda a fazer o seguinte:

  • Compreenda a experiência dos seus utilizadores com o reCAPTCHA.
  • Use como referência para integrar o reCAPTCHA na sua própria aplicação.
  • Experimente diferentes abordagens de frontend e backend editando o código fonte da aplicação de exemplo.

Pode implementar um Website de demonstração num dos seguintes idiomas: Java, Node.js ou Python.

Para um Google Cloud projeto, só pode implementar um Website de demonstração de cada 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.

      Aceder ao IAM

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

    4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

    5. Na lista Selecionar uma função, selecione uma função.
    6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
    7. Clique em Guardar.

  4. Se tiver implementado anteriormente um Website de demonstração, elimine a chave de demonstração relevante.

Implemente um Website de demonstração

  1. Na Google Cloud consola, aceda à página do Website de demonstração.

    Aceder ao Website de demonstração

  2. Na lista Idioma, selecione um idioma.

    Todo o processo de implementação pode demorar cerca de 1 minuto.

  3. Se lhe for pedido, autorize o Cloud Shell a fazer chamadas com as suas credenciais.

  4. Para navegar para a nova página Detalhes principais da demonstração, clique em Ver site.

  5. Para ver o Website de demonstração, no cartão Frontend, clique em Ver página Web de exemplo.

    O Website de demonstração é aberto num separador separado.

  6. Para saber os padrões de integração do reCAPTCHA com o seu Website, clique nos exemplos.

  7. Se quiser fazer alterações ao Website de demonstração, faça o seguinte:

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

    2. No Editor do Cloud Shell, encontre os ficheiros necessários no Explorador e edite-os conforme necessário.

      As alterações guardadas ao código-fonte são recarregadas no Website de demonstração.

    Não feche o editor do Cloud Shell, pois fecha o Cloud Shell e para o Website de demonstração.

O que se segue?