Mimecast
Dokumen ini memberikan panduan tentang cara mengintegrasikan Mimecast dengan Google SecOps.
Kasus Penggunaan
- Melakukan penyerapan pesan
- Melakukan tindakan triase (Menolak/Merilis/Melaporkan pesan)
Sebelum memulai
Sebelum melanjutkan, pastikan lingkungan Mimecast Anda telah disiapkan dengan lisensi produk dan peran administratif yang diperlukan.
Produk dan layanan Mimecast yang diperlukan
Untuk memastikan integrasi Mimecast API 2.0 berfungsi dengan benar, akun Mimecast Anda harus memiliki lisensi untuk produk berikut:
Izin yang Diperlukan untuk peran Mimecast
Untuk mengonfigurasi integrasi Mimecast, Anda harus membuat Peran Mimecast terlebih dahulu dengan izin yang diperlukan di Konsol Admin Mimecast.
Izin yang diperlukan adalah sebagai berikut:
Account | Dashboard | ReadAccount | Monitoring | Held | EditArchive | Search Logs | ReadArchive | View Logs | ReadGateway | Managed Senders | EditGateway | Policies | EditGateway | Policies | ReadGateway | Tracking | Read
Mengonfigurasi integrasi Mimecast 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 |
|---|---|---|---|---|
| Root API | String | https:/<<api root>> | Ya | Root API instance Mimecast. |
| ID Aplikasi | String | T/A | Ya | ID Aplikasi instance Mimecast. |
| Kunci Aplikasi | Sandi | T/A | Ya | Kunci Aplikasi instance Mimecast. |
| Kunci Akses | Sandi | T/A | Ya | Kunci Akses instance Mimecast. |
| Kunci Rahasia | Sandi | T/A | Ya | Kunci Rahasia instance Mimecast. |
| Verifikasi SSL | Kotak centang | Dicentang | Ya | Jika diaktifkan, pastikan sertifikat SSL untuk koneksi ke server Mimecast valid. |
Tindakan
Ping
Deskripsi
Uji konektivitas ke Mimecast 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* | Tindakan ini tidak boleh gagal atau menghentikan eksekusi playbook: Tindakan akan gagal dan menghentikan eksekusi playbook: |
Umum |
Penelusuran Arsip Sederhana
Deskripsi
Telusuri email arsip menggunakan parameter yang ditentukan di Mimecast.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| Kolom yang akan Ditampilkan | CSV | attachmentcount,status,subject, |
Ya | Tentukan daftar kolom yang dipisahkan koma yang perlu ditampilkan. |
| Kotak surat | CSV | T/A | Tidak | Tentukan daftar kotak surat yang dipisahkan koma yang perlu ditelusuri. |
| Dari | CSV | T/A | Tidak | Tentukan daftar alamat email yang dipisahkan koma yang digunakan untuk mengirim email. |
| Ke | CSV | T/A | Tidak | Tentukan daftar alamat email yang dipisahkan koma yang menjadi tujuan pengiriman email. |
| Subjek | String | T/A | Tidak | Tentukan subjek yang perlu ditelusuri. |
| Jangka Waktu | DDL | Sejam Terakhir Nilai yang Mungkin Muncul: Sejam Terakhir 6 Jam Terakhir 24 Jam Terakhir Seminggu Terakhir Sebulan Terakhir Kustom |
Ya | Tentukan jangka waktu untuk penelusuran. Jika "Kustom" dipilih, Anda juga harus memberikan "Waktu Mulai". |
| Waktu Mulai | String | T/A | Tidak | Tentukan waktu mulai untuk penelusuran. Parameter ini wajib diisi jika "Kustom" dipilih untuk parameter "Rentang Waktu". Format: ISO 8601 |
| Waktu Berakhir | String | T/A | Tidak | Tentukan waktu berakhir untuk penelusuran. Format: ISO 8601. Jika tidak ada yang diberikan dan "Kustom" dipilih untuk parameter "Rentang Waktu", parameter ini akan menggunakan waktu saat ini. |
| Jumlah Email Maksimum yang Akan Ditampilkan | Integrasi | 50 | Tidak | Tentukan jumlah email yang akan ditampilkan. Default: 50. |
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* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika data tidak tersedia (is_success=true): "No archive emails were found for the provided criteria in Mimecast"
Jika Waktu Mulai kosong, saat "Rentang Waktu" adalah "Kustom": "Error saat menjalankan tindakan "Penelusuran Arsip Sederhana". Alasan: "Waktu Mulai" harus diberikan, jika "Kustom" dipilih di parameter "Rentang Waktu"." Jika fail/errors memiliki nilai: Error executing action "Simple Archive Search". Reason: fail/errors/message". |
Umum |
| Tabel Repositori Kasus | Nama: Hasil Kolom: Semua kunci dari respons |
Umum |
Penelusuran Arsip Lanjutan
Deskripsi
Telusuri email arsip menggunakan kueri XML kustom di Mimecast.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| Kueri XML | XML | T/A | Ya | Tentukan kueri XML yang harus digunakan saat menelusuri email arsip. Buka dokumentasi untuk mengetahui detail selengkapnya. |
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* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika data tidak tersedia (is_success=true): "No archive emails were found for the provided criteria in Mimecast". Jika gagal/error memiliki nilai: Error executing action "Advanced Archive Search". Reason: fail/errors/message". |
Umum |
| Tabel Repositori Kasus | Nama: Hasil Kolom: Semua kunci dari respons |
Umum |
Tolak Pesan
Deskripsi
Tolak pesan di Mimecast. Catatan: Hanya pesan dengan status "Ditahan" yang dapat ditolak.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| ID Pesan | String | T/A | Ya | Tentukan ID pesan yang perlu ditolak. |
| Catatan | String | T/A | Tidak | Tentukan catatan tambahan yang berisi penjelasan tentang alasan pesan ditolak. |
| Alasan | DLL | Pilih Satu Nilai yang Mungkin Muncul: Pilih Satu Komunikasi yang Tidak Pantas Informasi Rahasia Bertentangan dengan Kebijakan Email Konten yang Dibatasi |
Tidak | Tentukan alasan penolakan. |
| Beri Tahu Pengirim | Kotak centang | Tidak dicentang | Tidak | Jika diaktifkan, tindakan akan memberi tahu pengirim tentang penolakan. |
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* | Tindakan ini tidak boleh gagal atau menghentikan eksekusi playbook: Tindakan akan gagal dan menghentikan eksekusi playbook: Jika fail/errors memiliki nilai: Error executing action "Reject Message". Reason: fail/errors/message". |
Umum |
Pesan Rilis
Deskripsi
Lepaskan pesan di Mimecast. Catatan: Hanya pesan dengan status "Ditahan" yang dapat dirilis.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| ID Pesan | String | T/A | Ya | Tentukan ID pesan yang perlu dirilis. |
| Rilis ke Sandbox | Kotak centang | T/A | Tidak | Jika diaktifkan, tindakan akan merilis pesan ke sandbox. |
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* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika gagal/error memiliki nilai: Error executing action "Release Message". Reason: fail/errors/message". |
Umum |
Laporkan Pesan - Tidak digunakan lagi
Laporkan pesan di Mimecast.
Input tindakan
| Parameter | Deskripsi |
|---|---|
Message IDs |
Wajib. Tentukan ID pesan yang perlu dilaporkan. |
Report as |
Opsional. Tentukan jenis laporan untuk pesan. Kemungkinan nilainya adalah sebagai berikut:
|
Comment |
Opsional. Tentukan komentar untuk laporan. |
Dijalankan Pada
Tindakan ini tidak berjalan di entity.
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False/is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* |
Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:
Tindakan akan gagal dan menghentikan eksekusi playbook:
|
Umum |
Blokir Pengirim
Deskripsi
Blokir pengirim di Mimecast.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| Pengirim | String | T/A | Ya | Tentukan alamat email pengirim yang akan diblokir. |
| Penerima | String | T/A | Ya | Tentukan alamat email penerima yang akan diblokir. |
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* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Tindakan akan gagal dan menghentikan eksekusi playbook: Jika fail/errors memiliki nilai: Error executing action "Block Sender". Reason: fail/errors/message". |
Umum |
Pengirim Izin
Deskripsi
Izinkan pengirim di Mimecast.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| Pengirim | String | T/A | Ya | Tentukan alamat email pengirim yang akan diizinkan. |
| Penerima | String | T/A | Ya | Tentukan alamat email penerima yang akan diizinkan. |
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* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Tindakan akan gagal dan menghentikan eksekusi playbook: Jika gagal/error memiliki nilai: Error executing action "Permit Sender". Reason: fail/errors/message". |
Umum |
Membuat Kebijakan Blokir Pengirim
Buat kebijakan Blokir Pengirim di Mimecast.
Dijalankan Pada
Tindakan ini tidak berjalan di entity mana pun.
Parameter
| Nama Tampilan Parameter | Jenis | Nilai Default | Watermark | Wajib Diisi | Deskripsi |
|---|---|---|---|---|---|
| Respons | DDL | T/A | T/A | Tidak | Berikan jenis respons yang akan dikaitkan dengan kebijakan yang dibuat. |
| Deskripsi | String | T/A | T/A | Ya | Deskripsi untuk kebijakan. |
| Data yang Diekstrak | DDL | T/A | T/A | Tentukan dari mana informasi tentang pengirim dan penerima harus diekstrak. | |
| Pengirim | String | T/A | T/A | Tidak | Pengirim pesan yang harus diblokir. Hanya diperlukan jika "Jenis Pengirim" adalah salah satu dari: Domain Email, Alamat Email, Nama Tampilan Header. Parameter ini diabaikan jika nilai "Dari Jenis" yang berbeda dipilih. |
| Jenis Pengirim | DDL | T/A | T/A | Tidak | Jenis pengirim untuk kebijakan. |
| Penerima | String | T/A | T/A | Tidak | Penerima pesan yang harus diblokir. Hanya diperlukan jika "Jenis Penerima" adalah salah satu dari: Domain Email, Alamat Email, Nama Tampilan Header. Parameter ini diabaikan jika nilai "Recipient Type" yang berbeda dipilih. |
| Jenis Penerima | DDL | T/A | T/A | Tidak | Jenis penerima untuk kebijakan. |
| Komentar | String | T/A | T/A | Tidak | Komentar untuk kebijakan. |
| Dua arah | Bool | T/A | T/A | Tidak | Jika diaktifkan, kebijakan akan ditentukan secara dua arah. |
| Diterapkan | Bool | T/A | T/A | Tidak | Jika diaktifkan, kebijakan akan diterapkan. |
| Waktu Mulai | String | T/A | T/A | Tidak | Waktu mulai untuk kebijakan. Jika tidak ada yang diberikan, waktu mulai akan ditetapkan ke abadi. Mengharapkan format ISO 8601. Contoh: 2025-03-07T16:03:00Z |
| Waktu Berakhir | String | T/A | T/A | Tidak | Waktu berakhir untuk kebijakan. Jika tidak ada yang diberikan, waktu akhir akan ditetapkan ke selamanya. Mengharapkan format ISO 8601. Contoh: 2025-03-07T16:03:00Z |
Hasil Tindakan
| Jenis | Tersedia |
|---|---|
| Hasil Skrip | Benar |
| Hasil JSON | Benar |
| Tabel Pengayaan | Salah |
| Tabel Repositori Kasus | Salah |
| Link Repositori Kasus | Salah |
| Lampiran Repositori Kasus | Salah |
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Hasil JSON
{
"option": "block_sender",
"id": "eNo1jr0OgjAYAN-lqw79QKyYOCCSiCJGqSCjlmqQn2ILNmp8d3Fwv8vdGynOOsnzDE3RSsP4ZTT0tPUMO3DL1pK-LrFZzzfJ9XJTrC78yPZgcc7CW1QdSLuUo11Mfc2rpIsfxlxQHFsDFXKPdkeq10ym7uJeDIKLA6Z66T1NUklI4c3QEDWizNnzVzYnBthDxDrViopLJjLe77iHyAEgjkmgpx9cqlzUaAp_kz4b7vc2YDzCny9vYUEo",
"policy": {
"description": "Description",
"fromPart": "both",
"from": {
"type": "individual_email_address",
"emailAddress": "example@exampl.com"
},
"to": {
"type": "individual_email_address",
"emailAddress": "exampleto@exampl.com"
},
"fromType": "individual_email_address",
"fromValue": "example@exampl.com",
"toType": "individual_email_address",
"toValue": "exampleto@exampl.com",
"fromEternal": true,
"toEternal": true,
"fromDate": "1900-01-01T00:00:00+0000",
"toDate": "2100-01-01T23:59:59+0000",
"override": false,
"bidirectional": false,
"conditions": {},
"enabled": true,
"enforced": true,
"createTime": "2025-03-27T12:51:46+0000",
"lastUpdated": "2025-03-27T12:51:46+0000"
}
}
Repositori Kasus
| Jenis Hasil | Nilai/Deskripsi | Type (Entity \ General) |
|---|---|---|
| Pesan output* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:
Tindakan akan gagal dan menghentikan eksekusi playbook:
if fatal error, like wrong credentials, no connection to server, other:print "Error executing action "{action name}". Reason: {0}''.format(error.Stacktrace) Jika fail/errors memiliki nilai: Error saat menjalankan tindakan "{action name}". Reason: fail/errors/message". |
Konektor
Mimecast - Message Tracking Connector
Deskripsi
Tarik informasi tentang pesan dari tab "Message Tracking" di Mimecast. Catatan: Daftar yang diizinkan berfungsi pada parameter "queueDetailStatus/bounceType".
Mengonfigurasi Mimecast - Message Tracking Connector di Google SecOps
Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi konektor di Google SecOps, lihat Mengonfigurasi konektor.
Parameter konektor
Gunakan parameter berikut untuk mengonfigurasi konektor:
| Nama Tampilan Parameter | Jenis | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| Nama Kolom Produk | String | Nama Produk | Ya | Masukkan nama kolom sumber untuk mengambil nama Kolom Produk. |
| Nama Kolom Peristiwa | String | event_type | Ya | Masukkan nama kolom sumber untuk mengambil nama Kolom Peristiwa. |
| Nama Kolom Lingkungan | String | "" | Tidak | Menjelaskan nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan tersebut adalah lingkungan default. |
| Pola Regex Lingkungan | String | .* | Tidak | Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom "Nama Kolom Lingkungan". Defaultnya adalah .* untuk menangkap semua dan menampilkan nilai yang tidak berubah. Digunakan untuk mengizinkan pengguna memanipulasi kolom lingkungan melalui logika ekspresi reguler. Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah lingkungan default. |
| Waktu Tunggu Skrip (Detik) | Int | 180 | Ya | Batas waktu tunggu untuk proses python yang menjalankan skrip saat ini. |
| Root API | String | https:/<<api root>> | Ya | Root API instance Mimecast. |
| ID Aplikasi | String | T/A | Ya | ID Aplikasi instance Mimecast. |
| Kunci Aplikasi | Sandi | T/A | Ya | Kunci Aplikasi instance Mimecast. |
| Kunci Akses | Sandi | T/A | Ya | Kunci Akses instance Mimecast. |
| Kunci Rahasia | Sandi | T/A | Ya | Kunci Rahasia instance Mimecast. |
| Domain | CSV | T/A | Ya | Daftar domain yang dipisahkan koma untuk mengkueri pesan. |
| Risiko Pengambilan Terendah | String | T/A | Tidak | Risiko terendah yang akan digunakan untuk mengambil pesan. Nilai yang memungkinkan: Dapat diabaikan, Rendah, Sedang, Tinggi. Jika tidak ada yang diberikan, konektor akan menyerap semua pesan. |
| Filter Status | CSV | held | Daftar filter status yang dipisahkan koma untuk pesan. Nilai yang mungkin: pengiriman, ditahan, diterima, tidak terkirim, ditangguhkan, ditolak, diarsipkan. Jika tidak ada yang diberikan, konektor akan menyerap semua pesan. |
|
| Filter Rute | CSV | T/A | Filter rute yang dipisahkan koma untuk pesan. Nilai yang mungkin: internal, keluar, masuk. Jika tidak ada yang diberikan, konektor akan menyerap semua pesan. |
|
| Filter Alasan Antrean | CSV | T/A | Daftar alasan antrean yang dipisahkan koma yang akan memfilter pesan. Jika tidak ada yang diberikan, filter ini akan diabaikan. |
|
| Menyerap Pesan Tanpa Risiko | Kotak centang | Jika diaktifkan, konektor akan menyerap pesan meskipun tidak ada info tentang risiko. Pemberitahuan Google SecOps yang dihasilkan dari pesan tersebut akan memiliki prioritas yang ditetapkan ke Informasi. | ||
| Jam Maksimum Mundur | Bilangan bulat | 1 | Tidak | Jumlah jam untuk mengambil pesan. Default: 1 jam. Maksimum: 30 hari. |
| Jumlah Pesan Maksimum yang Akan Ditampilkan | Bilangan bulat | 100 | Tidak | Jumlah pesan yang akan diproses per satu iterasi konektor. Default: 100. |
| Menggunakan daftar yang diizinkan sebagai daftar yang tidak diizinkan | Kotak centang | Dicentang | Ya | Jika diaktifkan, daftar yang diizinkan akan digunakan sebagai daftar yang tidak diizinkan. |
| Verifikasi SSL | Kotak centang | Dicentang | Ya | Jika diaktifkan, pastikan sertifikat SSL untuk koneksi ke server Mimecast valid. |
| Alamat Server Proxy | String | T/A | Tidak | Alamat server proxy yang akan digunakan. |
| Nama Pengguna Proxy | String | T/A | Tidak | Nama pengguna proxy untuk melakukan autentikasi. |
| Sandi Proxy | Sandi | T/A | Tidak | Sandi proxy untuk autentikasi. |
Aturan Konektor
Dukungan Proxy
Konektor mendukung proxy.
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.