Mengintegrasikan Microsoft Graph Mail dengan Google SecOps
Sebelum memulai
Sebelum mengonfigurasi integrasi Microsoft Graph Mail:
Membuat aplikasi Microsoft Entra
Untuk membuat aplikasi Microsoft Entra, selesaikan langkah-langkah berikut:
Login ke portal Azure sebagai administrator pengguna atau administrator sandi.
Pilih Microsoft Entra ID.
Buka App registrations > New registration.
Masukkan nama aplikasi.
Klik Daftar.
Dokumen ini memberikan contoh yang menggunakan penyiapan tenant tunggal. Karena integrasi ini menggunakan alur kredensial klien OAuth 2.0, tidak ada login pengguna interaktif yang terjadi. Oleh karena itu,
Redirect URItidak diperlukan.Simpan nilai Application (client) ID dan Directory (tenant) ID untuk mengonfigurasi Integration Parameters.
Mengonfigurasi izin API
Untuk mengonfigurasi izin API untuk integrasi, selesaikan langkah-langkah berikut:
Di portal Azure, buka API Permissions > Add a permission.
Pilih Microsoft Graph > Izin aplikasi.
Di bagian Pilih Izin, pilih izin wajib berikut:
Mail.ReadMail.ReadWriteMail.SendUser.ReadDirectory.Read.All
Klik Add permissions.
Klik Grant admin consent for
ORGANIZATION_NAME.Saat dialog Grant admin consent confirmation muncul, klik Yes.
Membatasi Akses Aplikasi ke Kotak Surat Tertentu
Secara default, aplikasi dengan izin aplikasi Mail.ReadWrite atau Mail.Send
memiliki akses ke semua kotak surat di organisasi Anda. Untuk membatasi akses aplikasi hanya ke kotak surat tertentu, konfigurasi Kebijakan Akses Aplikasi di Microsoft Exchange Online.
Untuk mengonfigurasi Kebijakan Akses Aplikasi, selesaikan langkah-langkah berikut:
Hubungkan ke Exchange Online PowerShell:
Buka PowerShell sebagai administrator.
Instal modul Exchange Online Management (jika belum diinstal):
Install-Module -Name ExchangeOnlineManagementHubungkan ke Exchange Online:
Connect-ExchangeOnline
Identifikasi ID aplikasi dan kotak surat target:
Dapatkan Client ID (Application ID) aplikasi Microsoft Graph Mail Anda dari Azure AD.
Identifikasi alamat email kotak surat yang ingin diakses oleh aplikasi. Untuk pengelolaan yang lebih mudah, buat grup keamanan yang mendukung email di Azure AD dan tambahkan kotak surat ini sebagai anggota.
Buat Kebijakan Akses Aplikasi:
Gunakan cmdlet
New-ApplicationAccessPolicyuntuk membuat kebijakan yang membatasi akses ke kotak surat tertentu.Opsional: Batasi akses ke grup keamanan kotak surat tertentu:
Ganti
<Your_Application_ID>dengan ID Klien aplikasi Anda.Ganti
<Security_Group_Email_Address>dengan alamat email grup keamanan yang berisi kotak surat yang diizinkan.
New-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -PolicyScopeGroupId "<Security_Group_Email_Address>" -AccessRight RestrictAccess -Description "SOAR Graph Mail Access Policy"
Verifikasi efektivitas kebijakan menggunakan cmdlet
Test-ApplicationAccessPolicy:Test-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -Identity "user_email_to_test@yourdomain.com"Perintah ini menunjukkan apakah aplikasi memiliki akses ke kotak surat yang ditentukan berdasarkan kebijakan yang diterapkan.
Catatan:
Izin
OrganizationManagementatauSecurity Administratordi Exchange Online diperlukan untuk membuat kebijakan ini.Perubahan kebijakan biasanya diterapkan dalam waktu 30 menit.
Setelah menerapkan kebijakan, aplikasi hanya dapat mengakses kotak surat yang diizinkan. Upaya untuk mengakses yang lain akan menampilkan error
Access Denied.
Membuat rahasia klien
Untuk membuat rahasia klien, selesaikan langkah-langkah berikut:
Buka Certificates and secrets > New client secret.
Berikan deskripsi untuk rahasia klien dan tetapkan batas waktu habis masa berlakunya.
Klik Tambahkan.
Simpan nilai rahasia klien (bukan ID rahasia) untuk menggunakannya sebagai nilai parameter ID Rahasia saat Anda mengonfigurasi integrasi. Nilai rahasia klien hanya ditampilkan sekali.
Parameter integrasi
Integrasi Microsoft Graph Mail memerlukan parameter berikut:| Parameter | Deskripsi |
|---|---|
Azure AD Endpoint
|
Wajib. Endpoint Microsoft Entra ID yang akan digunakan dalam integrasi. Nilainya dapat berbeda untuk jenis tenant yang berbeda. Nilai defaultnya adalah |
Microsoft Graph Endpoint |
Wajib. Endpoint Microsoft Graph yang akan digunakan dalam integrasi. Nilai dapat berbeda untuk berbagai jenis tenant. Nilai defaultnya adalah |
Client ID |
Wajib. ID aplikasi klien Microsoft Entra yang akan digunakan dalam integrasi. |
Secret ID |
Wajib. Nilai rahasia klien aplikasi Microsoft Entra yang akan digunakan dalam integrasi. |
Tenant
|
Wajib. Nilai Microsoft Entra ID (ID tenant). |
Default Mailbox
|
Wajib. Kotak surat yang akan digunakan dalam integrasi. |
Mail Field Source |
Opsional. Jika dipilih, integrasi akan mengambil alamat kotak surat dari atribut detail pengguna Tidak dipilih secara default. |
Verify SSL |
Wajib. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Microsoft Graph. Diaktifkan secara default. |
Base64 Encoded Private Key |
Opsional. Kunci pribadi berenkode Base64 yang digunakan untuk mendekripsi email terenkripsi S/MIME. Jika nilai diberikan, Anda juga harus memberikan
|
Base64 Encoded Certificate |
Opsional. Sertifikat berenkode Base64 yang digunakan untuk mendekripsi email terenkripsi S/MIME. Jika nilai diberikan, Anda juga harus memberikan
|
Base64 Encoded CA certificate |
Opsional. Sertifikat CA tepercaya berenkode Base64 untuk verifikasi tanda tangan. Jika tidak ada nilai yang diberikan, verifikasi tanda tangan untuk email bertanda tangan yang masuk akan gagal, kecuali jika |
Untuk mendapatkan petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.
Anda dapat melakukan perubahan pada tahap berikutnya, 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 Melakukan tindakan manual.
Blokir Domain
Gunakan tindakan Blokir Domain untuk memblokir domain email tertentu dengan menambahkannya ke aturan pesan di kotak surat target. Jika tidak ada, aturan akan dibuat.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.Input tindakan
Tindakan Blokir Domain memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Domains |
Opsional. Daftar domain pengirim yang dipisahkan koma untuk diblokir (misalnya, |
Mailboxes |
Wajib. Default-nya adalah Kotak surat tempat aturan pesan akan ditambahkan. Dapat berupa daftar nama utama pengguna yang dipisahkan koma. |
Rule Name |
Wajib. Default-nya adalah Nama aturan pesan untuk menambahkan domain ini. Jika aturan sudah ada, aturan tersebut akan diperbarui. |
Action |
Wajib. Default-nya adalah Tindakan yang harus dilakukan untuk domain ini. Nilai yang mungkin: |
How many mailboxes to process in a single batch |
Opsional. Default-nya adalah Tentukan jumlah kotak surat yang harus diproses oleh tindakan dalam satu batch. |
Output tindakan
Tindakan Blokir Domain 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Blokir Domain:
{
"status": "Success",
"mailbox": "user@domain.com",
"blocked_domain": "malicious-domain.com"
}
Pesan output
Tindakan Blokir Domain memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Blokir Domain:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Blokir Pengirim
Gunakan tindakan Blokir Pengirim untuk memblokir pengirim email tertentu dengan menambahkannya ke aturan pesan di kotak surat target. Jika tidak ada, aturan akan dibuat.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.Input tindakan
Tindakan Blokir Pengirim memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Senders |
Opsional. Daftar alamat email pengirim yang dipisahkan koma untuk diblokir. Pengirim yang dimasukkan secara manual di kolom ini dan pengirim yang diekstrak secara dinamis dari entitas bekerja sama dan keduanya akan ditambahkan ke kondisi aturan. |
Mailboxes |
Wajib. Default-nya adalah Kotak surat tempat aturan pesan akan ditambahkan. Dapat berupa daftar nama utama pengguna yang dipisahkan koma. |
Rule Name |
Wajib. Default-nya adalah Nama aturan pesan untuk menambahkan pengirim ini. Jika aturan sudah ada, aturan tersebut akan diperbarui. |
Action |
Wajib. Default-nya adalah Tindakan yang harus diambil untuk pengirim ini. Nilai yang mungkin: |
How many mailboxes to process in a single batch |
Opsional. Default-nya adalah Tentukan jumlah kotak surat yang harus diproses oleh tindakan dalam satu batch. |
Output tindakan
Tindakan Blokir Pengirim 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Blokir Pengirim:
[
{
"Entity": "user@example.com",
"EntityResult": {
"successful_mailboxes": [
"target@example.com"
],
"failed_mailboxes": []
}
}
]
Pesan output
Tindakan Blokir Pengirim memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Blokir Pengirim:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menghapus Email
Anda dapat menggunakan tindakan Delete Email untuk menghapus satu atau beberapa email dari kotak surat. Tindakan ini akan menghapus email berdasarkan kriteria penelusuran Anda. Dengan izin yang sesuai, tindakan Hapus Email dapat memindahkan email ke kotak surat yang berbeda.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Hapus Email memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Delete In Mailbox |
Wajib. Kotak surat default tempat menjalankan operasi penghapusan. Jika izin mengizinkan, tindakan ini juga dapat menelusuri di kotak surat lain. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Folder Name |
Wajib. Folder kotak surat untuk menelusuri email. Untuk
menentukan subfolder, gunakan garis miring |
Mail IDs |
Opsional Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini menerima daftar ID email yang dipisahkan koma untuk ditelusuri. Jika parameter ini diberikan, penelusuran akan mengabaikan parameter |
Subject Filter |
Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri. |
Sender Filter |
Opsional Kondisi filter yang menentukan pengirim email yang diminta. |
Timeframe (Minutes) |
Opsional Kondisi filter yang menentukan jangka waktu dalam menit untuk menelusuri email. |
Only Unread |
Opsional Jika dipilih, tindakan hanya akan menelusuri email yang belum dibaca. Tidak dipilih secara default. |
How many mailboxes to process in a single batch |
Opsional Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah |
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Hapus Email:
| 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 Hapus Email memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
Failed to execute action, the error is:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Hapus Email:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menghapus Aturan Kotak Masuk
Gunakan tindakan Delete Inbox Rules untuk menghapus aturan pesan kotak masuk yang ditentukan untuk Kotak Surat tertentu. Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.
Input tindakan
Tindakan Hapus Aturan Kotak Masuk memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Mailboxes |
Wajib. Default-nya adalah Kotak surat tempat aturan pesan akan dihapus. Dapat berupa daftar UPN utama pengguna yang dipisahkan koma. |
Rule Name |
Wajib. Nama persis aturan pesan kotak masuk yang akan dihapus. |
How many mailboxes to process in a single batch |
Opsional. Default-nya adalah Tentukan jumlah kotak surat yang harus diproses oleh tindakan dalam satu batch. Jika tidak ada yang diberikan, nilai default 25 akan digunakan. |
Output tindakan
Tindakan Hapus Aturan Kotak Masuk 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Delete Inbox Rules:
{
"deleted_rule": [
"New test cases"
],
"successful_mailboxes": [
"labops1@siemplifycyarx.onmicrosoft.com"
],
"failed_mailboxes": [
"user2@example.com",
"user3@example.com"
]
}
Pesan output
Tindakan Hapus Aturan Kotak Masuk memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Hapus Aturan Kotak Masuk:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Mendownload Lampiran dari Email
Gunakan tindakan Download Lampiran Dari Email untuk mendownload lampiran dari email berdasarkan kriteria yang diberikan.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Tindakan ini bersifat asinkron. Jika perlu, sesuaikan nilai waktu tunggu skrip di IDE Google SecOps.
Tindakan ini menggantikan karakter garis bawah \` forward slash or/backslash characters in
the names of the downloaded attachments with the_`.
Input tindakan
Tindakan Download Attachments From Email memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Search In Mailbox |
Wajib. Kotak surat default tempat operasi penelusuran dijalankan. Jika izin mengizinkan, tindakan ini juga dapat menelusuri di kotak surat lain. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Folder Name |
Wajib. Folder kotak surat tempat penelusuran akan dijalankan. Untuk
menentukan subfolder, gunakan garis miring |
Download Destination |
Wajib. Jenis penyimpanan untuk menyimpan lampiran yang didownload. Secara default, tindakan ini akan mencoba menyimpan lampiran ke bucket Cloud Storage. Menyimpan lampiran ke sistem file lokal adalah opsi penggantian. Kemungkinan nilainya adalah |
Download Path |
Wajib. Jalur untuk mendownload lampiran. Saat menyimpan
lampiran ke bucket Cloud Storage atau sistem file lokal, tindakan ini mengharuskan Anda menentukan jalur download dalam format mirip Unix, seperti
|
Mail IDs |
Opsional Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini menerima daftar ID email yang dipisahkan koma untuk ditelusuri. Jika parameter ini diberikan, penelusuran akan mengabaikan parameter |
Subject Filter |
Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri. Filter ini menggunakan logika |
Sender Filter |
Opsional Kondisi filter yang menentukan pengirim email yang diminta. Filter ini menggunakan logika |
Download Attachments From EML |
Opsional Jika dipilih, tindakan akan mendownload lampiran dari file EML. Tidak dipilih secara default. |
Download attachments to unique path? |
Opsional Jika dipilih, tindakan ini akan mendownload lampiran ke
jalur unik yang diberikan di kolom parameter Tidak dipilih secara default. |
How many mailboxes to process in a single batch |
Opsional Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah |
Output tindakan
Tindakan Download Lampiran Dari 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Download Lampiran dari Email:
[
{
"attachment_name": "name1.png",
"downloaded_path": "file_path/name1.png"
},
{
"attachment_name": "name2.png",
"downloaded_path": "file_path/name2.png"
}
]
Pesan output
Tindakan Download Attachments From Email memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Download Lampiran dari Email:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Mengekstrak Data dari EML Terlampir
Gunakan tindakan Extract Data From Attached EML untuk mengambil data dari
lampiran EML email dan menampilkannya dalam hasil tindakan. Tindakan ini
mendukung format file .eml, .msg, dan .ics.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Extract Data From Attached EML memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Search In Mailbox |
Wajib. Kotak surat default tempat operasi penelusuran dijalankan. Jika izin mengizinkan, tindakan ini juga dapat menelusuri di kotak surat lain. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Folder Name |
Opsional Folder kotak surat tempat menjalankan penelusuran. Untuk
menentukan subfolder, gunakan garis miring |
Mail IDs |
Wajib. Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini menerima daftar ID email yang dipisahkan koma untuk dicari. |
Regex Map JSON |
Opsional Definisi JSON yang berisi ekspresi reguler untuk diterapkan ke file email yang dilampirkan dan menghasilkan nilai kunci tambahan dalam hasil JSON tindakan. Contoh nilai parameter ini adalah sebagai berikut: {ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}
|
Output tindakan
Tindakan Extract Data From Attached EML 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 menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Ekstrak Data Dari EML Terlampir:
[
{
"type": "EML",
"subject": "examplesubject",
"from": "sender@example.com",
"to": "user1@example.com,user2@example.com",
"date": "Thu,4Jul202412:11:29+0530",
"text": "text",
"html": "<p>example-html</p>",
"regex": {},
"regex_from_text_part": {},
"id": "ID",
"name": "example.eml"
},
{
"type": "MSG",
"subject": "examplesubject",
"from": "user@example.com",
"to": "user1@example.com,user2@example.com",
"date": "Thu,4Jul202412:11:29+0530",
"text": "text",
"html": "<p>examplehtml</p>",
"regex": {},
"regex_from_text_part": {},
"id": "ID",
"name": "example.msg"
},
{
"type": "ICS",
"subject": "examplesubject",
"from": "sender@example.com",
"to": "user1@example.com,user2@example.com",
"date": "Thu,4Jul202412:11:29+0530",
"text": "text",
"html": "<p>example-html</p>",
"regex": {},
"regex_from_text_part": {},
"id": "ID",
"name": "example.ics"
}
]
Pesan output
Tindakan Ekstrak Data dari EML Terlampir memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
Failed to execute action, the error is:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Ekstrak Data dari EML Terlampir:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Meneruskan Email
Gunakan tindakan Teruskan Email untuk meneruskan email yang menyertakan rangkaian pesan sebelumnya. Dengan izin yang sesuai, tindakan ini dapat mengirim email dari kotak surat yang berbeda dengan yang ditentukan dalam konfigurasi integrasi.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Teruskan Email memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Send From |
Wajib. Alamat email opsional yang digunakan untuk mengirim email, jika izin mengizinkan. Secara default, email dikirim dari kotak surat default yang ditentukan dalam konfigurasi integrasi. |
Folder Name |
Opsional Folder kotak surat untuk menelusuri email. Untuk
menentukan subfolder, gunakan garis miring |
Mail ID |
Wajib. ID email yang akan diteruskan. |
Subject |
Wajib. Subjek email. |
Send to |
Wajib. Daftar alamat email yang dipisahkan koma untuk penerima email, seperti |
CC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email. Formatnya sama seperti untuk parameter |
BCC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email. Formatnya sama dengan parameter |
Attachments Paths |
Opsional Daftar jalur yang dipisahkan koma untuk lampiran file yang disimpan di server,
seperti |
Mail content |
Wajib. Isi email. |
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Teruskan Email:
| 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 Teruskan Email memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Email with message ID
MAIL_ID was forwarded successfully. |
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Teruskan Email:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Mendapatkan Setelan Akun Kotak Surat Di Luar Fasilitas
Gunakan tindakan Get Mailbox Account Out Of Facility Settings untuk mengambil
setelan out of facility (OOF) akun kotak surat untuk
entitas User Google SecOps yang disediakan.
Tindakan Get Mailbox Account Out Of Facility Settings menggunakan Microsoft Graph API versi beta.
Tindakan ini dijalankan pada entity User Google SecOps.
Input tindakan
Tidak ada.
Output tindakan
Tindakan Get Mailbox Account Out Of Facility Settings 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 Anda menggunakan tindakan Dapatkan Setelan Akun Kotak Surat di Luar Fasilitas:
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
"id": "ID",
"availability": "Offline",
"activity": "Offline",
"statusMessage": null,
"outOfOfficeSettings": {
"message": "\n\nOut Of Facility111\n",
"isOutOfOffice": true
}
}
Pesan output
Tindakan Get Mailbox Account Out Of Facility Settings dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat Anda menggunakan tindakan Get Mailbox Account Out Of Facility Settings:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Aturan Daftar
Gunakan tindakan List Rules untuk mencantumkan semua aturan pesan untuk kotak surat tertentu menggunakan Microsoft Graph API.
Input tindakan
Tindakan List Rules memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Mailboxes |
Wajib. Default-nya adalah Kotak surat yang aturannya akan dicantumkan. Dapat berupa daftar nama utama pengguna yang dipisahkan koma. |
Rule Name |
Opsional. Memfilter menurut nama tampilan aturan. |
Limit |
Opsional. Default-nya adalah Batasi jumlah aturan yang akan ditampilkan per kotak surat. |
Output tindakan
Tindakan List Rules memberikan output berikut:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tidak tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Pesan output | Tersedia |
| Hasil skrip | Tersedia |
Tabel repositori kasus
Tindakan List Rules memberikan detail eksekusi pada tabel dinding kasus.
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan List Rules:
[
{
"mailbox": "user@example.com",
"rules": [
{
"id": "AAMkAD...",
"displayName": "Google SecOps - Blocked Senders",
"sequence": 1,
"isEnabled": true
}
]
}
]
Pesan output
Tindakan List Rules memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan List Rules:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Tandai Email sebagai Sampah
Gunakan tindakan Tandai Email sebagai Sampah untuk menandai email sebagai sampah di kotak surat yang ditentukan. Tindakan ini akan menambahkan pengirim email ke daftar pengirim yang diblokir dan memindahkan pesan ke folder Junk Email.
Tindakan Tandai Email sebagai Sampah menggunakan Microsoft Graph API versi beta.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Tandai Email sebagai Sampah memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Search In Mailbox |
Wajib. Kotak surat tempat menelusuri email. Secara default, tindakan ini akan mencoba menelusuri email di kotak surat default yang Anda tentukan dalam konfigurasi integrasi. Untuk menjalankan penelusuran di kotak surat lain, konfigurasikan izin yang sesuai untuk tindakan tersebut. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Folder Name |
Wajib. Folder kotak surat tempat menelusuri email. Untuk
menentukan subfolder, gunakan garis miring Nilai defaultnya adalah |
Mail IDs |
Wajib. ID atau nilai Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Output tindakan
Tindakan Tandai Email sebagai Spam 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 Mark Email as Junk dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat Anda menggunakan tindakan Tandai Email sebagai Spam:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menandai Email sebagai Bukan Sampah
Gunakan tindakan Tandai Email sebagai Bukan Sampah untuk menandai email sebagai bukan sampah di kotak surat tertentu. Tindakan ini akan menghapus pengirim dari daftar pengirim yang diblokir dan memindahkan pesan ke folder Kotak Masuk.
Tindakan Tandai Email sebagai Bukan Spam menggunakan Microsoft Graph API versi beta.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Tandai Email sebagai Bukan Spam memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Search In Mailbox |
Wajib. Kotak surat tempat menelusuri email. Secara default, tindakan ini akan mencoba menelusuri email di kotak surat default yang Anda tentukan dalam konfigurasi integrasi. Untuk menjalankan penelusuran di kotak surat lain, konfigurasikan izin yang sesuai untuk tindakan tersebut. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Folder Name |
Wajib. Folder kotak surat tempat menelusuri email. Untuk
menentukan subfolder, gunakan garis miring |
Mail IDs |
Wajib. ID atau nilai Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Output tindakan
Tindakan Tandai Email sebagai Bukan Spam 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 Tandai Email sebagai Bukan Sampah dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat Anda menggunakan tindakan Tandai Email sebagai Bukan Spam:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Memindahkan Email Ke Folder
Gunakan tindakan Move Email To Folder untuk memindahkan satu atau beberapa email dari folder email sumber ke folder lain di kotak surat. Dengan izin yang sesuai, tindakan ini dapat memindahkan email ke kotak surat lain yang berbeda dari yang disediakan dalam konfigurasi integrasi.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Input tindakan
Untuk mengonfigurasi tindakan Move Email To Folder, gunakan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Move In Mailbox |
Wajib. Kotak surat default tempat operasi pemindahan berjalan. Jika izin mengizinkan, tindakan ini juga dapat menelusuri di kotak surat lain. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Source Folder Name |
Wajib. Folder sumber tempat email akan dipindahkan. Untuk
menentukan subfolder, gunakan garis miring |
Destination Folder Name |
Wajib. Folder tujuan untuk memindahkan email. Berikan nilai parameter dalam format berikut:
|
Mail IDs |
Opsional Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini menerima daftar ID email yang dipisahkan koma untuk ditelusuri. Jika parameter ini diberikan, penelusuran akan mengabaikan parameter |
Subject Filter |
Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri. Filter ini menggunakan logika |
Sender Filter |
Opsional Kondisi filter yang menentukan pengirim email yang diminta. Filter ini menggunakan logika |
Timeframe (Minutes) |
Opsional Kondisi filter yang menentukan jangka waktu, dalam menit, untuk menelusuri email. |
Only Unread |
Opsional Jika dipilih, tindakan hanya akan menelusuri email yang belum dibaca. Tidak dipilih secara default. |
How many mailboxes to process in a single batch |
Opsional Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah |
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Pindahkan Email Ke Folder:
| 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 Move Email To Folder memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
Failed to execute action, the error is:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Move Email To Folder:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Ping
Gunakan tindakan Ping untuk menguji konektivitas ke layanan email Microsoft Graph.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Input tindakan
Tidak ada.
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Ping:
| 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 memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully connected to the Microsoft Graph mail service with
the provided connection parameters! |
Tindakan berhasil. |
Failed to connect to the Microsoft Graph mail service! Error is
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Ping:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menghapus Domain yang Diblokir
Gunakan tindakan Hapus Domain yang Diblokir untuk menghapus domain email tertentu dari aturan pesan di kotak surat target. Jika aturan menjadi kosong, aturan tersebut akan dihapus.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.Input tindakan
Tindakan Hapus Domain yang Diblokir memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Domains |
Opsional. Daftar domain pengirim yang dipisahkan koma untuk dihapus (misalnya, |
Mailboxes |
Wajib. Default-nya adalah Kotak surat tempat aturan pesan berada. Dapat berupa daftar nama utama pengguna yang dipisahkan koma. |
Rule Name |
Wajib. Default-nya adalah Nama aturan pesan yang akan menghapus domain ini. |
How many mailboxes to process in a single batch |
Opsional. Default-nya adalah Tentukan jumlah kotak surat yang harus diproses oleh tindakan dalam satu batch. |
Output tindakan
Tindakan Remove Block Domain 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Remove Block Domain:
[
{
"Entity": "example.com",
"EntityResult": {
"successful_mailboxes": [
"user@example.com"
],
"failed_mailboxes": []
}
}
]
Pesan output
Tindakan Hapus Pemblokiran Domain memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Remove Block Domain:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menghapus Pemblokiran Pengirim
Gunakan tindakan Remove Block Sender untuk menghapus pengirim email yang ditentukan dari aturan pesan di kotak surat target. Jika aturan menjadi kosong, aturan tersebut akan dihapus.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di lingkungan pengembangan terintegrasi (IDE) Google SecOps sesuai kebutuhan.Input tindakan
Tindakan Hapus Pengirim yang Diblokir memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Senders |
Opsional. Daftar alamat email pengirim yang dipisahkan koma untuk dihapus. Pengirim yang dimasukkan secara manual di kolom ini dan pengirim yang diekstrak secara dinamis dari entitas akan bekerja sama dan keduanya akan dihapus dari kondisi aturan. |
Mailboxes |
Wajib. Default-nya adalah Kotak surat tempat aturan pesan berada. Dapat berupa daftar nama utama pengguna yang dipisahkan koma. |
Rule Name |
Wajib. Default-nya adalah Nama aturan pesan untuk menghapus pengirim ini. |
How many mailboxes to process in a single batch |
Opsional. Default-nya adalah Tentukan jumlah kotak surat yang harus diproses oleh tindakan dalam satu batch. |
Output tindakan
Tindakan Hapus Pemblokiran Pengirim 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Hapus Pemblokiran Pengirim:
[
{
"Entity": "user@example.com",
"EntityResult": {
"successful_mailboxes": [
"target@example.com"
],
"failed_mailboxes": []
}
}
]
Pesan output
Tindakan Hapus Pemblokiran Pengirim memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Hapus Pemblokir Pengirim:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menyimpan Email Ke Kasus
Gunakan tindakan Simpan Email Ke Kasus untuk menyimpan email atau lampiran email ke Dinding Kasus Google SecOps. Dengan izin yang sesuai, tindakan ini dapat menyimpan email dari kotak surat selain yang diberikan dalam konfigurasi integrasi.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Save Email To The Case memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Search In Mailbox |
Wajib. Kotak surat default tempat operasi penelusuran dijalankan. Jika izin mengizinkan, tindakan ini juga dapat menelusuri di kotak surat lain. |
Folder Name |
Opsional Folder kotak surat tempat menelusuri email. Untuk
menentukan subfolder, gunakan garis miring |
Mail ID |
Wajib. Daftar ID email yang dipisahkan koma untuk ditelusuri. Jika Anda menggunakan tindakan Kirim Email untuk
mengirim email, tetapkan nilai parameter ke placeholder
|
Save Only Email Attachments |
Opsional Jika dipilih, tindakan hanya menyimpan lampiran dari email yang ditentukan. Tidak dipilih secara default. |
Attachment To Save |
Opsional Jika parameter Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. |
Base64 Encode |
Opsional Jika dipilih, tindakan ini akan mengenkode file email ke format base64. Tidak dipilih secara default. |
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Simpan Email Ke Kasus:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tidak tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Pesan output | Tersedia |
| Hasil skrip | Tersedia |
Lampiran repositori kasus
Lampiran berikut terkait dengan tindakan Simpan Email ke Kasus:
EMAIL_SUBJECT.eml, jika tindakan menyimpan email.Jika tindakan menyimpan lampiran, nama lampiran berisi ekstensi file, jika ada.
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Simpan Email ke Kasus:
{
"id": "ID",
"createdDateTime": "2024-02-16T14:10:34Z",
"eml_info": "example_info",
"lastModifiedDateTime": "2024-02-16T14:10:41Z",
"changeKey": "cxsdjjh",
"categories": [],
"receivedDateTime": "2024-02-16T14:10:35Z",
"sentDateTime": "2024-02-16T14:09:36Z",
"hasAttachments": true,
"internetMessageId": "INTERNET_MESSAGE_ID",
"subject": "all attachments",
"bodyPreview": "all the attachments",
"importance": "normal",
"parentFolderId": "PARENT_FOLDER_ID",
"conversationId": "CONVERSATION_ID",
"conversationIndex": "example-index",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://example.com/",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "<html><head>example-html</head></html>"
},
"sender": {
"emailAddress": {
"name": "NAME",
"address": "sender@example.com"
}
},
"from": {
"emailAddress": {
"name": "NAME",
"address": "user@example.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "NAME",
"address": "recipient@example.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"flag": {
"flagStatus": "notFlagged"
}
}
Pesan output
Di Repositori Kasus, tindakan Simpan Email Ke Kasus memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
Failed to execute action, the error is:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Save Email To The Case:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menelusuri Email
Gunakan tindakan Search Emails untuk menjalankan penelusuran email di kotak surat default berdasarkan kriteria penelusuran yang diberikan. Dengan izin yang sesuai, tindakan ini dapat menjalankan penelusuran di kotak surat lain.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di Google SecOps IDE sesuai kebutuhan.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Search Emails memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Search In Mailbox |
Wajib Kotak surat default tempat operasi penelusuran dijalankan. Jika izin mengizinkan, tindakan ini juga dapat menelusuri di kotak surat lain. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. Untuk penelusuran kompleks terhadap sejumlah besar kotak surat, gunakan integrasi Exchange Extension Pack. |
Folder Name |
Opsional
Folder kotak surat tempat menelusuri email. Untuk menentukan subfolder,
gunakan garis miring Default-nya adalah |
Subject Filter |
Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri. Filter ini menggunakan logika |
Sender Filter |
Opsional Kondisi filter yang menentukan pengirim email yang diminta. Filter ini menggunakan logika |
Recipient Filter |
Opsional Kondisi filter yang menentukan penerima email yang diminta. |
Timeframe (minutes) |
Opsional Kondisi filter yang menentukan periode dalam menit untuk menelusuri email. |
Start Time |
Opsional Tentukan waktu mulai untuk penelusuran email dalam format ISO 8601. Parameter ini memiliki prioritas lebih tinggi daripada |
End Time |
Opsional Tentukan waktu berakhir untuk penelusuran email dalam format ISO 8601. Jika tidak diberikan dan |
Body Regex Filter |
Opsional Tentukan pola ekspresi reguler untuk menelusuri isi email. |
Message IDs |
Opsional Daftar ID pesan yang dipisahkan koma untuk ditelusuri. Catatan: filter ini memiliki prioritas di atas filter lainnya. |
Max Emails To Return |
Opsional Jumlah email yang akan ditampilkan untuk tindakan tersebut. Jika Anda tidak menetapkan nilai, nilai default API akan digunakan. Default-nya adalah |
Only Unread |
Opsional Jika dipilih, tindakan hanya akan menelusuri email yang belum dibaca. Tidak dipilih secara default. |
Select All Fields For Return |
Opsional Jika dipilih, tindakan akan menampilkan semua kolom yang tersedia untuk email yang diperoleh. Tidak dipilih secara default. |
How many mailboxes to process in a single batch |
Opsional Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Default-nya adalah |
Search in all mailboxes |
Opsional Jika dipilih, tindakan akan menelusuri semua kotak surat yang dapat diakses. Tidak dipilih secara default. |
Limit the Amount of Information Returned in the JSON Result |
Opsional Jika dipilih, jumlah informasi yang ditampilkan oleh tindakan hanya dibatasi pada kolom email utama. Tidak dipilih secara default. |
Disable the Action JSON Result |
Opsional Jika dipilih, tindakan tidak akan menampilkan hasil JSON. Tidak dipilih secara default. |
Output tindakan
Tindakan Search Emails memberikan output berikut:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tidak tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Hasil skrip | Tersedia |
Tabel repositori kasus
Tindakan Search Emails dapat menghasilkan tabel berikut:
Judul tabel: Email yang Cocok
Kolom:
- ID Email
- Subjek
- Pengirim
- Penerima
- Tanggal Diterima
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Telusuri Email:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
true atau false |
Pesan output tindakan
Tindakan Search Emails memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Kirim Email
Gunakan tindakan Kirim Email untuk mengirim email dari kotak surat tertentu ke daftar penerima arbitrer.
Tindakan ini dapat mengirim email dalam format teks biasa atau HTML. Dengan izin yang sesuai, tindakan ini dapat mengirim email dari kotak surat yang berbeda dengan yang ditentukan dalam konfigurasi integrasi.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Referensi cepat konfigurasi S/MIME
Gunakan referensi berikut untuk menentukan parameter S/MIME yang akan dikonfigurasi berdasarkan tingkat keamanan email keluar:
| Jenis email yang diinginkan | Base64 Encoded Certificate |
Base64 Encoded Private Key |
Base64 Encoded Recipient Certificate |
|---|---|---|---|
| Email standar (tanpa S/MIME) | Biarkan kosong | Biarkan kosong | Biarkan kosong |
| Ditandatangani secara digital | Wajib | Wajib | Biarkan kosong |
| Dienkripsi | Biarkan kosong | Biarkan kosong | Wajib |
| Ditandatangani dan dienkripsi | Wajib | Wajib | Wajib |
Mengonversi file sertifikat ke Base64
Untuk mengenkode file sertifikat dan kunci pribadi Anda menjadi string Base64 satu baris untuk parameter tindakan, jalankan perintah berikut:
Linux dan macOS:
base64 -w 0 sender_cert.crt
base64 -w 0 sender_key.key
Windows PowerShell:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\certificate.crt"))
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\private_key.key"))
Input tindakan
Tindakan Kirim Email memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Send From |
Wajib. Alamat email opsional yang digunakan untuk mengirim email, jika izin mengizinkan. Secara default, tindakan ini mengirim email dari kotak surat default yang ditentukan dalam konfigurasi integrasi. |
Subject |
Wajib. Subjek email. |
Send to |
Wajib. Daftar alamat email yang dipisahkan koma untuk penerima email, seperti |
CC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email. Formatnya sama seperti untuk parameter |
BCC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email. Formatnya sama dengan parameter |
Attachments Paths |
Opsional Daftar jalur yang dipisahkan koma untuk lampiran file yang disimpan di server,
seperti |
Attachments Location |
Wajib. Lokasi tempat lampiran disimpan. Secara default, tindakan ini mencoba mengupload lampiran dari bucket Cloud Storage. Kemungkinan nilainya adalah |
Mail Content Type |
Opsional Jenis konten email. Kemungkinan nilainya adalah sebagai berikut:
Nilai defaultnya adalah |
Mail Content |
Wajib. Isi email. |
Reply-To Recipients |
Opsional Daftar penerima yang dipisahkan koma untuk digunakan di header Reply-To. Gunakan header Reply-To untuk mengalihkan email balasan ke alamat email yang ditentukan, bukan alamat pengirim di kolom From. |
Base64 Encoded Certificate |
Opsional Sertifikat publik X.509 berenkode Base64 ( Jika diberikan, Anda juga harus memberikan
|
Base64 Encoded Private Key |
Opsional Kunci pribadi berenkode Base64 ( Wajib jika |
Base64 Encoded Recipient Certificate |
Opsional Sertifikat publik berenkode Base64 ( |
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Kirim Email:
| 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 Send Email memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Failed to execute action, the error is:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Kirim Email:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Mengirim HTML Email
Gunakan tindakan Send Email HTML untuk mengirim email yang menggunakan template HTML Google SecOps dari kotak surat tertentu ke daftar penerima arbitrer. Dengan izin yang sesuai, tindakan dapat mengirim email dari kotak surat selain kotak surat default.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Input tindakan
Tindakan Send Email HTML memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Send From |
Wajib. Alamat email opsional yang digunakan untuk mengirim email, jika izin mengizinkan. Secara default, tindakan ini mengirim email dari kotak surat default yang ditentukan dalam konfigurasi integrasi. |
Subject |
Wajib. Subjek email. |
Send to |
Wajib. Daftar alamat email yang dipisahkan koma untuk penerima email, seperti |
CC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email. Formatnya sama seperti untuk parameter |
BCC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email. Formatnya sama dengan parameter |
Attachments Paths |
Opsional Jalur lengkap untuk lampiran yang akan diberikan,
seperti Anda dapat memberikan beberapa nilai dalam string yang dipisahkan koma. |
Email HTML Template |
Wajib. Jenis template HTML yang akan digunakan. Kemungkinan nilainya adalah Nilai defaultnya adalah |
Mail Content |
Wajib. Isi email. |
Reply-To Recipients |
Opsional Daftar penerima yang dipisahkan koma untuk digunakan di header Reply-To. Gunakan header Reply-To untuk mengalihkan email balasan ke alamat email tertentu, bukan ke alamat pengirim yang tercantum di kolom From. |
Attachment Location |
Wajib. Lokasi tempat lampiran disimpan. Secara default, tindakan ini mencoba mengupload lampiran dari bucket Cloud Storage. Kemungkinan nilainya adalah |
Output tindakan
Tindakan Send Email HTML 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Send Email HTML:
{
"createdDateTime": "2024-01-30T16:50:27Z",
"lastModifiedDateTime": "2024-01-30T16:50:27Z",
"changeKey": "example-key",
"categories": [],
"receivedDateTime": "2024-01-30T16:50:27Z",
"sentDateTime": "2024-01-30T16:50:27Z",
"hasAttachments": false,
"internetMessageId": "outlook.com",
"subject": "Testing",
"bodyPreview": "example",
"importance": "normal",
"parentFolderId": "ID",
"conversationId": "ID",
"conversationIndex": "INDEX",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://example.com",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "content"
},
"sender": {
"emailAddress": {
"name": "NAME",
"address": "sender@example.com"
}
},
"from": {
"emailAddress": {
"name": "NAME",
"address": "user@example.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "NAME",
"address": "recipient@example.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"uniqueBody": {
"contentType": "html",
"content": "content"
},
"flag": {
"flagStatus": "notFlagged"
},
"id": "ID"
}
Pesan output
Di Case Wall, tindakan Send Email HTML memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Email was sent successfully. |
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Send Email HTML:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Kirim Balasan Rangkaian Pesan
Gunakan tindakan Send Thread Reply untuk mengirim pesan sebagai balasan ke rangkaian pesan email. Dengan izin yang sesuai, tindakan ini dapat mengirim email dari kotak surat selain yang ditentukan dalam konfigurasi integrasi.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Input tindakan
Tindakan Send Thread Reply memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Send From |
Wajib. Alamat email opsional yang digunakan untuk mengirim email, jika izin mengizinkan. Secara default, tindakan ini mengirim email dari kotak surat default yang ditentukan dalam konfigurasi integrasi. |
Mail ID |
Wajib. ID email yang akan ditelusuri. |
Folder Name |
Opsional Folder kotak surat tempat menelusuri email. Untuk
menentukan subfolder, gunakan garis miring Nilai defaultnya adalah |
Attachments Paths |
Opsional Daftar jalur yang dipisahkan koma untuk lampiran file yang disimpan di server,
seperti |
Mail Content |
Wajib. Isi email. |
Reply All |
Opsional Jika dipilih, tindakan ini akan mengirimkan balasan ke semua penerima yang terkait dengan email asli. Tidak dipilih secara default.
Parameter ini memiliki prioritas lebih tinggi daripada parameter |
Reply To |
Opsional Daftar email yang dipisahkan koma sebagai tujuan pengiriman balasan. Jika Anda tidak memberikan nilai dan kotak centang Jika kotak centang |
Attachments Location |
Wajib. Lokasi tempat lampiran disimpan. Secara default, tindakan ini mencoba mengupload lampiran dari bucket Cloud Storage. Kemungkinan nilainya adalah |
Message Timezone |
Opsional. Zona waktu yang digunakan untuk tanggal pengiriman email asli di header balasan
(seperti Nilai defaultnya adalah |
Output tindakan
Tabel berikut menjelaskan jenis output yang terkait dengan tindakan Kirim Balasan Rangkaian Pesan:
| 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 Thread:
{
"id": "yyyy",
"createdDateTime": "2024-02-02T10:57:18Z",
"lastModifiedDateTime": "2024-02-02T10:57:23Z",
"changeKey": "dsf+oAAQLaPjk",
"categories": [],
"receivedDateTime": "2024-02-02T10:57:20Z",
"sentDateTime": "2024-02-02T10:57:19Z",
"hasAttachments": true,
"internetMessageId": "sdfhsjdfhjsdjfd",
"subject": "RE: reply checking",
"bodyPreview": "Reply check kr",
"importance": "normal",
"parentFolderId": "id",
"conversationId": "id",
"conversationIndex": "sdghfjfke",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://www.example.com/about",
"inferenceClassification": "focused",
"body": {
"contentType": "text",
"content": "Reply check kr"
},
"sender": {
"emailAddress": {
"name": "aff",
"address": "ddxsm@a.com"
}
},
"from": {
"emailAddress": {
"name": "fasf",
"address": "ddxsm@a.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "wf",
"address": "ddxsm@a.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"uniqueBody": {
"contentType": "html",
"content": "Reply check"
},
"flag": {
"flagStatus": "notFlagged"
}
}
Pesan output
Tindakan Send Thread Reply memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully sent reply to the mail with ID:
EMAIL_ID |
Tindakan berhasil. |
Error executing action "Send Thread Reply". Reason: if you want
to send a reply only to your own email address, you need to work with
"Reply To" parameter. |
Tindakan gagal. Periksa nilai parameter |
Failed to execute action, the error is:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Kirim Balasan Thread:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Kirim Email Voting
Gunakan tindakan Kirim Email Pemungutan Suara untuk mengirim email dengan opsi jawaban yang telah ditentukan. Tindakan ini menggunakan template HTML Google SecOps untuk memformat email. Dengan izin yang sesuai, tindakan Send Vote Email dapat mengirim email dari kotak surat selain kotak surat default.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Send Vote Email memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Send From |
Wajib. Alamat email opsional yang digunakan untuk mengirim email, jika izin mengizinkan. Secara default, tindakan ini mengirim email dari kotak surat default yang ditentukan dalam konfigurasi integrasi. |
Subject |
Wajib. Subjek email. |
Send to |
Wajib. Daftar alamat email yang dipisahkan koma untuk penerima email, seperti |
CC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email. Formatnya sama seperti untuk parameter |
BCC |
Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email. Formatnya sama dengan parameter |
Attachments Paths |
Opsional Jalur lengkap untuk lampiran yang akan diberikan,
seperti Anda dapat memberikan beberapa nilai dalam string yang dipisahkan koma. |
Email HTML Template |
Wajib. Jenis template HTML yang akan digunakan. Kemungkinan nilainya adalah Nilai defaultnya adalah |
Reply-To Recipients |
Opsional Daftar penerima yang dipisahkan koma untuk digunakan di header Reply-To. Gunakan header Reply-To untuk mengalihkan email balasan ke alamat email yang ditentukan, bukan ke alamat pengirim yang dinyatakan di kolom From. |
Structure of voting options |
Wajib. Struktur suara yang akan dikirim ke penerima. Kemungkinan nilainya adalah |
Attachment Location |
Wajib. Lokasi tempat lampiran disimpan. Secara default, tindakan ini mencoba mengupload lampiran dari bucket Cloud Storage. Kemungkinan nilainya adalah |
Output tindakan
Tindakan Send Vote 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 menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Send Vote Email:
{
"createdDateTime": "2024-01-30T16:50:27Z",
"lastModifiedDateTime": "2024-01-30T16:50:27Z",
"changeKey": "KEY",
"categories": [],
"receivedDateTime": "2024-01-30T16:50:27Z",
"sentDateTime": "2024-01-30T16:50:27Z",
"hasAttachments": false,
"internetMessageId": "<example-message-ID>",
"subject": "Testing",
"bodyPreview": "example",
"importance": "normal",
"parentFolderId": "FOLDER_ID",
"conversationId": "CONVERSATION_ID",
"conversationIndex": "CONVERSATION_INDEX",
"isDeliveryReceiptRequested": false,
"isReadReceiptRequested": false,
"isRead": true,
"isDraft": false,
"webLink": "https://www.example.com/about",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "content"
},
"sender": {
"emailAddress": {
"name": "NAME",
"address": "sender@example.com"
}
},
"from": {
"emailAddress": {
"name": "NAME",
"address": "user@example.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "NAME",
"address": "recipient@example.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"uniqueBody": {
"contentType": "html",
"content": "content"
},
"flag": {
"flagStatus": "notFlagged"
},
"id": "ID"
}
Pesan output
Di Repositori Kasus, tindakan Kirim Email Pemungutan Suara memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Email was sent successfully. |
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Send Vote Email:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menunggu Email Dari Pengguna
Gunakan tindakan Tunggu Email Dari Pengguna untuk menunggu respons pengguna berdasarkan email yang dikirim menggunakan tindakan Kirim Email.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di Google SecOps IDE sesuai kebutuhan. Jika waktu tunggu disetel ke 0 atau dibiarkan kosong, waktu tunggu default yang dikonfigurasi di setelan lingkungan akan digunakan.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Input tindakan
Tindakan Wait For Email From User memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Mail ID |
Wajib ID atau |
Mail Date |
Opsional Stempel waktu pengiriman email yang ditunggu oleh tindakan. Jika pesan dikirim menggunakan tindakan Kirim Email, pilih kolom |
Mail Recipients |
Opsional Daftar alamat email penerima yang dipisahkan koma yang responsnya ditunggu oleh tindakan. Jika pesan dikirim menggunakan tindakan Kirim Email, pilih kolom |
How long to wait for recipient reply (minutes) |
Opsional Berapa lama dalam menit untuk menunggu balasan pengguna sebelum menandainya sebagai habis waktu. Default-nya adalah |
Wait for All Recipients to Reply? |
Opsional Jika dipilih, tindakan akan menunggu respons dari semua penerima hingga mencapai waktu tunggu atau melanjutkan dengan balasan pertama. Tidak dipilih secara default. |
Wait Stage Exclude pattern |
Opsional Ekspresi reguler untuk mengecualikan balasan tertentu dari tahap tunggu. Parameter ini berfungsi dengan subjek dan isi email. Misalnya, jika Anda mengonfigurasi ekspresi reguler |
Folder to Check for Reply |
Opsional Folder email kotak surat untuk menelusuri balasan penerima yang masuk. Penelusuran dijalankan di kotak surat tempat email yang berisi pertanyaan dikirim. Mendukung subfolder bertingkat menggunakan garis miring ke depan |
Fetch Response Attachments |
Opsional Jika dipilih dan balasan penerima berisi lampiran, tindakan akan mengambil balasan dan menambahkannya sebagai lampiran pada hasil tindakan. Tidak dipilih secara default. |
Limit the Amount of Information Returned in the JSON Result |
Opsional Jika dipilih, jumlah informasi yang ditampilkan oleh tindakan hanya dibatasi pada kolom email utama. Dipilih secara default. |
Disable the Action JSON Result |
Opsional Jika dipilih, tindakan tidak akan menampilkan hasil JSON. Tidak dipilih secara default. |
Output tindakan
Tindakan Wait For Email From User memberikan output berikut:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Hasil skrip | Tersedia |
Lampiran repositori kasus
Lampiran Case Wall berikut dikaitkan dengan tindakan Wait For Email From User:
Jenis: Entity
Konten lampiran: Judul, Nama file (ekstensi disertakan, jika ada), fileContent.
- Judul: Lampiran balasan
RECIPIENT_EMAIL. - Nama file:
ATTACHMENT_FILENAME+FILE_EXTENSION - fileContent:
CONTENT_OF_THE_ATTACHED_FILE
Tabel repositori kasus
Tindakan Wait For Email From User dapat menghasilkan tabel berikut:
Judul tabel: Email yang Cocok
Kolom:
- ID Email
- Tanggal Diterima
- Pengirim
- Penerima
- Subjek
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 |
Pesan output tindakan
Tindakan Wait For Email From User memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Menunggu Hasil Email Voting
Gunakan tindakan Wait For Vote Email Results untuk menunggu respons pengguna berdasarkan email pemungutan suara yang dikirim menggunakan tindakan Send Vote Email.
Tindakan ini bersifat asinkron. Sesuaikan waktu tunggu tindakan di IDE Google SecOps sesuai kebutuhan.
Tindakan ini tidak dijalankan pada entity Google SecOps.
Input tindakan
Tindakan Wait For Vote Email Results memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Vote Mail Sent From |
Wajib. Kotak surat yang digunakan tindakan Send Vote Email untuk mengirim email. Nilai defaultnya adalah kotak surat yang Anda tentukan dalam konfigurasi integrasi. Secara opsional, Anda dapat menetapkan nilai yang berbeda untuk parameter ini jika email pemungutan suara dikirim dari kotak surat yang berbeda. |
Mail ID |
Wajib. ID email. Jika email dikirim menggunakan tindakan Untuk menampilkan ID email, Anda dapat menggunakan tindakan Search Emails. |
Wait for All Recipients To Reply? |
Opsional Jika dipilih, tindakan akan menunggu respons dari semua penerima hingga mencapai waktu tunggu atau melanjutkan dengan balasan pertama. Diaktifkan secara default. |
Wait Stage Exclude Pattern |
Opsional Ekspresi reguler untuk mengecualikan balasan tertentu dari tahap tunggu. Parameter ini berfungsi dengan isi email. Contoh: tindakan tidak menganggap pesan saat tidak di kantor otomatis sebagai balasan penerima, melainkan menunggu balasan pengguna yang sebenarnya. |
Folder To Check For Reply |
Opsional Folder email kotak surat untuk menelusuri balasan pengguna. Penelusuran dijalankan di kotak surat tempat email yang berisi pertanyaan dikirim. Parameter ini menerima daftar folder yang dipisahkan koma untuk memeriksa respons pengguna di beberapa folder. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah |
Folder To Check For Sent Mail |
Opsional Folder kotak surat untuk menelusuri email terkirim. Ini adalah kotak surat yang Anda gunakan untuk mengirim email berisi pertanyaan. Parameter ini menerima daftar folder yang dipisahkan koma untuk memeriksa respons pengguna di beberapa folder. Parameter ini peka huruf besar/kecil.
Untuk menentukan subfolder, gunakan garis miring Nilai
defaultnya adalah |
Fetch Response Attachments |
Opsional Jika dipilih dan balasan penerima berisi lampiran, tindakan ini akan mengambil balasan dan menambahkannya sebagai lampiran ke Case Wall. Tidak dipilih secara default. |
Output tindakan
Tindakan Wait For Vote Email Results memberikan output berikut:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Pesan output | Tersedia |
| Hasil skrip | Tersedia |
Lampiran repositori kasus
Lampiran Catatan Aktivitas Kasus berikut dikaitkan dengan tindakan Wait For Vote Email Results:
Jenis: Entity
Konten lampiran: Judul, Nama file (termasuk ekstensi, jika ada), fileContent.
- Judul:
RECIPIENT_EMAILlampiran balasan. - Nama file:
ATTACHMENT_FILENAME+FILE_EXTENSION - fileContent:
CONTENT_OF_THE_ATTACHED_FILE
Tabel repositori kasus
Di Repositori Kasus, tindakan Wait For Email Results akan menghasilkan tabel berikut:
Judul tabel: Email yang Cocok
Kolom:
- ID Email
- Tanggal Diterima
- Pengirim
- Penerima
- Subjek
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat Anda menggunakan tindakan Wait For Vote Email Results:
{
"Responses": [
{
"recipient": "user@example.com",
"vote": "Approve"
}
]
}
Pesan output
Tindakan Wait For Vote Email Results memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat Anda menggunakan tindakan Wait For Vote Email Results:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Konektor
Untuk mempelajari lebih lanjut cara mengonfigurasi konektor di Google SecOps, lihat Menyerap data (konektor).
Konektor Email Microsoft Graph
Gunakan Microsoft Graph Mail Connector untuk mengambil email dari layanan email Microsoft Graph.
Gunakan daftar dinamis untuk memfilter nilai yang ditentukan dari bagian isi dan subjek email menggunakan ekspresi reguler. Secara default, konektor menggunakan ekspresi reguler untuk memfilter URL dari email.
Input konektor
Microsoft Graph Mail Delegated Connector memerlukan parameter berikut:| Parameter | Deskripsi |
|---|---|
Product Field Name |
Wajib. Nama kolom tempat nama produk disimpan. Nilai defaultnya adalah Nama produk terutama memengaruhi pemetaan. Untuk menyederhanakan dan meningkatkan
proses pemetaan untuk konektor, nilai default
|
Event Field Name |
Wajib. Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis). Nilai defaultnya adalah |
Environment Field Name |
Opsional Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan akan ditetapkan ke |
Environment Regex Pattern |
Opsional Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom Gunakan nilai default Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah |
Email Exclude Pattern |
Opsional Ekspresi reguler untuk mengecualikan email tertentu dari penyerapan, seperti spam atau berita. Parameter ini berfungsi dengan subjek dan isi email. |
PythonProcessTimeout
|
Wajib. Batas waktu tunggu, dalam detik, untuk proses Python yang menjalankan skrip saat ini. Nilai defaultnya adalah
|
Azure AD Endpoint
|
Wajib. Endpoint Microsoft Entra yang akan digunakan dalam integrasi. Nilai defaultnya adalah |
Microsoft Graph Endpoint |
Wajib. Endpoint Microsoft Graph yang akan digunakan dalam integrasi. Nilai defaultnya adalah |
Mail Address |
Wajib. Alamat email yang akan digunakan konektor. |
Client ID |
Wajib. ID aplikasi (klien) aplikasi Microsoft Entra. |
Secret ID |
Wajib. Nilai rahasia klien aplikasi Microsoft Entra. |
Tenant (Directory) ID
|
Wajib. Nilai Microsoft Entra ID (ID tenant). |
Folder to check for emails |
Wajib. Folder email untuk menelusuri email. Parameter
ini menerima daftar folder yang dipisahkan koma untuk menelusuri respons pengguna
di beberapa folder. Untuk menentukan subfolder, gunakan garis miring Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah |
Offset Time In Hours |
Wajib. Jumlah jam sebelum iterasi konektor pertama untuk mengambil email. Parameter ini berlaku untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya. Konektor dapat menggunakan parameter ini sebagai nilai penggantian saat stempel waktu dari iterasi konektor terbaru berakhir. Nilai defaultnya adalah |
Max Emails Per Cycle |
Wajib. Jumlah email yang akan diambil untuk setiap iterasi konektor. Nilai defaultnya adalah |
Unread Emails Only |
Opsional Jika dipilih, konektor hanya akan membuat kasus dari email yang belum dibaca. Tidak dipilih secara default. |
Mark Emails as Read |
Opsional Jika dipilih, konektor akan menandai email sebagai telah dibaca setelah penyerapan. Tidak dipilih secara default. |
Disable Overflow |
Opsional Jika dipilih, konektor akan mengabaikan mekanisme peluapan Google SecOps. Tidak dipilih secara default. |
Verify SSL |
Wajib. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke Microsoft Graph. Diaktifkan secara default. |
Original Received Mail Prefix |
Opsional Awalan yang akan ditambahkan ke kunci peristiwa yang diekstrak (misalnya, Nilai defaultnya adalah |
Attached Mail File Prefix |
Opsional Awalan yang akan ditambahkan ke kunci peristiwa yang diekstrak (misalnya, Nilai defaultnya adalah |
Create a Separate Google Secops Alert per Attached Mail File
|
Opsional Jika dipilih, konektor akan membuat beberapa pemberitahuan, dengan satu pemberitahuan untuk setiap file email yang dilampirkan. Perilaku ini berguna saat Anda memproses email dengan beberapa file email yang dilampirkan dan menetapkan pemetaan peristiwa Google SecOps untuk membuat entity dari file email yang dilampirkan. Tidak dipilih secara default. |
Attach Original EML |
Opsional Jika dipilih, konektor akan melampirkan email asli ke info kasus sebagai file EML. Tidak dipilih secara default. |
Headers to add to events |
Opsional String header email yang dipisahkan koma untuk ditambahkan ke
peristiwa Google SecOps, seperti Anda dapat mengonfigurasi pencocokan persis untuk header atau menetapkan nilai parameter ini sebagai ekspresi reguler. Konektor memfilter nilai yang dikonfigurasi dari
daftar Agar konektor tidak
menambahkan header ke peristiwa, tetapkan nilai parameter sebagai berikut:
Secara default, konektor menambahkan semua header yang tersedia. |
Case Name Template |
Opsional Nama kasus kustom. Saat Anda mengonfigurasi parameter ini, konektor akan menambahkan kunci baru bernama Anda dapat memberikan placeholder dalam format berikut:
Contoh: Untuk placeholder, konektor menggunakan peristiwa Google SecOps SOAR pertama. Konektor hanya menangani kunci yang berisi nilai string. |
Alert Name Template |
Opsional Nama notifikasi kustom. Anda dapat memberikan placeholder dalam format berikut:
Contoh: Untuk placeholder, konektor menggunakan peristiwa Google SecOps SOAR pertama. Konektor hanya menangani kunci yang berisi nilai string. Jika Anda tidak memberikan nilai atau template yang tidak valid, konektor akan menggunakan nama pemberitahuan default. |
Proxy Server Address |
Opsional Alamat server proxy yang akan digunakan. |
Proxy Username |
Opsional Nama pengguna proxy untuk melakukan autentikasi. |
Proxy Password |
Opsional Sandi proxy untuk mengautentikasi. |
Mail Field Source |
Opsional Jika dipilih, integrasi akan mengambil alamat kotak surat dari atribut detail pengguna Tidak dipilih secara default. |
Extract URLs from HTML Email Part |
Opsional Jika dipilih, konektor akan mengekstrak URL dari isi HTML email. Hal ini memungkinkan konektor mengekstrak URL yang kompleks, tetapi tidak mengekstrak URL dari bagian teks biasa email. URL yang diekstrak tersedia di kolom peristiwa Diaktifkan secara default. |
Event Fields to Exclude |
Opsional Comma separated list berisi kolom peristiwa yang akan dikecualikan dari pembuatan peristiwa
(seperti |
Exclude Attachments |
Opsional Jika dipilih, konektor tidak menyerap lampiran email atau menambahkannya ke kasus. |
Bypass S/MIME Signature Verification |
Opsional Jika dipilih, konektor akan menyerap email bertanda tangan S/MIME tanpa memerlukan sertifikat CA berenkode Base64 untuk verifikasi tanda tangan. Isi, header, dan lampiran pesan diekstrak secara langsung. |
Base64 Encoded Private Key |
Opsional Kunci pribadi berenkode Base64 yang digunakan untuk mendekripsi email terenkripsi S/MIME yang masuk. Jika diberikan, Anda juga harus memberikan
|
Base64 Encoded Certificate |
Opsional Sertifikat berenkode Base64 yang digunakan untuk mendekripsi email terenkripsi S/MIME yang masuk. Jika diberikan, Anda juga harus memberikan
|
Base64 Encoded CA certificate |
Opsional Sertifikat CA tepercaya yang dienkode dengan Base64 untuk memverifikasi tanda tangan digital email S/MIME masuk. Jika tidak ada sertifikat CA yang diberikan, verifikasi tanda tangan untuk email bertanda tangan yang masuk akan gagal, kecuali jika |
Aturan konektor
Konektor mendukung proxy.
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.