Trend Micro Cloud App Security
Dokumen ini memberikan panduan tentang cara mengintegrasikan Trend Micro Cloud App Security dengan Google SecOps.
Kasus Penggunaan Produk
Melakukan tindakan aktif - memperkaya entity, menelusuri email, memperbarui daftar blokir, memitigasi email/akun.
Cara membuat token API
- Buka Administration > Automation and Integration APIs.
- Tekan tombol "Tambahkan".
- Pilih "Untuk Aplikasi Eksternal".
- Berikan "Name" dan centang semua kotak.
- Tekan "Create Token".
- Salin "Token".
- Perbarui parameter "Kunci API" dalam konfigurasi integrasi.
- Menguji konektivitas.
Mengonfigurasi integrasi Trend Micro Cloud App Security di Google Security Operations
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 |
|---|---|---|---|---|
| Root API | String | https://api-eu.tmcas.trendmicro.com | Ya | Root API instance Trend Micro Cloud App Security. |
| Kunci API | Sandi | T/A | Ya | Kunci API instance Trend Micro Cloud App Security. |
| Verifikasi SSL | Kotak centang | Dicentang | Ya | Jika diaktifkan, setelan ini akan memverifikasi bahwa sertifikat SSL untuk koneksi ke server Trend Micro Cloud App Security valid. |
Tindakan
Ping
Deskripsi
Uji konektivitas ke Trend Micro Cloud App Security dengan parameter yang disediakan di halaman konfigurasi integrasi di halaman Google SecOps Content Hub.
Parameter
T/A
Dijalankan Pada
Tindakan ini tidak berjalan di entity.
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Jika Berhasil (is success = true) - Successfully connected to the Trend Micro Cloud App Security server with the provided connection parameters! Jika tidak Berhasil (is success = false) - Failed to connect to the Trend Micro Cloud App Security server! Error: {0}".format(exception.stacktrace) |
Umum |
Menambahkan Entitas ke Daftar yang Tidak Disetujui
Deskripsi
Menambahkan entitas ke daftar yang tidak diizinkan di Trend Micro Cloud App Security. Entity yang didukung: URL, Hash, dan Email (Entity pengguna yang cocok dengan pola alamat email).
Parameter
| Nama | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|
| T/A | T/A | T/A | T/A |
Dijalankan Pada
Tindakan ini berjalan di entity berikut:
- URL
- Hash
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai | Contoh |
|---|---|---|
| is_success | Benar/Salah | is_success:False |
Repositori Kasus
| Kasus | Berhasil | Gagal | Pesan |
|---|---|---|---|
| jika berhasil untuk 1 entitas | true | false | Berhasil menambahkan entitas berikut ke daftar yang tidak disetujui di Trend Micro Cloud App Security: {\n entity.identifier} |
| jika tidak berhasil untuk 1 entitas | true | false | Tindakan tidak dapat menambahkan entitas berikut ke daftar yang tidak diizinkan di Trend Micro Cloud App Security: {\n entity.identifier} |
| Jika duplikat | true | false | Entitas berikut sudah menjadi bagian dari daftar yang tidak diizinkan di Trend Micro Cloud App Security: {\n entity.identifier} |
| tidak berhasil untuk semua | false | false | Tidak ada entitas yang ditambahkan menggunakan informasi dari Trend Micro Cloud App Security |
| Error fatal, kredensial tidak valid, root API | false | true | Terjadi error saat menjalankan tindakan "Tambahkan Entitas ke Daftar yang Tidak Disetujui". Alasan: {error traceback} |
Mitigasi Email
Deskripsi
Menghapus atau mengarantina email menggunakan Trend Micro Cloud App Security. Catatan: untuk Gmail, Anda hanya dapat menghapus email.
Parameter
| Nama | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|
| ID Pesan | T/A | Ya | Tentukan daftar ID pesan yang dipisahkan koma yang perlu dimitigasi. |
| Tindakan Mitigasi | Hapus Nilai yang Mungkin Muncul: Hapus Karantina |
Ya | Tentukan tindakan mitigasi yang harus diterapkan. |
| Layanan | Gmail Nilai yang Mungkin Muncul Gmail Exchange |
Ya | Tentukan layanan yang digunakan untuk email. |
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 |
Repositori Kasus
| Kasus | Berhasil | Gagal | Pesan |
|---|---|---|---|
| jika berhasil untuk 1 message_id | Benar | false | Berhasil memitigasi email berikut di Trend Micro Cloud App Security: {\n unique message ids} |
| jika tidak berhasil untuk 1 message_id | Benar | false | Tindakan tidak dapat memitigasi email berikut di Trend Micro Cloud App Security: {\n unique message ids} |
| tidak berhasil untuk semua | false | false | Tidak ada email yang dimitigasi Trend Micro Cloud App Security. |
| Error fatal, kredensial tidak valid, root API | false | true | Terjadi error saat menjalankan tindakan "Mitigasi Email". Alasan: {error traceback} |
| Jika "Karantina" dipilih dan "Gmail" adalah layanannya | false | true | Terjadi error saat menjalankan tindakan "Mitigasi Email". Alasan: Anda hanya dapat menghapus email di layanan Gmail. |
Penelusuran Email Entitas
Deskripsi
Menelusuri email berdasarkan entitas di Trend Micro Cloud App Security. Entity yang didukung: URL, Hash, Email (Entity pengguna yang cocok dengan pola alamat email), Subjek Email, Nama File, IP.
Parameter
| Nama | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|
| Jumlah Hari Maksimum ke Belakang | 30 | Tidak | Tentukan berapa hari ke belakang untuk mencari email. Jumlah maksimumnya adalah 90. Default: 30. |
| Jumlah Email Maksimum yang Akan Ditampilkan | 100 | Tidak | Tentukan jumlah email yang akan ditampilkan. Default: 100. |
Dijalankan Pada
Tindakan ini berjalan di entity berikut:
- URL
- Hash
- Subjek Email
- Nama File
- Alamat IP
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai | Contoh |
|---|---|---|
| is_success | Benar/Salah | is_success:False |
Hasil JSON
emails=[{list of unique emails}]
Repositori Kasus
| Kasus | Berhasil | Gagal | Pesan |
|---|---|---|---|
| jika data tersedia: | true | false | Berhasil menampilkan informasi tentang email yang terkait dengan entitas yang diberikan di Trend Micro Cloud App Security. |
| jika data tidak tersedia | false | false | Tidak ada informasi tentang email yang terkait dengan entitas yang ditemukan di Trend Micro Cloud App Security. |
| Error fatal, kredensial tidak valid, root API | false | true | Terjadi error saat menjalankan tindakan "Penelusuran Email Entitas". Alasan: {error traceback} |
| Jika "Max Days Backwards" > 90 | false | true | Terjadi error saat menjalankan tindakan "Penelusuran Email Entitas". Alasan: "Hari Maksimum ke Belakang" harus berada dalam rentang dari 1 hingga 90. |
Memperkaya Entity
Deskripsi
Memperkaya entity dengan informasi dari Trend Micro Cloud App Security. Entity yang didukung: URL, Hash, dan Email (Entity pengguna yang cocok dengan pola alamat email).
Parameter
| Nama | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|
| T/A | T/A | T/A | T/A |
Dijalankan Pada
Tindakan ini berjalan di entity berikut:
- URL
- Hash
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai | Contoh |
|---|---|---|
| is_success | Benar/Salah | is_success:False |
Hasil JSON
blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]
Repositori Kasus
| Kasus | Berhasil | Gagal | Pesan |
|---|---|---|---|
| jika berhasil untuk 1 entitas | true | false | Successfully retrieved information about the following entities from Trend Micro Cloud App Security: {\n entity.identifier} |
| jika tidak berhasil untuk 1 entitas | true | false | Action wasn't able to retrieve information about the following entities from Trend Micro Cloud App Security: {\n entity.identifier} |
| tidak berhasil untuk semua | false | false | Tidak ada entitas yang diperkaya menggunakan informasi dari Trend Micro Cloud App Security |
| Error fatal, kredensial tidak valid, root API | false | true | Terjadi error saat menjalankan tindakan "Enrich Entities". Alasan: {error traceback} |
Memitigasi Akun
Deskripsi
Lakukan tindakan mitigasi pada akun pengguna melalui Trend Micro Cloud App Security.
Parameter
| Nama | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|
| Alamat Email | T/A | Ya | Tentukan daftar alamat email yang dipisahkan koma yang perlu dimitigasi. |
| Tindakan Mitigasi | Nonaktifkan Akun Mengaktifkan MFA Reset Sandi Mencabut Sesi Login |
Ya | Tentukan tindakan mitigasi yang harus diterapkan. |
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 |
Repositori Kasus
| Kasus | Berhasil | Gagal | Pesan |
|---|---|---|---|
| jika berhasil untuk 1 alamat email. | true | false | Berhasil memitigasi akun berikut di Trend Micro Cloud App Security: {\n email addresses} |
| jika tidak berhasil untuk 1 entitas | true | false | Tindakan tidak dapat memitigasi akun berikut di Trend Micro Cloud App Security: {\n email addresses} |
| tidak berhasil untuk semua | false | false | Tidak ada akun yang dimitigasi menggunakan informasi dari Trend Micro Cloud App Security. |
| Pesan Asinkron | false | false | Menunggu tindakan mitigasi selesai… |
| Error fatal, kredensial tidak valid, root API | false | true | Terjadi error saat menjalankan tindakan "Mitigasi Akun". Alasan: {error traceback} |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.