Latihan - Panggil API dengan kunci langganan

  • 5 menit

Kunci langganan adalah salah satu cara untuk membatasi akses ke API.

Dalam contoh perusahaan sepatu, NorthWind Shoes bekerja sama dengan pemasok dan ingin mereka langsung mengakses API Inventaris. Akses mitra harus dibatasi menggunakan kunci langganan untuk semua panggilan ke API.

Di sini, Anda mendapatkan kunci langganan untuk API Anda. Kemudian, Anda menguji akses ke API dengan dan tanpa kunci langganan.

Mendapatkan kunci langganan

Mitra mendapatkan kunci sebagai bagian dari proses orientasi. Dalam latihan ini, Anda menambahkan langganan khusus untuk NORTHWindShoes API. Setelah mendapatkan kunci, Anda mengikuti proses standar untuk menggunakan kunci dalam panggilan API.

  1. Pada menu portal Azure atau dari halaman Beranda, pilih Semua sumber daya, lalu pilih instans API Management Anda.

  2. Di panel menu kiri, di bawah bagian API, pilih Langganan.

  3. Pilih + Langganan, dan masukkan nilai berikut untuk setiap pengaturan. Lalu pilih Buat.

    Pengaturan Nilai
    Nama NorthWind
    Nama tampilan NorthWind subscription
    Scope Pilih API, lalu pilih NorthWindShoes Products dari daftar dropdown.

  4. Pilih menu konteks (...) untuk langganan Northwind, lalu pilih Perlihatkan/sembunyikan kunci.

  5. Pilih tombol Klik untuk menyalin untuk KUNCI PRIMER.

  6. Simpan kunci ini di suatu tempat, seperti Notepad.

Menggunakan kunci langganan dalam panggilan API

Langkah selanjutnya adalah menggunakan kunci langganan untuk menguji akses developer ke API yang diterbitkan.

  1. Jalankan perintah berikut di Cloud Shell untuk mengakses operasi Produk di API Anda, ganti <apim gateway> dengan nama gateway Anda.

    curl https://<apim gateway>.azure-api.net/api/Products

    Anda mendapatkan 401, Akses ditolak karena pesan kunci langganan hilang.

  2. Sekarang ulangi permintaan curl Anda, kali ini termasuk kunci langganan Anda.

  3. Jalankan perintah berikut ini di Cloud Shell, ganti <primary key> dengan kunci yang Anda simpan sebelumnya, dan ganti <apim gateway> dengan nama gateway Anda.

    curl --header "Ocp-Apim-Subscription-Key: <primary key>" https://<apim gateway>.azure-api.net/api/Products

    Anda sekarang dapat mengakses API, dan melihat daftar produk yang dikembalikan ke konsol.