Exchange

Versi integrasi: 102.0

Dokumen ini memberikan panduan tentang cara mengintegrasikan Exchange dengan Google Security Operations SOAR.

Peringatan: Mulai Mei 2024, Anda tidak akan dapat menetapkan peran ApplicationImpersonation di Microsoft Exchange Online. Pada Februari 2025, peran ApplicationImpersonation akan dihapus dari Exchange Online. Untuk mengetahui detail perubahan yang dilakukan Microsoft pada peran ApplicationImpersonation, lihat Penghentian Penggunaan Peniruan Identitas Aplikasi RBAC di Exchange Online. Jika dikonfigurasi sebelum Mei 2024, peran ApplicationImperonation akan berfungsi hingga Februari 2025. Perubahan ini tidak memengaruhi versi Exchange Server lokal. Sebaiknya Anda menggunakan Microsoft Graph Mail untuk bekerja dengan Exchange Online.

Integrasi ini menggunakan satu atau beberapa komponen open source. Anda dapat mendownload salinan kode sumber lengkap yang di-zip dari integrasi ini dari bucket Cloud Storage.

Mengonfigurasi Exchange Online

Prasyarat dan langkah-langkah konfigurasi berbeda-beda bergantung pada apakah Anda mengonfigurasi integrasi untuk Exchange Online atau Exchange Server.

• Untuk mengonfigurasi Exchange Online, lanjutkan ke bagian berikut.

• Untuk mengonfigurasi Exchange Server, lihat Mengonfigurasi Exchange Server.

Integrasi untuk Exchange Online hanya mendukung autentikasi yang didelegasikan OAuth dengan token yang didelegasikan yang memerlukan konfigurasi tambahan.

Perubahan yang dilakukan pada izin di lingkungan Azure dapat memerlukan waktu hingga 24 jam untuk diterapkan.

Sebelum memulai

Sebelum mengonfigurasi integrasi Exchange Online, Anda harus memilih metode autentikasi dan menyelesaikan semua langkah konfigurasinya. Pilih salah satu metode berikut:

• Metode 1: Menetapkan izin untuk meniru identitas pengguna: Integrasi bertindak sebagai satu pengguna yang ditetapkan.
• Metode 2: Mendelegasikan akses: Integrasi mengakses beberapa kotak surat secara langsung.

Menetapkan izin untuk meniru identitas pengguna

Metode ini mengharuskan Anda membuat aplikasi di Microsoft Entra ID dan menetapkan izin untuk meniru identitas satu pengguna.

Membuat aplikasi Microsoft Entra

Untuk memulai penyiapan peniruan identitas, Anda harus mendaftarkan aplikasi baru di Microsoft Entra ID.

1. Login ke Microsoft Azure dan buka Microsoft Entra ID > App registrations > New registration.
2. Masukkan nama aplikasi dan pilih Jenis akun yang didukung.
3. Untuk Redirect URI, berikan nilai berikut:
   1. Platform: Web
   2. URL Pengalihan: http://localhost
4. Klik Daftar.
5. Simpan nilai Application (client) ID dan Directory (tenant) ID.

Mengonfigurasi izin API

Anda harus memberikan izin yang diperlukan kepada aplikasi Anda untuk mengakses data pengguna.

1. Buka API permissions > Add a permission.
2. Pilih Microsoft Graph > Delegated permissions.
3. Di bagian Select permissions, pilih EWS, lalu izin Ews.AccessAsUser.All.
4. Klik Add permission > Grant admin consent.

Membuat rahasia klien

Anda harus membuat rahasia klien untuk digunakan sebagai sandi aplikasi Anda.

1. Buka Certificates and secrets > New client secret.
2. Berikan deskripsi, tetapkan waktu habis masa berlaku, lalu klik Tambahkan.
3. Simpan nilai secret.

Menetapkan izin di Exchange Online:

Untuk menyelesaikan penyiapan, Anda harus menetapkan peran ApplicationImpersonation kepada pengguna yang ingin Anda tiru.

1. Di Exchange administrator center, buka Roles > Admin Roles dan temukan grup peran yang berisi peran ApplicationImpersonation (seperti Discovery Management).
2. Tambahkan pengguna yang Anda tiru identitasnya ke grup peran tersebut.

Delegasikan Akses

Metode ini mengharuskan Anda memberikan izin langsung akun layanan ke kotak surat menggunakan Exchange Online PowerShell.

1. Hubungkan ke Exchange Online PowerShell.

2. Gunakan cmdlet Add-MailboxPermission untuk menetapkan izin.

   Misalnya, untuk memberikan akses penuh akun layanan ke kotak surat tertentu:

   Add-MailboxPermission -Identity "[e-mail]" -User "your_service_account" -AccessRights FullAccess
   

   Untuk mengetahui informasi selengkapnya, lihat Kontrol akses berbasis peran untuk aplikasi di Exchange Online untuk mengetahui informasi selengkapnya.

Mengintegrasikan Exchange Online dengan Google SecOps

Untuk mengetahui petunjuk tentang cara menginstal dan mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi Integrasi.

Untuk mengintegrasikan Exchange Online dengan platform Google SecOps, Anda harus menyelesaikan langkah-langkah berikut di Google SecOps:

1. Konfigurasi parameter awal dan simpan.

2. Buat token refresh:

   • Simulasikan kasus di Google SecOps.

   • Jalankan tindakan Get Authorization.

   • Jalankan tindakan Generate Token.

3. Masukkan refresh token yang diperoleh sebagai nilai parameter Refresh Token dan simpan konfigurasi.

Mengonfigurasi parameter awal

Integrasi Exchange Online memerlukan parameter awal berikut:

Parameter	Deskripsi
Mail Server Address	Wajib Alamat server email (nama host atau alamat IP) yang akan dihubungkan.
Mail address	Wajib Alamat email yang akan digunakan dalam integrasi untuk bekerja dengan email yang dikirim dan diterima di kotak surat.
Client ID	Wajib ID aplikasi (klien) Microsoft Entra yang digunakan untuk integrasi. Ini adalah nilai ID (klien) Aplikasi yang Anda simpan saat membuat aplikasi Microsoft Entra.
Client Secret	Wajib Nilai rahasia klien aplikasi Microsoft Entra yang digunakan untuk integrasi. Ini adalah nilai rahasia klien yang Anda simpan saat membuat rahasia klien.
Tenant (Directory) ID	Wajib ID direktori (tenant) aplikasi Microsoft Entra ID yang digunakan untuk integrasi. Ini adalah nilai ID (tenant) direktori yang Anda simpan saat membuat aplikasi Microsoft Entra.
Redirect URL	Wajib URI pengalihan yang dikonfigurasi di aplikasi Microsoft Entra. Biarkan nilai defaultnya http://localhost.

Setelah mengonfigurasi parameter, klik Simpan.

Membuat token refresh

Untuk membuat token refresh, Anda harus menjalankan tindakan manual pada kasus yang ada. Jika instance Google SecOps Anda baru dan tidak memiliki kasus yang ada, simulasikan satu kasus.

Menyimulasikan kasus

Untuk menyimulasikan kasus di Google SecOps, ikuti langkah-langkah berikut:

1. Di navigasi sebelah kiri, pilih Kasus.

2. Di halaman Kasus, klik Tambahkan > Simulasikan Kasus.

3. Pilih salah satu kasus default, lalu klik Buat. Tidak masalah kasus mana yang Anda pilih untuk disimulasikan.

4. Klik Simulasikan.

   Jika Anda memiliki lingkungan selain default dan ingin menggunakannya, pilih lingkungan yang benar, lalu klik Simulasi.

5. Di tab Cases, klik Refresh. Kasus yang telah Anda simulasikan akan muncul dalam daftar kasus.

Jalankan tindakan Mendapatkan Otorisasi

Gunakan kasus Google SecOps yang Anda simulasikan untuk menjalankan tindakan Dapatkan Otorisasi secara manual.

1. Di tab Kasus, pilih kasus simulasi Anda untuk membuka Tampilan Kasus.

2. Klik Tindakan Manual.

3. Di kolom Penelusuran Tindakan Manual, masukkan Exchange.

4. Di hasil di bagian Integrasi Exchange, pilih Dapatkan Otorisasi. Tindakan ini menampilkan link otorisasi yang digunakan untuk login secara interaktif ke aplikasi Microsoft Entra.

5. Klik Jalankan.

6. Setelah tindakan dieksekusi, buka Case Wall kasus simulasi Anda. Di catatan tindakan Exchange_Get Authorization, klik View More. Salin link otorisasi.

7. Buka jendela browser baru dalam mode samaran dan tempelkan URL otorisasi yang dihasilkan. Halaman login Azure akan terbuka.

8. Login dengan kredensial pengguna yang Anda pilih untuk integrasi. Setelah login, browser akan mengalihkan Anda ke alamat dengan kode di kolom URL.

   Browser diperkirakan akan menampilkan error saat aplikasi mengarahkan Anda ke http://localhost.

9. Salin seluruh URL dengan kode akses dari kolom URL.

Jalankan tindakan Buat Token

Gunakan kasus Google SecOps yang telah Anda simulasikan untuk menjalankan tindakan Generate Token secara manual.

1. Di tab Kasus, pilih kasus simulasi Anda untuk membuka Tampilan Kasus.

2. Klik Tindakan Manual.

3. Di kolom Penelusuran Tindakan Manual, masukkan Exchange.

4. Di hasil di bagian Integrasi Exchange, pilih Buat Token.

5. Di kolom Authorization URL, tempelkan seluruh URL dengan kode akses yang disalin setelah menjalankan tindakan Get Authentication.

6. Klik Jalankan.

7. Setelah tindakan dieksekusi, buka Case Wall kasus simulasi Anda. Di catatan tindakan Exchange_Generate Token, klik Lihat Lainnya.

8. Salin seluruh nilai token refresh yang dibuat.

Mengonfigurasi parameter Refresh Token

1. Buka dialog konfigurasi untuk integrasi Exchange.

2. Masukkan nilai token refresh yang Anda peroleh saat menjalankan tindakan Generate Token ke dalam kolom Refresh Token.

3. Klik Simpan.

4. Klik Uji untuk menguji apakah konfigurasi sudah benar dan integrasi berfungsi seperti yang diharapkan.

Anda dapat melakukan perubahan di tahap berikutnya jika diperlukan. Setelah dikonfigurasi, instance dapat digunakan dalam playbook. Untuk mengetahui informasi mendetail tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Mengonfigurasi Exchange Server

Sebelum mengintegrasikan Exchange Server dengan Google SecOps, siapkan autentikasi dasar untuk Exchange Server.

Untuk melakukan autentikasi dengan Exchange Server, gunakan nama pengguna dan sandi.

Menyiapkan autentikasi dasar

Untuk menyiapkan autentikasi dasar, selesaikan langkah-langkah berikut:

1. Verifikasi bahwa Exchange Server (salah satu server dalam cluster) dapat diakses dari server SecOps Google dan memenuhi persyaratan berikut:

   • Nama DNS Exchange Server dapat diselesaikan.

   • Alamat IP Exchange Server dapat diakses.

   • Exchange Web Services (EWS) diaktifkan dan dihosting di port yang dapat diakses oleh server Google SecOps.

   Jika Server Exchange tidak dapat diakses dari server SOAR Google SecOps, pertimbangkan untuk menggunakan agen jarak jauh Google SecOps.

2. Berikan integrasi dengan nama pengguna (akun email pengguna) dan sandi. Pilih pengguna untuk integrasi.

3. Untuk tindakan yang menggunakan izin yang didelegasikan atau di-impersonate, selesaikan langkah-langkah berikut:

   1. Berikan akses yang didelegasikan atau peniruan identitas ke kotak surat yang diperlukan ke akun email yang Anda gunakan dalam integrasi.

      Sebaiknya Anda mengonfigurasi akses dengan izin yang ditiru identitasnya. Untuk mengetahui informasi selengkapnya, lihat Peniruan Identitas dan EWS di Exchange dalam dokumentasi produk Microsoft.

   2. Untuk mengakses kotak surat lain, tetapkan peran Exchange berikut kepada pengguna (kotak surat) yang dikonfigurasi untuk integrasi:

      • Discovery Management grup peran dalam dokumentasi produk Microsoft.

      • Peran ApplicationImpersonation dalam dokumentasi produk Microsoft.

      • Peran Compliance Management dalam dokumentasi produk Microsoft.

      • Peran Organization Management dalam dokumentasi produk Microsoft.

Mengintegrasikan Exchange Server dengan Google SecOps

Untuk mengetahui petunjuk tentang cara menginstal dan mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Input integrasi

Integrasi Exchange Server memerlukan parameter berikut:

Parameter	Deskripsi
Mail Server Address	Wajib Alamat server email (nama host atau alamat IP) yang akan dihubungkan.
Mail address	Wajib Alamat email yang digunakan dalam integrasi untuk bekerja dengan email yang dikirim dan diterima di kotak surat.
Username	Wajib Nama pengguna untuk mengautentikasi di server email, seperti [e-mail].
Password	Wajib Sandi untuk melakukan autentikasi di server email.

Tindakan

Tindakan yang tercantum di bagian ini termasuk dalam dua kategori:

1. Tindakan integrasi Exchange umum.

2. Tindakan yang khusus untuk fungsi Blokir Pengirim dan Domain Exchange.

Izin yang diperlukan

Untuk izin minimal yang diperlukan untuk menjalankan tindakan umum, lihat tabel berikut:

Tindakan	Izin yang diperlukan
Menghapus Email	ApplicationImpersonation Mailbox Search
Download Lampiran	ApplicationImpersonation Mailbox Search
Menelusuri Email	ApplicationImpersonation Mailbox Search MailboxSearchApplication

Untuk mengetahui izin minimum yang diperlukan untuk menjalankan tindakan dari fungsi Blokir Pengirim dan Domain, lihat tabel berikut:

Tindakan	Izin yang diperlukan
Menambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify	EDiscovery Group Author
Menambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify	EDiscovery Group Author
Menghapus Aturan Kotak Masuk Exchange-Siemplify	EDiscovery Group Author
Mencantumkan Aturan Kotak Masuk Exchange-Siemplify	EDiscovery Group Author
Menghapus Domain dari Aturan Kotak Masuk Exchange-Siemplify	EDiscovery Group Author
Menghapus Pengirim dari Aturan Kotak Masuk Exchange-Siemplify	EDiscovery Group Author

Menghapus Email

Gunakan tindakan Hapus Email untuk menghapus satu atau beberapa email yang cocok dengan kriteria penelusuran dari kotak surat.

Menghapus email dapat berlaku untuk email pertama yang cocok dengan kriteria penelusuran atau semua email yang cocok.

Untuk mengetahui izin yang diperlukan untuk menjalankan tindakan ini, lihat bagian izin tindakan dalam dokumen ini.

Jika pengguna sedang offline, tindakan ini mungkin tidak menghapus pesan dari klien Outlook-nya hingga pengguna terhubung kembali dan menyinkronkan kotak suratnya.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Hapus Email memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Opsional Folder kotak surat untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Message IDs	Opsional Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini menerima daftar ID pesan yang dipisahkan koma untuk ditelusuri. Jika Anda memberikan ID pesan, tindakan akan mengabaikan parameter Subject Filter, Sender Filter, dan Recipient Filter.
Subject Filter	Opsional Kondisi filter yang menentukan subjek email yang akan dicari.
Sender Filter	Opsional Kondisi filter yang menentukan pengirim email yang diminta.
Recipient Filter	Opsional Kondisi filter yang menentukan penerima email yang diminta.
Delete All Matching Emails	Opsional Jika dipilih, tindakan ini akan menghapus semua email yang cocok dengan kriteria. Jika tidak dipilih, tindakan hanya akan menghapus email pertama yang cocok. Tidak dipilih secara default.
Delete from all mailboxes	Opsional Jika dipilih, tindakan ini akan menghapus email di semua kotak surat yang dapat diakses menggunakan setelan peniruan identitas saat ini.
How many mailboxes to process in a single batch	Wajib Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Jika Anda memilih parameter Delete from all mailboxes, tindakan akan berfungsi dalam batch. Nilai defaultnya adalah 25.
Time Frame (minutes)	Opsional Periode dalam menit untuk menelusuri email.

Output tindakan

Tindakan Delete Mail 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 Hapus Email dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
NUMBER_OF_EMAILS email(s) were deleted successfully.	Tindakan berhasil.
Error deleting emails.	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

Mendownload Lampiran

Gunakan tindakan Download Lampiran untuk mendownload lampiran email dari email ke jalur tertentu di server Google SecOps. Tindakan ini secara otomatis mengganti karakter garis miring terbalik atau spasi dalam nama lampiran yang didownload dengan karakter garis bawah.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Download Lampiran memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Opsional Folder kotak surat untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Download Path	Wajib Jalur di server Google SecOps untuk mendownload lampiran email.
Message IDs	Opsional Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini menerima daftar ID pesan yang dipisahkan koma untuk ditelusuri. Jika Anda memberikan ID pesan, tindakan akan mengabaikan parameter Subject Filter.
Subject Filter	Opsional Kondisi filter yang menentukan subjek email yang akan dicari.
Sender Filter	Opsional Kondisi filter yang menentukan pengirim email yang akan dicari.
Only Unread	Opsional Jika dipilih, tindakan akan mendownload lampiran hanya dari email yang belum dibaca. Tidak dipilih secara default.
Download Attachments from EML	Opsional Jika dipilih, tindakan ini akan mendownload lampiran dari file EML terlampir. Tidak dipilih secara default.
Download Attachments to unique path?	Opsional Jika dipilih, tindakan akan mendownload lampiran ke jalur unik di bawah nilai yang diberikan dalam parameter Download Path untuk menghindari penimpaan lampiran yang didownload sebelumnya. Tidak dipilih secara default.
Search in all mailboxes	Opsional Jika dipilih, tindakan akan menjalankan penelusuran di semua kotak surat yang dapat diakses menggunakan setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Wajib Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Jika Anda memilih parameter Search in all mailboxes, tindakan akan berfungsi dalam batch. Nilai defaultnya adalah 25.
Mailboxes	Opsional Daftar kotak surat yang dipisahkan koma untuk menjalankan penelusuran. Parameter ini memiliki prioritas lebih tinggi daripada parameter Search in all mailboxes.

Output tindakan

Tindakan Download Lampiran 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 Download Lampiran:

[
   {
       "attachment_name": "ATTACHMENT_NAME",
       "downloaded_path": "readonly" translate="no">FULL_PATH"
   },
   {
       "attachment_name": "ATTACHMENT_NAME",
       "downloaded_path": "readonly" translate="no">FULL_PATH"
   }
]

Pesan output

Tindakan Download Lampiran dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: LIST_OF_LOCAL_PATHS_FOR_ATTACHMENTS	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:

Nama hasil skrip	Nilai
file_paths	String jalur lengkap yang dipisahkan koma ke lampiran tersimpan.

Mengekstrak Data EML

Gunakan tindakan Ekstrak Data EML untuk mengekstrak data dari lampiran EML email.

Tindakan ini berjalan di semua entity Google SecOps.

Input tindakan

Tindakan Ekstrak Data EML memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Opsional Folder tempat email akan diambil. Nilai defaultnya adalah Inbox. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Message ID	Wajib ID pesan, seperti [e-mail].
Regex Map JSON	Opsional Ekspresi reguler untuk memilih email berdasarkan kecocokan bagian isi email, misalnya, {ips: \b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\b}.

Output tindakan

Tindakan Ekstrak Data 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
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Ekstrak Data EML:

[
    {
        "count": 3,
        "files": {
            "mxtoolbox_test_case.case": "090a131a0726dea8f5b0c2205ffc9527"
        },
        "from": "Exam <[e-mail]>",
        "text": "hello eml test", "regex": {

        },
        "to": "Test Test <[e-mail]>",
        "html": "<html><div></div></html>",
        "date": "Wed, 12 Sep 2018 12:36:17 +0300",
        "subject": "eml test"
    }
]

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ekstrak Data EML:

Nama hasil skrip	Nilai
eml_data	EML_DATA

Buat Token

Gunakan tindakan Buat Token untuk mendapatkan token refresh untuk konfigurasi integrasi dengan autentikasi OAuth. Gunakan URL otorisasi yang Anda terima dalam tindakan Dapatkan Otorisasi.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Generate Token memerlukan parameter berikut:

Parameter	Deskripsi
Authorization URL	Wajib URL otorisasi diterima dalam tindakan Dapatkan Otorisasi untuk meminta token refresh.

Output tindakan

Tindakan Generate Token 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 Generate Token dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully fetched the refresh token: REFRESH_TOKEN_VALUE. Copy this refresh token to the Integration Configuration. Note: This Token is valid for 90 days only.	Tindakan berhasil.
Failed to get the refresh token! 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 Buat Token:

Nama hasil skrip	Nilai
is_success	True atau False

Mendapatkan Setelan Keluar dari Fasilitas Akun

Gunakan tindakan Get Account Out Of Facility Settings untuk mendapatkan setelan keluar dari fasilitas (OOF) akun untuk entitas Google SecOps User yang diberikan.

Jika target entitas pengguna adalah nama pengguna, bukan email, jalankan tindakan Active Directory Enrich Entities untuk mengambil informasi tentang email pengguna yang disimpan di Active Directory.

Tindakan ini dijalankan pada entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Get 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	Tersedia
Tabel pengayaan entitas	Tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Tabel repositori kasus

Tindakan Get Account Out Of Facility Settings menampilkan tabel berikut di Dinding Kasus di Google SecOps:

Nama tabel: Out of Facility Settings

Kolom tabel:

• Parameter
• Nilai

Pengayaan entitas

Tindakan Get Account Out Of Facility Settings mendukung pengayaan entitas berikut:

Kolom pengayaan	Sumber (kunci JSON)	Logika
Exchange.oof_settings	OofSettings	Tindakan ini menampilkan status dinonaktifkan atau diaktifkan berdasarkan respons API.

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Get Account Out Of Facility Settings:

OofSettings(state='Disabled', external_audience='All', start=EWSDateTime(2020, 10, 1, 3, 0, tzinfo=<UTC>), end=EWSDateTime(2020, 10, 2, 3, 0, tzinfo=<UTC>))

Pesan output

Tindakan Get Account Out Of Facility Settings dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully returned OOF settings for ENTITY_ID Action wasn't able to find OOF settings for ENTITY_ID	Tindakan berhasil.
Error executing action "Get Account Out Of Facility Settings". Reason: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Mendapatkan Otorisasi

Gunakan tindakan Dapatkan Otorisasi untuk mendapatkan link dengan kode akses untuk konfigurasi integrasi dengan autentikasi OAuth. Salin link dan gunakan di tindakan Generate Token untuk mendapatkan token refresh.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Get Authorization memberikan output berikut:

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

Link repositori kasus

Tindakan Get Authorization ini akan menampilkan link berikut:

Nama: Jelajahi link otorisasi ini

Link: AUTHORIZATION_LINK

Pesan output

Tindakan Dapatkan Otorisasi ini dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Authorization URL generated successfully. Please navigate to the link below as the user that you want to run integration with, to get a URL with access code. The URL with access code should be provided next in the Generate Token action.	Tindakan berhasil.
Failed to generate authorization URL! 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 Dapatkan Otorisasi:

Nama hasil skrip	Nilai
is_success	True atau False

Mendapatkan File EML Email

Gunakan tindakan Get Mail EML File untuk mengambil file EML pesan.

Tindakan ini berjalan di semua entity Google SecOps.

Input tindakan

Tindakan Get Mail EML File memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Opsional Folder untuk mengambil email. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Message ID	Wajib ID pesan, seperti [e-mail].
Base64 Encode	Opsional Jika dipilih, tindakan ini akan mengenkode file email dalam format base64. Tidak dipilih secara default.

Output tindakan

Tindakan Dapatkan File EML 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	Tidak tersedia
Hasil skrip	Tersedia

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Dapatkan File EML Email:

Nama hasil skrip	Nilai
eml_info	EML_INFORMATION

Memindahkan Email ke Folder

Gunakan tindakan Move Mail to Folder untuk memindahkan satu atau beberapa email dari folder email sumber ke folder lain di kotak surat.

Bergantung pada kasus penggunaannya, tindakan ini menampilkan jumlah informasi yang berbeda tentang email yang diproses dalam hasil JSON.

Jika Anda memilih parameter Batasi jumlah informasi dalam hasil JSON, hasil JSON hanya berisi kolom email berikut: datetime_received, message_id, sender, subject, to_recipients. Jika tidak, hasil JSON berisi semua informasi yang tersedia tentang email yang diproses.

Jika Anda memilih parameter Nonaktifkan Hasil JSON Tindakan, tindakan tidak akan menampilkan hasil JSON sama sekali.

Tindakan Move Mail to Folder tidak berjalan di entitas Google SecOps.

Input tindakan

Tindakan Pindahkan Email ke Folder memerlukan parameter berikut:

Parameter	Deskripsi
Source Folder Name	Wajib Folder sumber untuk memindahkan email.
Destination Folder Name	Wajib Folder tujuan tempat email akan dipindahkan.
Subject Filter	Opsional Kondisi filter untuk menelusuri email berdasarkan subjek tertentu.
Message IDs	Opsional Kondisi filter untuk menelusuri email dengan ID email tertentu. Parameter ini juga menerima daftar ID pesan yang dipisahkan koma untuk dicari. Jika Anda memberikan ID pesan, tindakan akan mengabaikan parameter Subject Filter.
Only Unread	Opsional Kondisi filter untuk menelusuri hanya email yang belum dibaca. Tidak dipilih secara default.
Move In All Mailboxes	Opsional Jika dipilih, tindakan ini akan menelusuri dan memindahkan email di semua kotak surat yang dapat diakses melalui setelan penghapusan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Wajib Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Jika Anda memilih parameter Move In All Mailboxes, tindakan akan berfungsi dalam batch. Nilai defaultnya adalah 25.
Time Frame (minutes)	Opsional Periode dalam menit untuk menelusuri email.
Limit the Amount of Information Returned in the JSON Result	Opsional Jika dipilih, tindakan hanya akan menampilkan informasi tentang kolom email utama. Jika tidak dipilih, tindakan ini akan menampilkan informasi tentang semua kolom email. Dipilih secara default.
Disable the Action JSON Result	Opsional Jika dipilih, tindakan tidak akan menampilkan hasil JSON. Tidak dipilih secara default.

Output tindakan

Tindakan Pindahkan Email ke 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	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Pesan output

Tindakan Pindahkan Email ke Folder dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
NUMBER_OF_EMAILS mails were successfully moved from SOURCE_FOLDER to 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 Pindahkan Email ke Folder:

Nama hasil skrip	Nilai
is_success	True atau False

Ping

Gunakan tindakan Ping untuk menguji koneksi ke instance Microsoft Exchange.

Anda dapat menjalankan tindakan ini secara manual dan bukan sebagai bagian dari alur playbook.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

T/A

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:

Pesan output	Deskripsi pesan
Successfully connected to the Microsoft Exchange server with the provided connection parameters!	Tindakan berhasil.
Failed to connect to the Microsoft Exchange server! 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 Ping:

Nama hasil skrip	Nilai
is_success	True atau False

Menyimpan Lampiran Email ke Kasus

Gunakan tindakan Simpan Lampiran Email Ke Kasus untuk menyimpan lampiran email dari email yang disimpan di kotak surat yang dipantau ke Dinding Kasus di Google SecOps.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Save Mail Attachments To The Case memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Wajib Folder kotak surat untuk menelusuri email. Parameter ini juga menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Message IDs	Wajib ID pesan untuk menemukan email tertentu dan mendownload lampiran dari email tersebut.
Attachment To Save	Opsional Jika Anda tidak mengonfigurasi parameter ini, tindakan akan menyimpan semua lampiran email ke Dinding Kasus secara default. Jika tidak, tindakan hanya menyimpan lampiran yang Anda tentukan ke Dinding Kasus.

Output tindakan

Tindakan Save Mail Attachments To The 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	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Pesan output

Tindakan Save Mail Attachments To The Case dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully saved the following attachments from the email MESSAGE_ID: ATTACHMENT_LIST No attachments found in email MESSAGE_ID	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 Simpan Lampiran Email ke Kasus:

Nama hasil skrip	Nilai
is_success	True atau False

Menelusuri Email

Gunakan tindakan Telusuri Email untuk menelusuri email tertentu di kotak surat yang dikonfigurasi menggunakan beberapa kriteria penelusuran. Tindakan ini menampilkan informasi tentang email yang ditemukan di kotak surat dalam format JSON.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Search Mails memerlukan parameter berikut:

Parameter	Deskripsi
Folder Name	Opsional Folder kotak surat untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Subject Filter	Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri.
Sender Filter	Opsional Kondisi filter untuk menentukan pengirim email yang diminta.
Recipient Filter	Opsional Kondisi filter untuk menentukan penerima email yang diminta.
Time Frame (minutes)	Opsional Periode dalam menit untuk menelusuri email.
Only Unread	Opsional Jika dipilih, tindakan ini hanya menelusuri email yang belum dibaca. Tidak dipilih secara default.
Max Emails To Return	Opsional Jumlah maksimum email yang akan ditampilkan dalam hasil tindakan.
Search in all mailboxes	Opsional Jika dipilih, tindakan akan menjalankan penelusuran di semua kotak surat yang dapat diakses menggunakan setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Wajib Jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Jika Anda memilih parameter Search in all mailboxes, tindakan akan berfungsi dalam batch. Nilai defaultnya adalah 25.
Start Time	Opsional Waktu mulai untuk menjalankan penelusuran email. Format yang akan digunakan adalah ISO 8601. Parameter ini memiliki prioritas lebih tinggi daripada parameter Time Frame (minutes).
End Time	Opsional Waktu berakhir untuk menjalankan penelusuran email. Format yang akan digunakan adalah ISO 8601. Jika Anda tidak menetapkan nilai dan parameter Start Time valid, tindakan akan menetapkan nilai End Time ke waktu saat ini.
Mailboxes	Opsional Daftar kotak surat yang dipisahkan koma untuk menjalankan penelusuran. Parameter ini memiliki prioritas lebih tinggi daripada parameter Search in all mailboxes.
Message IDs	Opsional Daftar ID pesan yang dipisahkan koma untuk ditelusuri. Filter ini memiliki prioritas lebih tinggi daripada kondisi filter lainnya.
Body Regex Filter	Opsional Pola ekspresi reguler yang akan ditelusuri di isi email.

Output tindakan

Tindakan Search Mails 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 Search Mails menampilkan tabel berikut di Dinding Kasus di Google SecOps:

Judul tabel: Email yang Cocok

Kolom tabel:

• Message_id
• Tanggal Diterima
• Pengirim
• Penerima
• Subjek
• Isi email
• Nama lampiran (sebagai daftar nama lampiran yang dipisahkan koma)

Jika Anda memilih parameter Search in all mailboxes, tindakan akan menambahkan kolom Ditemukan di kotak surat ke tabel untuk menunjukkan kotak surat tempat email ditemukan.

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Search Mails:

[
    {
        "body": "Mail Body",
        "subject": "Mail Subject",
        "author": "[e-mail]"
    }, {
        "body": " ",
        "subject": "Mail Subject",
        "author": "[e-mail]"
    }
]

Pesan output

Tindakan Search Mails dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Search found NUMBER_OF EMAILS emails based on the provided search criteria. Search didn't find any matching emails. The following mailboxes were not found in the Mail Server: MAILBOX_LIST	Tindakan berhasil.
Search didn't completed successfully due to error: ERROR_REASON Error executing action "Exchange - Search Mails". Reason: the following mailboxes were not found: MAILBOX_LIST. Please check the spelling.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
mails_json	Tidak tersedia

Kirim Email dan Tunggu - Tidak digunakan lagi

Tidak digunakan lagi: Tindakan ini tidak digunakan lagi. Sebaiknya gunakan kombinasi Send Mail dan Wait For Mail From.

Mengirim email dan menunggu tindakan. Kolom Kirim ke dipisahkan dengan koma. Nama tampilan pengirim dapat dikonfigurasi di klien pada setelan akun.

Input tindakan

Nama Tampilan Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Subjek	String	T/A	Ya	Subjek email.
Kirim ke	String	[e-mail]	Ya	Alamat email penerima. Beberapa alamat dapat dipisahkan dengan koma.
CC	String	[e-mail]	Tidak	Alamat email CC. Beberapa alamat dapat dipisahkan dengan koma.
BCC	String	T/A	Tidak	Alamat email BCC. Beberapa alamat dapat dipisahkan dengan koma.
Isi email	String	T/A	Ya	Isi email.
Mengambil Lampiran Respons	Kotak centang	Tidak dicentang	Tidak	Mengizinkan lampiran file dari email respons.
Folder untuk Memeriksa Balasan	String	Kotak Masuk	Tidak	Parameter dapat digunakan untuk menentukan folder email kotak pesan (kotak pesan yang digunakan untuk mengirim email dengan pertanyaan) untuk menelusuri balasan pengguna di folder ini. Parameter ini juga menerima daftar folder yang dipisahkan koma untuk memeriksa respons pengguna di beberapa folder. Parameter peka huruf besar/kecil.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
Mail_body	T/A	T/A

Hasil JSON

  [
      {
          "EntityResult": {
              "attachments": [],
              "sensitivity": "Normal",
              "effective_rights": " test",
              "has_attachments": "false",
              "last_modified_name": "mail",
              "is_submitted": "false"
          },
          "Entity": "[e-mail]"
      }
  ]
  

Kirim Email

Gunakan tindakan Kirim Email untuk mengirim email dari kotak surat tertentu ke daftar penerima. Anda dapat menggunakan tindakan ini untuk memberi tahu pengguna tentang hal berikut:

• Pemberitahuan spesifik yang dibuat di Google SecOps.
• Hasil pemrosesan pemberitahuan tertentu.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Send Mail memerlukan parameter berikut:

Parameter	Deskripsi
Subject	Wajib Subjek email.
Send to	Wajib Daftar alamat email yang dipisahkan koma untuk penerima email, seperti [e-mail], [e-mail].
CC	Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email, seperti [e-mail], [e-mail].
BCC	Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email, seperti [e-mail], [e-mail].
Attachments Paths	Opsional Daftar jalur yang dipisahkan koma untuk lampiran file yang disimpan di server, seperti C:\FILE_DIRECTORY\file.pdf, C:\FILE_DIRECTORY\image.jpg.
Mail content	Wajib Isi email.
Reply-To Recipients	Opsional Daftar penerima yang dipisahkan koma yang digunakan di header Reply-To. Tindakan ini menambahkan header Reply-To untuk mengirim balasan email ke alamat email tertentu, bukan alamat email pengirim yang tercantum di kolom From.
Base64 Encoded Certificate	Opsional Sertifikat berenkode base64 yang digunakan untuk mengenkripsi email. Untuk mengenkripsi email, parameter ini sudah cukup. Untuk menandatangani email, berikan juga parameter Base64 Encoded Signature.
Base64 Encoded Signature	Opsional Sertifikat berenkode base64 yang digunakan untuk menandatangani email. Agar tanda tangan berfungsi dan berisi sertifikat penandatanganan, berikan parameter Base64 Encoded Signature dan Base64 Encoded Certificate.

Output tindakan

Tindakan Send Mail 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

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Send Mail:

{
    "mime_content": "b'From: exchange_online_test\\r\\n\\t<[e-mail]>\\r\\nTo: =?iso-8859-8-i?B?4ifp6e7xIOHl8OM=?=\\r\\n\\t<[e-mail]>\\r\\nSubject: test email\\r\\nThread-Topic: test email\\r\\nThread-Index: AQHZI2sS6qOMRJL5hkWATMpRN9fv4Q==\\r\\nDate: Sun, 8 Jan 2023 14:11:15 +0000\\r\\nMessage-ID: <message_id@example>\\r\\nAccept-Language: en-US\\r\\nContent-Language: en-US\\r\\nX-MS-Has-Attach:\\r\\nContent-Type: multipart/alternative;\\r\\n\\tboundary=\"_000_1673187082551404817642532883270906446a69558cb5108_\"\\r\\nMIME-Version: 1.0\\r\\n\\r\\n--_000_1673187082551404817642532883270906446a69558cb5108_\\r\\nContent-Type: text/plain; charset=\"iso-8859-8-i\"\\r\\nContent-Transfer-Encoding: quoted-printable\\r\\n\\r\\ntest content\\r\\n\\r\\n--_000_1673187082551404817642532883270906446a69558cb5108_\\r\\nContent-Type: text/html; charset=\"iso-8859-8-i\"\\r\\nContent-Transfer-Encoding: quoted-printable\\r\\n\\r\\n<html>\\r\\n<head>\\r\\n<meta http-equiv=3D\"Content-Type\" content=3D\"text/html; charset=3Diso-8859-=\\r\\n8-i\">\\r\\n</head>\\r\\n<body>\\r\\n<p>test content </p>\\r\\n</body>\\r\\n</html>\\r\\n\\r\\n--_000_1673187082551404817642532883270906446a69558cb5108_--\\r\\n'",
    "_id": "ItemId(id='AAMkAGMwYTc3NmZmLTM4YjYtNGJmMC1hNTllLWJmNDdlZTE0YTg4ZQBGAAAAAABZKh7ro7RoSpjbI663J/SqBwDjM1k0xgBMR6sDaC+Azo7rAAAAAAEJAADjM1k0xgBMR6sDaC+Azo7rAAAAEth6AAA=', changekey='CQAAABYAAADjM1k0xgBMR6sDaC+Azo7rAAAAEm3h')",
    "parent_folder_id": "ParentFolderId(id='AAMkAGMwYTc3NmZmLTM4YjYtNGJmMC1hNTllLWJmNDdlZTE0YTg4ZQAuAAAAAABZKh7ro7RoSpjbI663J/SqAQDjM1k0xgBMR6sDaC+Azo7rAAAAAAEJAAA=', changekey='AQAAAA==')",
    "item_class": "IPM.Note",
    "subject": "test email",
    "sensitivity": "Normal",
    "text_body": "test content\r\n",
    "body": "<html><head>\r\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body><p>test content </p></body></html>",
    "attachments": [],
    "datetime_received": "2023-01-08 14:11:15+00:00",
    "size": 2928,
    "categories": null,
    "importance": "Normal",
    "in_reply_to": null,
    "is_submitted": true,
    "is_draft": true,
    "is_from_me": false,
    "is_resend": false,
    "is_unmodified": false,
    "headers": null,
    "datetime_sent": "2023-01-08 14:11:15+00:00",
    "datetime_created": "2023-01-08 14:11:15+00:00",
    "reminder_due_by": null,
    "reminder_is_set": false,
    "reminder_minutes_before_start": 0,
    "display_cc": null,
    "display_to": "\u05d2'\u05d9\u05d9\u05de\u05e1 \u05d1\u05d5\u05e0\u05d3",
    "has_attachments": false,
    "vote_request": null,
    "culture": "en-US",
    "effective_rights": "EffectiveRights(create_associated=False, create_contents=False, create_hierarchy=False, delete=True, modify=True, read=True, view_private_items=True)",
    "last_modified_name": "exchange_online_test",
    "last_modified_time": "2023-01-08 14:11:15+00:00",
    "is_associated": false,
    "web_client_read_form_query_string": "https://example.com/&exvsurl=1&viewmodel=ReadMessageItem",
    "web_client_edit_form_query_string": null,
    "conversation_id": "ConversationId(id='AAQkAGMwYTc3NmZmLTM4YjYtNGJmMC1hNTllLWJmNDdlZTE0YTg4ZQAQAOqjjESS+YZFgEzKUTfX7+E=')",
    "unique_body": "<html><body><div>\r\n<div>\r\n<p>test content </p></div></div>\r\n</body></html>",
    "sender": "Mailbox(name='exchange_online_test', email_address='[e-mail]', routing_type='SMTP', mailbox_type='Mailbox')",
    "to_recipients": [
        "Mailbox(name=\"\u05d2'\u05d9\u05d9\u05de\u05e1 \u05d1\u05d5\u05e0\u05d3\", email_address='[e-mail]', routing_type='SMTP', mailbox_type='Mailbox')"
    ],
    "cc_recipients": null,
    "bcc_recipients": null,
    "is_read_receipt_requested": false,
    "is_delivery_receipt_requested": false,
    "conversation_index": "b'\\x01\\x01\\xd9#k\\x12\\xea\\xa3\\x8cD\\x92\\xf9\\x86E\\x80L\\xcaQ7\\xd7\\xef\\xe1'",
    "conversation_topic": "test email",
    "author": "Mailbox(name='exchange_online_test', email_address='[e-mail]', routing_type='SMTP', mailbox_type='Mailbox')",
    "message_id": "<167318708255.14048.17642532883270906446@a69558cb5108>",
    "is_read": true,
    "is_response_requested": false,
    "references": null,
    "reply_to": null,
    "received_by": null,
    "received_representing": null,
    "vote_response": null,
    "email_date": 1673187075
}

Selain hasil teknis JSON objek email, tindakan ini juga menampilkan ID pesan dan tanggal saat email dikirim. Data tambahan digunakan dalam tindakan Tunggu Surat, jika diperlukan:

{
…
"message_id": "<[e-mail]>",
"email_date": "1583916838"
...
}

Pesan output

Tindakan Send Mail dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Mail sent successfully.	Tindakan berhasil.
Failed to send 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 Send Mail:

Nama hasil skrip	Nilai
Success_Inidicator	Tidak tersedia

HTML Kirim Email

Gunakan tindakan Send Mail HTML untuk mengirim email dengan konten template HTML. Kolom Send to dipisahkan dengan koma.

Anda dapat mengonfigurasi nama pengirim di klien email pada setelan akun.

Tindakan ini berjalan di semua entity Google SecOps.

Input tindakan

Tindakan Send Mail HTML memerlukan parameter berikut:

Parameter	Deskripsi
Subject	Wajib Subjek email.
Send to	Wajib Daftar alamat email yang dipisahkan koma untuk penerima email.
CC	Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email.
BCC	Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email.
Attachments Paths	Opsional Daftar jalur yang dipisahkan koma untuk lampiran file yang disimpan di server, misalnya, C:\FILE_DIRECTORY\file.pdf, C:\FILE_DIRECTORY\image.jpg.
Mail content	Wajib Isi email.

Output tindakan

Tindakan Send Mail 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	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil skrip

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

Nama hasil skrip	Nilai
is_success	True atau False

Mengirim Balasan Rangkaian Pesan

Gunakan tindakan Send Thread Reply untuk mengirim pesan sebagai balasan ke rangkaian pesan email.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Send Thread Reply memerlukan parameter berikut:

Parameter	Deskripsi
Message ID	Wajib ID pesan yang akan dibalas.
Folder Name	Wajib Daftar folder kotak surat yang dipisahkan koma tempat menjalankan penelusuran email. Anda dapat menetapkan folder khusus email, misalnya, Gmail/Semua Email untuk menjalankan penelusuran di semua folder kotak surat Gmail. Selain itu, nama folder harus cocok dengan folder IMAP. Jika nama folder berisi spasi, sertakan spasi dalam tanda kutip ganda. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah.
Content	Wajib Konten balasan.
Attachment Paths	Opsional Daftar jalur yang dipisahkan koma ke lampiran file yang disimpan di server.
Reply All	Opsional Jika dipilih, tindakan akan mengirimkan balasan ke semua penerima yang terkait dengan email asli dan mengabaikan parameter Reply To. Dipilih secara default.
Reply To	Wajib Daftar email yang dipisahkan koma untuk mengirim balasan. Jika Anda tidak menetapkan nilai dan tidak memilih parameter Reply All, tindakan hanya akan mengirimkan balasan kepada pengirim email. Jika Anda memilih parameter Reply All, tindakan akan mengabaikan parameter ini.

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	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

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: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.	Tindakan gagal. Periksa parameter Reply To untuk mengirim balasan hanya ke alamat Anda.
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

Mengirim Surat Suara Pemilu

Gunakan tindakan Send Vote Mail untuk mengirim email dengan opsi jawaban yang telah dikonfigurasi sebelumnya untuk menyertakan pengguna yang tidak memiliki akses ke UI Google SecOps dalam proses otomatis.

Tindakan ini mendukung fitur pemungutan suara hanya jika penerima menggunakan Exchange untuk melihat dan memilih opsi pemungutan suara dengan benar.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Send Vote Mail memerlukan parameter berikut:

Parameter	Deskripsi
Subject	Wajib Subjek email.
Send to	Wajib Daftar alamat email yang dipisahkan koma untuk penerima email, seperti [e-mail], [e-mail].
CC	Opsional Daftar alamat email yang dipisahkan koma untuk kolom CC email, seperti [e-mail], [e-mail].
BCC	Opsional Daftar alamat email yang dipisahkan koma untuk kolom BCC email, seperti [e-mail], [e-mail].
Attachments Paths	Opsional Daftar jalur yang dipisahkan koma untuk lampiran file yang disimpan di server, misalnya, C:\FILE_DIRECTORY\file.pdf, C:\FILE_DIRECTORY\image.jpg.
Question or Decision Description	Wajib Pertanyaan yang akan diajukan kepada penerima atau keputusan yang harus ditanggapi oleh penerima.
Structure of voting options	Wajib Struktur suara yang dikirim ke penerima. Kemungkinan nilainya adalah sebagai berikut: Yes/No Approve/Reject Nilai defaultnya adalah Yes/No.

Output tindakan

Tindakan Send Vote Mail 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 Send Vote Mail:

{

…

"message_id": "[e-mail]>",

"email_date": "1583916838"

...

}

Pesan output

Tindakan Send Vote Mail dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Vote Mail was sent successfully Could not send vote mail for the following mailboxes: MAILBOX_LIST	Tindakan berhasil.
Could not send vote mail to any of the provided mailboxes. Please check the action parameters and try again.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Send Vote Mail:

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 dengan tindakan Kirim Email.

Tindakan ini berfungsi secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Wait for Mail From User memerlukan parameter berikut:

Parameter	Deskripsi
Mail message_id	Wajib ID pesan email. Jika pesan dikirim menggunakan tindakan Send Mail, pilih kolom SendEmail.JSONResult|message_id sebagai placeholder.
Mail Date	Wajib Stempel waktu email yang dikirim dan sedang menunggu tindakan saat ini. Jika pesan dikirim menggunakan tindakan Kirim Email, pilih kolom SendEmail.JSONResult|email_date sebagai placeholder.
Mail Recipients	Wajib Daftar penerima email yang dipisahkan koma yang menunggu respons dari tindakan saat ini. Jika pesan dikirim menggunakan tindakan Kirim Email, pilih kolom SendEmail.JSONResult|to_recipients sebagai tempat penampung.
How long to wait for recipient reply (minutes)	Wajib Periode tindakan untuk menunggu balasan pengguna sebelum menandainya waktunya habis. Nilai defaultnya adalah 1.440 menit.
Wait for All Recipients to Reply?	Opsional Jika dipilih, tindakan akan menunggu respons dari semua penerima hingga mencapai waktu tunggu habis atau melanjutkan dengan balasan pertama. Dipilih secara default.
Wait Stage Exclude pattern	Opsional Ekspresi reguler untuk mengecualikan balasan tertentu dari tahap tunggu. Parameter ini berfungsi dengan isi email. Misalnya, Anda dapat mengonfigurasi tindakan agar tidak menganggap pesan otomatis di luar kantor sebagai balasan penerima dan menunggu balasan pengguna yang sebenarnya.
Folder to Check for Reply	Opsional Folder email kotak surat untuk menelusuri balasan pengguna. Tindakan ini menjalankan penelusuran di kotak surat tempat email yang berisi pertanyaan dikirim dari. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Inbox.
Fetch Response Attachments	Opsional Jika dipilih dan balasan penerima berisi lampiran, tindakan akan mengambil balasan dan menambahkannya sebagai lampiran untuk hasil tindakan. Tidak dipilih secara default.

Output tindakan

Tindakan Wait for Mail From User memberikan output berikut:

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
Hasil skrip	Tersedia

Lampiran repositori kasus

Tindakan Wait for Mail From User menampilkan lampiran berikut di dinding Kasus di Google SecOps:

Kolom lampiran	Deskripsi
title	Lampiran dari penerima Balasan RECIPIENT_EMAIL
filename	ATTACHMENT_NAME. EXTENSION
fileContent	ATTACHED_FILE_CONTENT

Jenis lampiran Entity dipetakan ke penerima yang membalas message_id yang dilacak responsnya oleh server Google SecOps.

Hasil JSON

Sebagai hasil JSON, tindakan ini menampilkan kombinasi dari dua output berikut:

1. Output JSON objek email untuk email dengan respons yang dilacak.

   Tindakan ini melacak respons email menggunakan message_id.

2. Output JSON untuk proses pelacakan respons dari pengguna.

Metode untuk menggabungkan data output ditentukan pada tahap penerapan.

Alur untuk output JSON objek email adalah sebagai berikut:

1. tindakan menunggu setidaknya satu respons pengguna untuk melanjutkan.

2. Setelah menerima respons dari pengguna pertama, tindakan akan memperbarui hasil JSON dan melanjutkan dengan hasil tindakan.

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

Alur untuk output proses respons pelacakan adalah sebagai berikut:

1. Tindakan menunggu semua respons pengguna untuk melanjutkan.

2. Setelah menerima balasan dari pengguna atau mencapai waktu tunggu, tindakan akan memperbarui hasil JSON.

   Dalam hal ini, jika tindakan menunggu respons dari semua penerima dan waktu tunggu habis saat menunggu respons pengguna, tindakan akan menampilkan error handled_timeout.

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

Pesan output

Tindakan Wait for Mail From User dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Found the user EMAIL_RECIPIENT reply: USER_REPLY Timeout getting reply from user: EMAIL_RECIPIENT	Tindakan berhasil.
Failed to execute action, the error is: ERROR_REASON Failed to get user EMAIL_RECIPIENT reply, the error is: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Menunggu Hasil Pemungutan Suara melalui Surat

Gunakan tindakan Tunggu Hasil Pemilu melalui Surat untuk menunggu dan mengambil respons pemilu melalui surat yang dikirim menggunakan tindakan Kirim Pemilu melalui Surat. Tindakan Wait for Vote Mail Results meneruskan respons yang diambil ke Google SecOps.

Untuk melacak dan mengambil hasil voting dengan benar, lacak email voting. Untuk mengetahui informasi selengkapnya, lihat tindakan Send Vote Mail.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Tunggu Hasil Pemungutan Suara melalui Surat memerlukan parameter berikut:

Parameter	Deskripsi
Vote Mail message_id	Wajib ID pesan email pemungutan suara. Jika pesan dikirim menggunakan tindakan Send Vote Mail, pilih kolom SendVoteMail.JSONResult|message_id sebagai placeholder.
Mail Recipients	Wajib Daftar email penerima yang dipisahkan koma yang menunggu respons dari tindakan saat ini. Pilih kolom SendVoteMail.JSONResult|to_recipients sebagai placeholder.
Folder to Check for Reply	Wajib Folder kotak surat untuk menelusuri balasan pengguna. Tindakan ini menjalankan penelusuran di kotak surat tempat email yang berisi pertanyaan dikirim dari. Parameter ini juga menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Inbox.
Folder to Check for Sent Mail	Wajib Folder kotak surat untuk menelusuri email terkirim. Tindakan ini menjalankan penelusuran di kotak surat tempat email yang berisi pertanyaan dikirim dari. Parameter ini juga menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Sent Items.
How long to wait for recipient reply (minutes)	Wajib Periode agar tindakan menunggu balasan pengguna sebelum menandainya sebagai waktu habis. Nilai defaultnya adalah 1.440 menit.
Wait for All Recipients to Reply?	Opsional Jika dipilih, tindakan akan menunggu respons dari semua penerima hingga mencapai waktu tunggu habis atau melanjutkan dengan balasan pertama. Dipilih secara default.

Output tindakan

Tindakan Wait for Vote Mail Results 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 Vote Mail Results:

{
    "Responses": [{
        "recipient": "[e-mail]",
        "content": "Approve"
    }]
}

Pesan output

Tindakan Wait for Vote Mail Results dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Found the user EMAIL_RECIPIENT reply: USER_REPLY Timeout getting reply from user: EMAIL_RECIPIENT	Tindakan berhasil.
Could not perform action on the following mailboxes: MAILBOX_LIST Could not perform action on any of the provided mailboxes. Please check the action parameters and try again.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Tunggu Hasil Pemilu yang Dikirim melalui Pos:

Nama hasil skrip	Nilai
is_success	True atau False

Fungsi Blokir Pengirim dan Domain

Salah satu kasus penggunaan paling umum untuk pengelolaan dan keamanan email adalah untuk mengatasi ancaman yang ada, seperti email phishing, yang sudah ada di kotak masuk organisasi, lalu memblokir pengirim atau domain yang mencurigakan untuk melindungi organisasi Anda dari serangan pada masa mendatang dan mencegah kemungkinan pelanggaran keamanan.

Di Google SecOps, integrasi Exchange memberi Anda fungsi Blokir Pengirim dan Domain yang terdiri dari tahap berurutan berikut:

1. Perlindungan dalam organisasi.

   Gunakan tindakan Blokir Pengirim menurut ID Pesan untuk menambahkan pengirim ke daftar blokir menggunakan layanan EWS Tandai sebagai Sampah.

2. Perlindungan di luar organisasi dengan aturan kotak masuk.

   Buat aturan kotak masuk untuk menambahkannya di tingkat klien dan secara otomatis mencegah email berbahaya mencapai kotak surat organisasi Anda.

3. Perlindungan di luar organisasi dengan aturan kotak masuk server.

   Buat aturan kotak masuk server untuk mencegah email mencurigakan mencapai organisasi.

Anda dapat mempelajari lebih lanjut tahap-tahap ini di bagian berikut.

Kasus penggunaan

Kasus penggunaan berikut menunjukkan contoh pelanggaran keamanan yang merupakan email mencurigakan dan berpotensi berbahaya.

Setelah mengetahui bahwa email mencurigakan dan berbahaya telah membahayakan beberapa kotak surat organisasi Anda, rutininitas untuk menangani jenis ancaman ini adalah sebagai berikut:

1. Atasi ancaman dengan tindakan Blokir Pengirim menurut ID Pesan.
2. Menangani kotak surat yang disusupi.
3. Tambahkan perlindungan terhadap email mencurigakan yang diterima di kotak surat lain juga.

Memperbaiki ancaman

Untuk mengatasi ancaman, jalankan tindakan Blokir Pengirim menurut ID Pesan untuk mendapatkan parameter untuk penyelidikan dan informasi selengkapnya tentang email mencurigakan. Tindakan ini juga memungkinkan Anda memeriksa hanya kotak surat yang disusupi dan menangani ancaman yang ada di dalamnya.

Tindakan Blokir Pengirim menurut ID Pesan memicu layanan Tandai sebagai Sampah Exchange EWS untuk melakukan hal berikut:

1. Pindahkan email yang mencurigakan ke folder Sampah.
2. Tambahkan pengirim email ke Daftar Pengirim yang Diblokir dari kotak surat yang diselidiki.

Untuk mengetahui informasi selengkapnya tentang penggunaan layanan Tandai sebagai Sampah, lihat Menambahkan dan menghapus alamat email dari Daftar Pengirim yang Diblokir menggunakan EWS di Exchange dalam dokumentasi produk Microsoft.

Di satu sisi, memulihkan ancaman dengan tindakan Blokir Pengirim menurut ID Pesan hanya menargetkan kotak surat yang disusupi dan dapat dilakukan secara otomatis. Di sisi lain, tindakan tersebut tidak dapat memblokir pengirim di kotak surat yang tidak terkompromi atau menambahkan domain menggunakan API ke Daftar Pengirim yang Diblokir.

Menangani kotak surat yang disusupi

Setelah mengatasi ancaman, langkah berikutnya adalah menangani kotak surat yang disusupi dan melindungi setiap kotak surat di organisasi dari pengirim berbahaya, bahkan yang berpotensi berbahaya.

Untuk menangani kotak surat yang disusupi, jalankan kumpulan tindakan aturan kotak masuk yang terdiri dari tindakan berikut:

1. Menambahkan Domain ke Aturan Kotak Masuk Exchange-Siemplify
2. Menambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify
3. Menghapus Aturan Kotak Masuk Exchange-Siemplify
4. Mencantumkan Aturan Kotak Masuk Exchange-Siemplify
5. Menghapus Domain dari Aturan Kotak Masuk Exchange-Siemplify
6. Menghapus Pengirim dari Aturan Kotak Masuk Exchange-Siemplify

Untuk mempelajari lebih lanjut layanan yang digunakan dalam tindakan, lihat bagian Mengelola aturan kotak masuk di Exchange dalam dokumentasi produk Microsoft.

Integrasi Exchange memungkinkan Anda menggunakan serangkaian aturan bawaan berikut untuk operasi yang paling umum:

• Siemplify – Senders List – Move To Junk
• Siemplify – Senders List – Delete
• Siemplify – Senders List – Permanently Delete
• Siemplify – Domains List – Move To Junk
• Siemplify – Domains List – Delete
• Siemplify – Domains List – Permanently Delete

Menghapus email pengirim berbahaya secara permanen

Untuk mempertahankan daftar aturan yang sama di semua kotak surat, tambahkan aturan untuk pengguna administrator. Untuk menerapkan aturan administrator kepada pengguna lain, jalankan operasi di semua kotak surat.

Untuk menghapus email dari pengirim berbahaya secara permanen, selesaikan langkah-langkah berikut:

1. Di Google SecOps, dari akun administrator, jalankan tindakan Add Senders to Exchange-Siemplify Inbox Rule. Masukkan email pengirim berbahaya.

2. Pilih aturan yang sesuai dari daftar untuk menentukan cara mengelola email yang mencurigakan. Untuk menghapus email berbahaya secara permanen, pilih aturan Siemplify – Senders List – Permanently Delete.

   Tindakan ini akan memperbarui aturan kotak masuk dengan pengirim berbahaya baru.

3. Pilih parameter Perform action in all mailboxes untuk menerapkan aturan ke semua kotak surat.

   Jika aturan tidak ada di kotak surat, tindakan akan membuatnya. Jika aturan sudah ada di kotak surat, tindakan akan memperbaruinya dengan nilai parameter baru.

4. Untuk menambahkan perlindungan terhadap email mencurigakan yang diterima di kotak surat lain dan memblokir domain pengirim berbahaya, pilih parameter Should add senders' domain to the corresponding Domains List rule as well?.

5. Tinjau parameter lain dalam tindakan dan sesuaikan jika diperlukan.

Tindakan Tambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify memperbarui beberapa aturan sekaligus sesuai dengan parameter Mailboxes to process in one batch. Tindakan Add Senders to Exchange-Siemplify Inbox Rule berfungsi pada pengirim dan domain, berlaku untuk semua kotak surat terlepas dari apakah ada email mencurigakan yang diterima, dan dapat bersifat otomatis.

Pengguna akhir dapat menghapus aturan yang diterapkan untuk kotak suratnya. Menerapkan aturan administrator ke kotak surat lain akan otomatis menghapus aturan kotak masuk pribadi yang dinonaktifkan.

Tindakan Blokir Pengirim dan Domain

Sebelum menjalankan tindakan untuk fungsi Blokir Pengirim dan Domain, konfigurasi izin minimum yang diperlukan.

Menambahkan Domain ke Aturan Kotak Masuk Exchange-Siemplify

Gunakan tindakan Add Domains to Exchange-Siemplify Inbox Rules untuk mendapatkan daftar domain sebagai parameter atau gunakan entitas Domain Google SecOps jika parameternya kosong. Tindakan ini hanya tersedia untuk Google SecOps versi 5.6 dan yang lebih baru.

Sebelum menjalankan tindakan ini, konfigurasi izin tindakan yang diperlukan.

Anda dapat membuat atau memperbarui aturan dengan memfilter domain dari kotak surat Anda. Anda dapat mengubah tindakan ini menggunakan parameter Rule to add Domains to.

Tindakan Tambahkan Domain ke Aturan Kotak Masuk Exchange-Siemplify mengubah aturan kotak masuk pengguna saat ini dengan EWS.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Jika Anda tidak menetapkan parameter apa pun dan versi Google SecOps Anda adalah 5.6 dan yang lebih baru, tindakan ini akan berjalan di entitas Domain.

Input tindakan

Tindakan Tambahkan Domain ke Aturan Kotak Masuk Exchange-Siemplify memerlukan parameter berikut:

Parameter	Deskripsi
Domains	Opsional Daftar domain yang dipisahkan koma untuk ditambahkan ke aturan.
Rule to add Domains to	Wajib Aturan untuk menambahkan domain. Jika tidak ada aturan, tindakan akan membuatnya. Kemungkinan nilainya adalah sebagai berikut: Siemplify - Domains List - Move To Junk Siemplify - Domains List - Delete Siemplify - Domains List - Permanently Delete Nilai defaultnya adalah Siemplify - Domains List - Move To Junk.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 50.

Output tindakan

Tindakan Add Domains to Exchange-Siemplify Inbox Rules 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 Add Domains to Exchange-Siemplify Inbox Rules dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Added the following Domains to the corresponding rules: Domains: DOMAIN_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	Tindakan berhasil.
Error performing "Add Domains to Exchange-Siemplify Inbox Rules" action: ERROR_REASON No domains provided in "Domains" parameter, please check action parameters and try again.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Add Domains to Exchange-Siemplify Inbox Rules:

Nama hasil skrip	Nilai
is_success	True atau False

Menambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify

Gunakan tindakan Tambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify untuk mendapatkan daftar alamat email sebagai atau bekerja dengan entitas Pengguna Google SecOps jika parameternya kosong. Anda dapat menggunakan ekspresi reguler untuk tindakan ini.

Anda dapat membuat aturan baru dengan memfilter pengirim dari kotak surat Anda. Anda dapat mengubah tindakan ini menggunakan parameter Rule to add senders to.

Sebelum menjalankan tindakan ini, pastikan untuk mengonfigurasi izin tindakan yang diperlukan.

Tindakan Add Senders to Exchange-Siemplify Inbox Rule mengubah aturan kotak masuk pengguna Anda saat ini menggunakan EWS.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Jika ekspresi reguler email valid dan Anda tidak mengonfigurasi parameter apa pun, tindakan ini akan berjalan di entitas Pengguna.

Input tindakan

Tindakan Add Senders to Exchange-Siemplify Inbox Rule memerlukan parameter berikut:

Parameter	Deskripsi
Senders	Opsional Daftar alamat email yang dipisahkan koma untuk ditambahkan ke aturan. Jika Anda tidak menetapkan nilai, tindakan akan berfungsi dengan entity User.
Rule to add senders to	Wajib Aturan untuk menambahkan pengirim. Jika tidak ada aturan, tindakan akan membuatnya. Kemungkinan nilainya adalah sebagai berikut: Siemplify - Senders List - Move To Junk Siemplify - Senders List - Delete Siemplify - Senders List - Permanently Delete Nilai defaultnya adalah Siemplify - Senders List - Move To Junk.
Should add senders' domain to the corresponding Domains List rule as well?	Opsional Jika dipilih, tindakan ini akan otomatis menambahkan domain alamat email yang diberikan ke aturan domain yang sesuai. Tidak dipilih secara default.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan pelepasan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 50.

Output tindakan

Tindakan Add Senders to Exchange-Siemplify Inbox Rule 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 Tambahkan Pengirim ke Aturan Kotak Masuk Exchange-Siemplify dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Added the following inputs to the corresponding rules: Email Addresses: EMAIL_ADDRESS_LIST Domains: DOMAIN_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	Tindakan berhasil.
Error performing "Add Senders to Siemplify Inbox Rule" action: ERROR_REASON No email addresses provided in "Senders" parameter and there are no email addresses in user entities, Please check action inputs and try again.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Add Senders to Exchange-Siemplify Inbox Rule:

Nama hasil skrip	Nilai
is_success	True atau False

Memblokir Pengirim berdasarkan ID Pesan

Gunakan tindakan Blokir Pengirim menurut ID Pesan untuk mendapatkan daftar ID pesan sebagai parameter dan menandai daftar tersebut sebagai spam.

Dalam tindakan ini, menandai item sebagai sampah akan menambahkan alamat email pengirim ke Daftar Pengirim yang Diblokir dan memindahkan item ke folder Sampah.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Tindakan Blokir Pengirim menurut ID Pesan hanya mendukung Exchange Server versi 2013 dan yang lebih baru. Jika Anda menggunakan versi sebelumnya, tindakan akan gagal dengan pesan yang sesuai.

Pesan dari alamat email yang mencurigakan harus ada di kotak surat pengguna sebelum Anda menambahkan atau menghapus alamat email tersebut dari Daftar Pengirim yang Diblokir.

Tindakan Blokir Pengirim menurut ID Pesan tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Blokir Pengirim menurut ID Pesan memerlukan parameter berikut:

Parameter	Deskripsi
Move item to Junk folder?	Wajib Jika dipilih, tindakan ini akan memindahkan pesan yang ditentukan ke folder sampah. Dipilih secara default.
Message IDs	Opsional Kondisi filter untuk menemukan email dengan ID email tertentu. Parameter ini menerima daftar ID pesan yang dipisahkan koma untuk ditandai sebagai sampah. Jika Anda memberikan ID pesan, tindakan akan mengabaikan parameter Subject Filter, Sender Filter, dan Recipient Filter.
Mailboxes list to perform on	Opsional Kondisi filter untuk menjalankan operasi pada daftar kotak surat tertentu agar waktunya lebih tepat. Untuk menandai pesan dari beberapa alamat email sebagai sampah, berikan daftar alamat email yang dipisahkan koma. Jika Anda memberikan daftar kotak surat, tindakan akan mengabaikan parameter Perform Action in all Mailboxes.
Folder Name	Opsional Folder kotak surat untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Nilai defaultnya adalah Inbox.
Subject Filter	Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri.
Sender Filter	Opsional Kondisi filter yang menentukan pengirim email yang diminta.
Recipient Filter	Opsional Kondisi filter yang menentukan penerima email yang diminta.
Mark All Matching Emails	Opsional Jika dipilih, tindakan ini akan menandai semua email dari kotak surat yang cocok dengan kriteria. Jika tidak dipilih, tindakan hanya menandai email pertama yang cocok. Tidak dipilih secara default.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan akan dipindahkan ke sampah dan memblokir email pengirim di semua kotak surat yang dapat diakses melalui setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 25.
Time Frame (minutes)	Opsional Periode dalam menit untuk menelusuri email.

Output tindakan

Tindakan Blokir Pengirim menurut ID Pesan 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 Blokir Pengirim menurut ID Pesan dapat menampilkan output berikut pesan:

Pesan output	Deskripsi pesan
NUMBER_OF_EMAILS mails were successfully marked as junk. No mails were found matching the search criteria! NUMBER_OF_EMAILS email(s) were marked as junk from PROCESSED_MAILBOXES mailboxes (out of ALL_MAILBOXES). Continuing.	Tindakan berhasil.
Failed to execute action - Action is fully supported only from Exchange Server version 2013 and above, Please make sure you have the appropriate version configured in Chronicle SOAR.	Tindakan gagal. Versi Exchange Server yang Anda gunakan tidak didukung.
Error performing "Mark as junk and Block Sender" action: 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 Blokir Pengirim menurut ID Pesan:

Nama hasil skrip	Nilai
is_success	True atau False

Menghapus Aturan Kotak Masuk Exchange-Siemplify

Gunakan tindakan Delete Exchange-Siemplify Inbox Rules untuk mendapatkan nama aturan sebagai parameter dan menghapusnya dari semua kotak surat yang ditentukan.

Sebelum menjalankan tindakan ini, konfigurasi izin tindakan yang diperlukan.

Tindakan Delete Exchange-Siemplify Inbox Rules mengubah aturan kotak masuk saat ini dari pengguna Anda dengan EWS.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Delete Exchange-Siemplify Inbox Rules memerlukan parameter berikut:

Parameter	Deskripsi
Rule Name To Delete	Wajib Nama aturan yang akan dihapus sepenuhnya dari kotak surat yang relevan. Kemungkinan nilainya adalah sebagai berikut: Siemplify – Senders List – Move To Junk Siemplify – Senders List – Delete Siemplify – Senders List – Permanently Delete Siemplify – Domains List – Move To Junk Siemplify – Domains List – Delete Siemplify – Domains List – Permanently Delete All available Exchange-Siemplify Senders Rules All available Exchange-Siemplify Domains Rules All available Exchange-Siemplify Rules
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 50.

Output tindakan

Tindakan Hapus Aturan Kotak Masuk Exchange-Siemplify 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 Delete Exchange-Siemplify Inbox Rules dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Deleted the following rules from the specified mailboxes: MAILBOX_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	Tindakan berhasil.
Error performing "Delete Siemplify Inbox Rules" action: 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 Aturan Kotak Masuk Exchange-Siemplify:

Nama hasil skrip	Nilai
is_success	True atau False

Mencantumkan Aturan Kotak Masuk Exchange-Siemplify

Gunakan tindakan List Exchange-Siemplify Inbox Rules untuk mendapatkan nama aturan dari aturan Kotak Masuk Exchange-Siemplify sebagai parameter dan mencantumkannya. Jika tidak ada kotak surat yang akan dicantumkan, tindakan akan mencantumkan aturan untuk pengguna yang login.

Sebelum menjalankan tindakan ini, konfigurasi izin tindakan yang diperlukan.

Tindakan List Exchange-Siemplify Inbox Rules mengubah aturan kotak masuk saat ini dari pengguna Anda dengan EWS.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Exchange-Siemplify Inbox Rules memerlukan parameter berikut:

Parameter	Deskripsi
Rule Name To List	Wajib Nama aturan yang akan dicantumkan dari kotak surat yang relevan. Kemungkinan nilainya adalah sebagai berikut: Siemplify – Senders List – Move To Junk Siemplify – Senders List – Delete Siemplify – Senders List – Permanently Delete Siemplify – Domains List – Move To Junk Siemplify – Domains List – Delete Siemplify – Domains List – Permanently Delete All available Exchange-Siemplify Senders Rules All available Exchange-Siemplify Domains Rules All available Exchange-Siemplify Rules
Mailboxes list to perform on	Opsional Kondisi filter yang menentukan daftar kotak surat untuk menjalankan operasi, agar waktunya lebih tepat. Parameter ini menerima daftar alamat email yang dipisahkan koma untuk membatalkan tanda pesan sebagai sampah. Jika daftar kotak surat diberikan, tindakan akan mengabaikan parameter Perform action in all mailboxes.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 50.

Output tindakan

Tindakan List Exchange-Siemplify Inbox Rules 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 List Exchange-Siemplify Inbox Rules:

{
  {
    "id": "example_id",
    "name": "Siemplify - Domains List - Delete",
    "priority": 1,
    "is_enabled": True,
    "conditions": {
        "domains": ["EXAMPLE.COM", "EXAMPLE.CO"],
        "addresses": []
    },
    "actions": "move_to_folder"
  }
}

Pesan output

Tindakan List Exchange-Siemplify Inbox Rules dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Listed the following rules: LISTED_RULES for the specified mailboxes. Successfully listed NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST.	Tindakan berhasil.
Error performing "List Exchange-Siemplify Inbox Rules" action: 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 List Exchange-Siemplify Inbox Rules:

Nama hasil skrip	Nilai
is_success	True atau False

Menghapus Domain dari Aturan Kotak Masuk Exchange-Siemplify

Gunakan Remove Domains from Exchange-Siemplify Inbox Rules untuk mendapatkan daftar domain sebagai parameter atau kerjakan entitas Domain jika parameter tidak diberikan. Tindakan ini hanya tersedia untuk Google SecOps versi 5.6 dan yang lebih baru. Anda dapat menghapus domain yang diberikan dari aturan yang ada.

Sebelum menjalankan tindakan ini, konfigurasi izin tindakan yang diperlukan.

Tindakan Remove Domains from Exchange-Siemplify Inbox Rules mengubah aturan kotak masuk saat ini pengguna Anda dengan EWS.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Jika Anda tidak mengonfigurasi parameter apa pun, tindakan ini akan berjalan di entitas Domain Google SecOps.

Input tindakan

Tindakan Hapus Domain dari Aturan Kotak Masuk Exchange-Siemplify memerlukan parameter berikut:

Parameter	Deskripsi
Domains	Opsional Daftar domain yang dipisahkan koma yang akan dihapus dari aturan. Jika Anda tidak menetapkan nilai, tindakan akan berfungsi dengan entity.
Rule to remove Domains from	Wajib Aturan untuk menghapus domain. Jika Anda tidak menetapkan aturan, tindakan akan gagal. Kemungkinan nilainya adalah sebagai berikut: Siemplify – Domains List – Move To Junk Siemplify – Domains List – Delete Siemplify – Domains List – Permanently Delete Nilai defaultnya adalah Siemplify – Domains List – Move To Junk.
Remove Domains from all available Rules	Opsional Jika dipilih, tindakan ini akan menelusuri domain yang diberikan di semua aturan kotak masuk Google SecOps. Tidak dipilih secara default.
Mailboxes list to perform on	Opsional Kondisi filter yang menentukan daftar kotak surat untuk menjalankan operasi, agar waktunya lebih tepat. Parameter ini menerima daftar alamat email yang dipisahkan koma untuk membatalkan tanda pesan sebagai sampah. Jika Anda memberikan daftar kotak surat, tindakan akan mengabaikan parameter Perform action in all mailboxes.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 50.

Output tindakan

Tindakan Remove Domains from Exchange-Siemplify Inbox Rules 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 Remove Domains from Exchange-Siemplify Inbox Rules dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Removed the following inputs from the corresponding rules: Domains: DOMAIN_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	Tindakan berhasil.
Error performing "Remove Domains from Siemplify Inbox Rule" action: ERROR_REASON No domains provided in "Domains" parameter, please check action parameters and try again.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Remove Domains from Exchange-Siemplify Inbox Rules:

Nama hasil skrip	Nilai
is_success	True atau False

Menghapus Pengirim dari Aturan Kotak Masuk Exchange-Siemplify

Gunakan Remove Senders from Exchange-Siemplify Inbox Rules untuk mendapatkan daftar pengirim email sebagai parameter atau bekerja dengan entitas User jika parameter tidak diberikan.

Anda dapat menghapus pengirim yang diberikan dari aturan yang ada.

Sebelum menjalankan tindakan ini, konfigurasi izin tindakan yang diperlukan.

Tindakan Remove Senders from Exchange-Siemplify Inbox Rules mengubah aturan kotak masuk saat ini pengguna Anda dengan EWS.

Tindakan ini berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Jika tidak ada parameter yang diberikan, tindakan ini akan berjalan di entitas Pengguna Google SecOps.

Input tindakan

Tindakan Hapus Pengirim dari Aturan Kotak Masuk Exchange-Siemplify memerlukan parameter berikut:

Parameter	Deskripsi
Senders	Opsional Daftar alamat email yang dipisahkan koma untuk dihapus dari aturan. Jika Anda tidak menetapkan nilai, tindakan akan berfungsi dengan entity User.
Rule to remove senders from	Wajib Aturan untuk menghapus pengirim. Jika Anda tidak menetapkan aturan, tindakan akan gagal. Kemungkinan nilainya adalah sebagai berikut: Siemplify – Senders List – Move To Junk Siemplify – Senders List – Delete Siemplify – Senders List – Permanently Delete Nilai defaultnya adalah Siemplify – Senders List – Move To Junk.
Remove senders from all available rules	Opsional Jika dipilih, tindakan ini akan menelusuri pengirim yang diberikan di semua aturan kotak masuk Google SecOps. Tidak dipilih secara default.
Should remove senders' domain from the corresponding Domains List rule as well?	Opsional Jika dipilih, tindakan ini akan otomatis menghapus domain alamat email yang diberikan dari aturan domain yang sesuai. Tidak dipilih secara default.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan pelepasan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 50.

Output tindakan

Tindakan Remove Senders from Exchange-Siemplify Inbox Rules 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 Remove Senders from Exchange-Siemplify Inbox Rules dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Removed the following inputs from the corresponding rules: Senders: SENDERS_LIST Rules updated: RULE_LIST Successfully updated NUMBER_OF_UPDATED_MAILBOXES out of ALL_MAILBOXES. Failed to perform operation on the following mailboxes: MAILBOX_LIST. NUMBER_OF_UPDATED_MAILBOXES mailboxes were updated out of ALL_MAILBOXES mailboxes. Continuing.	Tindakan berhasil.
Error performing "Remove Senders from Siemplify Inbox Rule" action: ERROR_REASON No email addresses provided in "Senders" parameter and there are no email addresses in user entities, Please check action inputs and try again.	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Remove Senders from Exchange-Siemplify Inbox Rules:

Nama hasil skrip	Nilai
is_success	True atau False

Berhenti Memblokir Pengirim berdasarkan ID Pesan

Gunakan tindakan Buka Blokir Pengirim menurut ID Pesan untuk mendapatkan daftar ID pesan sebagai parameter dan membatalkan penandaannya sebagai sampah.

Dalam tindakan ini, membatalkan tanda item sebagai sampah akan menghapus alamat email pengirim dari Daftar Pengirim yang Diblokir. Untuk memindahkan item kembali ke folder kotak masuk, pilih parameter Move items back to Inbox? di parameter tindakan.

Unblock Sender by Message ID berjalan secara asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE untuk tindakan sesuai kebutuhan.

Tindakan ini hanya mendukung Exchange Server versi 2013 dan yang lebih baru. Jika Anda menggunakan versi sebelumnya, tindakan akan gagal dengan pesan yang sesuai.

Pesan dari alamat email yang mencurigakan harus ada di kotak surat pengguna sebelum Anda menambahkan atau menghapus alamat email dari Daftar Pengirim yang Diblokir.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Unblock Sender by Message ID memerlukan parameter berikut:

Parameter	Deskripsi
Move items back to Inbox?	Wajib Jika dipilih, tindakan ini akan memindahkan pesan yang ditentukan kembali ke folder kotak masuk. Dipilih secara default.
Message IDs	Opsional Kondisi filter untuk membatalkan tanda email dengan ID email tertentu. Parameter ini juga menerima daftar ID pesan yang dipisahkan koma untuk membatalkan tanda email sebagai sampah. Jika Anda memberikan ID pesan, tindakan akan mengabaikan parameter Subject Filter, Sender Filter, dan Recipient Filter
Mailboxes list to perform on	Opsional Kondisi filter untuk menjalankan operasi pada daftar kotak surat tertentu agar waktunya lebih tepat. Untuk menandai pesan dari beberapa alamat email sebagai sampah, berikan daftar alamat email yang dipisahkan koma. Jika Anda memberikan daftar kotak surat, tindakan akan mengabaikan parameter Perform action in all mailboxes.
Folder Name	Opsional Folder kotak surat untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma untuk memindahkan item. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Nilai defaultnya adalah Junk Email.
Subject Filter	Opsional Kondisi filter yang menentukan subjek email yang akan ditelusuri.
Sender Filter	Opsional Kondisi filter yang menentukan pengirim email yang diminta.
Recipient Filter	Opsional Kondisi filter yang menentukan penerima email yang diminta.
Unmark All Matching Emails	Opsional Jika dipilih, tindakan ini akan membatalkan tanda semua email dari kotak surat yang cocok dengan kriteria. Jika tidak dipilih, tindakan ini hanya membatalkan tanda email pertama yang cocok. Tidak dipilih secara default.
Perform action in all mailboxes	Opsional Jika dipilih, tindakan ini berlaku untuk semua kotak surat yang dapat diakses melalui setelan peniruan identitas saat ini. Tidak dipilih secara default.
How many mailboxes to process in a single batch	Opsional Jika Anda memilih parameter Perform action in all mailboxes, tindakan akan berfungsi dalam batch. Parameter ini menentukan jumlah kotak surat yang akan diproses dalam satu batch (satu koneksi ke server email). Nilai defaultnya adalah 25.
Time Frame (minutes)	Opsional Periode dalam menit untuk menelusuri email.

Output tindakan

Tindakan Unblock Sender by Message ID 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 Unblock Sender by Message ID dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
NUMBER_OF_EMAILS mails were successfully unmarked as junk. No mails were found matching the search criteria! NUMBER_OF_EMAILS email(s) were unmarked as junk from PROCESSED_MAILBOXES mailboxes (out of ALL_MAILBOXES). Continuing.	Tindakan berhasil.
Failed to execute action - Action is fully supported only from Exchange Server version 2013 and above, Please make sure you have the appropriate version configured in Chronicle SOAR.	Tindakan gagal. Versi Exchange Server yang Anda gunakan tidak didukung.
Error performing action: 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 Buka Blokir Pengirim menurut ID Pesan:

Nama hasil skrip	Nilai
is_success	True atau False

Konektor

Untuk mengetahui petunjuk mendetail tentang cara mengonfigurasi konektor di Google SecOps, lihat Menyerap data Anda (konektor).

Saat mengonfigurasi konektor dan tindakan, perhatikan spasi dan simbol khusus dalam kredensial Anda. Jika integrasi menolak kredensial Anda, periksa ejaannya.

Untuk mengonfigurasi konektor yang dipilih, gunakan parameter khusus konektor yang tercantum dalam tabel berikut:

• Parameter konfigurasi Exchange EML Connector
• Parameter konfigurasi Exchange Mail Connector
• Parameter konfigurasi Exchange Mail Connector V2
• Parameter konfigurasi Autentikasi OAuth Exchange Mail Connector v2

Konektor EML Exchange

Peringatan: Konektor ini sudah tidak berlaku. Sebaiknya gunakan konektor Exchange Mail Connector v2 dan Exchange Mail Connector v2 dengan OAuth.

Exchange EML Connector mengambil email dari server Exchange dan menguraikannya. Jika ada file EML terlampir, konektor akan melampirkannya ke kasus sebagai peristiwa. Jika ada beberapa lampiran EML dalam email, konektor akan membuat beberapa kasus dan menyerap setiap lampiran sebagai satu peristiwa untuk setiap kasus.

Batasan umum

1. Microsoft 365 dan autentikasi dasar.

   • Exchange EML Connector tidak lagi mendukung autentikasi dasar dan tidak dapat digunakan dengan Microsoft 365. Untuk Microsoft 365, gunakan Exchange Mail Connector v2 dengan OAuth.

2. Berikut spesifikasi Exchange EML Connector:

   • Konektor membuat pemberitahuan Google SecOps hanya dari email yang berisi lampiran file EML atau MSG.

   • Konektor mengabaikan email yang tidak berisi lampiran email.

Input konektor

Exchange EML Connector memerlukan parameter berikut:

Parameter	Deskripsi
Product Field Name	Wajib Nama kolom tempat nama produk disimpan. Nilai defaultnya adalah device_product.
EventClassId	Wajib Nama kolom yang digunakan untuk menentukan nama peristiwa (subtipe). Nilai defaultnya adalah event_name.
Server IP	Wajib Alamat IP server yang akan dihubungkan.
Domain	Wajib Nilai domain yang akan digunakan untuk autentikasi.
Username	Wajib Nama pengguna untuk kotak surat yang akan digunakan untuk mengambil email, seperti [e-mail].
Password	Wajib Sandi untuk kotak surat email yang digunakan untuk mengambil email.
Mail Address	Wajib Alamat email untuk kotak surat yang akan dipantau. Nilai defaultnya adalah Inbox.
Verify SSL	Opsional Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL untuk menghubungkan ke server Exchange valid. Tidak dipilih secara default.
Use Domain for Authentication	Opsional Jika dipilih, integrasi akan menggunakan domain sebagai bagian dari kredensial autentikasi, seperti user@domain. Dipilih secara default.
Unread Emails Only	Opsional Jika dipilih, kasus hanya dibuat dari email yang belum dibaca. Tidak dipilih secara default.
Mark Emails as Read	Opsional Jika dipilih, email akan ditandai sebagai telah dibaca setelah diproses. Tidak dipilih secara default.
Max Days Backwards	Opsional Jumlah hari sebelum iterasi konektor pertama untuk mengambil email. Parameter ini hanya berlaku satu kali untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya.
PythonProcessTimeout	Wajib Batas waktu dalam detik untuk proses Python yang menjalankan skrip saat ini. Nilai default-nya adalah 30 detik.
Folder Name	Opsional Nama folder untuk menjalankan penelusuran. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Nilai defaultnya adalah Inbox.
Environment Field Name	Opsional Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan akan disetel ke "".
Environment Regex Pattern	Opsional Pola ekspresi reguler untuk dijalankan pada nilai yang ditemukan di kolom Environment Field Name. Dengan parameter ini, Anda dapat memanipulasi kolom lingkungan menggunakan logika ekspresi reguler. Gunakan nilai default .* untuk mengambil nilai Environment Field Name mentah yang diperlukan. Jika pola ekspresi reguler adalah null atau kosong, atau nilai lingkungan adalah null, hasil lingkungan akhir adalah lingkungan default.
Encode Data as UTF-8	Opsional Jika dipilih, integrasi akan mengenkode data email dengan UTF-8. Sebaiknya pilih parameter ini. Dipilih secara default.
Attach EML or MSG File to the Case Wall	Opsional Jika dipilih, integrasi akan melampirkan file EML atau MSG yang diteruskan ke dinding Kasus di Google SecOps. Tidak dipilih secara default.
Exclusion Body Regex	Opsional Ekspresi reguler untuk mengecualikan email yang isi pesannya cocok dengan nilai yang diberikan. Misalnya, ekspresi reguler '([N|n]ewsletter)|([O|o]ut of office)' mengecualikan semua email yang berisi kata kunci Newsletter atau Out of office.
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.
Extract urls from HTML email part?	Opsional Jika dipilih, konektor akan mencoba mengekstrak URL dari bagian HTML email. Parameter ini juga memungkinkan konektor mengekstrak URL yang kompleks, tetapi bukan URL dari bagian teks biasa dalam email. URL yang diekstrak tersedia di kolom peristiwa urls_from_html_part. Tidak dipilih secara default.

Aturan konektor

• Exchange EML Connector tidak mendukung aturan daftar blokir dan daftar dinamis.

• Exchange EML Connector mendukung proxy.

Exchange Mail Connector

Peringatan: Konektor ini sudah tidak berlaku. Sebaiknya gunakan Exchange Mail Connector v2 dan Exchange Mail Connector v2 dengan OAuth.

Gunakan Exchange Mail Connector untuk berkomunikasi dengan server Exchange dan menelusuri email hampir secara real time serta meneruskannya untuk diterjemahkan dan diberi konteks sebagai pemberitahuan dalam kasus Google SecOps.

Bagian ini mengacu pada komunikasi dengan Server Microsoft Exchange 2007-2019 atau Microsoft 365 menggunakan Exchange Web Services (EWS) dan menjelaskan cara Google SecOps berinteraksi dengan antarmuka Exchange Mail serta alur kerja dan aktivitas yang dibantu dalam aplikasi.

Exchange Mail Connector memungkinkan pengambilan email dari server Exchange yang dikonfigurasi yang memindai setiap server dan kemudian membuat kasus baru. Setidaknya satu kemunculan email awal disertakan dalam setiap skenario. Perbedaan utamanya adalah konektor Email Exchange menghapus email dan membuat peristiwa yang mengurai data EML atau MSG dalam email asli server Exchange.

Batasan umum

1. Microsoft 365 dan autentikasi dasar.

   • Exchange Mail Connector tidak lagi mendukung autentikasi dasar dan tidak dapat digunakan dengan Microsoft 365. Untuk Microsoft 365, gunakan Exchange Mail Connector v2 dengan OAuth.

2. Berikut spesifikasi Exchange Mail Connector:

   • Konektor membuat pemberitahuan Google SecOps hanya dari email asli yang diterima dan ada di kotak surat.

   • Konektor mengabaikan file EML dan MSG terlampir.

Input konektor

Exchange Mail Connector memerlukan parameter berikut:

Parameter	Deskripsi
Product Field Name	Wajib Nama kolom tempat nama produk disimpan. Nilai defaultnya adalah device_product.
Event Field Name	Wajib Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis). Nilai defaultnya adalah event_name.
Server IP	Wajib Alamat IP server yang akan dihubungkan.
Domain	Wajib Nilai domain yang akan digunakan untuk autentikasi.
Username	Wajib Nama pengguna untuk kotak surat yang akan digunakan untuk mengambil email, seperti [e-mail].
Password	Wajib Sandi untuk kotak surat email yang digunakan untuk mengambil email.
Mail Address	Wajib Alamat email untuk kotak surat yang akan dipantau. Nilai defaultnya adalah Inbox.
Verify SSL	Opsional Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL untuk menghubungkan ke server Exchange valid. Tidak dipilih secara default.
Use Domain for Authentication	Opsional Jika dipilih, domain akan digunakan sebagai bagian dari kredensial autentikasi, seperti user@domain. Dipilih secara default.
Unread Emails Only	Opsional Jika dipilih, integrasi hanya membuat kasus dari email yang belum dibaca. Dipilih secara default.
Mark Emails as Read	Opsional Jika dipilih, integrasi akan menandai semua email yang diproses sebagai telah dibaca. Tidak dipilih secara default.
Max Days Backwards	Opsional Jumlah hari sebelum iterasi konektor pertama untuk mengambil email. Parameter ini hanya berlaku satu kali untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya.
PythonProcessTimeout	Wajib Batas waktu dalam detik untuk proses Python yang menjalankan skrip saat ini. Nilai defaultnya adalah 30 detik.
Attach Original EML	Opsional Jika dipilih, email asli akan dilampirkan ke kasus sebagai file EML. Tidak dipilih secara default.
Folder Name	Opsional Nama folder untuk menjalankan penelusuran. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Nilai defaultnya adalah Inbox.
Environment Field Name	Opsional Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan akan disetel ke "".
Environment Regex Pattern	Opsional Pola ekspresi reguler untuk dijalankan pada nilai yang ditemukan di kolom Environment Field Name. Dengan parameter ini, Anda dapat memanipulasi kolom lingkungan menggunakan logika ekspresi reguler. Gunakan nilai default .* untuk mengambil nilai Environment Field Name mentah yang diperlukan. Jika pola ekspresi reguler adalah null atau kosong, atau nilai lingkungan adalah null, hasil lingkungan akhir adalah lingkungan default.
Exclusion Subject Regex	Opsional Ekspresi reguler untuk mengecualikan email dengan subjek yang cocok dengan nilai yang diberikan. Misalnya, ekspresi reguler ([N|n]ewsletter)|([O|o]ut of office) mengecualikan semua email yang berisi kata kunci Newsletter atau Out of office di subjek emailnya.
Exclusion Body Regex	Opsional Ekspresi reguler untuk mengecualikan email dengan isi yang cocok dengan nilai yang diberikan. Misalnya, ekspresi reguler ([N|n]ewsletter)|([O|o]ut of office) mengecualikan semua email yang berisi kata kunci Newsletter atau Out of office dalam isi emailnya.
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 melakukan autentikasi.
Extract urls from HTML email part?	Opsional Jika dipilih, konektor akan mencoba mengekstrak URL dari bagian HTML email. Parameter ini memungkinkan konektor mengekstrak URL yang kompleks, tetapi bukan URL dari bagian teks biasa dalam email. URL yang diekstrak tersedia di kolom peristiwa urls_from_html_part. Tidak dipilih secara default.

Mengonfigurasi aturan daftar dinamis

Di bagian daftar dinamis, untuk mengekstrak nilai tertentu dari email menggunakan ekspresi reguler, tambahkan aturan dalam format berikut:

'<var>FIELD_NAME</var>': '<var>REGULAR_EXPRESSION</var>'

Misalnya, untuk mengekstrak ID pesan dari email, masukkan aturan berikut:

message-id: (?<=Message-ID: ).*

Aturan konektor

• Exchange Mail Connector mendukung proxy.

• Exchange Mail Connector tidak mendukung aturan daftar blokir.

• Integrasi Exchange menggunakan bagian daftar dinamis untuk menentukan ekspresi reguler dan mengaktifkan hal berikut:

  • Mengurai konten email.
  • Tambahkan kolom tertentu berdasarkan regular expression yang cocok dengan peristiwa email.

Exchange Mail Connector v2

Gunakan Exchange Mail Connector v2 untuk terhubung ke server email dan memeriksa email baru di kotak surat tertentu.

Jika email baru muncul, konektor akan membuat dan menyerap di Google SecOps pemberitahuan baru yang berisi informasi dari email baru tersebut.

Jika tidak ada email baru, Exchange Mail Connector v2 akan menyelesaikan iterasi saat ini dan menunggu selama jangka waktu tertentu sebelum iterasi berikutnya dijalankan.

Alur iterasi konektor

Setelah setiap proses, Exchange Mail Connector v2 memperbarui file stempel waktu dengan tanggal dan waktu proses terakhir. Exchange Mail Connector v2 mengekstrak informasi yang dapat ditindaklanjuti untuk kasus dari email sebagai hasil teknis objek email, seperti, tetapi tidak terbatas pada:

• Pengirim dan penerima email.
• Subjek email.
• Isi email.
• URL dalam email.
• Lampiran, jika ada.

Setelah Exchange Mail Connector v2 membuat pemberitahuan (kasus) untuk diproses ke Google SecOps, iterasi konektor selesai.

Berdasarkan data kasus yang disediakan oleh Exchange Mail Connector v2, server Google SecOps menjalankan prosedur ETL untuk menyerap pemberitahuan baru dan membuat atau memperbarui kasus. Jika ada playbook terkait yang ditentukan, Google SecOps akan menjalankan playbook untuk memperkaya kasus, membuat insight, dan melakukan tindakan otomatis.

Menggunakan Template Nama Pemberitahuan dan Template Nama Kasus

Parameter Alert Name Template dan Case Name Template memungkinkan Anda mengganti cara pembuatan nama kasus dan notifikasi. Hanya pemberitahuan pertama yang menetapkan nama kasus atau pemberitahuan, semua pemberitahuan berikutnya tidak memengaruhi nama.

Contoh peristiwa Google SecOps adalah sebagai berikut:

{
    "event": {
        "type": "Phishing"
        "name": "Example Event",
        "id": "1"
    }
}

Untuk membuat nama kustom untuk pemberitahuan Google SecOps, gunakan template berikut:

[EVENT_TYPE] - [EVENT_NAME]

Misalnya, untuk membuat pemberitahuan Google SecOps bernama Phishing – Example Event, templatenya adalah sebagai berikut:

[Phishing] - [Example Event]

Input konektor

Di Exchange Mail Connector v2, parameter berikut dapat memengaruhi pemrosesan email:

• Original Received Mail Prefix
• Attached Mail File Prefixes
• Create a Separate Siemplify Alert per Attached Mail File?

Untuk memetakan kolom to dan from dari email yang diproses, konektor membuat kumpulan kolom berikut:

1. Kolom to dan from reguler yang berisi alamat email dalam format berikut: email@example.

2. Kolom to_raw dan from_raw yang hanya berisi alamat email sebagai nilai dalam format berikut: email@example.

Exchange Mail Connector v2 memerlukan parameter berikut:

Parameter	Deskripsi
Product Field Name	Wajib nama kolom tempat nama produk disimpan. Nilai defaultnya adalah device_product.
Event Field Name	Wajib Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis). Nilai defaultnya adalah event_name.
Mail Server Address	Wajib Alamat IP server email yang akan dihubungkan. Saat menghubungkan ke Microsoft 365, tetapkan alamat server ke outlook.office365.com.
Verify SSL	Opsional Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL untuk menghubungkan ke server Exchange valid. Tidak dipilih secara default.
Mail Address	Wajib Alamat email untuk kotak surat yang akan dipantau. Nilai defaultnya adalah Inbox.
Use Domain for Authentication	Opsional Jika dipilih, domain akan digunakan sebagai bagian dari kredensial autentikasi, seperti user@domain. Dipilih secara default.
Domain	Wajib Nilai domain yang akan digunakan untuk autentikasi.
Username	Wajib Nama pengguna untuk kotak surat yang akan digunakan untuk mengambil email, seperti [e-mail].
Password	Wajib Sandi untuk kotak surat email yang digunakan untuk menarik email dari.
Unread Emails Only	Opsional Jika dipilih, kasus hanya dibuat dari email yang belum dibaca. Dipilih secara default.
Mark Emails as Read	Opsional Jika dipilih, email akan ditandai sebagai telah dibaca setelah diproses. Tidak dipilih secara default.
Offset Time In Days	Wajib Jumlah hari sebelum iterasi konektor pertama untuk mengambil email. Parameter ini hanya berlaku satu kali untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya. Nilai defaultnya adalah 5.
Max Emails Per Cycle	Wajib Jumlah email yang akan diambil dalam satu iterasi konektor. Nilai defaultnya adalah 10.
Environment Field Name	Opsional Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan akan disetel ke "".
Environment Regex Pattern	Opsional Pola ekspresi reguler untuk dijalankan pada nilai yang ditemukan di kolom Environment Field Name. Dengan parameter ini, Anda dapat memanipulasi kolom lingkungan menggunakan logika ekspresi reguler. Gunakan nilai default .* untuk mengambil nilai Environment Field Name mentah yang diperlukan. Jika pola ekspresi reguler adalah null atau kosong, atau nilai lingkungan adalah null, hasil lingkungan akhir adalah "".
Headers to add to events	Opsional String yang dipisahkan koma yang menentukan header email mana yang akan ditambahkan ke acara. Anda dapat memberikan nilai sebagai pencocokan persis atau menetapkan sebagai ekspresi reguler.
Email Exclude Pattern	Opsional Regular expression untuk mengecualikan email tertentu dari penyerapan. Parameter ini berfungsi dengan bagian subjek dan isi email. Anda dapat menggunakan parameter ini untuk mengecualikan email yang disiarkan secara massal seperti berita agar tidak diproses.
PythonProcessTimeout	Wajib Batas waktu dalam detik untuk proses Python yang menjalankan skrip saat ini. Nilai default-nya adalah 60 detik.
Folder to check for emails	Wajib Folder email untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Inbox.
Attach Original EML	Opsional Jika dipilih, integrasi akan melampirkan email asli ke kasus sebagai file EML. Tidak dipilih secara default.
Fetch Backwards Time Interval (minutes)	Opsional Interval yang digunakan konektor untuk mengambil peristiwa dari periode yang dikonfigurasi dalam hitungan menit sebelum sekarang. Nilai parameter ini adalah stempel waktu iterasi konektor terakhir. Sesuaikan nilai ini dengan lingkungan yang ada, misalnya, 60 menit atau kurang. Nilai defaultnya adalah 0.
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 melakukan autentikasi.
Extract urls from HTML email part?	Opsional Jika dipilih, konektor akan mencoba mengekstrak URL dari bagian HTML email. Parameter ini memungkinkan konektor mengekstrak URL yang kompleks, tetapi bukan URL dari bagian teks biasa dalam email. URL yang diekstrak tersedia di kolom peristiwa urls_from_html_part. Tidak dipilih secara default.
Disable Overflow	Opsional Jika dipilih, konektor akan mengabaikan mekanisme overflow. Tidak dipilih secara default.
Original Received Mail Prefix	Opsional Awalan yang akan ditambahkan ke kunci peristiwa yang diekstrak, misalnya, to, from, atau subject dari email asli yang diterima di kotak surat yang dipantau. Nilai defaultnya adalah orig.
Attached Mail File Prefix	Opsional Awalan yang akan ditambahkan ke kunci peristiwa yang diekstrak, misalnya, to, from, atau subject dari file email terlampir yang diterima di kotak surat yang dipantau. Nilai defaultnya adalah attach.
Create a Separate Siemplify Alert per Attached Mail File?	Opsional Jika dipilih, konektor akan membuat beberapa pemberitahuan, dengan satu pemberitahuan untuk setiap file email terlampir. Jika Anda memilih parameter ini, Google SecOps akan memproses email dengan beberapa file terlampir dan membuat entitas dari file terlampir. Tidak dipilih secara default.
Case Name Template	Opsional Nama kasus kustom. Saat Anda mengonfigurasi parameter ini, konektor akan menambahkan kunci baru bernama custom_case_name ke peristiwa Google SecOps. Anda dapat memberikan placeholder dalam format berikut: [name of the field]. Contoh: Phishing - [event_mailbox]. Untuk placeholder, konektor menggunakan peristiwa Google SecOps pertama. Konektor hanya memproses kunci yang berisi nilai string.
Alert Name Template	Opsional Nama notifikasi kustom. Anda dapat memberikan placeholder dalam format berikut: [name of the field]. Contoh: Phishing - [event_mailbox]. Untuk placeholder, konektor menggunakan peristiwa Google SecOps pertama. Hanya kunci yang berisi nilai string yang ditangani. Jika Anda tidak memberikan nilai atau template yang tidak valid, konektor akan menggunakan nama pemberitahuan default.
Email Padding Period (minutes)	Opsional Periode bagi konektor untuk mengambil email sebelum stempel waktu terbaru.
URL Regex	Wajib Konektor ekspresi reguler yang digunakan untuk mengurai URL dari email yang diproses.

Aturan konektor

• Exchange Mail Connector v2 mendukung proxy.

• Exchange Mail Connector v2 tidak mendukung aturan daftar blokir.

• Integrasi Exchange menggunakan bagian daftar dinamis untuk menentukan ekspresi reguler guna mengaktifkan hal berikut:

  • Mengurai konten email.
  • Tambahkan kolom tertentu berdasarkan kecocokan ekspresi reguler ke peristiwa email.

Exchange Mail Connector v2 dengan Autentikasi OAuth

Gunakan Exchange Mail Connector v2 dengan OAuth untuk memantau kotak surat tertentu di server email Microsoft 365 yang memerlukan autentikasi OAuth. Anda dapat menggunakan tindakan Dapatkan Otorisasi dan Buat Token untuk mendapatkan token refresh yang diperlukan untuk konfigurasi konektor.

Untuk menjalankan Exchange Mail Connector v2 dengan OAuth, konfigurasi integrasi untuk mendukung autentikasi OAuth.

Menggunakan Template Nama Pemberitahuan dan Template Nama Kasus

Parameter Alert Name Template dan Case Name Template memungkinkan Anda mengganti cara pembuatan nama kasus dan notifikasi.

Contoh peristiwa Google SecOps adalah sebagai berikut:

{
    "event": {
        "type": "Phishing"
        "name": "Example Event",
        "id": "1"
    }
}

Untuk membuat nama kustom untuk pemberitahuan Google SecOps, gunakan template berikut:

[EVENT_TYPE] - [EVENT_NAME]

Misalnya, untuk membuat pemberitahuan Google SecOps bernama Phishing – Example Event, templatenya adalah sebagai berikut:

[Phishing] - [Example Event]

Input konektor

Di Exchange Mail Connector v2 dengan OAuth, parameter berikut dapat memengaruhi pemrosesan email:

• Original Received Mail Prefix
• Attached Mail File Prefixes
• Create a Separate Siemplify Alert per Attached Mail File?

Untuk memetakan kolom to dan from dari email yang diproses, konektor membuat dua set kolom berikut:

1. Kolom to dan from reguler yang berisi alamat email, seperti email@example.

2. Kolom to_raw dan from_raw yang hanya berisi alamat email sebagai nilai, seperti email@example.

Exchange Mail Connector v2 dengan OAuth memerlukan parameter berikut:

Parameter	Deskripsi
Product Field Name	Wajib Nama kolom tempat nama produk disimpan. Nilai defaultnya adalah device_product.
Event Field Name	Wajib Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis). Nilai defaultnya adalah event_name.
Mail Server Address	Wajib Alamat IP server email yang akan dihubungkan. Saat menghubungkan ke Microsoft 365, tetapkan alamat server ke outlook.office365.com.
Mail Address	Wajib Alamat email yang akan digunakan untuk konektor.
Client ID	Wajib Untuk autentikasi OAuth Microsoft 365, ID aplikasi (klien) dari aplikasi Microsoft Entra yang Anda gunakan untuk integrasi.
Client Secret	Wajib Untuk autentikasi OAuth Microsoft 365, rahasia klien yang Anda berikan untuk alur autentikasi.
Tenant (Directory) ID	Wajib Untuk autentikasi OAuth Microsoft 365, ID tenant (direktori) aplikasi Microsoft Entra yang Anda gunakan untuk integrasi.
Refresh Token	Wajib Untuk autentikasi OAuth Microsoft 365, token refresh yang diperoleh setelah membuat token.
Verify SSL	Opsional Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL untuk menghubungkan ke server Exchange valid. Tidak dipilih secara default.
Unread Emails Only	Opsional Jika dipilih, integrasi hanya membuat kasus dari email yang belum dibaca. Tidak dipilih secara default.
Mark Emails as Read	Opsional Jika dipilih, konektor akan menandai email yang masuk sebagai telah dibaca. Tidak dipilih secara default.
Offset Time In Days	Wajib Jumlah hari sebelum iterasi konektor pertama untuk mengambil email. Parameter ini hanya berlaku satu kali untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya. Nilai defaultnya adalah 5 hari.
Max Emails Per Cycle	Wajib Jumlah email yang akan diambil dalam satu iterasi konektor. Nilai defaultnya adalah 10 email.
Environment Field Name	Opsional Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan akan disetel ke "".
Environment Regex Pattern	Opsional Pola ekspresi reguler untuk dijalankan pada nilai yang ditemukan di kolom Environment Field Name. Dengan parameter ini, Anda dapat memanipulasi kolom lingkungan menggunakan logika ekspresi reguler. Gunakan nilai default .* untuk mengambil nilai Environment Field Name mentah yang diperlukan. Jika pola ekspresi reguler adalah null atau kosong, atau nilai lingkungan adalah null, hasil lingkungan akhir adalah "".
Headers to add to events	Opsional String yang dipisahkan koma yang menentukan header email mana yang akan ditambahkan ke acara. Anda dapat memberikan nilai sebagai pencocokan persis atau menetapkan sebagai ekspresi reguler.
Email Exclude Pattern	Opsional Regular expression untuk mengecualikan email tertentu dari penyerapan. Parameter ini berfungsi dengan bagian subjek dan isi email. Anda dapat menggunakan parameter ini untuk mengecualikan email yang disiarkan secara massal seperti berita agar tidak diproses.
PythonProcessTimeout	Wajib Batas waktu dalam detik untuk proses Python yang menjalankan skrip saat ini. Nilai defaultnya adalah 60.
Folder to check for emails	Wajib Folder email untuk menelusuri email. Parameter ini menerima daftar folder yang dipisahkan koma. Integrasi Exchange menggunakan garis miring terbalik sebagai pemisah untuk menentukan subfolder, seperti folder/subfolder1/subfolder2. Untuk menghindari error waktu tunggu atau kegagalan tindakan, ganti garis miring terbalik dalam nama folder atau subfolder dengan karakter lain seperti garis bawah. Parameter ini peka huruf besar/kecil. Nilai defaultnya adalah Inbox.
Attach Original EML	Opsional Jika dipilih, email asli akan dilampirkan ke kasus sebagai file EML. Tidak dipilih secara default.
Fetch Backwards Time Interval (minutes)	Opsional Interval yang digunakan konektor untuk mengambil peristiwa dari periode yang dikonfigurasi dalam hitungan menit sebelum sekarang. Nilai parameter ini adalah stempel waktu iterasi konektor terakhir. Sesuaikan nilai ini dengan lingkungan yang ada, misalnya, 60 menit atau kurang. Nilai defaultnya adalah 0.
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 melakukan autentikasi.
Extract urls from HTML email part?	Opsional Jika dipilih, konektor akan mencoba mengekstrak URL dari bagian HTML email. Parameter ini memungkinkan konektor mengekstrak URL yang kompleks, tetapi bukan URL dari bagian teks biasa dalam email. URL yang diekstrak tersedia di kolom peristiwa urls_from_html_part. Tidak dipilih secara default.
Disable Overflow	Opsional Jika dipilih, konektor akan mengabaikan mekanisme overflow. Tidak dipilih secara default.
Original Received Mail Prefix	Opsional Awalan yang akan ditambahkan ke kunci peristiwa yang diekstrak, misalnya, to, from, atau subject dari email asli yang diterima di kotak surat yang dipantau. Nilai defaultnya adalah orig.
Attached Mail File Prefix	Opsional Awalan yang akan ditambahkan ke kunci peristiwa yang diekstrak, misalnya, to, from, atau subject dari file email terlampir yang diterima di kotak surat yang dipantau. Nilai defaultnya adalah attach.
Create a Separate Siemplify Alert per Attached Mail File?	Opsional Jika dipilih, konektor akan membuat beberapa pemberitahuan, dengan satu pemberitahuan untuk setiap file email terlampir. Jika Anda memilih parameter ini, Google SecOps akan memproses email dengan beberapa file terlampir dan membuat entitas dari file terlampir. Tidak dipilih secara default.
Case Name Template	Opsional Nama kasus kustom. Saat Anda mengonfigurasi parameter ini, konektor akan menambahkan kunci baru bernama custom_case_name ke peristiwa Google SecOps. Anda dapat memberikan placeholder dalam format berikut: [name of the field]. Contoh: Phishing - [event_mailbox]. Untuk placeholder, konektor menggunakan peristiwa Google SecOps pertama. Konektor hanya memproses kunci yang berisi nilai string.
Alert Name Template	Opsional Parameter untuk menetapkan nama pemberitahuan kustom. Nama notifikasi kustom. Anda dapat memberikan placeholder dalam format berikut: [name of the field]. Contoh: Phishing - [event_mailbox]. Untuk placeholder, konektor menggunakan peristiwa Google SecOps pertama. Hanya kunci yang berisi nilai string yang ditangani. Jika Anda tidak memberikan nilai atau template yang tidak valid, konektor akan menggunakan nama pemberitahuan default.
Email Padding Period (minutes)	Opsional Periode bagi konektor untuk mengambil email sebelum stempel waktu terbaru.

Pekerjaan

Sebelum mengonfigurasi tugas untuk integrasi Exchange, pastikan versi platform Google SecOps Anda mendukungnya.

Tugas Perpanjangan Token Refresh

Peringatan: Tugas ini hanya didukung di platform Google SecOps versi 6.2.35 dan yang lebih baru. Jika Anda menjalankan tugas ini di versi platform yang lebih lama, tugas akan gagal.

Tujuan Refresh Token Renewal Job adalah untuk memperbarui secara berkala token refresh yang digunakan dalam integrasi.

Secara default, masa berlaku token refresh berakhir setiap 90 hari. Sebaiknya jalankan tugas ini setiap 7 atau 14 hari untuk memastikan token refresh selalu terbaru.

Input tugas

Refresh Token Renewal Job memerlukan parameter berikut:

Parameter	Deskripsi
Integration Environments	Opsional Lingkungan integrasi yang digunakan tugas untuk memperbarui token refresh. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. Sertakan setiap nilai dalam tanda kutip (" ").
Connector Names	Opsional Nama konektor yang digunakan pekerjaan untuk memperbarui token refresh. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma. Sertakan setiap nilai dalam tanda kutip (" ").

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