Menjalankan contoh aplikasi Web Risk

Menjalankan contoh aplikasi Web Risk

Pelajari cara menginstal aplikasi contoh 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. 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. Buat kunci API baru untuk autentikasi:
   1. Di menu navigasi konsol Google Cloud, klik APIs & Services > Credentials.
   2. Di halaman Credentials, klik Create credentials, lalu pilih API key.
   3. Di dialog API key created, untuk menyalin kunci, klik Copy key. Tutup dialog dan amankan kunci yang Anda salin untuk digunakan nanti.
9. Siapkan 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.

   export APIKEY=API_KEY

Menginstal dan menjalankan contoh aplikasi Web Risk

Contoh aplikasi Web Risk 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.
• Perintah command line wrlookup: Biner ini memfilter URL tidak aman yang disalurkan melalui STDIN.

Dokumen panduan memulai ini menunjukkan cara mendeteksi apakah URL berbahaya atau aman 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

   Saat Anda melihat pesan Starting server at localhost:8080, wrserver akan 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 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 singkat untuk URL malware:

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

   URL yang aman:

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

   Output berikut adalah output singkat untuk URL yang aman:

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

Anda telah berhasil memverifikasi URL menggunakan biner command line wrlookup.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda 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 tersebut.
• Anda tidak dapat menggunakan kembali project ID kustom untuk project yang telah dihapus.

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

Untuk menghapus project, lakukan langkah-langkah berikut:

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

   Buka Setelan

2. Pastikan nama project adalah nama project yang ingin Anda hapus.

   Jika tidak, pilih project yang ingin dihapus dari Project selector.

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

Langkah selanjutnya

• Pelajari Web Risk lebih lanjut.
• Pelajari aplikasi Web Risk lebih lanjut di project GitHub Web Risk.