Mengakses API Microsoft Defender XDR

Note

Coba API baru kami menggunakan API keamanan MS Graph. Cari tahu lebih lanjut di: Menggunakan API keamanan Microsoft Graph - Microsoft Graph | Microsoft Learn.

Penting

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat maupun tersirat, sehubungan dengan informasi yang diberikan di sini.

Microsoft Defender mengekspos sebagian besar data dan tindakannya melalui serangkaian API terprogram. API ini membantu Anda mengotomatiskan alur kerja dan memanfaatkan sepenuhnya kemampuan Microsoft Defender.

Secara umum, Anda harus mengambil langkah-langkah berikut untuk menggunakan API:

• Membuat aplikasi Microsoft Entra
• Dapatkan token akses menggunakan aplikasi ini
• Menggunakan token untuk mengakses API Microsoft Defender

Note

Akses API memerlukan autentikasi OAuth2.0. Untuk informasi selengkapnya, lihat Alur Kode Otorisasi OAuth 2.0.

Setelah menyelesaikan langkah-langkah ini, Anda siap untuk mengakses API Microsoft Defender menggunakan konteks tertentu.

Konteks aplikasi (Disarankan)

Gunakan konteks ini untuk aplikasi yang berjalan tanpa ada pengguna yang masuk, seperti layanan latar belakang atau daemon.

1. Buat aplikasi web Microsoft Entra.
2. Tetapkan izin yang diinginkan ke aplikasi.
3. Buat kunci untuk aplikasi.
4. Dapatkan token keamanan menggunakan aplikasi dan kuncinya.
5. Gunakan token untuk mengakses API Microsoft Defender.

Untuk informasi selengkapnya, lihat Membuat aplikasi untuk mengakses Microsoft Defender tanpa pengguna.

Konteks pengguna

Gunakan konteks ini untuk melakukan tindakan atas nama satu pengguna.

1. Buat aplikasi asli Microsoft Entra.
2. Tetapkan izin yang diinginkan ke aplikasi.
3. Dapatkan token keamanan menggunakan kredensial pengguna untuk aplikasi.
4. Gunakan token untuk mengakses API Microsoft Defender.

Untuk informasi selengkapnya, lihat Membuat aplikasi untuk mengakses API Microsoft Defender atas nama pengguna.

Konteks mitra

Gunakan konteks ini saat Anda perlu menyediakan aplikasi kepada banyak pengguna di beberapa penyewa.

1. Buat aplikasi multi-penyewa Microsoft Entra.
2. Tetapkan izin yang diinginkan ke aplikasi.
3. Dapatkan persetujuan admin untuk aplikasi dari setiap penyewa.
4. Dapatkan token keamanan menggunakan kredensial pengguna berdasarkan ID penyewa pelanggan.
5. Gunakan token untuk mengakses API Microsoft Defender.

Untuk informasi selengkapnya, lihat Membuat aplikasi dengan akses mitra ke API Microsoft Defender.

Artikel terkait

• Gunakan API keamanan Microsoft Graph - Microsoft Graph | Microsoft Pelajari

• Ringkasan API Microsoft Defender XDR

• Otorisasi OAuth 2.0 untuk masuk pengguna dan akses API

• Mengelola rahasia di aplikasi server Anda dengan Azure Key Vault

• Membuat aplikasi 'Halo dunia' yang mengakses API Microsoft 365

Tip

Apakah Anda ingin mempelajari lebih lanjut? Terlibatlah dengan komunitas Microsoft Security di Komunitas Teknologi kami: Microsoft Defender XDR Tech Community.