Tüm Ürünler
Search
Belge Merkezi

API Gateway:Yetkilendirme yönetimi

Son Güncelleme:Oct 04, 2026

API yetkilendirmesi, bir uygulama ile bir API arasında ilişki kurar. Uygulama, bir API'yi çağırmak için kullanılan kimliktir ve söz konusu API'yi çağırabilmek için yetkilendirilmesi gerekir.

Ön koşullar

API kimlik doğrulama yöntemi Alibaba Cloud App authentication olarak ayarlanmıştır.

Uygulamalar

Uygulama, bir API'yi çağırmak için kullanılan kimliktir. Varsayılan olarak her uygulamanın AppKey ve AppSecret'tan oluşan bir anahtar çifti bulunur. AppKey'in istek üst bilgisinde parametre olarak geçirilmesi, AppSecret'in ise istek imzasını hesaplamak için kullanılması gerekir. İmzanın nasıl hesaplanacağı ve iletileceği hakkında daha fazla bilgi için bkz. Bir API'yi çağırmak için digest authentication kullanma.

  • AppKey ve AppSecret anahtar çifti, uygulamaya tam izinler sağlar. Bu anahtarları güvenli bir şekilde saklayın. Anahtarların yetkisiz kişilerin eline geçmesi durumunda API Gateway konsolunda sıfırlayabilirsiniz.

  • İş ihtiyaçlarınıza göre birden çok uygulama oluşturabilir ve bu uygulamaları farklı API'leri çağırmak üzere yetkilendirebilirsiniz. API'lerin Alibaba Cloud hesabı yerine uygulamalar için yetkilendirildiğini unutmayın.

  • API Gateway konsolunda uygulama oluşturabilir, değiştirebilir ve silebilir; ayrıntıları görüntüleyebilir; anahtarları yönetebilir ve yetkilendirilmiş API'leri görebilirsiniz.

  • Uygulamanın ayrıntılar sayfasından yeni AppKey ve AppSecret çiftleri ekleyebilirsiniz. Yeni anahtar çifti uygulamanın tüm izinlerine sahiptir ve silinebilir. Uygulamayı oluşturduğunuzda otomatik olarak oluşturulan varsayılan anahtar çifti silinemez.

Uygulama oluşturma

  1. API Gateway konsoluna gidin. Sol gezinme bölmesinde Call APIs > Apps seçeneğine tıklayın ve sağ üst köşede Create App öğesine tıklayın.

  2. Create App sayfasında bir App Name girin ve Create (Oluştur) düğmesine tıklayın.

Not

Uygulama oluştururken isteğe bağlı olarak etiketler ayarlayabilir, özel AK bilgileri sağlayabilir ve bir extension field yapılandırabilirsiniz.

  • Tag settings: Uygulamalarınızı düzenlemek için etiketleri kullanın.

  • Custom AK information: Uygulama oluştururken özel bir AppKey ve AppCode tanımlamanıza olanak tanır. Üretim ortamındaki bir uygulamanın AppKey ve AppCode değerlerini de değiştirebilirsiniz. Değişiklikler hemen etkili olur.

  • Extension field: Uygulama için bir uzantı alanı yapılandırmanıza olanak tanır. API Gateway bu alanı arka uç hizmetine CaAppExtInfo sistem parametresi olarak iletir.

    Önemli

    Ağustos 2023 öncesinde satın alınan özel örneklerde uzantı alanı etkili olmazsa örnek sürümünüzü yükseltmek için bir destek bileti gönderin.

Uygulamayı devre dışı bırakma

  1. API Gateway konsoluna gidin. Sol gezinme bölmesinde Call APIs > Apps seçeneğine tıklayın.

  2. Hedef uygulamaya tıklayarak Application Details sayfasına gidin. Ardından sağ üst köşede Disable App Authentication seçeneğine tıklayın.

    Not

    Devre dışı bırakılan bir uygulama artık yetkilendirildiği API'leri çağıramaz. Uygulamayı istediğiniz zaman yeniden etkinleştirerek API çağrılarına devam edebilirsiniz.

    Önemli

    Temmuz 2025 öncesinde satın alınan özel örneklerde bu özellik çalışmazsa örnek sürümünüzü yükseltmek için bir destek bileti gönderin.

API yetkilendirmesi

Yetkilendirme, bir uygulamaya API çağrısı yapma izni verme sürecidir. Bir uygulama API'yi çağırabilmek için öncelikle yetkilendirilmelidir.

  • Kendi uygulamalarınızı kendi API'lerinizi çağırmak üzere doğrudan yetkilendirebilirsiniz.

  • Uygulamalarınızı Alibaba Cloud Marketplace üzerinden satın aldığınız API'leri çağırmak üzere yetkilendirebilirsiniz. Bir uygulamanız yoksa Alibaba Cloud Marketplace, satın alma işlemi sırasında sizin için bir uygulama oluşturur ve bunu yetkilendirir. Daha fazla bilgi için Alibaba Cloud Marketplace konsoluna gidin.

  • Çevrim dışı bir anlaşma yoluyla bir iş ortağının API'sini (başka bir Alibaba Cloud hesabından) kullanmak için bir uygulama oluşturun ve uygulama kimliğini iş ortağına iletin. İş ortağı, kimliği arayarak uygulamanızı yetkilendirebilir.

Yordam

  1. API Gateway konsoluna gidin. Sol gezinme bölmesinde Manage APIs > APIs seçeneğine tıklayın, hedef API'yi bulun ve Actions sütununda image> Authorize seçeneğine tıklayın.

  2. Yetkilendirme sayfasında bir stage ve bir Authorization validity period seçin, ardından Choose apps for authorization altında yetkilendirmek istediğiniz uygulamayı seçin. Hesabınızdaki bir uygulamayı yetkilendirmek için My apps seçeneğini belirleyin ve hesabınızdaki tüm uygulamaları yüklemek için Search düğmesine tıklayın.

    Başka bir hesaptaki bir uygulamayı yetkilendirmek için App ID seçeneğini belirleyin, ilgili uygulama kimliğini metin kutusuna girin ve Search (Ara) düğmesine tıklayın.

    Önemli

    Kasım 2023 öncesinde satın alınan özel örneklerde yeni eklenen bir anahtar çifti etkili olmazsa örnek sürümünüzü yükseltmek için bir destek bileti gönderin. Uygulamayı oluşturduğunuzda otomatik olarak oluşturulan varsayılan anahtar çifti örnek sürümünden etkilenmez.