Microsoft Defender For Endpoint

Dokumen ini memberikan panduan tentang cara mengintegrasikan Microsoft Defender For Endpoint dengan Google SecOps.

Kasus penggunaan

  1. Gunakan data yang dikumpulkan di Microsoft Defender for Endpoint untuk pengayaan saat menyelidiki kasus tertentu.

    Analis dapat menggunakan data yang dikumpulkan dan disimpan di Microsoft Defender for Endpoint dalam investigasi—misalnya, untuk mendapatkan informasi tentang pemberitahuan yang terdeteksi di Microsoft Defender for Endpoint atau mencantumkan mesin yang terdaftar di Microsoft Defender for Endpoint.

  2. Melakukan tindakan respons aktif dalam potensi insiden keamanan seperti mengisolasi host tertentu dari jaringan atau menjalankan pemindaian antivirus.

  3. Pantau dan periksa pemberitahuan Microsoft Defender for Endpoint sebagai pemberitahuan Google Security Operations yang diambil oleh konektor masing-masing.

Prasyarat

Sebelum mengonfigurasi integrasi di platform Google SecOps, pastikan untuk menyelesaikan langkah-langkah prasyarat berikut:

  1. Buat aplikasi Microsoft Entra.

  2. Konfigurasikan izin API untuk aplikasi Anda.

  3. Buat rahasia klien.

Sebaiknya gunakan Application Context, bukan User Context, saat mengakses Microsoft Defender for Endpoint API.

Membuat aplikasi Microsoft Entra

  1. Login ke portal Azure sebagai administrator pengguna atau administrator sandi.

  2. Pilih Microsoft Entra ID.

  3. Buka App registrations > New registration.

  4. Masukkan nama aplikasi.

  5. Klik Daftar.

  6. Simpan nilai Application (client) ID dan Directory (tenant) ID untuk digunakan nanti saat mengonfigurasi parameter integrasi.

Mengonfigurasi izin API

  1. Buka API Permissions > Add a permission > APIs my organization uses. Dialog Request API permissions akan terbuka.

  2. Di kolom Search, masukkan WindowsDefenderATP.

  3. Pilih WindowsDefenderATP > Application permissions.

  4. Di bagian jenis izin Alert, pilih izin berikut:

    • Alert.Read.All
  5. Klik Add permissions.

  6. Di halaman API Permissions, klik Add a permission.

  7. Pilih Microsoft Graph > Delegated permissions.

  8. Di bagian Select Permissions, pilih izin yang diperlukan berikut:

    • User.Read
  9. Klik Add permissions.

  10. Di halaman API Permissions, klik Add a permission.

  11. Pilih WindowsDefenderATP > Application permissions.

  12. Di bagian Select Permissions, pilih izin yang diperlukan berikut:

    • AdvancedQuery.Read.All
    • Alert.Read.All
    • Alert.ReadWrite.All
    • Event.Write
    • File.Read.All
    • Ip.Read.All
    • Machine.Isolate
    • Machine.Read.All
    • Machine.ReadWrite.All
    • Machine.Scan
    • Machine.StopAndQuarantine
    • Ti.ReadWrite
    • Url.Read.All
    • User.Read.All
  13. Klik Grant admin consent for ORGANIZATION_NAME.

    Saat dialog Grant admin consent confirmation muncul, klik Yes.

Contoh permintaan API untuk mendapatkan pemberitahuan Defender ATP adalah sebagai berikut (perhatikan parameter $expand yang digunakan untuk mengambil data tentang alamat IP, domain, dan file):

GET /api/alerts?$expand=files,ips,domains HTTP/1.1
Host: api.securitycenter.windows.com
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJ...
User-Agent: PostmanRuntime/7.19.0
Accept: */ *
Cache-Control: no-cache
Postman-Token: 2dc0f885-068a-45d4-81a6-2da0d23a58ad,d3dd0e6e-83ab-4d27-94d2-0f3889dff324
Host: api.securitycenter.windows.com
Accept-Encoding: gzip, deflate
Connection: keep-alive
cache-control: no-cache

Untuk mempelajari lebih lanjut parameter permintaan dan opsi permintaan seperti filter atau perluas, lihat Supported Microsoft Defender for Endpoint APIs dalam dokumentasi Microsoft.

Membuat rahasia klien

  1. Buka Certificates and secrets > Rahasia klien baru.

  2. Berikan deskripsi untuk rahasia klien dan tetapkan batas waktu habis masa berlakunya.

  3. Klik Tambahkan.

  4. Simpan nilai rahasia klien (bukan ID rahasia) untuk digunakan sebagai nilai parameter Client Secret saat mengonfigurasi integrasi. Nilai rahasia klien hanya ditampilkan sekali.

Mengaktifkan integrasi SIEM - Tidak digunakan lagi

  1. Di panel navigasi, pilih Settings > SIEM.

  2. Pilih Aktifkan integrasi SIEM.

Tindakan ini akan mengaktifkan bagian detail akses konektor SIEM dengan nilai yang telah diisi otomatis dan aplikasi akan dibuat di tenant Azure AD Anda.

  • Pilih jenis SIEM sebagai Generic API.
  • Salin nilai satu per satu atau pilih Simpan detail ke file untuk mendownload file yang berisi semua nilai.
  • Anda akan memerlukan nilai yang ditampilkan di halaman ini untuk membuat token guna mengakses data deteksi: Client ID, Rahasia Klien, Resource.

Mengintegrasikan Microsoft Defender For Endpoint dengan Google SecOps

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

Parameter integrasi

Untuk mengonfigurasi integrasi, gunakan parameter berikut:

Parameter
Client ID Wajib

ID Klien (Aplikasi) dari aplikasi Microsoft Entra yang akan digunakan untuk integrasi.

Client Secret Wajib

Nilai rahasia klien aplikasi Microsoft Entra yang akan digunakan untuk integrasi.

Azure Active Directory ID Wajib

Nilai Microsoft Entra ID (ID Tenant).

Verify SSL Opsional

Jika dipilih, verifikasi bahwa sertifikat SSL untuk koneksi ke server Microsoft 365 Defender valid.

Dipilih secara default.

API Root Wajib

URL root API yang akan digunakan dengan integrasi. Untuk performa yang lebih baik, Anda dapat menggunakan server yang paling dekat dengan lokasi Anda:

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com

Nilai defaultnya adalah https://api.securitycenter.windows.com.

Tindakan

Menghapus Indikator Entity

Menghapus indikator entitas di Microsoft Defender for Endpoint.

Parameter

T/A

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Alamat IP
  • URL
  • Filehash

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 204 dilaporkan (is_success=true): "Successfully deleted the following entities as indicators in Microsoft Defender for Endpoint: {entity.identifier}.

Jika insiden tidak ditemukan (is_success=true): "The following entities don't exist as indicators in Microsoft Defender for Endpoint: {entity.identifier}.

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Delete Entity Indicators". Reason: {0}''.format(error.Stacktrace)

Umum

Memperkaya Entity

Memperkaya entitas Host, Alamat IP, atau Hash file Google SecOps berdasarkan informasi dari Microsoft Defender for Endpoint.

Parameter

T/A

Kasus penggunaan

Tindakan ini dapat digunakan dalam playbook yang menyelidiki aktivitas di perangkat. Jika perangkat telah menginstal agen Microsoft Defender for Endpoint, tindakan ini akan mengambil informasi dari Defender ATP di perangkat untuk memperkaya entity Google SecOps. Tindakan ini juga dapat digunakan untuk memperkaya hash file pemberitahuan dengan informasi dari Defender ATP.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Host
  • Alamat IP
  • Filehash

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON

Jika pengayaan berfungsi pada Alamat IP atau Host:

[
    {
        "EntityResult": {
            "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines/$entity",
            "id": "example_id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-18T11:13:04.0588699Z",
            "lastSeen": "2019-11-24T18:31:50.581058Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.138",
            "lastExternalIpAddress": "203.0.113.28",
            "agentVersion": "10.4860.17134.982",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "High",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        }
    }
]

Jika pengayaan berfungsi di Filehash:

[
    {
        "EntityResult": {
            "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Files/$entity",
            "sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
            "sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
            "md5": "9512e1cc66a1d36feb0a290cab09087b",
            "globalPrevalence": 5205000,
            "globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
            "globalLastObserved": "2019-11-21T00:24:01.921338Z",
            "size": 245760,
            "fileType": "APP",
            "isPeFile": true,
            "filePublisher": "Microsoft Corporation",
            "fileProductName": "Microsoft Windows Operating System",
            "signer": "Microsoft Windows",
            "issuer": "Microsoft Windows Production PCA 2011",
            "signerHash": "419e77aed546a1a6cf4dc23c1f977542fe289cf7",
            "isValidCertificate": true
            },
        "EntityResult": {
            "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
            "sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
            "orgPrevalence": "1",
            "orgFirstSeen": "2019-11-19T03:54:15Z",
            "orgLastSeen": "2019-11-19T04:21:18Z",
            "globalPrevalence": "5205000",
            "globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
            "globalLastObserved": "2019-11-21T00:24:01.921338Z",
            "topFileNames": ["notepad.exe"]
        }
    }
]
Pengayaan entity

IP dan Host

Nama Kolom Pengayaan Logika - Kapan harus diterapkan
Defender_ATP.sha1 Menampilkan jika ada dalam hasil JSON
Defender_ATP.sha256 Menampilkan jika ada dalam hasil JSON
Defender_ATP.md5 Menampilkan jika ada dalam hasil JSON
Defender_ATP.globalPrevalence Menampilkan jika ada dalam hasil JSON
Defender_ATP.globalFirstObserved Menampilkan jika ada dalam hasil JSON
Defender_ATP.globalLastObserved Menampilkan jika ada dalam hasil JSON
Defender_ATP.size Menampilkan jika ada dalam hasil JSON
Defender_ATP.fileType Menampilkan jika ada dalam hasil JSON
Defender_ATP.isPeFile Menampilkan jika ada dalam hasil JSON
Defender_ATP.filePublisher Menampilkan jika ada dalam hasil JSON
Defender_ATP.fileProductName Menampilkan jika ada dalam hasil JSON
Defender_ATP.signer Menampilkan jika ada dalam hasil JSON
Defender_ATP.issuer Menampilkan jika ada dalam hasil JSON
Defender_ATP.signerHash Menampilkan jika ada dalam hasil JSON
Defender_ATP.isValidCertificate Menampilkan jika ada dalam hasil JSON
Defender_ATP.orgPrevalence Menampilkan jika ada dalam hasil JSON
Defender_ATP.orgFirstSeen Menampilkan jika ada dalam hasil JSON
Defender_ATP.orgLastSeen Menampilkan jika ada dalam hasil JSON
Defender_ATP.topFileNames Menampilkan jika ada dalam hasil JSON

Hash File

Nama Kolom Pengayaan Logika - Kapan harus diterapkan
Defender_ATP.sha1 Menampilkan jika ada dalam hasil JSON
Defender_ATP.sha256 Menampilkan jika ada dalam hasil JSON
Defender_ATP.md5 Menampilkan jika ada dalam hasil JSON
Defender_ATP.globalPrevalence Menampilkan jika ada dalam hasil JSON
Defender_ATP.globalFirstObserved Menampilkan jika ada dalam hasil JSON
Defender_ATP.globalLastObserved Menampilkan jika ada dalam hasil JSON
Defender_ATP.size Menampilkan jika ada dalam hasil JSON
Defender_ATP.fileType Menampilkan jika ada dalam hasil JSON
Defender_ATP.isPeFile Menampilkan jika ada dalam hasil JSON
Defender_ATP.filePublisher Menampilkan jika ada dalam hasil JSON
Defender_ATP.fileProductName Menampilkan jika ada dalam hasil JSON
Defender_ATP.signer Menampilkan jika ada dalam hasil JSON
Defender_ATP.issuer Menampilkan jika ada dalam hasil JSON
Defender_ATP.signerHash Menampilkan jika ada dalam hasil JSON
Defender_ATP.isValidCertificate Menampilkan jika ada dalam hasil JSON
Defender_ATP.orgPrevalence Menampilkan jika ada dalam hasil JSON
Defender_ATP.orgFirstSeen Menampilkan jika ada dalam hasil JSON
Defender_ATP.orgLastSeen Menampilkan jika ada dalam hasil JSON
Defender_ATP.topFileNames Menampilkan jika ada dalam hasil JSON

Menjalankan Perintah Live Response

Gunakan tindakan Execute Live Response Command untuk menjalankan perintah respons langsung di Microsoft Defender for Endpoint.

Input tindakan

Tindakan Execute Live Response Command memerlukan parameter berikut:

Parameter Deskripsi
Command

Wajib.

Objek JSON yang mewakili perintah yang akan dijalankan, termasuk jenis dan parameternya.

Untuk mengetahui informasi selengkapnya tentang struktur perintah yang didukung, lihat dokumentasi API Microsoft Defender for Endpoint.

Contoh format:

{
    "type": "Command",
    "params": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}
Comment

Opsional.

Komentar atau deskripsi untuk perintah yang dijalankan.

Output tindakan

Tindakan Execute Live Response Command 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 Execute Live Response Command:

{
   "Entity": "",
   "EntityResult": {
       "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
       "id": "00000000-0000-0000-0000-000000000000",
       "type": "LiveResponse",
       "title": null,
       "requestor": "SEC_OPS_USER",
       "requestorComment": "Execution of live response command",
       "status": "Pending",
       "machineId": "MACHINE_ID_HASH",
       "computerDnsName": "hostname.domain.local",
       "creationDateTimeUtc": "2026-01-04T10:57:33.032Z",
       "lastUpdateDateTimeUtc": "2026-01-04T10:57:33.032Z",
       "cancellationRequestor": null,
       "cancellationComment": null,
       "cancellationDateTimeUtc": null,
       "errorHResult": 0,
       "scope": null,
       "externalId": null,
       "requestSource": "PublicApi",
       "relatedFileInfo": null,
       "commands": [],
       "troubleshootInfo": null,
       "results": {
           "filepath": "",
           "script_name": "remediation_script.ps1",
           "exit_code": 0,
           "script_output": "Script completed successfully",
           "script_errors": ""
       }
   }
}
Pesan output

Tindakan Execute Live Response Command dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully executed command on the following endpoints in Microsoft Defender for Endpoint: ENTITY_ID.

Tindakan berhasil.

The command didn't complete for the following endpoints in Microsoft Defender for Endpoint: ENTITY_ID.

The scan didn't complete for all of the provided endpoints in Microsoft Defender for Endpoint.

Error executing action "Execute Live Response Command". 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 Execute Live Response Command:

Nama hasil skrip Nilai
is_success true atau false

Mendapatkan Status Tugas Saat Ini

Mendapatkan status tugas saat ini.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
ID Tugas String T/A Ya Daftar ID tugas sebagai string yang dipisahkan koma.

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
[
    {
        "status": "Succeeded",
        "creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
        "cancellation_requestor": null,
        "cancellation_date_time_utc": null,
        "id": "2e39d22e-60a7-4267-899c-a1471e800000",
        "last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
        "related_file_info": null,
        "cancellation_comment": null,
        "requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
        "error_h_result": 0,
        "scope": "Selective",
        "machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
        "type": "Isolate",
        "requestor_comment": "test"
    }
]

Mendapatkan pemberitahuan terkait file dari Microsoft Defender for Endpoint berdasarkan hash file.

Parameter

Nilai Tampilan Parameter Jenis Nilai Default Is Mandatory Deskripsi
Status String Unknown, New, InProgress, Resolved Tidak

Tentukan status pemberitahuan yang perlu diperhatikan.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Keparahan String UnSpecified, Informational, Low, Medium, High TIDAK

Tentukan tingkat keparahan insiden yang akan dicari.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Kategori String T/A Tidak

Tentukan kategori pemberitahuan yang akan dicari.

Jika tidak diberikan, tindakan akan mencari semua kategori.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Nilai yang Mungkin: 'Collection', 'CommandAndControl', 'CredentialAccess', 'DefenseEvasion', 'Discovery', 'Execution', 'Exfiltration', 'Exploit', 'InitialAccess', 'LateralMovement', 'Malware', 'Persistence', 'PrivilegeEscalation', 'Ransomware', 'SuspiciousActivity', 'UnwantedSoftware'.

ID Insiden Bilangan bulat T/A Tidak Tentukan ID Insiden Microsoft Defender yang ingin Anda temukan pemberitahuan terkaitnya.

‌Kasus penggunaan

Saat menyelidiki pemberitahuan yang berasal dari konektor Defender ATP, tindakan ini dapat digunakan untuk mengumpulkan informasi apakah file ini terkait dengan pemberitahuan apa pun untuk mendapatkan insight apakah file tersebut berbahaya atau tidak.

Dijalankan Pada

Tindakan ini berjalan di entity Filehash.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
    "value": [
        {
            "id": "example_id",
            "incidentId": 2,
            "investigationId": 1,
            "assignedTo": null,
            "severity": "Medium",
            "status": "New",
            "classification": null,
            "determination": null,
            "investigationState": "TerminatedBySystem",
            "detectionSource": "WindowsDefenderAtp",
            "category": "DefenseEvasion",
            "threatFamilyName": null,
            "title": "Suspicious process injection observed",
            "description": "A process abnormally injected code into another process, As a result, unexpected code may be running in the target process memory. Injection is often used to hide malicious code execution within a trusted process. \nAs a result, the target process may exhibit abnormal behaviors such as opening a listening port or connecting to a command and control server.",
            "alertCreationTime": "2019-11-19T03:56:37.7335862Z",
            "firstEventTime": "2019-11-19T03:54:15.7698362Z",
            "lastEventTime": "2019-11-19T03:54:15.7698362Z",
            "lastUpdateTime": "2019-11-20T10:13:31.7266667Z",
            "resolvedTime": null,
            "machineId": "machine-id",
            "alertUser": {
                "accountName": "example.user",
                "domainName": "EXAMPLELAB"
            },
            "comments": [],
            "alertFiles": [
                {
                    "sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
                    "sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
                    "filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
                    "fileName": "powershell.exe"
                },{
                    "sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
                    "sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
                    "filePath": "C:\\Windows\\System32\\notepad.exe",
                    "fileName": "notepad.exe"
                }
            ],
            "alertDomains": [],
            "alertIps": [],
            "alertProcesses": []
        }
    ]
}

Mendapatkan komputer yang terkait dengan file dari Microsoft Defender for Endpoint berdasarkan hash file.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Nama Perangkat String T/A Tidak Tentukan nama lengkap mesin yang akan dicari.
Alamat IP Mesin String T/A Tidak Tentukan alamat IP mesin yang akan dicari.
Skor Risiko Mesin String T/A Tidak

Tentukan skor penilaian risiko mesin yang akan dicari.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Status Kondisi Mesin String Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunication Tidak

Tentukan status respons mesin yang akan dicari.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Platform OS Mesin String T/A Tidak Tentukan platform OS mesin yang akan dicari.
ID Grup RBAC String T/A Tidak Tentukan ID Grup RBAC yang akan dicari.

Kasus penggunaan

Saat menyelidiki pemberitahuan yang berasal dari konektor Defender ATP, tindakan ini dapat digunakan untuk mengumpulkan informasi tentang perangkat yang mendaftarkan file ini di Defender ATP.

Dijalankan pada

Tindakan ini berjalan di entity Filehash.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
    "value": [
        {
            "id": "example_id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-18T11:13:04.0588699Z",
            "lastSeen": "2019-11-20T19:35:36.4619266Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.1",
            "lastExternalIpAddress": "203.0.113.121",
            "agentVersion": "10.4860.17134.982",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "High",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        }
    ]
}

Mendapatkan Log Mesin pada Pengguna

Mendapatkan informasi tentang login pengguna di komputer tertentu.

Parameter

T/A

Kasus penggunaan

Tindakan ini dapat digunakan untuk tujuan investigasi guna mendapatkan detail spesifik tentang pengguna yang login di komputer yang dimaksud dari server Defender ATP.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Host
  • Alamat IP

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Users",
    "value": [
        {
            "id": "example\\example.user",
            "accountName": "example.user",
            "accountDomain": "example",
            "accountSid": null,
            "firstSeen": "2019-11-19T03:50:36Z",
            "lastSeen": "2019-11-19T03:50:36Z",
            "mostPrevalentMachineId": null,
            "leastPrevalentMachineId": null,
            "logonTypes": "Interactive",
            "logOnMachinesCount": 1,
            "isDomainAdmin": false,
            "isOnlyNetworkUser": null
        }
    ]
}

Mendapatkan Rekomendasi Mesin

Gunakan tindakan Get Machine Recommendations untuk mengambil daftar rekomendasi keamanan untuk mesin tertentu di Microsoft Defender for Endpoint.

Tindakan ini berjalan di entity Google SecOps berikut:

  • Hostname

  • IP Address

Input tindakan

Tindakan Get Machine Recommendations memerlukan parameter berikut:

Parameter Deskripsi
Max Recommendations To Return

Wajib.

Jumlah maksimum rekomendasi yang akan diambil untuk setiap entity.

Nilai maksimumnya adalah 100.

Nilai defaultnya adalah 100.

Output tindakan

Tindakan Get Machine Recommendations 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 Get Machine Recommendations:

{
   "Entity": "",
   "EntityResult": [
         {
            "id": "va-_-7-zip-_-7-zip",
            "productName": "7-zip",
            "recommendationName": "Update 7-zip to version 25.01.0.0",
            "weaknesses": 12,
            "vendor": "7-zip",
            "recommendedVersion": "25.01.0.0",
            "recommendedVendor": "",
            "recommendedProgram": "",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0.0,
            "publicExploit": true,
            "activeAlert": false,
            "associatedThreats": [],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0.0,
            "exposureImpact": 0.0,
            "totalMachineCount": 0,
            "exposedMachinesCount": 1,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "7-zip",
            "hasUnpatchableCve": false,
            "tags": [],
            "exposedCriticalDevices": 0
        }
   ]
}
Pesan output

Tindakan Get Machine Recommendations dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully returned recommendations for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No recommendations were found for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No recommendations were found for the provided endpoints in Microsoft Defender for Endpoint.

Tindakan berhasil.
Error executing action "Get Machine Recommendations". 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 Get Machine Recommendations:

Nama hasil skrip Nilai
is_success true atau false

Mendapatkan pemberitahuan terkait mesin tertentu yang terdaftar di Defender ATP.

Parameter

Parameter Jenis Nilai Default Is Mandatory Deskripsi
Status String Unknown, New, InProgress, Resolved Tidak

Tentukan status pemberitahuan yang perlu diperhatikan.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Keparahan String UnSpecified, Informational, Low, Medium, High Tidak

Tentukan tingkat keparahan insiden yang akan dicari.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Kategori String T/A Tidak

Tentukan kategori pemberitahuan yang akan dicari.

Jika tidak diberikan, tindakan akan mencari semua kategori.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Nilai yang Mungkin: 'Collection', 'CommandAndControl', 'CredentialAccess', 'DefenseEvasion', 'Discovery', 'Execution', 'Exfiltration', 'Exploit', 'InitialAccess', 'LateralMovement', 'Malware', 'Persistence', 'PrivilegeEscalation', 'Ransomware', 'SuspiciousActivity', 'UnwantedSoftware'.

ID Insiden Bilangan bulat T/A Tidak Tentukan ID Insiden Microsoft Defender yang ingin Anda temukan pemberitahuan terkaitnya.

Kasus penggunaan

Tindakan ini dapat digunakan untuk tujuan investigasi guna mendapatkan pemberitahuan terkait mesin tertentu yang dimaksud dari server Defender ATP.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Host
  • Alamat IP

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
    "value": [
        {
            "id": "example-id",
            "incidentId": 1,
            "investigationId": null,
            "assignedTo": "testuser@example.com",
            "severity": "Informational",
            "status": "Resolved",
            "classification": "FalsePositive",
            "determination": "SecurityTesting",
            "investigationState": "UnsupportedAlertType",
            "detectionSource": "WindowsDefenderAtp",
            "category": "Execution",
            "threatFamilyName": null,
            "title": "[Test Alert] Suspicious Powershell commandline",
            "description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
            "alertCreationTime": "2019-11-18T11:17:48.287421Z",
            "firstEventTime": "2019-11-18T11:15:06.5226815Z",
            "lastEventTime": "2019-11-18T11:15:06.5226815Z",
            "lastUpdateTime": "2019-11-20T04:12:03.91Z",
            "resolvedTime": "2019-11-20T04:12:03.4976288Z",
            "machineId": "machine-id",
            "alertUser": {
                "accountName": "Administrator",
                "domainName": "US-LT-V13007"
            },
            "comments": [],
            "alertFiles": [
                {
                    "sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
                    "sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
                    "filePath": "C:\\Windows\\System32\\cmd.exe",
                    "fileName": "cmd.exe"
                },
                {
                    "sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
                    "sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
                    "filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
                    "fileName": "powershell.exe"
                }
            ],
            "alertDomains": [],
            "alertIps": [],
            "alertProcesses": []
        }
    ]
}

Mendapatkan Kerentanan Mesin

Gunakan tindakan Get Machine Vulnerabilities untuk mencantumkan kerentanan yang terkait dengan mesin tertentu di Microsoft Defender for Endpoint.

Tindakan ini berjalan di entity Google SecOps berikut:

  • Hostname

  • IP Address

Input tindakan

Tindakan Get Machine Vulnerabilities memerlukan parameter berikut:

Parameter Deskripsi
Severity Filter

Opsional.

Tingkat keparahan yang digunakan untuk memfilter kerentanan yang ditampilkan.

Kemungkinan nilainya adalah sebagai berikut:

  • Critical
  • High
  • Medium
  • Low

Nilai defaultnya adalah Critical.

Threat Filter

Opsional.

Kriteria threat intelligence yang digunakan untuk memfilter kerentanan yang ditampilkan.

Kemungkinan nilainya adalah sebagai berikut:

  • Associated Active Alert
  • Exploit is available
  • Exploit is verified
  • This exploit is part of an exploit kit
Sort By

Opsional.

Kolom yang digunakan untuk mengurutkan kerentanan yang ditampilkan.

Kemungkinan nilainya adalah sebagai berikut:

  • First Detection Time
  • Severity
  • Update Time

Nilai defaultnya adalah Severity.

Sort Order

Opsional.

Urutan tampilan hasil yang diurutkan.

Kemungkinan nilainya adalah sebagai berikut:

  • ASC
  • DESC

Nilai defaultnya adalah ASC.

Max Vulnerabilities To Return

Wajib.

Jumlah maksimum kerentanan yang akan ditampilkan untuk setiap entitas.

Nilai maksimumnya adalah 100.

Nilai defaultnya adalah 100.

Output tindakan

Tindakan Get Machine Vulnerabilities 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 Get Machine Vulnerabilities:

{
   "Entity": "",
   "EntityResult": [
       {
           "@odata.type": "#microsoft.windowsDefenderATP.api.PublicVulnerabilityDto",
           "id": "CVE-2025-21266",
           "name": "CVE-2025-21266",
           "description": "Summary: The Windows Telephony Service in Microsoft Windows is vulnerable to remote code execution. An attacker can exploit this vulnerability by tricking a user into visiting a malicious website, which would allow them to execute arbitrary code on the system. Impact: If successfully exploited, this vulnerability could allow an attacker to execute arbitrary code on the affected system. This could lead to a complete compromise of the system, enabling the attacker to gain unauthorized access, steal sensitive information, or perform other malicious activities. Remediation: Apply the latest patches and updates provided by the respective vendors. Generated by AI",
           "severity": "High",
           "cvssV3": 8.8,
           "cvssVector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:U/RL:O/RC:C",
           "exposedMachines": 1,
           "publishedOn": "2025-01-14T08:00:00Z",
           "updatedOn": "2025-09-09T23:45:43.5Z",
           "firstDetected": "2025-01-14T18:31:29Z",
           "patchFirstAvailable": null,
           "publicExploit": false,
           "exploitVerified": false,
           "exploitInKit": false,
           "exploitTypes": [],
           "exploitUris": [],
           "cveSupportability": "Supported",
           "tags": [],
           "epss": 0.01391,
           "status": "RemediationRequired"
       }
   ]
}
Pesan output

Tindakan Get Machine Vulnerabilities dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully returned vulnerabilities for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

The action wasn't able to return vulnerabilities for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

The action wasn't able to return vulnerabilities for the provided endpoints in Microsoft Defender for Endpoint.

No vulnerabilities were found for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No vulnerabilities were found for the provided endpoints in Microsoft Defender for Endpoint.

Tindakan berhasil.
Error executing action "Get Machine Vulnerabilities". 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 Get Machine Vulnerabilities:

Nama hasil skrip Nilai
is_success true atau false

Gunakan tindakan Get User Related Alerts untuk mencantumkan pemberitahuan yang terkait dengan pengguna tertentu di Microsoft Defender for Endpoint.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Dapatkan Notifikasi Terkait Pengguna memerlukan parameter berikut:

Parameter Deskripsi
Max Alerts To Return

Wajib.

Jumlah maksimum notifikasi yang akan diambil untuk setiap pengguna.

Nilai maksimumnya adalah 100.

Nilai defaultnya adalah 100.

Output tindakan

Tindakan Get User Related Alerts 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 Dapatkan Notifikasi Terkait Pengguna:

[
    {
        "Entity": "User@domain.local",
        "EntityResult": [
            {
                "id": "da06788650-4d45-4dcf-ae23-d1071ad426ec_1",
                "incident_id": 864492,
                "investigation_id": 1778,
                "assigned_to": "API-Automated Investigation and Response",
                "severity": "Low",
                "status": "Resolved",
                "classification": null,
                "determination": null,
                "investigation_state": "Benign",
                "detection_source": "WindowsDefenderAv",
                "category": "Malware",
                "threat_family_name": "Ceprolad",
                "title": "An active '' malware ",
                "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
                "alert_creation_time": "2026-02-27T06:58:08.1366667Z",
                "first_event_time": "2026-02-27T06:55:51.021546Z",
                "last_event_time": "2026-02-27T06:55:51.021546Z",
                "last_update_time": "2026-02-27T07:13:46.2333333Z",
                "resolved_time": "2026-02-27T07:13:44.3513463Z",
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da0b1f334d-b5e5-4618-8a2a-d3675e62a93b_1",
                "incident_id": 864492,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Low",
                "status": "New",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious JavaScript process",
                "description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
                "alert_creation_time": "2026-02-27T06:58:38.5533333Z",
                "first_event_time": "2026-02-27T06:55:32.6699867Z",
                "last_event_time": "2026-03-05T07:24:52.7415066Z",
                "last_update_time": "2026-03-05T07:28:04.67Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1",
                "incident_id": 690846,
                "investigation_id": null,
                "assigned_to": "analyst@company.onmicrosoft.com",
                "severity": "Medium",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious behavior by cmd.exe was observed",
                "description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
                "alert_creation_time": "2025-10-13T10:26:21.3333333Z",
                "first_event_time": "2025-10-13T10:23:58.1472359Z",
                "last_event_time": "2025-10-13T10:25:22.714708Z",
                "last_update_time": "2026-02-13T08:14:22.61Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 13 Oct 25 | 10:26 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: MMC [T1218.014]\n  * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-13T10:40:32.4733451Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da0e3de096-1789-43ff-bb2e-6cc22e5037ad_1",
                "incident_id": 864492,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Low",
                "status": "New",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "DefenseEvasion",
                "threat_family_name": null,
                "title": "Suspicious registry modification",
                "description": "A suspicious process modified the registry on this device. Registry entries can be added, modified, or removed to change various settings of the system or behavior of a program. Attackers leverage this technique to gain persistence, escalate privileges, launch malicious codes, or to tamper with security products.",
                "alert_creation_time": "2026-02-27T06:58:38.7266667Z",
                "first_event_time": "2026-02-27T06:56:11.3416006Z",
                "last_event_time": "2026-03-05T07:25:30.6007486Z",
                "last_update_time": "2026-03-05T07:28:07.39Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da13c4af0a-bd35-4cb2-a556-fa972f3b80da_1",
                "incident_id": 864492,
                "investigation_id": 1779,
                "assigned_to": "API-Automated Investigation and Response",
                "severity": "Low",
                "status": "Resolved",
                "classification": null,
                "determination": null,
                "investigation_state": "Benign",
                "detection_source": "WindowsDefenderAv",
                "category": "Malware",
                "threat_family_name": "Ceprolad",
                "title": "An active '' malware ",
                "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
                "alert_creation_time": "2026-03-02T07:26:21.22Z",
                "first_event_time": "2026-03-02T07:25:05.4166175Z",
                "last_event_time": "2026-03-02T07:25:05.4166175Z",
                "last_update_time": "2026-03-02T07:37:19.2666667Z",
                "resolved_time": "2026-03-02T07:37:19.1231428Z",
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da2052972f-7cc3-42c8-8abf-8ac490d63c35_1",
                "incident_id": 690846,
                "investigation_id": null,
                "assigned_to": "analyst@company.onmicrosoft.com",
                "severity": "Medium",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious behavior by cmd.exe was observed",
                "description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
                "alert_creation_time": "2025-10-07T10:25:41.1666667Z",
                "first_event_time": "2025-10-07T10:23:44.5677721Z",
                "last_event_time": "2025-10-07T10:25:10.6581007Z",
                "last_update_time": "2026-02-13T08:14:22.61Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\ud83e\udde8 Generic Threat - APTSimulator_schedu... - Not Mitigated - Escalated\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: MMC [T1218.014]\n  * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Isolation, Stop and Quarantine File, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis)\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-07T10:27:41.3867936Z"
                    },
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage (\ud83d\udca1Triage updated \u2192 Risk Deescalated)\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: MMC [T1218.014]\n  * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-07T10:32:21.417826Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da2068d331-0335-4479-9f96-e8f33db81aa9_1",
                "incident_id": 864492,
                "investigation_id": 1780,
                "assigned_to": "API-Automated Investigation and Response",
                "severity": "Low",
                "status": "Resolved",
                "classification": null,
                "determination": null,
                "investigation_state": "Benign",
                "detection_source": "WindowsDefenderAv",
                "category": "Malware",
                "threat_family_name": "Ceprolad",
                "title": "An active 'Ceprolad' malware in a command line was prevented from executing",
                "description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
                "alert_creation_time": "2026-03-05T07:26:09.89Z",
                "first_event_time": "2026-03-05T07:25:08.6889036Z",
                "last_event_time": "2026-03-05T07:25:08.6889036Z",
                "last_update_time": "2026-03-05T07:37:44.9066667Z",
                "resolved_time": "2026-03-05T07:37:44.65021Z",
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da29243e25-be1e-47b7-9d40-e626df36345c_1",
                "incident_id": 688299,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Medium",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Persistence",
                "threat_family_name": null,
                "title": "New group added suspiciously",
                "description": "A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.",
                "alert_creation_time": "2025-09-18T14:59:47.52Z",
                "first_event_time": "2025-09-18T14:53:30.7348596Z",
                "last_event_time": "2025-09-21T14:53:43.8093531Z",
                "last_update_time": "2025-09-21T14:56:44.5166667Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - APTSimulator_schedu... - Not Mitigated - Follow Up Required\n===================================\n\n- Title: New group added suspiciously\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Medium\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Discovery: Local Groups [T1069.001]\n  * Persistence: Account Manipulation [T1098]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da29243e25-be1e-47b7-9d40-e626df36345c_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-09-18T15:03:43.2796289Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da2be6df1c-2401-4545-8111-5f75d0fd0223_1",
                "incident_id": 690846,
                "investigation_id": null,
                "assigned_to": "analyst@company.onmicrosoft.com",
                "severity": "Low",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious JavaScript process",
                "description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
                "alert_creation_time": "2025-10-01T10:26:20.6566667Z",
                "first_event_time": "2025-10-01T10:24:19.1071611Z",
                "last_event_time": "2025-10-07T10:24:27.1065475Z",
                "last_update_time": "2026-02-13T08:14:22.61Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - en-US.js - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 01 Oct 25 | 10:26 UTC\n- External severity: Low\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: Indicator Removal on Host [T1070]\n  * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2be6df1c-2401-4545-8111-5f75d0fd0223_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-10-01T10:30:36.462226Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            },
            {
                "id": "da37252b75-0446-4a7b-99b4-e64886557bd3_1",
                "incident_id": 688299,
                "investigation_id": null,
                "assigned_to": null,
                "severity": "Low",
                "status": "InProgress",
                "classification": null,
                "determination": null,
                "investigation_state": "UnsupportedAlertType",
                "detection_source": "WindowsDefenderAtp",
                "category": "Execution",
                "threat_family_name": null,
                "title": "Suspicious JavaScript process",
                "description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
                "alert_creation_time": "2025-09-18T14:59:46.57Z",
                "first_event_time": "2025-09-18T14:54:11.4061419Z",
                "last_event_time": "2025-09-21T14:54:00.575478Z",
                "last_update_time": "2025-09-21T14:56:36.6533333Z",
                "resolved_time": null,
                "machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
                "alert_user": null,
                "alert_files": [],
                "comments": [
                    {
                        "comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - wscript.exe - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Low\n- Hosts: \n  * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n  * Command and Control: Application Layer Protocol [T1071]\n  * Defense Evasion: Indicator Removal on Host [T1070]\n  * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da37252b75-0446-4a7b-99b4-e64886557bd3_1?environment=mde",
                        "createdBy": "API Action",
                        "createdTime": "2025-09-18T15:06:13.2743521Z"
                    }
                ],
                "alert_domains": null,
                "alert_ips": null,
                "alert_processes": null
            }
        ]
    }
]
Pesan output

Tindakan Dapatkan Pemberitahuan Terkait Pengguna dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully returned alerts related to the following users in Microsoft Defender for Endpoint: ENTITY_IDS.

No alerts were related to the following users in Microsoft Defender for Endpoint: ENTITY_IDS.

No alerts were related to the provided users in Microsoft Defender for Endpoint.

Tindakan berhasil.
Error executing action "Get User Related Alerts". 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 Get User Related Alerts:

Nama hasil skrip Nilai
is_success true atau false

Isolasi Mesin

Mengisolasi perangkat menggunakan Microsoft Defender for Endpoint. Mesin dapat disetel dalam isolasi penuh, atau isolasi selektif. Aplikasi Outlook, Skype for Business, dan Teams terus berfungsi di komputer yang diisolasi.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Jenis Isolasi DDL

Penuh

Nilai yang Mungkin Muncul:

  • Penuh
  • Selektif
Ya Tentukan jenis isolasi.
Komentar String T/A Ya Tentukan komentar tentang alasan mesin perlu diisolasi.
Buat Insight? Kotak centang Dicentang Jika diaktifkan, tindakan ini akan membuat Insight Google SecOps dengan informasi terkait jika berhasil dijalankan.

Kasus penggunaan

Mengisolasi komputer yang dianggap terinfeksi. Misalnya, pemberitahuan konektor Defender ATP diserap ke server Google SecOps, dan selama analisis pemberitahuan, ditemukan bahwa terkait dengan mesin pemberitahuan (entitas Kasus), mesin tersebut dapat terinfeksi dan perlu diisolasi.

Dijalankan pada

Tindakan ini berjalan pada tindakan berikut:

  • Host
  • Alamat IP

Hasil tindakan

Hasil skrip

Benar jika Endpoint API yang ditampilkan untuk setiap entity yang disediakan tempatnya dijalankan, status 201, dalam Respons JSON "status": "Pending", yang menunjukkan bahwa permintaan API berhasil dijalankan. Jika tindakan gagal untuk setidaknya satu entitas, hasil akhirnya akan gagal (False).

Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "Isolate",
    "requestor": "requestor-id",
    "requestorComment": "Machine Isolation due to alert ...",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
    "lastUpdateDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": null
}
Insight
  • Logika Insight: Jika mesin diisolasi menggunakan agen Defender ATP, buat insight untuk menunjukkan hal ini.
  • Type: Entity.
  • Title (String): entity.
  • IdentifierMessage: "Host diisolasi menggunakan Microsoft Defender for Endpoint."

Mencantumkan Pemberitahuan

Mencantumkan pemberitahuan Microsoft Defender for Endpoint berdasarkan kriteria penelusuran yang diberikan. Tindakan ini menampilkan informasi tentang pemberitahuan yang ditemukan dalam tabel dan formulir tampilan JSON sebagai output tindakan, beserta data pemberitahuan mentah yang disimpan dan dilampirkan ke file JSON output tindakan.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Jangka Waktu Bilangan bulat 3 Tidak Tentukan jangka waktu dalam jam untuk mengambil pemberitahuan.
Status String Unknown, New, InProgress, Resolved Tidak

Tentukan status pemberitahuan yang perlu diperhatikan.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Keparahan String T/A Tidak

Tentukan tingkat keparahan insiden yang akan dicari.

Jika tidak diberikan, tindakan akan mencari semua tingkat keparahan.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Nilai yang Mungkin: Tidak Ditentukan, Informasi, Rendah, Sedang, dan Tinggi

Kategori String T/A Tidak

Tentukan kategori pemberitahuan yang akan dicari.

Jika tidak diberikan, tindakan akan mencari semua kategori.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Nilai yang Mungkin: 'Collection', 'CommandAndControl', 'CredentialAccess', 'DefenseEvasion', 'Discovery', 'Execution', 'Exfiltration', 'Exploit', 'InitialAccess', 'LateralMovement', 'Malware', 'Persistence', 'PrivilegeEscalation', 'Ransomware', 'SuspiciousActivity', 'UnwantedSoftware'.

ID Insiden Bilangan bulat T/A Tidak Tentukan ID Insiden Microsoft Defender yang ingin Anda temukan pemberitahuan terkaitnya.

Kasus penggunaan

Tindakan ini dapat digunakan untuk meninjau peringatan Defender ATP ke server Google SecOps untuk pengguna akhir. Misalnya, saat menangani peringatan yang berasal dari konektor Defender ATP, pengguna mengonfigurasi tindakan "List Warnings" untuk menerima IncidentId pemberitahuan yang diproses sebagai parameter input untuk mengambil detail dari server Defender ATP—ada peringatan lain yang merupakan bagian dari satu Insiden Defender ATP.

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
    "value": [
        {
            "id": "example_id",
            "incidentId": 2,
            "investigationId": null,
            "assignedTo": null,
            "severity": "Medium",
            "status": "New",
            "classification": null,
            "determination": null,
            "investigationState": "UnsupportedAlertType",
            "detectionSource": "WindowsDefenderAtp",
            "category": "Execution",
            "threatFamilyName": null,
            "title": "Unexpected behavior observed by a process run with no command line arguments",
            "description": "The legitimate process by this name does not normally exhibit this behavior when run with no command line arguments. \nSuch unexpected behavior may be a result of extraneous code injected into a legitimate process, or a malicious executable masquerading as the legitimate one by name.",
            "alertCreationTime": "2019-11-19T03:56:35.3007009Z",
            "firstEventTime": "2019-11-19T03:54:16.0441057Z",
            "lastEventTime": "2019-11-19T03:54:16.0441057Z",
            "lastUpdateTime": "2019-11-19T03:56:38.45Z",
            "resolvedTime": null,
            "machineId": "machine-id",
            "alertUser": null,
            "comments": [],
            "alertFiles": [],
            "alertDomains": [],
            "alertIps": [],
            "alertProcesses": []
            }
    ]
}

Indikator Daftar

Mencantumkan indikator di Microsoft Defender for Endpoint.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Indikator CSV T/A Tidak Tentukan daftar indikator yang dipisahkan koma yang ingin Anda ambil.
Jenis Indikator CSV FileSha1,FileSha256,FileMd5,CertificateThumbprint,IpAddress,DomainName, Url Tidak

Tentukan daftar jenis indikator yang dipisahkan koma yang ingin Anda ambil.

Nilai yang mungkin: FileSha1, FileSha256, FileMd5, CertificateThumbprint, IpAddress,DomainName, Url.

Tindakan CSV Warn,Block,Audit,Alert,AlertAndBlock,BlockAndRemediate,Allowed Tidak

Tentukan daftar tindakan indikator yang dipisahkan koma yang ingin Anda gunakan untuk pemfilteran.

Nilai yang mungkin: Warn,Block,Audit,Alert, AlertAndBlock,BlockAndRemediate,Allowed

Keparahan CSV Informasional,Rendah,Sedang,Tinggi Tidak

Tentukan daftar tingkat keparahan yang dipisahkan koma yang ingin Anda gunakan untuk pemfilteran.

Nilai yang mungkin: Informasional,Rendah,Sedang,Tinggi

Jumlah Hasil Maksimum yang Akan Ditampilkan Bilangan bulat 50 Tidak Tentukan jumlah indikator yang akan ditampilkan.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "id": "18",
    "indicatorValue": "110e7d15b011d7fac48f2bd61114db1022197f7a",
    "indicatorType": "FileSha1",
    "action": "Audit",
    "createdBy": "45e9773c-100e-4a9f-ad37-d8e182e9ed26",
    "severity": "Informational",
    "category": 1,
    "application": "demo-test",
    "educateUrl": null,
    "bypassDurationHours": null,
    "title": "test",
    "description": "test",
    "recommendedActions": "nothing",
    "creationTimeDateTimeUtc": "2022-02-08T14:20:34.9071582Z",
    "expirationTime": null,
    "lastUpdateTime": "2022-02-08T14:20:34.9151307Z",
    "lastUpdatedBy": null,
    "rbacGroupNames": [],
    "rbacGroupIds": [],
    "notificationId": null,
    "notificationBody": null,
    "version": null,
    "mitreTechniques": [],
    "historicalDetection": false,
    "lookBackPeriod": null,
    "generateAlert": true,
    "additionalInfo": null,
    "createdByDisplayName": "Example Defender ATP",
    "externalId": null,
    "createdBySource": "PublicApi",
    "certificateInfo": null
}
Repositori kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika data tersedia (is_success=true): "Successfully found indicators for the provided criteria in Microsoft Defender for Endpoint.".

Jika data tidak tersedia (is_success=false): "No indicators were found for the provided criteria in Microsoft Defender for Endpoint."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "List Indicators". Reason: {0}''.format(error.Stacktrace)

Jika parameter "Indicator types" yang tidak valid diberikan: "Error executing action "List Indicators". Alasan: nilai tidak valid untuk parameter "Jenis Indikator". Nilai yang mungkin: FileSha1, FileSha256, FileMd5, CertificateThumbprint, IpAddress, DomainName, Url.

Jika parameter "Actions" yang tidak valid diberikan: "Error executing action "List Indicators". Alasan: nilai tidak valid untuk parameter "Actions". Nilai yang mungkin: Warn, Block, Audit, Alert, AlertAndBlock, BlockAndRemediate, Allowed.

Jika parameter "Severity" yang tidak valid diberikan: "Error executing action "List Indicators". Alasan: nilai tidak valid untuk parameter "Actions". Nilai yang mungkin: Informasional, Rendah, Sedang, Tinggi.

Umum
Tabel Repositori Kasus

Indikator yang Ditemukan

Type: indicatorType

Action: action

Tingkat keparahan: severity Deskripsi: description Judul: title Rekomendasi: recommendedActions

Entity

Mencantumkan Mesin

Mendapatkan informasi tentang mesin yang terdaftar di server Microsoft Defender for Endpoint berdasarkan parameter yang diberikan untuk penelusuran.

Parameter

Parameter Jenis Nilai Default Is Mandatory Deskripsi
Rentang Waktu Terakhir Dilihat Bilangan bulat T/A Tidak Tentukan jangka waktu terakhir terlihat yang akan dicari dalam jam.
Nama Perangkat String T/A Tidak Tentukan nama lengkap mesin yang akan dicari.
Alamat IP Mesin String T/A Tidak Tentukan alamat IP mesin yang akan dicari.
Skor Risiko Mesin String Tidak Ada, Rendah, Sedang, Tinggi Tidak

Tentukan skor penilaian risiko mesin yang akan dicari.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Status Kondisi Mesin String Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunication Tidak

Tentukan status respons mesin yang akan dicari.

Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Platform OS Mesin String T/A Tidak Tentukan platform OS mesin yang akan dicari.
ID Grup RBAC String T/A Tidak Tentukan ID Grup RBAC yang akan dicari.

Kasus penggunaan

Tindakan ini dapat digunakan untuk tujuan investigasi guna mendapatkan informasi tentang perangkat yang terdaftar di server Defender ATP. Tindakan ini sebagian besar digunakan sebagai tindakan manual, agar pengguna tidak perlu beralih kembali ke konsol Defender ATP dan mencari mesin yang sedang digunakan oleh agen Defender ATP.

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
    "value": [
        {
            "id": "example-id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-18T11:13:04.0588699Z",
            "lastSeen": "2019-11-20T09:59:28.0646303Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.138",
            "lastExternalIpAddress": "203.0.113.35",
            "agentVersion": "10.4860.17134.982",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "High",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        },{
            "id": "example-id",
            "computerDnsName": "example-name",
            "firstSeen": "2019-11-20T08:36:16.2721384Z",
            "lastSeen": "2019-11-20T08:36:52.7182837Z",
            "osPlatform": "Windows10",
            "osVersion": null,
            "osProcessor": "x64",
            "version": "1803",
            "lastIpAddress": "192.0.2.141",
            "lastExternalIpAddress": "203.0.113.35",
            "agentVersion": "10.4850.17134.191",
            "osBuild": 17134,
            "healthStatus": "Active",
            "rbacGroupId": 0,
            "rbacGroupName": null,
            "riskScore": "None",
            "exposureLevel": "Medium",
            "aadDeviceId": null,
            "machineTags": []
        }
    ]
}

Ping

Uji konektivitas ke instance Microsoft Defender for Endpoint dengan parameter yang disediakan di halaman konfigurasi integrasi.

Parameter

T/A

Kasus penggunaan

Tindakan ini digunakan untuk menguji konektivitas dan dapat dijalankan sebagai tindakan manual, yang bukan bagian dari playbook.

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False

Menjalankan Kueri Perburuan Lanjutan

Menjalankan kueri perburuan lanjutan Microsoft Defender for Endpoint. Perhatikan bahwa tanda kutip, baris baru, atau simbol khusus lainnya harus di-escape, misalnya, gunakan garis miring terbalik untuk meng-escape tanda kutip.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Kueri String T/A Ya Kueri perburuan lanjutan yang akan dijalankan.

Kasus penggunaan

Pengguna dapat memiliki kueri perburuan yang ingin mereka gunakan untuk mengkueri data yang dikumpulkan di Defender ATP selama pemrosesan Pemberitahuan Defender tertentu. Dengan tindakan ini, pengguna dapat menjalankan kueri perburuan lanjutan tersebut.

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "Stats": {
        "ExecutionTime": 0.0156652,
        "resource_usage": {
            "cache": {
                "memory": {
                    "hits": 13,
                    "misses": 0,
                    "total": 13
                },
                "disk": {
                    "hits": 0,
                    "misses": 0,
                    "total": 0
                }
            },
            "cpu": {
                "user": "00:00:00.0156250",
                "kernel": "00:00:00",
                "total cpu": "00:00:00.0156250"
            },
            "memory": {
                "peak_per_node": 33554624
            }
        },
        "dataset_statistics": [
            {
                "table_row_count": 2,
                "table_size": 60
            }
        ]
    },
    "Schema": [
        {
            "Name": "EventTime",
            "Type": "DateTime"
        },
        {
            "Name": "FileName",
            "Type": "String"
        },
        {
            "Name": "InitiatingProcessFileName",
            "Type": "String"
        }
    ],
    "Results": [
        {
            "EventTime": "2019-11-18T11:13:07.043128Z",
            "FileName": "csc.exe",
            "InitiatingProcessFileName": "powershell.exe"
        },
        {
            "EventTime": "2019-11-19T03:54:14.4256361Z",
            "FileName": "csc.exe",
            "InitiatingProcessFileName": "powershell.exe"
        }
    ]
}

Menjalankan Pemindaian Antivirus

Memulai pemindaian antivirus di host menggunakan Microsoft Defender for Endpoint. Tersedia dua jenis pemindaian Defender ATP: Penuh atau Cepat.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Jenis Pemindaian Antivirus DDL

Penuh

Nilai yang Mungkin Muncul:

  • Penuh
  • Cepat
Ya Tentukan apakah akan memulai pemindaian antivirus Lengkap atau Cepat di komputer.
Komentar String T/A Ya Tentukan komentar tentang alasan pemindaian antivirus perlu dijalankan di mesin.

Kasus penggunaan

Pemberitahuan berasal dari konektor Defender ATP, selama pemrosesan pemberitahuan, indikator penyusupan malware ditemukan di komputer yang terkait dengan entitas kasus Google SecOps, dan karena itu pengguna memutuskan untuk menjalankan pemindaian antivirus di komputer untuk mencoba menemukan malware di host.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Host
  • Alamat IP

Hasil tindakan

Hasil skrip

Benar jika Endpoint API yang ditampilkan untuk setiap entity yang disediakan tempatnya dijalankan, status 201, dalam Respons JSON "status": "Pending", yang menunjukkan bahwa permintaan API berhasil dijalankan. Jika tindakan gagal untuk setidaknya satu entitas, hasil akhirnya akan gagal (False).

Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "RunAntiVirusScan",
    "requestor": "requestor_id",
    "requestorComment": "Run antivirus scan on suspect",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-21T11:07:06.611628Z",
    "lastUpdateDateTimeUtc": "2019-11-21T11:07:06.611628Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": null
}

Menghentikan dan Mengarantina File di Mesin Tertentu

Menghentikan eksekusi file di mesin tertentu dan mengarantinanya menggunakan agen Microsoft Defender For Endpoint. Tindakan berfungsi dengan entity Host atau IP Google SecOps.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Hash File SHA1 yang akan Dikarantina String T/A Ya

Tentukan hash file SHA-1 dari file yang akan dihentikan dan dikarantina.

Catatan: Hash SHA-1 harus dalam huruf kecil agar tindakan dapat menemukan file yang cocok.

Komentar String T/A Ya Tentukan komentar tentang alasan pemindaian antivirus perlu dijalankan di mesin.
Buat Insight? Kotak centang Dicentang Jika diaktifkan, tindakan akan membuat Insight Google SecOps dengan informasi terkait jika berhasil dijalankan.

Kasus penggunaan

Selama pemrosesan pemberitahuan yang berasal dari konektor Defender ATP, tindakan "Stop and Quarantine File" dapat digunakan untuk memblokir file tertentu agar tidak dieksekusi guna mencegah penyusupan mesin. Kebutuhan akan tindakan ini mungkin berasal dari perburuan lanjutan, dan pengguna mungkin menemukan beberapa file yang berpotensi berbahaya yang saat ini ingin diblokir pengguna di satu perangkat.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Host
  • Alamat IP

Hasil tindakan

Hasil skrip

Dapat berupa Benar atau Salah. Benar jika Endpoint API yang ditampilkan untuk setiap entity yang disediakan tempatnya dijalankan, status 201, dalam Respons JSON "status": "Pending", yang menunjukkan bahwa permintaan API berhasil dijalankan. Jika setidaknya untuk salah satu entitas, tindakan gagal, hasil akhirnya harus gagal (False).

Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "StopAndQuarantineFile",
    "requestor": "requestor-id",
    "requestorComment": "Stopping and quarantining putty",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
    "lastUpdateDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": {
        "fileIdentifier": "d932604ab8e9debe475415851fd26929a0c0dcd1",
        "fileIdentifierType": "Sha1"
    }
}
Insight
  • Type: Entity.
  • Title (String): entity.
  • IdentifierMessage (String): "File dengan Hash File SHA-1 {0} dihentikan dan dikarantina pada {1}". format (filehash,entity.Identifier).

Mengirimkan Indikator Entitas

Mengirimkan entity sebagai indikator di Microsoft Defender for Endpoint.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Is Mandatory Deskripsi
Tindakan DDL

Blokir

Nilai yang Mungkin Muncul:

  • Blokir
  • Audit
  • Memblokir dan Memperbaiki
  • Izinkan
Ya

Tentukan tindakan yang perlu diterapkan ke entity.

Catatan: Nilai "Block And Remediate" hanya didukung untuk entity filehash.

Keparahan DDL

Tinggi

Nilai yang Mungkin Muncul:

  • Tinggi
  • Sedang
  • Rendah
  • Informatif
Ya Tentukan tingkat keparahan untuk entity yang ditemukan.
Aplikasi String T/A Tidak Tentukan aplikasi yang terkait dengan entity.
Judul Pemberitahuan Indikator String T/A Ya Tentukan judul untuk pemberitahuan, jika diidentifikasi di lingkungan.
Deskripsi String Remediasi Google SecOps Ya Tentukan deskripsi untuk entity.
Tindakan yang Disarankan String T/A Tidak Tentukan tindakan yang disarankan untuk penanganan entity.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Alamat IP
  • URL
  • Filehash

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika data tersedia untuk satu entitas (is_success = true): "Successfully submitted the following entities as indicators to Microsoft Defender for Endpoint: {entity.identifier}".

Jika data tidak tersedia untuk satu entitas (is_success=true): "Action wasn't able to submit the following entities as indicators to Microsoft Defender for Endpoint: {entity.identifier}".

Jika kode status 403 dilaporkan untuk satu entitas: "Instance doesn't have enough permissions to submit for the following entities: {entity.identifier}

Jika data tidak tersedia untuk semua entitas (is_success=false): "None of the provided entities were submitted as indicators to Microsoft Defender for Endpoint."

Jika entity sudah menjadi indikator: "The following entities are already indicators in Microsoft Defender for Endpoint: {entity.identifier}"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Submit Entity Indicators". Reason: {0}''.format(error.Stacktrace)

Jika kode status 403 dilaporkan untuk semua entitas: "Error executing action "Submit Entity Indicators". Alasan: tidak ada indikator yang dibuat karena izin instance, periksa konfigurasinya.''.

Umum

Unisolate Machine

Membatalkan isolasi mesin yang sebelumnya diisolasi menggunakan Microsoft Defender for Endpoint.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
Komentar String T/A Ya Tentukan komentar yang menjelaskan alasan mesin perlu dibatalkan isolasinya.
Buat Insight? Kotak centang Dicentang Jika diaktifkan, tindakan ini akan membuat Insight Google SecOps dengan informasi terkait jika berhasil dijalankan.

Kasus penggunaan

Tindakan ini dapat digunakan untuk situasi saat mesin sudah diisolasi, tetapi dengan data baru yang dikumpulkan selama pemrosesan playbook (misalnya, mesin pertama diisolasi, selanjutnya kita membuat indikator ancaman untuk file yang mencurigakan, dan menjalankan tindakan "Hentikan dan Karantina" untuk menghapus file ini dari mesin yang terpengaruh), kita dapat menganggap aman untuk menghapus mesin yang terpengaruh dari isolasi.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Host
  • Alamat IP

Hasil tindakan

Hasil skrip

Benar jika Endpoint API yang ditampilkan untuk setiap entity yang disediakan tempatnya dijalankan, status 201, dalam Respons JSON "status": "Pending", yang menunjukkan bahwa permintaan API berhasil dijalankan. Jika tindakan gagal untuk setidaknya satu entitas, hasil akhirnya akan gagal (False).

Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
    "id": "example-id",
    "type": "Unisolate",
    "requestor": "requestor-id",
    "requestorComment": "Unisolate machine due to the following remediation measures taken...",
    "status": "Pending",
    "machineId": "machine-id",
    "creationDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
    "lastUpdateDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
    "cancellationRequestor": null,
    "cancellationComment": null,
    "cancellationDateTimeUtc": null,
    "errorHResult": 0,
    "scope": null,
    "relatedFileInfo": null
}
Insight
  • Type: Entity
  • Title: entity.
  • IdentifierMessage: Isolasi Microsoft Defender for Endpoint telah dihapus.

Perbarui Notifikasi

Mengupdate Pemberitahuan Microsoft Defender for Endpoint tertentu. Tindakan ini dapat digunakan untuk menutup pemberitahuan di Microsoft Defender for Endpoint.

Parameter

Parameter Jenis Nilai Default Is Mandatory Deskripsi
ID pemberitahuan String T/A Ya Tentukan ID Pemberitahuan Microsoft Defender for Endpoint yang akan diupdate.
Status DDL

Baru

Nilai yang Mungkin Muncul:

  • Baru
  • InProgress
  • Selesai
Tidak Tentukan status pemberitahuan yang akan diperbarui.
Ditetapkan Ke String T/A Tidak Tentukan info pengguna jika Anda ingin memperbarui kolom ini.
Klasifikasi DDL

Tidak diketahui

Nilai yang Mungkin Muncul:

  • Tidak diketahui
  • FalsePositive
  • TruePositive
Tidak Tentukan klasifikasi untuk memperbarui notifikasi.
Penentuan DDL

NotAvailable

Nilai yang Mungkin Muncul:

  • NotAvailable
  • Apt
  • Malware
  • SecurityPersonnel
  • SecurityTesting
  • UnwantedSoftware
  • Lainnya
Tidak Tentukan keputusan untuk memperbarui pemberitahuan.

Kasus penggunaan

  • Gunakan tindakan untuk memperbarui peringatan Defender ATP.

  • Gunakan tindakan untuk mengintervensi alur kerja yang melibatkan analisis peringatan Defender ATP.

    Setelah pemberitahuan diproses di Google SecOps, Anda dapat mengabaikan pemberitahuan Defender ATP agar daftar pemberitahuan Defender ATP dan Google SecOps tetap selaras. Selain itu, Anda dapat mengubah notifikasi untuk menampilkan progres analisis notifikasi (misalnya, menetapkan atribut assignedTo atau menetapkan status notifikasi ke inProgress).

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts/$entity",
    "id": "example-id",
    "incidentId": 1,
    "investigationId": null,
    "assignedTo": null,
    "severity": "Informational",
    "status": "Resolved",
    "classification": null,
    "determination": null,
    "investigationState": "UnsupportedAlertType",
    "detectionSource": "WindowsDefenderAtp",
    "category": "Execution",
    "threatFamilyName": null,
    "title": "[Test Alert] Suspicious Powershell commandline",
    "description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
    "alertCreationTime": "2019-11-18T11:17:48.287421Z",
    "firstEventTime": "2019-11-18T11:15:06.5226815Z",
    "lastEventTime": "2019-11-18T11:15:06.5226815Z",
    "lastUpdateTime": "2019-11-20T04:12:03.6066667Z",
    "resolvedTime": "2019-11-20T04:12:03.4976288Z",
    "machineId": "machine-id",
    "alertUser": {
        "accountName": "Administrator",
        "domainName": "example-domain"
    },
    "comments": [],
    "alertFiles": [
        {
            "sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
            "sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
            "filePath": "C:\\Windows\\System32\\cmd.exe",
            "fileName": "cmd.exe"
        },
        {
            "sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
            "sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
            "filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
            "fileName": "powershell.exe"
        }
    ],
    "alertDomains": [],
    "alertIps": [],
    "alertProcesses": []
}

Menunggu Status Tugas

Menunggu status tugas.

Parameter

Parameter Display Name Jenis Nilai Default Is Mandatory Deskripsi
ID Tugas String T/A Ya Daftar ID tugas sebagai string yang dipisahkan koma.

Dijalankan pada

Tindakan ini berjalan di semua entity.

Hasil tindakan

Hasil skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
[
    {
        "status": "Succeeded",
        "creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
        "cancellation_requestor": null,
        "cancellation_date_time_utc": null,
        "id": "2e39d22e-60a7-4267-899c-a1471e800000",
        "last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
        "related_file_info": null,
        "cancellation_comment": null,
        "requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
        "error_h_result": 0,
        "scope": "Selective",
        "machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
        "type": "Isolate",
        "requestor_comment": "test"
    }
]

Konektor

Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi konektor di Google SecOps, lihat Mengonfigurasi konektor.

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

Konektor Microsoft Defender ATP

Defender ATP SIEM API yang digunakan di Microsoft Defender ATP Connector untuk peristiwa tidak digunakan lagi mulai 1 Maret 2022.

Konektor secara berkala terhubung ke endpoint API Defender ATP dan mengambil daftar pemberitahuan yang dihasilkan untuk jangka waktu tertentu. Untuk pemberitahuan yang diproses, konektor dalam permintaan terpisah akan mengambil informasi tentang deteksi dari Defender ATP. Deteksi memiliki kolom AlertId yang dapat digunakan untuk mengaitkan deteksi dengan pemberitahuan tertentu.

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Nama Kolom Produk String ProductName Ya Menjelaskan nama kolom tempat nama produk disimpan.
Nama Kolom Peristiwa String AlertName Ya Menjelaskan nama kolom tempat nama peristiwa disimpan.
Nama Kolom Lingkungan String "" Tidak

Menjelaskan nama kolom tempat nama lingkungan disimpan.

Jika kolom lingkungan tidak ditemukan, lingkungan adalah "".

Pola Regex Lingkungan String .* Tidak

Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom Environment Field Name.

Defaultnya adalah .* untuk menangkap semua dan menampilkan nilai yang tidak berubah.

Digunakan untuk memungkinkan pengguna memanipulasi kolom lingkungan menggunakan logika ekspresi reguler.

Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah "".

Root API String https://api.securitycenter.windows.com Ya

URL root API yang akan digunakan dengan integrasi.

Untuk performa yang lebih baik, Anda dapat menggunakan server yang paling dekat dengan lokasi Anda:

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com
ID Azure Active Directory String T/A Ya ID Tenant Microsoft Entra, dapat dilihat di Active Directory > App Registration > Aplikasi Anda > Directory (tenant) ID.
ID Klien Integrasi String T/A Ya ID Klien (Aplikasi) yang ditambahkan untuk pendaftaran aplikasi di Microsoft Entra untuk integrasi.
Rahasia Klien Integrasi Sandi T/A Ya Rahasia yang dimasukkan untuk pendaftaran aplikasi Azure AD untuk integrasi.
Client ID SIEM String T/A Ya Client (Application) ID untuk integrasi SIEM yang diaktifkan di Microsoft Defender for Endpoint.
Rahasia Klien SIEM Sandi T/A Ya Rahasia untuk integrasi SIEM yang diaktifkan di Microsoft Defender for Endpoint.
Waktu Offset Dalam Jam Bilangan bulat 24 Ya Mengambil pemberitahuan dari X jam ke belakang.
Pemberitahuan Maksimum Per Siklus Bilangan bulat 100 Ya Jumlah pemberitahuan yang diproses selama satu operasi konektor.
Status Pemberitahuan yang akan diambil String Unknown, New, InProgress, Resolved Ya

Tentukan status pemberitahuan Defender ATP yang harus diambil oleh server Google SecOps.

Parameter dapat mengambil beberapa nilai sebagai string yang dipisahkan koma.

Tingkat Keparahan Pemberitahuan yang akan diambil String UnSpecified, Informational, Low, Medium, High Ya

Tentukan tingkat keparahan pemberitahuan Defender ATP yang harus diambil oleh server Google SecOps.

Parameter dapat mengambil beberapa nilai sebagai string yang dipisahkan koma.

Alamat Server Proxy IP_OR_HOST T/A Tidak Server proxy yang akan digunakan untuk koneksi.
Nama Pengguna Server Proxy String T/A Tidak Nama pengguna server proxy.
Sandi Server Proxy Sandi T/A Tidak Sandi server proxy.

Aturan konektor

  • Konektor tidak mendukung aturan daftar yang tidak diizinkan atau daftar dinamis.

  • Konektor mendukung proxy.

Microsoft Defender ATP Connector V2

Ambil pemberitahuan Defender ATP menggunakan API insiden 365 Defender untuk mendapatkan data peristiwa. Gunakan daftar dinamis konektor untuk menyerap hanya jenis pemberitahuan tertentu berdasarkan nilai atribut detectionSource pemberitahuan.

Atribut SourceGroupIdentifier konektor dapat digunakan untuk mengelompokkan pemberitahuan berdasarkan ID insiden Defender ATP.

Prasyarat

Sebelum mengonfigurasi konektor, pastikan untuk memberikan izin tambahan ke aplikasi Microsoft Entra Anda:

  1. Login ke portal Azure sebagai administrator pengguna atau administrator sandi.

  2. Pilih Microsoft Entra ID.

  3. Buka API Permissions > Add a permission > APIs my organization uses.

  4. Pilih Microsoft Threat Protection > Application permissions.

  5. Di bagian Select Permissions, pilih izin yang diperlukan berikut:

    • Incident.Read.All
    • Incident.ReadWrite.All
  6. Klik Add permissions.

  7. Klik Grant admin consent for YOUR_ORGANIZATION_NAME.

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Nama Kolom Produk String :: Ya Menjelaskan nama kolom tempat nama produk disimpan.
Nama Kolom Peristiwa String EventName Ya Menjelaskan nama kolom tempat nama peristiwa disimpan.
Nama Kolom Lingkungan String "" Tidak

Menjelaskan nama kolom tempat nama lingkungan disimpan.

Jika kolom lingkungan tidak ditemukan, lingkungan adalah "".

Pola Regex Lingkungan String .* Tidak

Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom Environment Field Name.

Defaultnya adalah .* untuk menangkap semua dan menampilkan nilai yang tidak berubah.

Digunakan untuk memungkinkan pengguna memanipulasi kolom lingkungan menggunakan logika ekspresi reguler.

Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah "".

Root API Defender ATP String https://api.securitycenter.windows.com Ya

URL root API yang akan digunakan dengan integrasi

Untuk performa yang lebih baik, Anda dapat menggunakan server yang paling dekat dengan lokasi Anda:

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com
Root API 365 Defender String https://api.security.microsoft.com Ya Root API instance Microsoft 365 Defender yang digunakan untuk mendapatkan data peristiwa Google SecOps.
ID Azure Active Directory String T/A Ya ID Tenant Microsoft Entra yang dapat ditemukan di Microsoft Entra > App Registration > Your application > Directory (tenant) ID.
ID Klien Integrasi String T/A Ya ID Klien (Aplikasi) yang ditambahkan untuk pendaftaran aplikasi di Microsoft Entra untuk integrasi.
Rahasia Klien Integrasi Sandi T/A Ya Rahasia yang dimasukkan untuk pendaftaran aplikasi Azure AD untuk integrasi.
Verifikasi SSL Kotak centang Dicentang Ya Jika diaktifkan, setelan ini akan memverifikasi bahwa sertifikat SSL untuk koneksi ke server Microsoft 365 Defender valid.
Waktu Offset Dalam Jam Bilangan bulat 24 Ya Mengambil pemberitahuan dari X jam ke belakang.
Pemberitahuan Maksimum Per Siklus Bilangan bulat 10 Ya Jumlah pemberitahuan yang diproses selama satu operasi konektor.
Status Pemberitahuan yang akan diambil String Unknown, New, InProgress, Resolved Ya

Tentukan status pemberitahuan Defender ATP yang harus diambil oleh server Google SecOps.

Parameter dapat mengambil beberapa nilai sebagai string yang dipisahkan koma.

Tingkat Keparahan Pemberitahuan yang akan diambil String UnSpecified, Informational, Low, Medium, High Ya

Tentukan tingkat keparahan pemberitahuan Defender ATP yang harus diambil oleh server Google SecOps.

Parameter dapat mengambil beberapa nilai sebagai string yang dipisahkan koma.

Menonaktifkan Overflow Kotak centang Tidak dicentang Tidak Jika diaktifkan, konektor akan mengabaikan mekanisme tambahan.
Waktu Tunggu Skrip Bilangan bulat 300 Ya Tentukan waktu tunggu untuk menjalankan konektor.
Menggunakan daftar yang diizinkan sebagai daftar yang tidak diizinkan Kotak centang Tidak dicentang Tidak Jika diaktifkan, daftar dinamis akan digunakan sebagai daftar yang tidak diizinkan.
Alamat Server Proxy IP_OR_HOST T/A Tidak Server proxy yang akan digunakan untuk koneksi.
Nama Pengguna Server Proxy String T/A Tidak Nama pengguna server proxy.
Sandi Server Proxy Sandi T/A Tidak Sandi server proxy.

Aturan konektor

Konektor ini mendukung logika daftar dinamis berdasarkan nilai kolom pemberitahuan detectionSource Defender ATP.

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