Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Paylaşılan akışlar, bir dizi API'de standart istek ön işleme veya yanıt sonrası işleme gerçekleştirebilir. Akış kancası ile, belirli bir ortama dağıtılan tüm API proxy'lerinde aynı yerde yürütülecek şekilde paylaşılan bir akış eklersiniz. Bu, proxy'nin uygulama kodunun bir parçası olmayan, ayrı olarak uygulanmış ve dağıtılmış bir mantık sırası sağlar.
Bir akış kancasına eklenen kod, API proxy'sinin temel mantığı bağlamının dışında olduğundan bazı davranışları API proxy'lerinden farklıdır. Aşağıdakileri göz önünde bulundurun:
- Paylaşılan bir akışı akış kancasına eklemek için izninizin olması gerekir. Kuruluş yöneticisi olmanız gerekir.
- Her akış kancasına yalnızca bir paylaşılan akış ekleyebilirsiniz.
- Aynı paylaşılan akışı birden fazla akış kancasına ekleyebilirsiniz.
- Bir akış kancasına eklenen paylaşılan akışta hata oluşursa veya paylaşılan akış yürütülürken hatalar varsa ileti reddedilir ve hata, arayana geri gönderilir.
- Bir ileti, akış kancası yürütülürken reddedilirse ayrıntılar, çağrılan proxy bağlamında Analytics'e kaydedilir. Paylaşılan akış, özel kod ve hata mesajıyla da hata verebilir.
Aşağıdaki videoda, Klasik Edge kullanıcı arayüzünde paylaşılan bir akışın akış kancasına nasıl bağlanacağı ve ardından nasıl izleneceği gösterilmektedir.
Aşağıdaki videoda, Yeni Edge deneyimi kullanıcı arayüzünde paylaşılan bir akışın nasıl akış kancasına bağlanacağı ve ardından nasıl izleneceği gösterilmektedir.
Bir akış kancası aracılığıyla bir proxy'ye eklenen paylaşılan akış, geniş politika koşullarını zorunlu kılan mantık için harika bir yer sağlar. Örneğin, farklı iş kollarını (LOB) temsil eden birden fazla ekibin tek bir güvenlik şartları grubunu yöneten bir ekibiniz olduğunu düşünün. Her iş kolu ekibi, kendi gereksinimlerine göre ve daha geniş güvenlik gereksinimlerini dikkate almasına gerek kalmadan API'ler geliştirebilir. Güvenlik ekibi bu güvenlik şartlarını paylaşılan bir akışta uygulayabilir ve ardından akışı bir akış kancası kullanarak Apigee Edge ortamına ekleyebilir. Paylaşılan akış, proxy kodunun bir parçası olmadığından güvenlik ekibi, iş birimi koduna müdahale etmeden gerektiği gibi revize edebilir.
Akış kancaları aracılığıyla eklenen paylaşılan akışlar, proxy kancasının ortamına dağıtılan her API proxy'si için bu konumda yürütülür. Bu nedenle, akış kancalarını kullanma özelliği yalnızca Apigee Edge kuruluşunun yöneticileri tarafından kullanılabilir.
Paylaşılan akışlar hakkında daha fazla bilgi için Yeniden kullanılabilir paylaşılan akışlar başlıklı makaleyi inceleyin.
Apigee Edge yönetim konsolunu kullanarak bir akış kancasına paylaşılan akış eklersiniz. Aşağıdaki yerlerin her birinde bir flowhook'a en fazla bir paylaşılan akış ekleyebilirsiniz:
-
Bir proxy uç noktası yürütülmeden ÖNCE uygulanması gereken mantık için Proxy Öncesi Akış Kancası.
Örneğin, bir ortamdaki tüm API'lerde güvenliği zorunlu kılmak için mantık oluşturabilirsiniz.
-
Bir hedef çağrılmadan ÖNCE uygulanması gereken mantık için Hedef Öncesi Akış Kancası.
Örneğin, istek arka uca ulaşmadan önce günlük kaydını uygulayabilirsiniz. Ayrıca, istekten belirli alanları kaldırarak da arabuluculuğu zorunlu kılabilirsiniz.
-
Hedef yanıt yürütüldükten SONRA uygulanması gereken mantık için hedef sonrası akış kancası.
Bu kısıtlama, arka uçtan yanıt geldikten hemen sonra uygulanır. Arka uç yanıtını kaydetmek veya arka uç yanıtından hassas alanları kaldırarak uyumlulaştırma yapmak için kullanabilirsiniz.
-
Proxy uç noktasından SONRA ve yanıt istemciye gönderilmeden hemen ÖNCE uygulanması gereken mantık için proxy sonrası akış kancası.
Bu, CORS için bazı zorunlu kılma mantığı, yanıtı kaydetme veya bazı mashup ya da biçimlendirme işlemlerini içerebilir.
Akış kancasına paylaşılan akış ekleme
Bir akış kancasına paylaşılan akış eklemek için paylaşılan akışı içeren kuruluşta yönetici olmanız gerekir.
- Aşağıda açıklandığı şekilde Flow Hooks sayfasına erişin.
Edge
Edge kullanıcı arayüzünü kullanarak Akış Kancaları sayfasına erişmek için:
- apigee.com/edge adresinde oturum açın.
- Paylaşılan akışınızı içeren kuruluşu seçin. Kuruluşlarınız arasında geçiş yapma başlıklı makaleyi inceleyin.
Paylaşılan akış, bu kuruluştan bir ortama dağıtılan tüm API proxy'leri ve paylaşılan akışlar tarafından kullanılabilir. Bu kuruluşun dışından erişilemez.
- Sol gezinme çubuğunda Yönetici > Ortamlar > Akış Kancaları'nı seçin.
Classic Edge (Private Cloud)
Klasik Edge kullanıcı arayüzünü kullanarak Akış Kancaları sayfasına erişmek için:
http://ms-ip:9000adresinde oturum açın. Burada ms-ip, Yönetim Sunucusu düğümünün IP adresi veya DNS adıdır.- Paylaşılan akışınızı içeren kuruluşu seçin. Kuruluşlarınız arasında geçiş yapma başlıklı makaleyi inceleyin.
Paylaşılan akış, bu kuruluştan bir ortama dağıtılan tüm API proxy'leri ve paylaşılan akışlar tarafından kullanılabilir. Bu kuruluşun dışından erişilemez.
- Üst gezinme çubuğunda API'ler > Ortam Yapılandırması > Akış Kancaları'nı seçin.
- Akış kancaları listesinde, paylaşılan akışın yürütülmesini istediğiniz yere göre paylaşılan akışı eklemek istediğiniz akış kancasını belirleyin.
Akış Kancası Konumu Açıklama Proxy öncesi akış kancası Bir proxy uç noktası yürütülmeden ÖNCE Hedef öncesi akış kancası Hedef uç nokta ÇALIŞTIRILMADAN ÖNCE Hedef sonrası akış kancası Hedef yanıt yürütüldükten SONRA Post-proxy Flow Hook Proxy uç noktasından SONRA ve yanıt istemciye gönderilmeden HEMEN ÖNCE - İşlemler sütununu görüntülemek için imlecinizi listedeki akış kancasının üzerine getirin.
simgesini tıklayın.- Paylaşılan Akış iletişim kutusunda, Paylaşılan akış açılır listesinden eklemek istediğiniz paylaşılan akışı seçin.
- Tamam'ı tıklayın.
- Gerektiğinde paylaşılan akışları diğer akış kancalarına ekleyin.