Mengintegrasikan EmailV2 dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan EmailV2 dengan Google Security Operations (Google SecOps).

Catatan: Integrasi ini menggunakan satu atau beberapa komponen open source. Anda dapat mendownload salinan kode sumber lengkap integrasi ini dari bucket penyimpanan.

Kasus penggunaan

Integrasi EmailV2 menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:

• Triase dan notifikasi phishing: Mengotomatiskan proses pengiriman email notifikasi kepada penerima, termasuk pengguna eksternal, dan menyiapkan playbook asinkron untuk menunggu respons pengguna (seperti konfirmasi upaya phishing).

• Pengayaan dan retensi data insiden: Telusuri kotak surat untuk menemukan pesan terkait berdasarkan kriteria (seperti pengirim atau subjek) dan simpan semua lampiran file dari email yang mencurigakan langsung ke dinding kasus untuk analisis forensik dan retensi data.

• Pengelolaan dan pembatasan kotak surat: Memindahkan email berbahaya atau yang telah diseleksi secara otomatis dari kotak masuk ke folder karantina atau arsip, atau menghapus email yang cocok dengan filter tertentu secara permanen (seperti menghapus semua salinan email malware yang diketahui di beberapa folder).

• Respons dan kolaborasi berangkai: Kirim balasan langsung atau respons terstruktur dalam rangkaian pesan email yang ada menggunakan tindakan Kirim Balasan Rangkaian Pesan, untuk memastikan semua pihak yang diperlukan terus mendapatkan informasi update keamanan yang relevan.

Sebelum memulai

Agar integrasi EmailV2 berhasil terhubung ke server email, Anda harus memastikan kotak surat yang dikonfigurasi memberikan akses ke aplikasi pihak ketiga menggunakan IMAP/SMTP.

Jika Anda menggunakan akun Gmail atau Google Workspace, Anda harus menggunakan Sandi aplikasi untuk melakukan autentikasi. Sandi akun standar tidak berfungsi untuk koneksi IMAP/SMTP ke server Google .

Untuk menggunakan sandi aplikasi, pastikan persyaratan berikut terpenuhi:

1. Aktifkan Verifikasi 2 Langkah: Sandi aplikasi hanya dapat dibuat jika Verifikasi 2 Langkah diaktifkan di Akun Google Anda. Untuk mengetahui detail selengkapnya, lihat Mengaktifkan Verifikasi 2 Langkah.

2. Buat Sandi aplikasi 16 digit: Buat kode sandi unik untuk integrasi. Untuk mengetahui detail selengkapnya, lihat Login dengan sandi aplikasi.

Catatan: Untuk server email non-Google , pastikan akses IMAP dan SMTP diaktifkan di setelan penyedia email Anda.

Akses jaringan ke IMAP/SMTP

Mengakses dan memproses email yang diterima menggunakan IMAP serta mengirim email keluar menggunakan SMTP memerlukan akses jaringan menggunakan kredensial akun yang dikonfigurasi.

Persyaratan jaringan

Fungsi	Port Default	Arah	Protokol
Komunikasi Server Email	Multivalues	Keluar	IMAP/SMTP

Parameter integrasi

Integrasi EmailV2 memerlukan parameter berikut:

Parameter	Deskripsi
IMAP - Use SSL	Opsional. Jika dipilih, tindakan ini akan mengaktifkan komunikasi aman (SSL/TLS) saat terhubung ke server IMAP. Diaktifkan secara default.
SMTP - Use Authentication	Opsional. Jika dipilih, tindakan ini akan mengaktifkan autentikasi untuk koneksi SMTP. Hal ini diperlukan jika server SMTP tidak dalam konfigurasi "relai terbuka" dan memerlukan kredensial untuk mengirim email keluar. Diaktifkan secara default.
Sender's Address	Wajib. Alamat email kotak surat yang digunakan oleh integrasi untuk mengirim dan menerima pesan.
Sender's Display Name	Wajib. Nama yang muncul sebagai pengirim saat integrasi mengirim email.
SMTP Server Address	Opsional. Nama host DNS atau alamat IP server SMTP yang digunakan untuk mengirim email, seperti smtp.gmail.com.
SMTP Port	Opsional. Nomor port yang digunakan untuk terhubung ke server SMTP, seperti 587 atau 465.
IMAP Server Address	Opsional. Nama host DNS atau alamat IP server IMAP yang diperlukan untuk mengambil email yang diterima, seperti imap.gmail.com.
IMAP Port	Opsional. Nomor port yang digunakan untuk terhubung ke server IMAP, seperti 993.
Username	Wajib. Nama pengguna yang diperlukan untuk autentikasi dengan server email (biasanya alamat email lengkap).
Password	Wajib. Sandi yang diperlukan untuk autentikasi dengan server email. Untuk akun Gmail atau Google Workspace, Anda harus memasukkan Sandi aplikasi 16 digit yang dibuat di setelan keamanan akun Google Anda.

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

Anda dapat melakukan perubahan pada tahap selanjutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.

Menghapus Email

Gunakan tindakan Hapus Email untuk menghapus email dari kotak surat yang cocok dengan kriteria penelusuran yang ditentukan. Anda dapat menggunakan tindakan ini untuk menghapus email pertama yang cocok atau menghapus semua email yang cocok.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Hapus Email memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Wajib. Daftar folder kotak surat yang dipisahkan koma tempat tindakan menelusuri email.
Message IDs	Opsional. Daftar ID Pesan tertentu yang dipisahkan koma untuk ditelusuri dan dihapus. Jika diberikan, daftar ini akan menggantikan Subject Filter, Sender Filter, dan Recipient Filter.
Subject Filter	Opsional. Baris subjek yang digunakan untuk mempersempit penelusuran email yang cocok.
Sender Filter	Opsional. Alamat pengirim yang digunakan untuk menelusuri email yang cocok.
Recipient Filter	Opsional. Alamat penerima yang digunakan untuk menelusuri email yang cocok.
Days Back	Opsional. Jendela waktu (dalam hari) saat tindakan menelusuri email yang akan dihapus. Jangka waktu dihitung dengan perincian hari. Menggunakan nilai 0 akan membatasi penelusuran hanya pada email yang diterima dalam hari ini. Nilai defaultnya adalah 0.
Delete all matching emails	Opsional. Jika dipilih, tindakan akan menghapus semua email yang cocok dengan kriteria yang ditentukan; jika tidak, tindakan hanya akan menghapus kecocokan pertama. Dinonaktifkan secara default.

Output tindakan

Tindakan Hapus Email memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Hapus Email:

{
    "deleted_emails": {
        "email_1_deleted": {
            "message_id": "<[e-mail]>",
            "deleted_from_folder": "Inbox",
            "subject": "Suspicious Login Alert - Deleted",
            "sender": "[e-mail]",
            "timestamp": "2025-11-20T14:30:00Z"
        },
        "email_2_deleted": {
            "message_id": "<[e-mail]>",
            "deleted_from_folder": "Spam",
            "subject": "Phishing Offer",
            "sender": "[e-mail]",
            "timestamp": "2025-11-15T09:15:00Z"
        }
    }
}

Pesan output

Tindakan Delete Email dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
NUMBER_OF_DELETED_EMAILS email(s) were deleted successfully Failed to find emails for deletion!	Tindakan berhasil.
Error deleting emails ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Hapus Email:

Nama hasil skrip	Nilai
is_success	true atau false

DownloadEmailAttachments

Gunakan tindakan Download Email Attachments untuk mengambil lampiran dari email tertentu dan menyimpannya ke jalur yang ditentukan di server Google SecOps.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Download Email Attachments memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Wajib. Daftar folder kotak surat yang dipisahkan koma tempat tindakan menelusuri email. Nilai defaultnya adalah Inbox.
Download Path	Wajib. Jalur di server Google SecOps tempat lampiran yang didownload disimpan.
Message IDs	Opsional. Daftar ID pesan yang dipisahkan koma untuk mendownload lampiran.
Subject filter	Opsional. Baris subjek yang digunakan untuk mempersempit penelusuran email.

Output tindakan

Tindakan Download Email Attachments memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Pesan output

Tindakan Download Lampiran Email dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Downloaded NUMBER_OF_ATTACHMENTS attachments. ATTACHMENT_PATHS	Tindakan berhasil.
failed to download email attachments, the error is: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Download Lampiran Email:

Nama hasil skrip	Nilai
attachments_local_paths	String jalur lengkap yang dipisahkan koma ke lampiran yang disimpan.

Teruskan Email

Gunakan tindakan Teruskan Email untuk mengirim email yang ada, termasuk konten rangkaian pesan sebelumnya, kepada penerima baru dengan memberikan ID Pesan unik email asli.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Forward Email memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Wajib. Folder kotak surat tempat email asli berada. Berikan daftar yang dipisahkan koma jika memeriksa beberapa folder. Nama folder harus sama persis dengan folder IMAP. Jika nama folder berisi spasi, nama tersebut harus diapit tanda kutip ganda. Nilai defaultnya adalah Inbox.
Message ID of the email to forward	Wajib. message_id unik dari email yang ada yang diteruskan oleh tindakan.
Recipients	Wajib. Daftar alamat email utama yang dipisahkan koma untuk penerima baru.
CC	Opsional. Daftar alamat email yang dipisahkan koma untuk disertakan dalam kolom CC.
BCC	Opsional. Daftar alamat email yang dipisahkan koma untuk disertakan dalam kolom BCC.
Subject	Wajib. Baris subjek untuk email yang diteruskan.
Content	Opsional. Konten isi tambahan yang akan disertakan dalam email yang diteruskan.
Return message id for the forwarded email	Opsional. Jika dipilih, tindakan akan menampilkan ID Pesan unik dari email yang baru diteruskan dalam hasil JSON. Dinonaktifkan secara default.
Attachment Paths	Opsional. Daftar jalur file yang dipisahkan koma di server untuk lampiran tambahan.

Output tindakan

Tindakan Forward Email memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Teruskan Email:

{
   "Date"
   "message_id"
   "Recipient"
}

Pesan output

Tindakan Forward Email dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Email was forwarded successfully. Mail was forwarded successfully. Mail message ID is: MESSAGE_ID	Tindakan berhasil.
Failed to forward the email! The Error is ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Forward Email:

Nama hasil skrip	Nilai
is_success	true atau false

Pindahkan Email ke Folder

Gunakan tindakan Move Email to Folder untuk mentransfer email dari folder sumber yang ditentukan ke folder tujuan yang berbeda dalam kotak surat.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Move Email to Folder memerlukan parameter berikut:

Parameter	Deskripsi
Source Folder Name	Wajib. Nama folder sumber tempat email dipindahkan.
Destination Folder Name	Wajib. Nama folder tujuan tempat email dipindahkan.
Message IDs	Opsional. Daftar ID Pesan tertentu yang dipisahkan koma untuk ditelusuri dan dipindahkan. Jika diberikan, daftar ini akan menggantikan Subject Filter.
Subject Filter	Opsional. Baris subjek yang digunakan untuk mempersempit penelusuran email yang cocok.
Only Unread	Opsional. Jika dipilih, penelusuran akan membatasi hasil hanya untuk email yang belum dibaca. Dinonaktifkan secara default.

Output tindakan

Tindakan Move Email to Folder memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Move Email to Folder:

{
    "emails": {
        "email_1": {
            "message_id": "<[e-mail]>",
            "received": "Mon, 24 Nov 2025 10:00:00 +0000",
            "sender": "[e-mail]",
            "recipients": "[e-mail]",
            "subject": "Phishing Alert: Urgent Action Required",
            "plaintext_body": "Original alert content...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Quarantine"
        },
        "email_2": {
            "message_id": "<[e-mail]>",
            "received": "Sun, 23 Nov 2025 14:30:00 +0000",
            "sender": "[e-mail]",
            "recipients": "[e-mail]",
            "subject": "System Update Notification",
            "plaintext_body": "System update successful...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Archive"
        }
    }
}

Pesan output

Tindakan Move Email to Folder dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
NUMBER_OF_MOVED_EMAILS mails were successfully moved from SOURCE_FOLDER hingga DESTINATION_FOLDER No mails were found matching the search criteria!	Tindakan berhasil.
Error search emails: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Move Email to Folder:

Nama hasil skrip	Nilai
is_success	true atau false

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke Email V2.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Ping memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Pesan output

Tindakan Ping dapat menampilkan pesan output berikut:

Catatan: Tindakan ini melakukan pemeriksaan konektivitas terpisah untuk IMAP dan SMTP.

Tindakan ini akan menampilkan keberhasilan secara keseluruhan jika setidaknya satu server dikonfigurasi dan lulus pemeriksaan, sekaligus mencatat bagian yang dilewati atau tidak dikonfigurasi.

Fungsi ini menampilkan kegagalan keseluruhan jika semua pemeriksaan yang dikonfigurasi gagal, dan mencetak semua error terkait.

Jika IMAP dan SMTP tidak dikonfigurasi, error akan ditampilkan.

Pesan output	Deskripsi pesan
Successfully connected to the email server server with the provided connection parameters!	Tindakan berhasil.
Failed to connect to the IMAP server! Error is ERROR_REASON Failed to connect to the SMTP server! Error is ERROR_REASON SMTP (or IMAP) configuration is needed to execute action. Please configure STMP (or IMAP) on integration configuration page in Content Hub.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ping:

Nama hasil skrip	Nilai
is_success	true atau false

Menyimpan Lampiran Email ke Kasus

Gunakan tindakan Save Email Attachments to Case untuk mengambil dan otomatis menyimpan lampiran dari email tertentu di kotak surat langsung ke Case Wall kasus saat ini.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Save Email Attachments to Case memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Wajib. Daftar folder kotak surat yang dipisahkan koma tempat tindakan menelusuri email.
Message ID	Opsional. ID Pesan unik email yang lampirannya akan didownload.
Attachment To Save	Opsional. Nama spesifik lampiran yang disimpan. Jika tidak ada nilai yang diberikan, tindakan ini akan menyimpan semua lampiran dari email ke Case Wall.

Output tindakan

Tindakan Save Email Attachments to Case memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Save Email Attachments to Case:

{
    "saved_attachments_from_email": {
        "message_id": "<[e-mail]>",
        "subject": "Email with Malicious Attachment",
        "sender": "[e-mail]",
        "attachments_saved": [
            {
                "file_name": "Invoice_Q3_2025.pdf",
                "file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
                "saved_to_case_wall": "True"
            },
            {
                "file_name": "Report_Data.docx",
                "file_hash_md5": "b3e0c1a9f8d7c6b5a4e3d2c1b0a9f8e7",
                "saved_to_case_wall": "True"
            }
        ]
    }
}

Pesan output

Tindakan Save Email Attachments to Case dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully saved the following attachments from the email MESSAGE_ID: MESSAGE_INFO	Tindakan berhasil.
Failed to save the email attachments to the case, the error is: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Save Email Attachments to Case:

Nama hasil skrip	Nilai
is_success	true atau false

Menelusuri Email

Gunakan tindakan Search Email untuk menemukan email tertentu dalam kotak surat yang dikonfigurasi menggunakan berbagai kriteria pemfilteran.

Tindakan ini mengambil detail tentang pesan yang cocok dalam file JSON, yang dapat digunakan untuk analisis otomatis atau manual berikutnya.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Telusuri Email memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Wajib. Comma separated list berisi folder kotak surat tempat tindakan menelusuri email. Nilai defaultnya adalah Inbox.
Subject Filter	Opsional. Baris subjek yang digunakan untuk mempersempit penelusuran email yang cocok.
Sender Filter	Opsional. Alamat pengirim yang digunakan untuk menelusuri email yang cocok.
Recipient Filter	Opsional. Alamat penerima yang digunakan untuk menelusuri email yang cocok.
Time frame (minutes)	Wajib. Periode waktu (dalam menit) penelusuran melihat kembali email. Nilai defaultnya adalah 60.
Only Unread	Opsional. Jika dipilih, penelusuran hanya akan mengambil email yang belum dibaca. Dinonaktifkan secara default
Max Emails To Return	Wajib. Jumlah maksimum email yang ditampilkan tindakan sebagai hasil. Nilai defaultnya adalah 100.

Output tindakan

Tindakan Telusuri Email memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Telusuri Email:

{
    "emails": {
        "email_1": {
            "message id": "<CAJP=[e-mail]>",
            "received": "Mon, 26 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "[e-mail]",
            "recipients": "[e-mail],[e-mail]",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "pdfdocument.pdf",
            "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        },
        "email_2": {
            "message id": "<WEAA=[e-mail]>",
            "received": "Wen, 21 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "[e-mail]",
            "recipients": "[e-mail]",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "photo.jpg",        "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
            "attachmment_2": "word_document.docx",
            "attachment_2_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        }
    }
}

Pesan output

Tindakan Telusuri Email dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Search found NUMBER_OF_FOUND_EMAILS emails based on the provided search criteria Search didn't found any matching emails	Tindakan berhasil.
Search didn't completed successfully due to error: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Telusuri Email:

Nama hasil skrip	Nilai
is_success	true atau false

Kirim Email

Gunakan tindakan Send Email untuk mengirim email dari kotak surat yang dikonfigurasi ke beberapa penerima.

Tindakan ini secara opsional menampilkan ID Pesan, yang kemudian dapat digunakan oleh tindakan Wait for Email From User untuk melacak respons pengguna dan mengontrol eksekusi playbook.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Kirim Email memerlukan parameter berikut:

Parameter	Deskripsi
Recipients	Wajib. Alamat email penerima utama. Beberapa alamat harus dipisahkan dengan koma.
CC	Opsional. Alamat email yang akan disertakan dalam kolom Carbon Copy (CC). Beberapa alamat harus dipisahkan dengan koma.
Bcc	Opsional. Alamat email yang akan disertakan dalam kolom Blind Carbon Copy (Bcc). Beberapa alamat harus dipisahkan dengan koma.
Subject	Wajib. Baris subjek pesan email.
Content	Wajib. Konten isi pesan email.
Return message id for the sent email	Opsional. Jika dipilih, tindakan akan menampilkan ID Pesan unik dalam hasil JSON. ID ini dapat digunakan oleh tindakan Wait for Email From User untuk melacak respons. Dinonaktifkan secara default.
Attachments Paths	Opsional. Comma separated list berisi jalur file absolut di server untuk lampiran.

Output tindakan

Tindakan Send Email memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Kirim Email:

Catatan: Mengaktifkan Return message id for the sent email diperlukan untuk mengambil message_id unik dalam hasil JSON, yang diperlukan untuk tindakan dependen.

{
    "message_id": "<[e-mail]>"
}

Pesan output

Tindakan Kirim Email dapat menampilkan pesan output berikut:

Catatan: Tindakan ini melakukan pemeriksaan konektivitas terpisah untuk IMAP dan SMTP.

Tindakan ini akan menampilkan keberhasilan secara keseluruhan jika setidaknya satu server dikonfigurasi dan lulus pemeriksaan, sekaligus mencatat bagian yang dilewati atau tidak dikonfigurasi.

Fungsi ini menampilkan kegagalan keseluruhan jika semua pemeriksaan yang dikonfigurasi gagal, dan mencetak semua error terkait.

Jika IMAP dan SMTP tidak dikonfigurasi, error akan ditampilkan.

Pesan output	Deskripsi pesan
Mail sent successfully. Mail sent successfully. Mail message ID is: MESSAGE_ID	Tindakan berhasil.
Execution Failed: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Kirim Email:

Nama hasil skrip	Nilai
is_success	true atau false

Kirim Balasan Rangkaian Pesan

Gunakan tindakan Send Thread Reply untuk mengirim pesan baru sebagai respons dalam rangkaian pesan email yang ada menggunakan ID pesan asli.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Send Thread Reply memerlukan parameter berikut:

Parameter	Deskripsi
Message ID	Wajib. ID unik pesan yang akan dibalas.
Folder Name	Wajib. Daftar folder kotak surat yang dipisahkan koma tempat tindakan menelusuri email asli. Nama folder harus sama persis dengan folder IMAP. Jika nama berisi spasi, nama tersebut harus diapit tanda kutip ganda (seperti "[Gmail]/Semua Email"). Nilai defaultnya adalah Inbox.
Content	Wajib. Konten isi pesan balasan.
Attachment Paths	Opsional. Daftar jalur file yang dipisahkan koma di server untuk lampiran yang akan disertakan dalam balasan.
Reply All	Opsional. Jika dipilih, balasan akan dikirim ke semua penerima rangkaian pesan email asli. Parameter ini lebih diprioritaskan daripada Reply To. Diaktifkan secara default.
Reply To	Opsional. Daftar alamat email tertentu yang dipisahkan koma untuk menerima balasan. Jika Reply All dinonaktifkan dan tidak ada nilai yang diberikan, balasan hanya akan dikirim ke pengirim email asli.

Output tindakan

Tindakan Send Thread Reply memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Kirim Balasan Rangkaian Pesan:

{
    "message_id": "<162556278608.14165.480701790user@example>",
    "recipients": "[e-mail]"
}

Pesan output

Tindakan Send Thread Reply dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully sent reply to the message with ID MESSAGE_ID in Exchange.	Tindakan berhasil.
Error executing action "Send Thread Reply". Reason: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Kirim Balasan Thread:

Nama hasil skrip	Nilai
is_success	true atau false

Menunggu Email dari Pengguna

Gunakan tindakan Wait for Email From User untuk menjeda eksekusi playbook dan memantau kotak surat untuk balasan pesan yang sebelumnya dikirim oleh tindakan Send Email.

Tindakan ini tidak berjalan di entity Google SecOps.

Catatan: Tindakan ini bersifat asinkron. Sesuaikan nilai waktu tunggu skrip di IDE Google SecOps sesuai kebutuhan.

Input tindakan

Tindakan Wait for Email From User memerlukan parameter berikut:

Parameter	Deskripsi
Email Message_id	Wajib. ID Pesan unik dari email terkirim yang balasannya dilacak oleh tindakan. Jika pesan telah dikirim menggunakan tindakan Kirim Email, pilih SendEmail.JSONResult.message_id sebagai placeholder.
Email Date	Wajib. Stempel waktu yang menunjukkan kapan email asli dikirim. Tindakan ini menggunakan nilai ini untuk menghitung periode balasan. Jika pesan dikirim menggunakan tindakan Kirim Email, gunakan placeholder SendEmail.JSONResult.email_date.
Email Recipients	Wajib. Daftar alamat email penerima yang dipisahkan koma yang ditunggu balasannya oleh tindakan. Jika pesan dikirim menggunakan tindakan Kirim Email, gunakan placeholder SendEmail.JSONResult.email_date.
Wait stage timeout (minutes)	Opsional. Durasi (dalam menit) tindakan menunggu balasan sebelum menandai tahap tunggu sebagai waktu habis. Nilai defaultnya adalah 1440.
Wait for all recipients to reply?	Opsional. Jika dipilih, playbook akan menunggu respons dari semua penerima untuk melanjutkan; jika tidak, playbook akan melanjutkan setelah menerima balasan pertama. Diaktifkan secara default.
Wait stage exclude pattern	Opsional. Pola ekspresi reguler yang digunakan untuk mengecualikan balasan tertentu (seperti pesan Saat Tidak di Kantor otomatis) agar tidak dianggap sebagai respons yang valid.
Folder to check for reply	Opsional. Daftar folder kotak surat yang dipisahkan koma, tempat tindakan menelusuri balasan pengguna. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Inbox.
Fetch Response Attachments	Opsional. Jika dipilih, lampiran apa pun yang disertakan dalam balasan penerima akan disimpan sebagai lampiran untuk hasil tindakan. Dinonaktifkan secara default.

Output tindakan

Tindakan Wait for Email From User memberikan output berikut:

Jenis output tindakan	Ketersediaan
Lampiran repositori kasus	Tidak tersedia
Link repositori kasus	Tidak tersedia
Tabel repositori kasus	Tidak tersedia
Tabel pengayaan	Tidak tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Wait for Email From User:

{
    "Responses":
    {[
     "[e-mail]": "Approved",
     "[e-mail]": "",
     "[e-mail]": ""
     ]}
}

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Wait for Email From User:

Nama hasil skrip	Nilai
is_success	true atau false

Konektor

Untuk mempelajari lebih lanjut cara mengonfigurasi konektor di Google SecOps, lihat Menyerap data (konektor).

Catatan: Untuk mencegah kehilangan data, konektor menggunakan Perataan Peristiwa. Jika pemberitahuan mentah berisi daftar entitas (seperti beberapa alamat email, nama host, atau alamat IP), konektor akan otomatis meratakannya menjadi peristiwa yang terpisah dan unik.

Misalnya, satu pemberitahuan mentah yang berisi tiga alamat email berbeda diserap sebagai tiga peristiwa terpisah, yang masing-masing berisi satu alamat email yang berbeda.

Proses ini memastikan bahwa setiap entity diindeks dengan benar sebagai aset unik, sehingga dapat sepenuhnya ditelusuri dan ditindaklanjuti dalam playbook.

Konektor Email IMAP Generik

Gunakan Generic IMAP Email Connector untuk terhubung secara berkala ke email IMAP guna memeriksa kotak surat yang ditentukan untuk email baru. Konektor ini memproses email baru dalam waktu hampir real-time, menerjemahkannya menjadi pemberitahuan dan kasus kontekstual dalam platform Google SecOps.

Masalah Umum dan Batasan

1. Lampiran Outlook (.eml): Konektor mungkin tidak memproses lampiran yang dikonversi ke format .eml oleh Microsoft Outlook jika header penting tidak ada. Google SecOps tetap membuat pemberitahuan untuk email tersebut, tetapi tanpa peristiwa berdasarkan lampiran. Log berikut menunjukkan masalah ini:

   Error Code 1: Encountered an email object with missing headers. Please
   visit documentation portal for more details.
   

2. Nama File Tidak Ada: Saat memproses file email terlampir yang tidak memiliki nama file di header email, konektor akan menetapkan nama file placeholder unik: Undefined_{UUID}.eml, sehingga lampiran dapat muncul sebagai peristiwa di Google SecOps.

Penerusan Kasus Email

Google SecOps berkomunikasi dengan server email untuk menelusuri dan menyerap email, meneruskannya ke platform untuk penerjemahan dan kontekstualisasi hampir real-time sebagai notifikasi keamanan.

Aturan Konektor

• Konektor menggunakan SSL/TLS untuk memastikan komunikasi terenkripsi dengan server email.
• Konektor mendukung koneksi ke server email menggunakan proxy untuk traffic IMAP dan IMAPS.
• Konektor ini memungkinkan penelusuran email di beberapa folder kotak surat. Parameter Folder menerima daftar nama folder yang dipisahkan koma dan peka huruf besar/kecil.
• Konektor ini mendukung encoding Unicode, sehingga dapat memproses email yang dikirim dalam bahasa selain bahasa Inggris.

Input konektor

Konektor Email IMAP Generik memerlukan parameter berikut:

Parameter	Deskripsi
Default Environment	Opsional. Nama lingkungan tempat pemberitahuan yang diserap ditetapkan.
Run Every	Opsional. Frekuensi konektor berjalan untuk memeriksa email baru. Nilai default-nya adalah 00:00:10:00 (10 menit).
Product Field Name	Wajib. Nama kolom tempat nama produk disimpan. Nama produk terutama memengaruhi pemetaan. Untuk menyederhanakan dan meningkatkan proses pemetaan untuk konektor, nilai default di-resolve ke nilai pengganti yang direferensikan dari kode. Setiap input yang tidak valid untuk parameter ini akan di-resolve ke nilai penggantian secara default. Nilai defaultnya adalah Product Name.
Event Field Name	Wajib. Nama kolom yang menentukan nama peristiwa (subjenis). Nilai defaultnya adalah event_name_mail_type.
Additional headers to extract from emails	Opsional. Daftar kolom header kustom yang dipisahkan koma yang akan diekstrak dari pesan email selama pemrosesan konektor.
Script Timeout (Seconds)	Wajib. Batas waktu tunggu, dalam detik, untuk proses Python yang menjalankan skrip saat ini. Nilai defaultnya adalah 60.
IMAP Server Address	Wajib. Alamat IP atau nama host DNS server IMAP yang akan dihubungkan. Nilai defaultnya adalah imap.gmail.com.
IMAP Port	Wajib. Nomor port yang digunakan untuk terhubung ke server IMAP. Nilai defaultnya adalah 993.
Username	Wajib. Nama pengguna untuk kotak surat tempat konektor mengambil email. Nilai defaultnya adalah username.
Password	Wajib. Sandi untuk kotak surat yang digunakan untuk mengambil email. Nilai defaultnya adalah 1.
Folder to check for emails	Wajib. Daftar folder kotak surat yang dipisahkan koma, tempat konektor menelusuri email. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Inbox.
Server Time Zone	Opsional. Zona waktu yang dikonfigurasi di server email. Nilai defaultnya adalah UTC.
Environment Regex Pattern	Opsional. Pola ekspresi reguler yang digunakan untuk memanipulasi data kolom peristiwa dan mengekstrak nama lingkungan.
IMAP USE SSL	Opsional. Jika dipilih, konektor akan menggunakan SSL/TLS untuk membuat koneksi IMAP yang aman ke server email. Diaktifkan secara default.
Unread Emails Only	Opsional. Jika dipilih, konektor hanya akan mengambil email yang belum dibaca. Diaktifkan secara default.
Mark Emails as Read	Opsional. Jika dipilih, email akan ditandai sebagai telah dibaca setelah berhasil ditarik oleh konektor. Diaktifkan secara default.
Attach Original EML	Opsional. Jika dipilih, pesan asli akan dilampirkan ke notifikasi yang dibuat sebagai file .eml. Dinonaktifkan secara default.
Regex expressions to handle forwarded emails	Opsional. String satu baris JSON yang berisi pola ekspresi reguler untuk mengekstrak kolom subjek, pengirim, dan penerima asli dari email yang diteruskan.
Exclusion Body Regex	Opsional. Pola ekspresi reguler yang digunakan untuk mengecualikan email dari penyerapan jika konten isi cocok dengan pola, seperti ([N|n]ewsletter)|([O|o]ut of office).
Exclusion Subject Regex	Opsional. Pola ekspresi reguler yang digunakan untuk mengecualikan email dari penyerapan jika baris subjek cocok dengan pola, seperti ([N|n]ewsletter)|([O|o]ut of office).
Offset Time In Days	Wajib. Jumlah hari maksimum ke belakang yang digunakan konektor untuk mengambil email (periode waktu maksimum). Nilai ini juga berfungsi sebagai pengganti untuk operasi awal atau jika stempel waktu konektor habis masa berlakunya, sehingga memastikan pemberitahuan diserap selama periode nonaktif. Nilai defaultnya adalah 5.
Max Emails Per Cycle	Wajib. Jumlah maksimum email yang diproses konektor dalam satu siklus polling. Nilai defaultnya adalah 10.
Proxy Server Address	Opsional. Alamat server proxy yang akan digunakan.
Proxy Username	Opsional. Nama pengguna untuk autentikasi server proxy.
Proxy Password	Opsional. Sandi untuk autentikasi server proxy.
Create a Separate Siemplify Alert per Attached Mail File?	Opsional. Jika dipilih, konektor akan membuat pemberitahuan terpisah untuk setiap file email terlampir yang ditemukan dalam pesan. Hal ini berguna saat pemetaan peristiwa ditetapkan untuk membuat entity dari file email yang dilampirkan. Dinonaktifkan secara default.
Original Received Mail Prefix	Opsional. Awalan (seperti orig) yang ditambahkan ke kunci yang diekstrak (kepada, dari, subjek, dll.) dari email asli yang diterima di kotak surat yang dipantau. Nilai defaultnya adalah orig.
Attached Mail File Prefix	Opsional. Awalan (seperti attach) yang ditambahkan ke kunci yang diekstrak (kepada, dari, subjek, dll.) dari file email terlampir yang ditemukan dalam email. Nilai defaultnya adalah attach.

Catatan: Konektor mendukung ekstraksi nilai tertentu dari email menggunakan Ekspresi Reguler yang ditentukan di area Daftar Dinamis (sering diberi label "Aturan Ekstraksi"). Untuk mengekstrak nilai, gunakan format: Desired Display Name: matching regex.

Untuk mengekstrak URL dari isi email untuk dibuat sebagai entity, sisipkan:

none urls: http[s]?://(?:[a-zA-Z]|[0-9]|[$-_@.&+]|[!*(),]|(?:%0-9a-fA-F))+

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