Menjalankan contoh aplikasi Web Risk

Pelajari cara menginstal contoh aplikasi Web Risk Go dari GitHub dan cara menjalankan aplikasi contoh untuk mendeteksi URL berbahaya di lingkungan Go.


Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, klik Pandu saya:

Pandu saya


Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan API Web Risk.

    Mengaktifkan API

  5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan API Web Risk.

    Mengaktifkan API

  8. Buat kunci API baru untuk autentikasi:
    1. Di menu navigasi Konsol Google Cloud, klik APIs & Services > Credentials.
    2. Pada halaman Credentials, klik Create credentials, lalu pilih API key.
    3. Pada dialog API key created, klik Copy key untuk menyalin kunci. Tutup dialog dan amankan kunci yang disalin untuk digunakan nanti.
  9. Menyiapkan lingkungan Anda:
    1. Di Konsol Google Cloud, klik Activate Cloud Shell untuk membuka jendela terminal.


      Terminal Cloud Shell dapat memerlukan waktu beberapa detik untuk dimuat sepenuhnya.

    2. Ekspor kunci API yang Anda salin.
    3. export APIKEY=API_KEY
      

Menginstal dan menjalankan contoh aplikasi Web Risk

Aplikasi Web Risk contoh memiliki biner berikut untuk mendeteksi apakah URL berbahaya atau aman:

  • Server wrserver: Biner ini menjalankan proxy pencarian Web Risk API yang memungkinkan Anda memeriksa URL.
  • Command line wrlookup: Biner ini memfilter URL tidak aman yang disalurkan melalui STDIN.

Dokumen panduan memulai ini menunjukkan cara mendeteksi apakah URL tersebut berbahaya atau aman dengan menggunakan server wrserver dan biner command line wrlookup.

Memeriksa URL menggunakan biner server wrserver

  1. Di terminal Cloud Shell, instal wrserver:
    go install github.com/google/webrisk/cmd/wrserver@latest
    
  2. Jalankan wrserver dengan kunci API Anda:
    wrserver -apikey=$APIKEY
    

    Jika Anda melihat pesan Memulai server di localhost:8080, wrserver dimulai di localhost:8080.

  3. Untuk melihat pratinjau aplikasi di localhost, klik Web Preview lalu pilih Preview on port 8080.

    Cloud Shell membuka URL pratinjau (port 8080) pada layanan proxy-nya di jendela browser baru. Jendela browser URL pratinjau menampilkan pesan 404 page not found.

  4. Di jendela URL pratinjau, periksa URL berikut. Untuk memeriksa URL, ganti string kueri setelah URL pratinjau server lokal dengan URL yang ingin Anda periksa dalam format berikut: PREVIEW_URL/r?url=URL_TO_BE_CHECKED.

    Jika URL tidak aman, halaman peringatan interstisial akan ditampilkan seperti yang direkomendasikan oleh Web Risk. Jika URL aman, klien akan otomatis dialihkan ke target.

    URL malware palsu:

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

    URL yang aman:

     http://www.google.com/
    
  5. Untuk menghentikan server, tekan Control+C.

Anda telah berhasil memverifikasi URL dengan menggunakan biner server wrserver.

Memeriksa URL menggunakan biner command line wrlookup

  1. Di terminal Cloud Shell, instal biner command line wrlookup:
    go install github.com/google/webrisk/cmd/wrlookup@latest
  2. Periksa URL dengan kunci API Anda.

    URL malware palsu:

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

    Output berikut adalah output yang disingkat untuk URL malware:

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

    URL yang aman:

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

    Output berikut adalah output yang disingkat untuk URL yang aman:

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

Anda telah berhasil memverifikasi URL dengan menggunakan biner command line wrlookup.

Pembersihan

Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Perhatikan hal-hal berikut saat menghapus project:

  • Menghapus project akan menghapus semua resource dalam project.
  • Anda tidak dapat menggunakan kembali ID project kustom dari project yang telah dihapus.

Jika Anda berencana mempelajari berbagai tutorial dan panduan memulai, menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

Untuk menghapus project Anda, lakukan langkah-langkah berikut:

  1. Di menu navigasi konsol Google Cloud, klik IAM & Admin > Setelan.

    Buka Settings

  2. Konfirmasikan bahwa nama project adalah nama project yang ingin Anda hapus.

    Jika tidak, pilih project yang ingin Anda hapus dari Pemilih project.

  3. Klik Shut down.
  4. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah selanjutnya