Alıştırma - Abonelik anahtarıyla API çağırma

  • 5 dakika

Abonelik anahtarı, BIR API'ye erişimi kısıtlamanın bir yoludur.

Ayakkabı şirketi örneğinde NorthWind Shoes bir tedarikçiyle çalışmakta ve Stok API'sine doğrudan erişim vermek istemektedir. İş ortağı erişimi, API'ye yapılan tüm çağrılar için abonelik anahtarı kullanılarak kısıtlanmalıdır.

Burada API'niz için bir abonelik anahtarı alırsınız. Ardından, abonelik anahtarıyla ve abonelik anahtarı olmadan API'ye erişimi test edebilirsiniz.

Abonelik anahtarını alma

Sisteme dahil edilen iş ortaklarına anahtar verilmektedir. Bu alıştırmada, özellikle NorthWindShoes API'sine yönelik bir abonelik ekleyebilirsiniz. Anahtarı aldıktan sonra, API çağrılarında anahtarı kullanmak için standart bir işlemi izlersiniz.

  1. Azure portalı menüsünde veya Giriş sayfasında Tüm kaynaklar'ı ve ardından API Management örneğinizi seçin.

  2. Sol menü bölmesindeki API'ler'in altında Abonelikler'i seçin.

  3. + Abonelik'i seçin ve her ayar için aşağıdaki değerleri girin. Daha sonra, Oluştur'u seçin.

    Ayar Değer
    Veri Akışı Adı NorthWind
    Display name NorthWind subscription
    Scope API'yi ve ardından açılan listeden NorthWindShoes Ürünleri'ni seçin.

  4. Northwind aboneliği için bağlam menüsünü (...) ve ardından Anahtarları göster/gizle'yi seçin.

  5. BİrİnCİl ANAHTAR için Kopyalamak için tıklayın düğmesini seçin.

  6. Bu anahtarı Not Defteri gibi bir yere kaydedin.

API çağrısında abonelik anahtarı kullanma

Bir sonraki adım, yayımladığınız API'ye geliştirici erişimini test etmek için abonelik anahtarını kullanmaktır.

  1. Cloud Shell'de aşağıdaki komutu çalıştırarak <apim gateway> API'nizdeki Ürünler işlemine erişin ve yerine ağ geçidinizin adını yazın.

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

    Abonelik anahtarı iletisi eksik olduğundan 401, Erişim reddedildi iletisini alırsınız.

  2. Şimdi bu kez abonelik anahtarınızı da dahil olmak üzere curl isteğinizi yineleyin.

  3. Cloud Shell'de aşağıdaki komutu çalıştırın; öğesini <primary key> daha önce kaydettiğiniz anahtarla ve değerini ağ geçidinizin adıyla değiştirerek <apim gateway> çalıştırın.

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

    Şimdi API'ye erişebilmeniz ve konsola ürün listesinin döndürülmesi gerekir.