Mendapatkan token Microsoft Entra dan menggunakannya untuk mengirim peristiwa ke pusat aktivitas

  • Artikel

Lihat Mengautentikasi dari aplikasi untuk gambaran umum mendapatkan token Microsoft Entra.

Artikel ini memberi Anda contoh mendapatkan token Microsoft Entra yang dapat Anda gunakan untuk mengirim peristiwa ke dan menerima peristiwa dari namespace Azure Event Hubs. Ini menggunakan alat Postman untuk tujuan pengujian.

Prasyarat

Daftarkan aplikasi Anda dengan Microsoft Entra ID

Langkah pertama adalah mendaftarkan aplikasi Anda dengan penyewa Microsoft Entra dan mencatat nilai ID penyewa, ID klien, dan rahasia klien. Anda menggunakan nilai-nilai ini terbaru saat menguji REST API menggunakan alat Postman.

  1. Masuk ke portal Microsoft Azure.

  2. Di bilah pencarian, cari Microsoft Entra ID, dan pilih dari daftar drop-down.

  3. Pada halaman Microsoft Entra ID, pilih tautan Pendaftaran Aplikasi di menu sebelah kiri, lalu pilih + Pendaftaran baru pada toolbar.

    Cuplikan layar memperlihatkan halaman Pendaftaran Aplikasi dengan tautan Pendaftaran baru dipilih.

  4. Masukkan nama untuk aplikasi, dan pilih Daftar.

    Cuplikan layar memperlihatkan halaman Daftarkan aplikasi.

  5. Pada beranda aplikasi, catat nilai ID Aplikasi (klien) dan ID Direktori (penyewa). Anda menggunakan nilai-nilai ini untuk mendapatkan token dari Microsoft Entra ID.

    Cuplikan layar memperlihatkan halaman beranda dengan ID klien dan ID penyewa disorot.

  6. Sekarang, pilih Sertifikat & rahasia di menu sebelah kiri, dan pilih + Rahasia klien baru.

    Cuplikan layar memperlihatkan halaman Sertifikat & Rahasia.

  7. Masukkan deskripsi, pilih kapan rahasia akan kedaluwarsa, dan pilih Tambahkan.

    Cuplikan layar memperlihatkan deskripsi, pilih waktu kedaluwarsa, dan tombol Tambahkan.

  8. Pilih tombol salin di samping nilai rahasia dalam daftar Rahasia klien untuk menyalin nilai ke clipboard. Tempelkan di suatu tempat. Anda menggunakannya nanti untuk mendapatkan token dari Microsoft Entra ID.

    Cuplikan layar memperlihatkan tombol rahasia klien.

Menambahkan aplikasi ke peran Pengirim Data Azure Event Hubs

Dalam contoh ini, kami hanya mengirim pesan ke pusat aktivitas, jadi tambahkan aplikasi ke peran Azure Event Hubs Pengirim Data.

  1. Pada halaman Namespace Layanan Pusat Aktivitas , pilih Kontrol akses dari menu sebelah kiri, lalu pilih Tambahkan pada petak Tambahkan penetapan peran .

    Cuplikan layar memperlihatkan halaman Access Control.

  2. Pada halaman Tambahkan penetapan peran, pilih Azure Event Hubs Pengirim Data untuk Peran, dan pilih aplikasi Anda (dalam contoh ini, ServiceBusRestClientApp) untuk perwakilan layanan.

    Cuplikan layar memperlihatkan penambahan aplikasi ke peran Pengirim Data Azure Event Hubs.

  3. Pilih Simpan di halaman Tambahkan penetapan peran untuk menyimpan penetapan peran.

Menggunakan Postman untuk mendapatkan token Microsoft Entra

  1. Luncurkan Postman.

  2. Untuk metode , pilih GET.

  3. Untuk URI, masukkan https://login.microsoftonline.com/<TENANT ID>/oauth2/token. Ganti <TENANT ID> dengan nilai ID penyewa yang Anda salin sebelumnya.

  4. Pada tab Header , tambahkan kunci Jenis Konten dan application/x-www-form-urlencoded untuk nilai .

    Cuplikan layar memperlihatkan header jenis konten.

  5. Beralih ke tab Isi , dan tambahkan kunci dan nilai berikut.

    1. Pilih data formulir.

    2. Tambahkan grant_type kunci, dan ketik client_credentials untuk nilai .

    3. Tambahkan client_id kunci, dan tempelkan nilai ID klien yang Anda catat sebelumnya.

    4. Tambahkan client_secret kunci, dan tempelkan nilai rahasia klien yang Anda catat sebelumnya.

    5. Tambahkan resource kunci, dan ketik https://eventhubs.azure.net untuk nilai .

      Cuplikan layar memperlihatkan isi untuk permintaan.

  6. Pilih Kirim untuk mengirim permintaan untuk mendapatkan token. Anda melihat token dalam hasilnya. Simpan token (tidak termasuk tanda kutip ganda). Anda menggunakannya nanti.

    Cuplikan layar memperlihatkan token akses dari Microsoft Entra.

Mengirim peristiwa ke pusat aktivitas

  1. Di Postman, buka tab baru.

  2. Pilih POST untuk metode .

  3. Masukkan URI dalam format berikut: https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Ganti <EVENT HUBS NAMESPACE NAME> dengan nama namespace layanan Azure Event Hubs. Ganti <QUEUE NAME> dengan nama antrean.

  4. Pada tab Header , tambahkan dua header berikut ini.

    1. Tambahkan Authorization kunci dan nilai untuknya dalam format berikut: Bearer <TOKEN from Microsoft Entra ID>. Saat Anda menyalin/menempelkan token, jangan salin tanda kutip ganda yang diapit.

    2. Tambahkan Content-Type kunci dan application/atom+xml;type=entry;charset=utf-8 sebagai nilai untuk itu.

      Cuplikan layar tab Header yang ditekankan di hub peristiwa.

  5. Pada tab Isi , pilih mentah untuk jenis data, dan masukkan This is a message atau pesan apa pun untuk isi.

    Cuplikan layar peristiwa pengujian dalam tampilan Isi mentah di hub peristiwa.

  6. Pilih Kirim untuk mengirim pesan ke antrean. Anda melihat status seperti Created kode 201 seperti yang ditunjukkan pada gambar berikut.

    Cuplikan layar memperlihatkan status berhasil.

  7. Pada halaman namespace di portal Azure, Anda dapat melihat bahwa pesan diposting ke antrean.

    Cuplikan layar memperlihatkan pesan yang diposting ke antrean.

Lihat juga

Lihat artikel berikut ini: