Mimecast

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

Kasus Penggunaan

  1. Melakukan penyerapan pesan
  2. 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 | Read

  • Account | Monitoring | Held | Edit

  • Archive | Search Logs | Read

  • Archive | View Logs | Read

  • Gateway | Managed Senders | Edit

  • Gateway | Policies | Edit

  • Gateway | Policies | Read

  • Gateway | 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:
jika berhasil: "Successfully connected to the Mimecast server with the provided connection parameters!"

Tindakan akan gagal dan menghentikan eksekusi playbook:
jika tidak berhasil: "Failed to connect to the Mimecast server! Error is {0}".format(exception.stacktrace)

Umum

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,
size,receiveddate,displayfrom,
displayfromaddress,id,displayto,
displaytoaddresslist,smash

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 tersedia(is_success = true): "Successfully found archive emails for the provided criteria in Mimecast".

Jika data tidak tersedia (is_success=true): "No archive emails were found for the provided criteria in Mimecast"



Tindakan akan gagal dan menghentikan eksekusi playbook:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Simple Archive Search". Reason: {0}''.format(error.Stacktrace)

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

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 tersedia(is_success = true): "Successfully found archive emails for the provided criteria in Mimecast".

Jika data tidak tersedia (is_success=true): "No archive emails were found for the provided criteria in Mimecast".

Tindakan akan gagal dan menghentikan eksekusi playbook:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Advanced Archive Search". Reason: {0}''.format(error.Stacktrace)

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:
Jika tidak ada "error" dalam respons (is_success = true): "Successfully rejected message with ID "{ID}" in Mimecast".

Tindakan akan gagal dan menghentikan eksekusi playbook:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Reject Message". Reason: {0}''.format(error.Stacktrace)

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 tidak ada "error" dalam respons (is_success = true): "Successfully released message with ID "{ID}" in Mimecast".

Tindakan akan gagal dan menghentikan eksekusi playbook:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Release Message". Reason: {0}''.format(error.Stacktrace)

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:

  • Spam
  • Malware
  • Phishing
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:

  • jika data tersedia (is\_success = true): cetak "Successfully reported the following messages with ID "{ID}" in Mimecast".
  • Jika gagal/error memiliki nilai: cetak "Error executing action "Report Message". Reason: fail/errors/message".

Tindakan akan gagal dan menghentikan eksekusi playbook:

  • jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: cetak "Error executing action "Report Message". Reason: {0}''.format(error.Stacktrace).
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:
Jika tidak ada "error" dalam respons (is_success = true): "Successfully blocked sender {sender} for recipient {recipient} in Mimecast".

Tindakan akan gagal dan menghentikan eksekusi playbook:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Block Sender". Reason: {0}''.format(error.Stacktrace)

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:
Jika tidak ada "error" dalam respons (is_success = true): "Successfully permitted sender {sender} for recipient {recipient} in Mimecast".

Tindakan akan gagal dan menghentikan eksekusi playbook:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Permit Sender". Reason: {0}''.format(error.Stacktrace)

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:


Jika tidak ada "error" dalam respons (is_success = true): cetak "Successfully created a block sender policy in Mimecast".

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.