Executar o app Web Risk de amostra

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Web Risk 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

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

Verify that billing is enabled for your Google Cloud project.

Enable the Web Risk 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

1. Crie uma chave de API para autenticação:
   1. No menu de navegação do console Google Cloud , clique em APIs e Serviços > Credenciais.
   2. Na página Credenciais, clique em addCriar credenciais e selecione Chave de API.
   3. Na caixa de diálogo Chave de API criada, clique em content_copy Copiar chave para copiar a chave. Feche a caixa de diálogo e proteja a chave que você copiou para uso posterior.
2. Configure seu ambiente:

   1. No console do Google Cloud , clique em Ativar o Cloud Shell para abrir uma janela do terminal.

      
      

      O terminal do Cloud Shell pode levar vários segundos para ser totalmente carregado.

   2. Exporte a chave de API que você copiou.

   export APIKEY=API_KEY

Instalar e executar o app Web Risk de amostra

O app Web Risk tem os seguintes binários para detectar se os URLs são maliciosos ou seguros:

• Servidor wrserver: este binário executa o proxy de pesquisa da API Web Risk, que permite verificar URLs.
• Linha de comando wrlookup: este binário filtra URLs perigosos transmitidos pelo STDIN.

Este guia de início rápido mostra como detectar se os URLs são maliciosos ou seguros usando os binários de servidor wrserver e de linha de comando wrlookup.

Verificar URLs usando o binário de servidor wrserver

1. No terminal do Cloud Shell, instale wrserver:

   go install github.com/google/webrisk/cmd/wrserver@latest

2. Execute wrserver com sua chave de API:

   wrserver -apikey=$APIKEY

   Quando você vir a mensagem Start server at localhost:8080, o wrserver é iniciado em localhost:8080.

3. Para visualizar o aplicativo no host local, clique em Visualização na Web e selecione Visualizar na porta 8080.
   

   O Cloud Shell abre o URL de visualização (porta 8080) no serviço de proxy em uma nova janela do navegador. A janela do navegador do URL de visualização mostra uma mensagem 404 página não encontrada.

4. Na janela do URL de visualização, verifique os URLs a seguir. Para verificar um URL, substitua a string de consulta que fica depois do URL de visualização do servidor local pelo URL que você quer verificar no seguinte formato: PREVIEW_URL/r?url=URL_TO_BE_CHECKED.

   Se o URL não for seguro, uma página de aviso intersticial será exibida conforme recomendado pelo Web Risk. Se o URL for seguro, o cliente será redirecionado automaticamente para o destino.

   Um URL de malware falso:

   http://testsafebrowsing.appspot.com/apiv4/ANY_PLATFORM/MALWARE/URL/

   Um URL seguro:

    http://www.google.com/

5. Para interromper o servidor, pressione Control+C.

Os URLs foram verificados usando o binário de servidor wrserver.

Verificar URLs usando o binário de linha de comando wrlookup

1. No terminal do Cloud Shell, instale o binário da linha de comando wrlookup:

   go install github.com/google/webrisk/cmd/wrlookup@latest

2. Verifique os URLs com sua chave de API.

   Um URL de malware falso:

    echo "http://testsafebrowsing.appspot.com/apiv4/ANY_PLATFORM/MALWARE/URL/" | wrlookup -apikey=$APIKEY

   A saída a seguir é abreviada para um URL de malware:

      ......
      Unsafe URL: [MALWARE]
   

   Um URL seguro:

    echo "http://www.google.com/" | wrlookup -apikey=$APIKEY

   A saída a seguir é abreviada para um URL seguro:

      ......
      Safe URL: http://google.com
   

Os URLs foram verificados usando o binário de linha de comando wrlookup.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

Tenha isto em mente ao excluir um projeto:

• A exclusão de um projeto exclui todos os recursos dele.
• Não é possível reutilizar o ID personalizado de um projeto excluído.

Se você planeja ver vários tutoriais e guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

Para excluir seu projeto, faça o seguinte:

1. No menu de navegação do console Google Cloud , clique em IAM e administrador > Configurações.

   Acesse configurações

2. Confirme se o nome do projeto corresponde ao que você quer excluir.

   Caso contrário, escolha o projeto que você quer excluir no seletor de projetos.

3. Clique em Encerrar.
4. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir

• Saiba mais sobre o Web Risk.
• Saiba mais sobre o app Web Risk no projeto do GitHub sobre o Web Risk.