iboss

Dokumen ini memberikan panduan tentang cara mengintegrasikan iboss dengan Google SecOps.

Kasus Penggunaan

  1. Melakukan tindakan pengayaan - mendapatkan 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 melakukan autentikasi, 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 Diisi Deskripsi
Nama Instance String T/A Tidak Nama Instance yang ingin Anda konfigurasi integrasinya.
Deskripsi String T/A Tidak Deskripsi Instance.
Cloud API Root String https://cloud.iboss.com/ Ya Tentukan Root API cloud iboss.
Root API Akun 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 disediakan di halaman konfigurasi integrasi di halaman Google SecOps Content Hub.

Dijalankan Pada

Tindakan ini tidak berjalan di 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:
cetak "Successfully connected to the iboss server with the provided connection parameters!"

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

print "Failed to connect to the iboss server! Error is {0}".format(exception.stacktrace)

 Umum

Tambahkan URL ke Daftar Blokir Kebijakan

Deskripsi

Tambahkan URL ke Daftar yang Diblokir iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Developer Tools (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 Diisi 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 "Port Mulai" atau "Port Akhir" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Port Akhir Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan URL yang perlu diblokir. Catatan: jika hanya "Port Mulai" atau "Port Akhir" 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.

Dijalankan Pada

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 tidak diizinkan: (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, atau error lainnya:

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

 Umum

Menambahkan IP ke Daftar Blokir Kebijakan

Deskripsi

Tambahkan IP ke Daftar yang Tidak Disetujui iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Developer Tools (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 Diisi 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 "Port Mulai" atau "Port Akhir" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Port Akhir Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan URL yang perlu diblokir. Catatan: jika hanya "Port Mulai" atau "Port Akhir" 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.

Dijalankan Pada

Tindakan ini berjalan di 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 yang tidak diizinkan: (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, atau error lainnya:

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

 Umum

Menambahkan IP ke Daftar Blokir Kebijakan

Deskripsi

Tambahkan IP ke Daftar yang Tidak Disetujui iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Developer Tools (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 Diisi 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 "Port Mulai" atau "Port Akhir" yang ditentukan, nilai akan ditambahkan ke kedua parameter tindakan.
Port Akhir Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan IP yang perlu diblokir. Catatan: jika hanya "Port Mulai" atau "Port Akhir" 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.

Dijalankan Pada

Tindakan ini berjalan di 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 tidak diizinkan: (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, atau error lainnya:

print "Error executing action "Add IP to Policy Block List". Reason: {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 Developer Tools (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 Diisi Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan yang ingin Anda gunakan untuk mencantumkan entri Daftar Blokir.
Jumlah Entri Maksimum yang Akan Ditampilkan Bilangan bulat 50 Ya Tentukan jumlah entri yang akan ditampilkan.

Dijalankan Pada

Tindakan ini tidak berjalan 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:

jika berhasil ditampilkan dan data tersedia(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 tidak diizinkan: (is_success = false)

Cetak "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, atau error lainnya:

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

 Umum
Repositori Kasus CSV

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

Kolom:

  • Nama (dipetakan sebagai URL)
  • Priority (dipetakan sebagai priority)
  • Berat (dipetakan sebagai berat)
  • Direction (dipetakan sebagai direction. Memeriksa perilaku tindakan)
  • Start Port (dipetakan sebagai startPort)
  • Port Akhir (dipetakan sebagai endPort)
  • Catatan (dipetakan sebagai catatan)
  • Regex (dipetakan sebagai isRegex. 1 = Benar, 0 = Salah)

Menghapus URL dari Daftar Blokir Kebijakan

Deskripsi

Menghapus URL dari Daftar yang Tidak Diizinkan iboss.

Cara menemukan ID Kategori

  1. Buka Web Security -> Policy Layers.
  2. Buka Konsol Developer Tools (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 Diisi Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan yang ingin Anda hapus URL-nya.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan URL yang perlu dihapus. Parameter ini wajib jika URL yang diinginkan memiliki port awal yang ditentukan. Ini adalah batasan iboss.
Port Akhir Bilangan bulat T/A Tidak Tentukan port akhir yang terkait dengan URL yang perlu dihapus. Parameter ini wajib 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.

Dijalankan Pada

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 telah 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):

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

Jika Kebijakan bukan Daftar yang tidak diizinkan: (is_success = false):

Cetak "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, atau error lainnya:

print "Error executing action "Remove URL from Policy Block List". Reason: {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 Developer Tools (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 Diisi Deskripsi
ID Kategori Bilangan bulat 1001 Ya Tentukan kategori kebijakan yang ingin Anda hapus IP-nya.
Mulai Transfer Bilangan bulat T/A Tidak Tentukan port awal yang terkait dengan IP yang perlu dihapus. Parameter ini wajib jika URL yang diinginkan memiliki port awal yang ditentukan. Ini adalah batasan iboss.
Port Akhir 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.

Dijalankan Pada

Tindakan ini berjalan di 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 telah 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 tidak diizinkan: (is_success = false)

Cetak "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, atau error lainnya:

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

 Umum

Pencarian URL

Deskripsi

Lakukan Pencarian URL.

Parameter

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

Dijalankan Pada

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):

Cetak "Tidak ada informasi yang diambil tentang URL."

Tindakan akan gagal dan menghentikan eksekusi playbook:

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

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

 Umum

Pengategorian Ulang URL

Deskripsi

Kirim URL untuk kategorisasi ulang.

Dijalankan Pada

Tindakan ini berjalan di 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:

if successful and at least one of the provided URLs was submitted(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):

print: "No URLs were submitted for recategorization."

Tindakan akan gagal dan menghentikan eksekusi playbook:

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

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

 Umum

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