Akış kancası kullanarak paylaşılan akış ekleme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Paylaşılan akışların, bir grup API genelinde ortak metin isteği ön işleme veya yanıt sonrası işleme gerçekleştirmesini sağlayabilirsiniz. Akış kancası ile belirli bir ortama dağıtılan tüm API proxy'leri için aynı yerde yürütülmesi için paylaşılan bir akış eklersiniz. Bu sayede, bir proxy'nin uygulama kodunun parçası olmayan, ayrı olarak uygulanmış ve dağıtılmış bir mantık sırası elde edilir.

Akış kancasına eklenen kod, API proxy temel mantığının bağlamı dışında olduğu için davranışının bir kısmı API proxy'lerinden farklıdır. Aşağıdakileri göz önünde bulundurun:

  • Bir akış kancasına paylaşılan akış ekleme izniniz olmalıdır. Kuruluş yöneticisi olmanız gerekir.
  • Her bir akış kancasına yalnızca bir paylaşılan akış ekleyebilirsiniz.
  • Aynı paylaşılan akışı birden fazla akış kancasına ekleyebilirsiniz.
  • Akış kancasına eklenmiş paylaşılan akış bir hataya neden olursa veya paylaşılan akışın yürütülmesi sırasında hata oluşursa mesaj reddedilir ve arayana geri gönderilir.
  • Akış kancası yürütülürken bir mesaj reddedilirse ayrıntılar, çağrılan proxy bağlamında Analytics'e kaydedilir. Paylaşılan akış ayrıca özel bir kod ve hata mesajı göndererek hata verebilir

Aşağıdaki videoda, paylaşılan bir akışın klasik Edge kullanıcı arayüzünde bir akış kancasına nasıl bağlanacağı ve ardından nasıl izleneceği gösterilmektedir.

Aşağıdaki videoda, paylaşılan bir akışın New Edge deneyimi kullanıcı arayüzünde bir akış kancasına nasıl bağlanacağı ve ardından nasıl izleneceği gösterilmektedir.

Akış kancası aracılığıyla proxy'ye bağlı paylaşılan akış, geniş politika gereksinimlerini zorunlu kılan mantık için harika bir yerdir. Örneğin, farklı işletme kollarını (iş kolu) temsil eden birden fazla ekip için tek bir güvenlik şartı grubunu yöneten bir ekibiniz olduğunu düşünün. Her iş kolu ekibi, daha geniş kapsamlı güvenlik gereksinimlerini hesaba katmaya gerek kalmadan API'leri kendi gereksinimlerine göre geliştirebilir. Güvenlik ekibi bu güvenlik gereksinimlerini paylaşılan bir akışta uygulayabilir, ardından bir akış kancası kullanarak akışı Apigee Edge ortamına ekleyebilir. Paylaşılan akış proxy kodunun bir parçası olmadığından, güvenlik ekibi LOB koduna müdahale etmeden gerektiği gibi bu akışı 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ı yalnızca bir Apigee Edge kuruluşunun yöneticileri kullanabilir.

Paylaşılan akışlar hakkında daha fazla bilgi için Yeniden kullanılabilir paylaşılan akışlar bölümünü inceleyin.

Apigee Edge yönetim konsolunu kullanarak akış kancasına paylaşılan bir akış eklersiniz. Aşağıdaki yerlerin her birinde, bir akış kancasına en fazla bir paylaşılan akış ekleyebilirsiniz:

  • 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 bir mantığınız olabilir.

  • Bir hedef çağrılmadan ÖNCE uygulanması gereken mantık için Önceden Hedef Akış Kancası.

    Örneğin, günlük kaydını istek arka uca ulaşmadan önce uygulayabilirsiniz. Belirli alanları istekten kaldırarak uyumlulaştırmayı da zorunlu kılabilirsiniz.

  • Hedef yanıt yürütüldükten SONRA uygulanması gereken mantık için Hedef sonrası Akış Kancası.

    Bu, yanıt arka uçtan geri geldikten hemen sonra uygulanır. Bunu, arka uç yanıtını günlüğe kaydetmek veya arka uç yanıtından hassas alanları kaldırarak bazı uyumlulaştırmalar gerçekleştirmek 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ı yaptırım mantığını, yanıtı günlüğe kaydetmeyi veya bazı karmalar ya da biçimlendirmeleri gerçekleştirmeyi içerebilir.

Akış kancasına paylaşılan akış ekleme

Akış kancasına paylaşılan akış eklemek için paylaşılan akışı içeren kuruluşta yönetici olmanız gerekir.

  1. Aşağıda açıklandığı şekilde Akış Kancaları sayfasına erişin.

    Edge

    Edge kullanıcı arayüzünü kullanarak Akış Kancaları sayfasına erişmek için:

    1. apigee.com/edge adresinde oturum açın.
    2. 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ışlarda kullanılabilecektir. Bu kuruluşun dışından kullanılamayacak.

    3. Sol gezinme çubuğunda Yönetici > Ortamlar > Akış Kancaları'nı seçin.

    Klasik Edge (Private Cloud)

    Klasik Edge kullanıcı arayüzünü kullanarak Akış Kancaları sayfasına erişmek için:

    1. http://ms-ip:9000 üzerinde oturum açın. Burada ms-ip, Yönetim Sunucusu düğümünün IP adresi veya DNS adıdır.
    2. 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ışlarda kullanılabilecektir. Bu kuruluşun dışından kullanılamayacak.

    3. Üst gezinme çubuğunda API'ler > Ortam Yapılandırması > Akış Kancaları'nı seçin.
  2. Akış kancaları listesinde, paylaşılan akışın yürütülmesini istediğiniz yere bağlı olarak paylaşılan akışı eklemek istediğiniz akış kancasını belirleyin.
    Akış Kancası Konumu Açıklama
    Proxy Öncesi Akış Kancası Proxy uç noktası yürütülmeden ÖNCE
    Önceden Hedeflenmiş Akış Kancası Hedef uç nokta yürütülmeden ÖNCE
    Hedef Sonrası Akış Kancası Hedef yanıt yürütüldükten SONRA
    Proxy Sonrası Akış Kancası Proxy uç noktasından SONRA ve yanıt istemciye gönderilmeden hemen önce
  3. İşlemler sütununu görüntülemek için imlecinizi listedeki akış kancasının üzerine getirin.
  4. simgesini tıklayın.
  5. Paylaşılan Akış iletişim kutusundaki Paylaşılan akış açılır menüsünden eklemek istediğiniz paylaşılan akışı seçin.
  6. OK (Tamam) seçeneğini tıklayın.
  7. Paylaşılan akışları gerektiğinde diğer akış kancalarına ekleyin.