API Gateway'de oluşturulan API'ler, istemciler ve API Gateway tarafından çağrılabilir. API Gateway, aynı bölgedeki API'leri dahili ağlar üzerinden veya bölgeler arasında İnternet üzerinden çağırabilir. API Gateway, yetkilendirilmiş bir uygulamanın AccessKey çiftini kullanarak APIGW_FRONTEND türünde bir arka uç imzalama eklentisini API'ye bağlayarak hesaplar arası API çağrıları da yapabilir. API Gateway bir API'yi çağırmadan önce AccessKey çiftini kullanarak bir imza oluşturur ve kimlik doğrulama için bu imzayı API'ye gönderir. API Gateway ile Çağırma özelliği aşağıdaki tipik senaryoda kullanılabilir: İstekleri yönlendirmek için bir API oluşturursunuz. Bu API'ye bir arka uç yönlendirme eklentisi ve bir arka uç imzalama eklentisi bağlanır. Arka uç yönlendirme eklentisi, istek parametrelerine göre istekleri diğer API'lere yönlendirir.
Yapılandırma örneği
1. İş API'lerini yapılandırma
API Gateway'in API'nizi sanal özel bulut (VPC) üzerinden çağırmasını istiyorsanız API Gateway konsolunda aşağıdaki adımları uygulayın: Özel bir örnek satın alın, API'nin ait olduğu API grubunu özel örneğe taşıyın ve VPC tabanlı API çağrıları için manuel olarak bir dahili alan adı oluşturun.
-
API Gateway ile Çağırma özelliğini etkinleştirin
a. API Gateway konsolu üzerinde oturum açın.
b. Sol gezinme bölmesinde Instances and Clusters > Dedicated Instances seçeneğini belirleyin. Örnekler sekmesinde istenen özel örneği bulun ve Calls from API Gateway yanındaki Etkinleştir seçeneğine tıklayın.
-
API çağrıları için dahili alan adları oluşturun
Örnek üzerinde iki API grubu oluşturun. Ardından grupların her birine tıklayarak bir dahili alan adı oluşturun.
Örneğin aşağıdaki iki dahili alan adı oluşturulur:
17ff4c9189004a1d87b557606b767334-cn-huhehaote-intranet.alicloudapi.com
c6e984b2dd784c0fb843f7c2a8878b15-cn-huhehaote-intranet.alicloudapi.com
-
Grupların her birinde bir API oluşturun
Her API grubunda bir API oluşturun. Her iki API için de Güvenlik Kimlik Doğrulaması parametresini Alibaba Cloud Uygulaması olarak ayarlayın. Aşağıdaki örneklerde iki API'nin varsayılan nitelikleri gösterilmektedir:
-
API1: Yöntem: GET Yol: /business1 Arka uç hizmeti URL'si:
http://backend1.alicloudapi.com:8080/business1 -
API2 Yöntem: GET Yol: /business2 Arka uç hizmeti URL'si:
http://backend2.alicloudapi.com:8080/business2
-
-
Bir uygulamayı API'leri çağırmak için yetkilendirin
Aynı uygulamayı her iki API'yi çağırmak için yetkilendirin. Bu örnekte uygulamanın aşağıdaki AccessKey çifti vardır: KEY:TESTKEY SECRET:TESTSECRET
2. Dağıtım API'sini yapılandırma
-
Dağıtım API'sini oluşturun
Anonim erişime izin veren bir dağıtım API'si oluşturun. HTTP yöntemini GET, yolu /distributeAPI ve ait olduğu API grubunun alan adını
17ff4c9189004a1d87b557606b767334-cn-huhehaote.alicloudapi.comolarak yapılandırın.
-
Arka uç yönlendirme eklentisi oluşturun ve bağlayın
Bir arka uç yönlendirme eklentisi oluşturun ve eklentiyi API'ye bağlayın.
---
parameters:
target: "Query:target"
routes:
- name: backend1
condition: "$target = 'resource1'"
backend:
type: "HTTP"
address: "17ff4c9189004a1d87b557606b767334-cn-huhehaote-intranet.alicloudapi.com"
path: "/business1"
- name: backend2
condition: "$target = 'resource2'"
backend:
type: "HTTP"
address: "c6e984b2dd784c0fb843f7c2a8878b15-cn-huhehaote-intranet.alicloudapi.com"
path: "/business2"
Yukarıdaki eklenti kodu, eklentinin alınan isteği isteğin sorgu bölümündeki hedef parametresinin değerine göre yönlendirdiğini belirtir. Değer resource1 ise eklenti isteği 17ff4c9189004a1d87b557606b767334-cn-huhehaote-intranet.alicloudapi.com adresine iletir ve isteğin yolu /business1 olarak değişir. Değer resource2 ise eklenti isteği aynı şekilde iletir.
-
Arka uç imzalama eklentisi oluşturun ve bağlayın
Bir arka uç imzalama eklentisi oluşturun ve eklentiyi API'ye bağlayın.
---
type: APIGW_FRONTEND
key: TESTKEY
secret: TESTSECRET
signatureMethod: HmacSHA256
Yukarıdaki eklenti kodu, eklentinin alınan isteğin içeriğine ve ön uç tarafından kullanılan imzalama algoritmasına dayalı olarak bir imza hesapladığını belirtir. Ardından eklenti hesaplanan imzayı isteğe ekler ve isteği arka uç hizmetine gönderir.
3. Dağıtım API'sini çağırma
API'yi çağırmadan önce ilgili tüm API'lerin yayınlandığından ve düzgün şekilde test edildiğinden emin olun.
curl 'http://17ff4c9189004a1d87b557606b767334-cn-huhehaote.alicloudapi.com/distributeAPI?target=resource1' -i
Aşağıdaki kod parçacığı bir arka uç hizmetine gönderilen örnek bir isteği gösterir:
GET /business1 HTTP/1.1
User-Agent: curl/7.64.1
Via: 0045e52ee3a8400b8501b4c449b28779
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
X-Forwarded-Proto: http
X-Forwarded-For: 192.168.XX.XX, 127.0.0.1
Host: backend1.alicloudapi.com:8080
X-Ca-Request-Id: 23853B41-C54D-45E9-8C43-EE4C1E8A7889
Via: bc48a42a3d17408b991b0bb4d18c23c0
curl 'http://17ff4c9189004a1d87b557606b767334-cn-huhehaote.alicloudapi.com/distributeAPI?target=resource2' -i
Aşağıdaki kod parçacığı bir arka uç hizmetine gönderilen başka bir örnek isteği gösterir:
GET /business2 HTTP/1.1
User-Agent: curl/7.64.1
Via: 0045e52ee3a8400b8501b4c449b28779
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
X-Forwarded-Proto: http
X-Forwarded-For: 192.168.XX.XX, 127.0.0.1
Host: backend2.alicloudapi.com:8080
X-Ca-Request-Id: AFD529D2-9B24-437E-8CEC-897E0BCD8B2F
Via: bc48a42a3d17408b991b0bb4d18c23c0