Mengelola token API

Defender for Cloud Apps mengekspos sebagian besar data dan tindakannya melalui serangkaian API terprogram. API tersebut akan memungkinkan Anda mengotomatiskan alur kerja dan berinovasi berdasarkan kemampuan Defender for Cloud Apps.

Untuk mengakses API Defender for Cloud Apps, Anda harus membuat token API dan menggunakannya di perangkat lunak Anda untuk terhubung ke API. Token ini akan disertakan dalam header ketika Defender for Cloud Apps membuat permintaan API.

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

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

  • Membuat aplikasi Microsoft Entra
  • Dapatkan token akses menggunakan aplikasi ini
  • Gunakan token untuk mengakses API Defender for Cloud Apps

Anda dapat mengakses API Defender for Cloud Apps dengan Konteks Aplikasi atau Konteks Pengguna.

Note

Metode warisan untuk mengakses API Defender for Cloud Apps masih didukung. Namun, itu berada di jalur penghentian, jadi sebaiknya gunakan metode yang dijelaskan di halaman ini.

Digunakan oleh aplikasi yang berjalan tanpa ada pengguna yang masuk. Misalnya, aplikasi yang berjalan sebagai layanan latar belakang atau daemon.

Langkah-langkah yang perlu diambil untuk mengakses API Defender for Cloud Apps dengan konteks aplikasi:

  1. Buat Microsoft Entra Web-Application.
  2. Tetapkan izin yang diinginkan ke aplikasi. Misalnya, Baca Pemberitahuan atau Unggah Laporan Penemuan.
  3. Buat kunci untuk aplikasi ini.
  4. Dapatkan token menggunakan aplikasi dengan kuncinya.
  5. Gunakan token untuk mengakses API Defender for Cloud Apps.

Untuk langkah-langkah lebih rinci tentang cara melakukan langkah-langkah ini, lihat Mendapatkan akses dengan konteks aplikasi.

Konteks pengguna

Digunakan untuk melakukan tindakan di API atas nama pengguna.

Langkah-langkah yang harus diambil untuk mengakses API Defender for Cloud Apps dengan konteks aplikasi:

  1. Buat Microsoft Entra Native-Application.
  2. Tetapkan izin yang diinginkan ke aplikasi. Misalnya, Baca Pemberitahuan atau Unggah Laporan Penemuan.
  3. Dapatkan token menggunakan aplikasi dengan kredensial pengguna.
  4. Gunakan token untuk mengakses API Defender for Cloud Apps.

Untuk langkah-langkah lebih rinci tentang cara melakukan langkah ini, lihat Mendapatkan akses dengan konteks pengguna.

  • Last updated on