Mendapatkan token Azure Active Directory (Azure AD) dan menggunakannya untuk mengirim pesan ke antrean Azure Service Bus

Lihat Mengautentikasi dari aplikasi untuk gambaran umum mendapatkan token Azure Active Directory (Azure AD).

Artikel ini memberi Anda contoh mendapatkan token Azure AD yang dapat Anda gunakan untuk mengirim pesan ke namespace Service Bus. Ini menggunakan alat Postman untuk tujuan pengujian.

Prasyarat

• Ikuti instruksi dari Mulai Cepat: Gunakan portal Azure untuk membuat antrean Bus Layanan untuk membuat namespace Bus Layanan dan antrean di namespace layanan.
• Unduh dan instal aplikasi desktop Postman .

Daftarkan aplikasi Anda dengan Azure AD

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

1. Masuk ke portal Microsoft Azure.

2. Di bilah pencarian, cari Azure Active Directory, dan pilih dari daftar drop-down.

   

3. Pada halaman Azure Active Directory , pilih tautan Pendaftaran Aplikasi di menu sebelah kiri, lalu pilih + Pendaftaran baru pada toolbar.

   

4. Masukkan nama untuk aplikasi, dan pilih Daftar.

   

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

   

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

   

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

   

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

   

Menambahkan aplikasi ke peran Pengirim Data Azure Service Bus

Dalam contoh ini, kami hanya mengirim pesan ke antrean Bus Layanan, jadi tambahkan aplikasi ke peran Pengirim Data Azure Service Bus .

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

   

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

   

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

Menggunakan Postman untuk mendapatkan token Azure AD

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 .

   

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://servicebus.azure.net untuk nilai .

      

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

   

Mengirim pesan ke antrean

1. Di Postman, buka tab baru.

2. Pilih POST untuk metode .

3. Masukkan URI dalam format berikut: https://<SERVICE BUS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. Ganti <SERVICE BUS NAMESPACE NAME> dengan nama namespace Bus Layanan. 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 Azure AD>. 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.

      

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

   

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

   

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

   

   Anda juga dapat menggunakan Service Bus Explorer (pratinjau) pada halaman Antrean Bus Layanan seperti yang ditunjukkan pada gambar berikut untuk menerima atau mengintip pesan.

   

Lihat juga

Lihat artikel berikut ini:

• Mengautentikasi dari aplikasi
• Platform identitas Microsoft dan alur kode otorisasi OAuth 2.0