iboss

Versi integrasi: 9.0

Kasus Penggunaan

  1. Lakukan tindakan pengayaan - dapatkan data dari iboss untuk memperkaya data dalam pemberitahuan Google Security Operations.
  2. Melakukan tindakan aktif - memblokir IP atau URL di iboss dari Google SecOps.

Izin Produk

Untuk mengautentikasi, tindakan melakukan dua permintaan. Permintaan pertama adalah untuk mendapatkan token dan permintaan kedua adalah untuk mendapatkan token XSRF khusus.

Mengonfigurasi integrasi iboss di Google SecOps

Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Nama Instance String T/A Tidak Nama Instance yang ingin Anda konfigurasi integrasinya.
Deskripsi String T/A Tidak Deskripsi Instance.
Root Cloud API String https://cloud.iboss.com/ Ya Tentukan Root API cloud iboss.
Root Account API String https://accounts.iboss.com/ Ya Tentukan Root API Akun iboss.
Nama pengguna String T/A Ya Tentukan nama pengguna akun iboss.
Sandi Sandi T/A Ya Tentukan sandi akun iboss.
Verifikasi SSL Kotak centang Tidak dicentang Tidak Jika diaktifkan, pastikan sertifikat SSL untuk koneksi ke server cloud publik iboss valid.
Menjalankan dari Jarak Jauh Kotak centang Dicentang Tidak Centang kolom untuk menjalankan integrasi yang dikonfigurasi dari jarak jauh. Setelah dicentang, opsi akan muncul untuk memilih pengguna jarak jauh (agen).

Tindakan

Ping

Deskripsi

Uji konektivitas ke iboss dengan parameter yang diberikan di halaman konfigurasi integrasi di tab Google Security Operations Marketplace.

Run On

Tindakan ini tidak berjalan pada entity, dan tidak memiliki parameter input wajib.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:
jika berhasil:
print "Successfully connected to the iboss server with the provided connection parameters!"

Tindakan harus gagal dan menghentikan eksekusi playbook:
jika tidak berhasil:

print "Gagal terhubung ke server iboss! Error adalah {0}".format(exception.stacktrace)

 Umum

Menambahkan URL ke Daftar Pemblokiran Kebijakan

Deskripsi

Menambahkan URL ke Daftar Blokir iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Alat Developer (Ctrl + Shift + I di Google Chrome).
  3. Buka tab Jaringan.
  4. Coba edit daftar blokir yang diperlukan.

Di konsol, Anda akan melihat permintaan yang sedang dibuat. Telusuri di antara permintaan tersebut untuk parameter customCategoryId=xxxx.

Parameter
Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan yang ingin Anda tambahi URL.
Prioritas Bilangan bulat 50 Ya Tentukan prioritas URL yang perlu diblokir.
Arah DDL

Tujuan

Nilai yang memungkinkan:

Tujuan

Sumber

Tujuan dan Sumber

 Ya Tentukan arah URL.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan URL yang perlu diblokir. Catatan: Jika hanya "Start Port" atau "End Port" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Akhiri Port Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan URL yang perlu diblokir. Catatan: Jika hanya "Start Port" atau "End Port" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Catatan String T/A Tidak Tambahkan catatan terkait URL yang perlu diblokir.
Adalah Ekspresi Reguler Kotak centang Tidak dicentang Tidak Jika diaktifkan, URL akan dianggap sebagai ekspresi reguler.
Skema Strip Kotak centang Tidak dicentang Tidak Jika diaktifkan, tindakan akan menghapus skema yang terkait dengan URL.

Run On

Tindakan ini berjalan di entity berikut:

  • URL
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

if successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Jika gagal memblokir URL tertentu(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Jika gagal memperkaya semua entitas (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Jika Kebijakan bukan Daftar yang diblokir: (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error executing action "Add URL to Policy Block List". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menambahkan IP ke Daftar Pemblokiran Kebijakan

Deskripsi

Tambahkan IP ke Daftar Blokir iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Alat Developer (Ctrl + Shift + I di Google Chrome).
  3. Buka tab Jaringan.
  4. Coba edit daftar blokir yang diperlukan.

Di konsol, Anda akan melihat permintaan yang sedang dibuat. Telusuri di antara permintaan tersebut untuk parameter customCategoryId=xxxx.

Parameter
Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan yang ingin Anda tambahi URL.
Prioritas Bilangan bulat 50 Ya Tentukan prioritas URL yang perlu diblokir.
Arah DDL

Tujuan

Nilai yang memungkinkan:

Tujuan

Sumber

Tujuan dan Sumber

 Ya Tentukan arah URL.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan URL yang perlu diblokir. Catatan: Jika hanya "Start Port" atau "End Port" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Akhiri Port Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan URL yang perlu diblokir. Catatan: Jika hanya "Start Port" atau "End Port" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Catatan String T/A Tidak Tambahkan catatan terkait URL yang perlu diblokir.
Adalah Ekspresi Reguler Kotak centang Salah Tidak Jika diaktifkan, URL akan dianggap sebagai ekspresi reguler.

Run On

Tindakan ini dijalankan pada entity Alamat IP.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

if successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Jika gagal memblokir URL tertentu(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Jika gagal memperkaya semua entitas (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Jika Kebijakan bukan Daftar blokir: (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error executing action "Add URL to Policy Block List". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menambahkan IP ke Daftar Pemblokiran Kebijakan

Deskripsi

Tambahkan IP ke Daftar Blokir iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Alat Developer (Ctrl + Shift + I di Google Chrome).
  3. Buka tab Jaringan.
  4. Coba edit daftar blokir yang diperlukan.

Di konsol, Anda akan melihat permintaan yang sedang dibuat. Telusuri di antara permintaan tersebut untuk parameter customCategoryId=xxxx.

Parameter
Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan yang ingin Anda tambahi IP.
Prioritas Bilangan bulat 50 Ya Tentukan prioritas IP yang perlu diblokir.
Arah DDL

Tujuan

Nilai yang memungkinkan:

Tujuan

Sumber

Tujuan dan Sumber

 Ya Tentukan arah IP.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan IP yang perlu diblokir. Catatan: Jika hanya "Start Port" atau "End Port" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Akhiri Port Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan IP yang perlu diblokir. Catatan: Jika hanya "Start Port" atau "End Port" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Catatan String T/A Tidak Tambahkan catatan terkait IP yang perlu diblokir.
Adalah Ekspresi Reguler Kotak centang Tidak dicentang Tidak Jika diaktifkan, IP akan dianggap sebagai ekspresi reguler.

Run On

Tindakan ini dijalankan pada entity Alamat IP.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

if successful and at least one of the provided IPs were blocked(is_success = true):
print "Successfully blocked the following IPs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Jika gagal memblokir IP tertentu(is_success = true):
print "Action was not able to block the following IPs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Jika gagal memperkaya semua entitas (is_success = false):

print: "No IPs were blocked in the iboss category with ID {0}.".format(category_id)

Jika Kebijakan bukan Daftar yang diblokir: (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error executing action "Add IP to Policy Block List". Alasan: {0}''.format(error.Stacktrace)

 Umum

Mencantumkan Entri Daftar Blokir Kebijakan

Deskripsi

Menampilkan entri Daftar Blokir iboss dalam grup tertentu.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Alat Developer (Ctrl + Shift + I di Google Chrome).
  3. Buka tab Jaringan.
  4. Coba edit daftar blokir yang diperlukan.

Di konsol, Anda akan melihat permintaan yang sedang dibuat. Telusuri di antara permintaan tersebut untuk parameter customCategoryId=xxxx.

Parameter
Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan tempat Anda ingin mencantumkan entri Daftar Blokir.
Jumlah Maksimum Entri yang Akan Ditampilkan Bilangan bulat 50 Ya Tentukan jumlah entri yang akan ditampilkan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "entries": [
       {
          "direction": 0,
          "endPort": 0,
          "isRegex": 0,
          "note": "",
          "priority": 0,
          "startPort": 0,
          "type": 0,
          "url": "asaa.com",
          "weight": 501
       }
    ],
    "message": ""
}
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

if successful returned and is available data(is_success = true):
print "Successfully listed entries from the iboss Block List in a category with ID '{0}'".format(category_id)

Jika ditampilkan dan tidak ada data (is_success = false):

print: "No Block List entries were found in the iboss category with ID {0}.".format(category_id)

Jika Kebijakan bukan Daftar yang diblokir: (is_success = false)

Mencetak "Kategori dengan ID {category_id} tidak dikaitkan dengan Daftar blokir."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error executing action "List Policy Block List Entries". Alasan: {0}''.format(error.Stacktrace)

 Umum
Repositori Kasus CSV

Nama: "Entri Daftar Blokir. Kategori {0}".format(Category)

Kolom:

  • Nama (dipetakan sebagai URL)
  • Prioritas (dipetakan sebagai prioritas)
  • Berat (dipetakan sebagai berat)
  • Arah (dipetakan sebagai direction. Periksa perilaku tindakan)
  • Start Port (dipetakan sebagai startPort)
  • End Port (dipetakan sebagai endPort)
  • Catatan (dipetakan sebagai catatan)
  • Regex (dipetakan sebagai isRegex. 1 = Benar, 0 = Salah)

Menghapus URL dari Daftar Blokir Kebijakan

Deskripsi

Hapus URL dari Daftar Blokir iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Alat Developer (Ctrl + Shift + I di Google Chrome).
  3. Buka tab Jaringan.
  4. Coba edit daftar blokir yang diperlukan.

Di konsol, Anda akan melihat permintaan yang sedang dibuat. Telusuri di antara permintaan tersebut untuk parameter customCategoryId=xxxx.

Parameter
Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan tempat Anda ingin menghapus URL.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan URL yang perlu dihapus. Parameter ini wajib diisi jika URL yang diinginkan memiliki port awal yang ditentukan. Ini adalah batasan iboss.
Akhiri Port Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan URL yang perlu dihapus. Parameter ini wajib diisi jika URL yang diinginkan memiliki port akhir yang ditentukan. Ini adalah batasan iboss.
Skema Strip Kotak centang Tidak dicentang Tidak Jika diaktifkan, tindakan akan menghapus skema yang terkait dengan URL.

Run On

Tindakan ini berjalan di entity berikut:

  • URL
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

jika berhasil dan setidaknya salah satu URL yang diberikan dihapus (is_success = true):
print "Successfully removed the following URLs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Jika gagal menghapus URL tertentu(is_success = true):

print "Action was not able to remove the following URLs from the category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Jika gagal memperkaya semua entitas (is_success = false):

Cetak: "No URLs were removed from the iboss category with ID {0}.".format(category_id)

Jika Kebijakan bukan Daftar yang diblokir: (is_success = false):

Mencetak "Kategori dengan ID {category_id} tidak dikaitkan dengan Daftar blokir."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau lainnya:

print "Error executing action "Remove URL from Policy Block List". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menghapus IP dari Daftar Blokir Kebijakan

Deskripsi

Hapus IP dari Daftar Blokir iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Alat Developer (Ctrl + Shift + I di Google Chrome).
  3. Buka tab Jaringan.
  4. Coba edit daftar blokir yang diperlukan.

Di konsol, Anda akan melihat permintaan yang sedang dibuat. Telusuri di antara permintaan tersebut untuk parameter customCategoryId=xxxx.

Parameter
Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan dari kategori kebijakan mana Anda ingin menghapus IP.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan IP yang perlu dihapus. Parameter ini wajib diisi jika URL yang diinginkan memiliki port awal yang ditentukan. Ini adalah batasan iboss.
Akhiri Port Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan IP yang perlu dihapus. Parameter ini wajib diisi jika IP yang diinginkan memiliki port akhir yang ditentukan. Ini adalah batasan iboss.

Run On

Tindakan ini dijalankan pada entity Alamat IP.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

jika berhasil dan setidaknya salah satu URL yang diberikan dihapus (is_success = true):
print "Successfully removed the following IPs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Jika gagal menghapus URL tertentu(is_success = true):

print "Action was not able to remove the following IPs from the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Jika gagal memperkaya semua entitas (is_success = false):

print: "No IPs were removed from the iboss category with ID {0}.".format(category_id)

Jika Kebijakan bukan Daftar yang diblokir: (is_success = false)

Mencetak "Kategori dengan ID {category_id} tidak dikaitkan dengan Daftar blokir."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error executing action "Remove IP from Policy Block List". Alasan: {0}''.format(error.Stacktrace)

 Umum

Pencarian URL

Deskripsi

Lakukan Penelusuran URL.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Grup Bilangan bulat T/A Tidak Tentukan grup mana yang akan melakukan Penelusuran URL. Jika tidak ada yang ditentukan, grup "Default" akan digunakan.

Run On

Tindakan ini berjalan di entity berikut:

  • URL
  • Hostname

Hasil Tindakan

Pengayaan Entity
Nama Kolom Pengayaan Sumber (Kunci JSON) Logika - Kapan harus diterapkan
IBOSS_group_{group_id}_categories kategori Jika tersedia dalam JSON
IBOSS_group_{group_id}_action tindakan Jika tersedia dalam JSON
IBOSS_group_{group_id}_message pesan Jika tersedia dalam JSON
Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "action": "Not Blocked",
    "categories": "Pornography/Nudity",
    "message": "Url Known."
}
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil dan setidaknya salah satu URL yang diberikan telah dicari (is_success = true):
print "Successfully retrieved information about the following URLs: \n {0}".format( entity.identifier list)

Jika gagal mencari URL tertentu(is_success = true):

Print: "Action was not able to retrieve information about the following URLs\n: {0}".format([entity.identifier])

Jika gagal mencari semua entitas (is_success = false):

Mencetak "No information was retrieved about URLs."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error executing action "URL Lookup". Alasan: {0}''.format(error.Stacktrace)

 Umum

Pengkategorian Ulang URL

Deskripsi

Kirimkan URL untuk dikategorikan ulang.

Run On

Tindakan ini dijalankan pada entity URL.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

jika berhasil dan setidaknya salah satu URL yang diberikan dikirimkan(is_success = true):
print "Successfully submitted the following URLs for recategorization: \n {0}".format( entity.identifier list)

Jika gagal menghapus URL tertentu(is_success = true):

print "Action was not able to submit the following URLs for recategorization\n: {0}".format([entity.identifier])

Jika gagal memperkaya semua entitas (is_success = false):

cetak: "Tidak ada URL yang dikirimkan untuk dikategorikan ulang."

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

print "Error saat menjalankan tindakan "Pengategorian Ulang URL". Alasan: {0}''.format(error.Stacktrace)

 Umum

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.