Alibaba Cloud API Gateway, istemci istekleri için Alibaba Cloud App kimlik doğrulaması, JWT eklentileri ve üçüncü taraf yetkilendirme dahil olmak üzere birden fazla kimlik doğrulama yöntemi sunar. Alibaba Cloud App kimlik doğrulaması için imza tabanlı kimlik doğrulama ve basit kimlik doğrulama (AppCode) olmak üzere iki yöntem arasından seçim yapabilirsiniz. Bu konuda basit kimlik doğrulamanın (AppCode) nasıl kullanılacağı açıklanmaktadır.
Dikkat edilmesi gerekenler
Basit kimlik doğrulama, karmaşık imzalama süreçlerine olan ihtiyacı ortadan kaldırır. Ancak, AppCode ağ üzerinden düz metin olarak iletildiği için bir güvenlik riski oluşturur.
İstemci ile API Gateway arasındaki iletişim için mutlaka HTTPS kullanmanız gerekir. Veri iletimi için HTTP kullanmaktan kaçının. Basit kimlik doğrulama AppCode'u düz metin olarak ilettiğinden, şifrelenmemiş HTTP protokolünün kullanılması durumunda ağ paketlerinin ele geçirilmesi halinde AppCode'un ele geçirilme riski yüksektir.
Genel bakış
İmza tabanlı kimlik doğrulama hakkında bilgi için bkz. İmza tabanlı kimlik doğrulama kullanarak bir API çağırma.
-
Basit kimlik doğrulama (AppCode), istemcileri API Gateway tarafından verilen bir
AppCodekullanarak doğrular. İstemci, kimlik doğrulama içinAppCodeöğesini istek başlığına veya birsorgu parametresiolarak ekler. Bu sayede birAPIhızlı bir şekilde çağrılabilir.Basit kimlik doğrulama (AppCode) kullanan bir API oluşturun.
Bir
AppCodealmak için bir uygulama oluşturun.Uygulamayı API'yi çağırmak için yetkilendirin.
Kimlik doğrulama için API Gateway tarafından verilen
AppCodedeğerini kullanın.
AppCode kimlik doğrulaması için bir API oluşturma
API Gateway konsolu üzerinde oturum açın. Sol gezinme bölmesinde API Management > API Groups seçeneğini belirleyin. API Groups sayfasında sağ üst köşede bulunan Create Group öğesine tıklayın.
Create Group sayfasında Instance açılır listesinden API Gateway örneğinizi seçin, bir Group Name ve bir BasePath girin ve ardından OK öğesine tıklayın.
Sol gezinme bölmesinde seçeneğini belirleyin. APIs sayfasında sağ üst köşede bulunan Create API öğesine tıklayın.
-
Create API sayfasında Basic Information bölümünde oluşturduğunuz Group öğesini seçin. Bir API Name girin. Security Authentication için Alibaba Cloud App seçeneğini belirleyin. AppCode Authentication için Enable AppCode Authentication (Header) veya Enable AppCode Authentication (Header & Query) seçeneğini belirleyin.
Aşağıdaki tabloda AppCode kimlik doğrulaması seçenekleri açıklanmaktadır.
Option
Description
Enable After Publishing to Alibaba Cloud Marketplace
Bu seçenek varsayılan olarak devre dışıdır. API Alibaba Cloud Marketplace'te yayımlanırsa, istek başlığında AppCode kimlik doğrulamasına izin vermek için bu seçeneği etkinleştirebilirsiniz.
Disable AppCode Authentication
AppCode kimlik doğrulaması devre dışı bırakılır. API'nin Alibaba Cloud Marketplace'te yayımlanıp yayımlanmadığına bakılmaksızın tüm API çağrıları imza tabanlı kimlik doğrulama kullanmalıdır.
Enable AppCode Authentication (Header)
AppCode kimlik doğrulaması etkinleştirilir. API'nin Alibaba Cloud Marketplace'te yayımlanıp yayımlanmadığına bakılmaksızın AppCode yalnızca istek başlığında iletilebilir.
Enable AppCode Authentication (Header & Query)
AppCode kimlik doğrulaması etkinleştirilir. API'nin Alibaba Cloud Marketplace'te yayımlanıp yayımlanmadığına bakılmaksızın AppCode istek başlığında veya sorgu parametresi olarak iletilebilir. Bir Signature Algorithm seçin ve Next öğesine tıklayın.
Define API Request adımında API isteğini yapılandırın. Daha fazla bilgi için bkz. Bir API isteği tanımlama. Ardından Next öğesine tıklayın.
Define Backend Service adımında arka uç hizmetini yapılandırın. Daha fazla bilgi için bkz. Arka uç hizmeti bilgilerini tanımlama. Ardından Next öğesine tıklayın.
Define Response adımında yanıtı yapılandırın. Daha fazla bilgi için bkz. Bir yanıt tanımlama. Ardından Save öğesine tıklayın.
API parametrelerini tanımlarken
AppCodeiçin bir parametre eklemeniz gerekmez.API'yi oluşturduktan sonra hata ayıklama amacıyla bir ortama yayımlayabilirsiniz.
Bir uygulama oluşturma
API Gateway konsolu üzerinde oturum açın. Sol gezinme bölmesinde seçeneğini belirleyin. Apps sayfasında sağ üst köşede bulunan Create App öğesine tıklayın.
Create App iletişim kutusunda bir App Name girin ve OK öğesine tıklayın.
Her yeni uygulama için otomatik olarak bir
AppCodeoluşturulur. AppCode'u bulmak için Apps sayfasına gidin ve uygulamanın App Details sayfasını açmak için uygulama adına tıklayın.Alibaba Cloud Marketplace kullanıcıları bir API satın aldığında onlar için otomatik olarak bir uygulama oluşturulur.
Bir uygulamayı AppCode API'sini kullanacak şekilde yetkilendirme
API Gateway konsolu üzerinde oturum açın. Sol gezinme bölmesinde seçeneğini belirleyin. APIs sayfasında oluşturduğunuz API'yi bulun ve Actions sütununda
öğesine ve ardından Authorize öğesine tıklayın.Yetkilendirme iletişim kutusunda Stage öğesini seçin ve Authorization Validity Period değerini ayarlayın. Select Apps for Authorization altında My Apps bölümünü bulun ve hesabınızdaki uygulamaları görüntülemek için Search öğesine tıklayın. İstediğiniz uygulamayı seçin, Add öğesine tıklayın ve ardından OK öğesine tıklayın.
AppCode kullanarak kimlik doğrulama
AppCode değerini iki şekilde sağlayabilirsiniz: istek başlığı içinde veya bir sorgu parametresi olarak.
Yöntem 1: AppCode'u başlıkta iletme
istek başlığıöğesine birAuthorizationparametresi ekleyin.-
Authorizationalanının değeriAPPCODEile başlamalı, ardından bir boşluk ve AppCode değeri gelmelidir. Biçim:Authorization:APPCODEÖrnek:
Authorization:APPCODE 3F2504E04F8911D39A0C0305E82C3301ÖnemliArka uç hizmeti bir HTTP işleviyse
Authorizationbaşlığı arka uç hizmetine iletilmez. HTTP işlevininAuthorizationparametresi bunu geçersiz kılar. Bu nedenle AppCode'u sorgu parametresi olarak iletmenizi öneririz.
Yöntem 2: AppCode'u sorgu parametresi olarak iletme
İstek
queryöğesine birAppCodeparametresi ekleyin. Parametre adı büyük/küçük harfe duyarlı değildir.appcode,appCode,APPCODEveyaAPPCodekullanabilirsiniz.AppCodeparametresinin değeriAppCodedeğerinizdir.
Örnek:
http://?AppCode=3F2504E04F8911D39A0C0305E82C3301