Executar o app Web Risk de amostra

Aprenda a instalar o app Web Risk Go de amostra usando GitHub e como executar o app de exemplo para detectar URLs maliciosos em um ambiente Go.

Para seguir as instruções passo a passo desta tarefa diretamente no console do Google Cloud, clique em Orientação:

Orientações

Antes de começar

  1. 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.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Web Risk API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Web Risk API.

    Enable the API

    8.
  8. Crie uma nova chave de API para autenticação:
    1. No menu de navegação do console do Google Cloud, clique em APIs e serviços > Credenciais.
    2. Na página Credenciais, clique em Criar credenciais. e selecione Chave de API.
    3. Na caixa de diálogo Chave de API criada, clique em Copiar chave para copiar a chave. Feche a caixa de diálogo e proteja a chave que você copiou para uso posterior.
  9. Configure o 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.
      3. 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:

Este documento de início rápido mostra como detectar se os URLs são maliciosos ou seguros usando os binários de linha de comando wrserver e 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 de 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 estas etapas.

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 do 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.

    Se não for, escolha o projeto que deseja excluir do 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