Tüm Ürünler
Search

Bu Ürün

    API Gateway:Tüketici Yönetimi

    Belge Merkezi

    API Gateway:Tüketici Yönetimi

    Son Güncelleme:Oct 04, 2026

    Cloud-native API Gateway, rotalar ve API'ler için kimlik doğrulamayı etkinleştirmek üzere tüketicileri kullanır. Konsolda tüketici oluşturabilir, devre dışı bırakabilir ve silebilirsiniz.

    Tüketici oluşturma

    Cloud-native API Gateway üç kimlik doğrulama yöntemi sunar.


    Yöntem


    Açıklama


    Kullanım Senaryosu


    API Key


    İstemci, isteğe bir kimlik bilgisi ekler. Ağ geçidi bu bilginin geçerliliğini ve izinlerini doğrular. JWT veya AK/SK yöntemlerine göre daha az güvenlidir. Kimlik bilgilerinizi dikkatli şekilde koruyun.


    Düşük güvenlik gereksinimine sahip, hafif ve hızlı entegrasyon senaryoları.


    JWT


    JWT, istemci ile sunucu arasında HMAC, RSA veya ECDSA imzaları kullanarak bilgiyi güvenli şekilde iletmek için kullanılan bir standarttır. Ağ geçidinde kimlik doğrulama ve erişim kontrolü için JWT kullanın.


    Dağıtık sistemler ve tek oturum açma (SSO) senaryoları için uygundur.


    HMAC


    İstemci, bir AK/SK çifti kullanarak istek içeriğini HMAC algoritmasıyla imzalar ve ardından imzayı doğrulanmak üzere ağ geçidine gönderir.


    Yüksek veri bütünlüğü ve kurcalamaya karşı koruma gerektiren senaryolar.

    API Key kimlik doğrulaması ile tüketici oluşturma

    1. Cloud-native API Gateway konsolunda Tüketiciler sayfasına gidin ve bir bölge seçin.

    2. Create a consumer seçeneğine tıklayın. Tüketici Oluştur panelinde Consumer Name alanını belirtin, kimlik doğrulama yöntemi olarak API Key seçeneğini belirleyin ve aşağıdaki yapılandırmaları tamamlayın:

      • Oluşturma Yöntemi:

        • System Generated: Sistem sizin için otomatik olarak bir API anahtarı oluşturur.

        • Custom: Özel bir API anahtarı ve kaynağını belirtin.

      • Kimlik Bilgisi: Özel API anahtarı.

      • Kimlik Bilgisi Kaynağı:

        Ağ geçidinin API anahtarını aldığı istek konumu:

        • Authorization: Bearer <token> (Standart belirteç formatı)

        • Özel HTTP Başlığı (örneğin X-API-Key: your-key)

        • Özel Sorgu Parametresi (örneğin ?apikey=your-key)

    JWT kimlik doğrulaması ile tüketici oluşturma

    1. Cloud-native API Gateway konsolunda Tüketiciler sayfasına gidin ve bir bölge seçin.

    2. Create a consumer seçeneğine tıklayın. Tüketici Oluştur panelinde Consumer Name alanını belirtin, kimlik doğrulama yöntemi olarak JSON Web Token (JWT) seçeneğini belirleyin ve aşağıdaki yapılandırmaları tamamlayın:

      • Oluşturma Yöntemi:

        • Local Configuration: Kimlik doğrulama hizmeti ve ağ geçidi aynı küme veya yerel ağ içindeyse, performans gereksinimleri yüksekse ve anahtarlar nadiren değişiyorsa kullanın.

        • Remote Fetch: OAuth2 veya OpenID Connect gibi merkezi bir kimlik sağlayıcı ile birlikte kullanın. Dinamik anahtar güncellemelerini destekler. Çok kiracılı veya üretim ortamları için idealdir.

      • Anahtar Türü (Uzaktan Getir için gerekli değildir):

        • Symmetric Key: Her tüketici için benzersiz olan, belirtecin şifrelenmesi ve çözülmesinde kullanılan anahtarı içeren varsayılan bir JWKS yapılandırması oluşturur.

        • Asymmetric Key: Eksiksiz bir JWKS yapılandırması sağlayın ve belirteci şifrelemek için özel anahtar kullanın. Ağ geçidi, JWKS içindeki genel anahtarla şifreyi çözer.

      • JWKS:

        • Yerel Yapılandırma seçeneğini belirlerseniz, JWKS yapılandırmasını JSON Web Key (JWK) standardına göre ayarlayın.

        • Uzaktan Getir seçeneğini belirlerseniz URL'i girin. Sistem, bağlantı noktası numarasını, zaman aşımı süresini ve önbellek süresini URL'den otomatik olarak ayrıştırır.

          Önemli

          URL bir IP adresi değil, bir alan adı olmalıdır.

      • JWT Belirteci: JWT belirteci yapılandırmasını ayarlayın.

        • Type: Belirteç parametresinin türü. Varsayılan değer Header'dır.

        • Anahtar: Belirteç parametre adı.

        • Prefix: Belirteç parametresi öneki. Varsayılan olarak Bearer önekiyle birlikte Authorization başlığını kullanır; örneğin, Authorization: Bearer token.

        • Enable Passthrough: Belirteç parametresini arka uç hizmetine iletir.

      • JWT Yükündeki Tüketici Kimliği: Tüketiciyi tanımlayan JWT yükündeki bir anahtar-değer çifti. Varsayılan olarak uid rastgele bir dize değeriyle ayarlanır. Özelleştirilebilir. Örnek yük:

        {
  "uid": "11215ac069234abcb8944232b79ae711"
}

    HMAC kimlik doğrulaması ile tüketici oluşturma

    1. Cloud-native API Gateway konsolunda Tüketiciler sayfasına gidin ve bir bölge seçin.

    2. Create a consumer seçeneğine tıklayın. Tüketici Oluştur panelinde Consumer Name alanını belirtin, kimlik doğrulama yöntemi olarak Hash-based Message Authentication Code (HMAC) seçeneğini belirleyin ve aşağıdaki yapılandırmaları tamamlayın:

      • System Generated: Sistem sizin için Access Key (AK) ve Secret Key (SK) anahtarlarını otomatik olarak oluşturur.

      • Custom: Özel bir AK ve SK belirtin.

    Tüketiciyi devre dışı bırakma

    1. API Gateway konsolu üzerinden oturum açın.

    2. Sol gezinme bölmesinde Consumers seçeneğine tıklayın. Üst gezinme çubuğunda bir bölge seçin.

    3. Consumers sayfasında hedef tüketiciyi bulun, Actions sütunundaki Disable seçeneğine tıklayın ve onaylamak için OK seçeneğine tıklayın.

    Tüketici silme

    1. API Gateway konsolu üzerinden oturum açın.

    2. Sol gezinme bölmesinde Consumers seçeneğine tıklayın. Üst gezinme çubuğunda bir bölge seçin.

    3. Consumers sayfasında hedef tüketiciyi bulun ve Actions sütunundaki Delete seçeneğine tıklayın. Onay iletişim kutusunda tüketici adını girin ve Delete seçeneğine tıklayın.