Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info
Edge Microgateway v. 3.3.x
Apigee Edge Microgateway, API'ler için güvenli, HTTP tabanlı bir mesaj işleyicidir. Ana görevi, arka uç hizmetleriyle gelen ve giden istek ve yanıtları güvenli bir şekilde işlemek ve değerli API yürütme verilerini Edge Analytics sistemi tarafından tüketileceği Apigee Edge'e asenkron olarak göndermektir. Edge Microgateway'in kurulumu ve dağıtımı kolaydır. Birkaç dakika içinde bir örneği kullanıma hazır hale getirebilirsiniz.
Edge Microgateway genellikle arka uç hedef hizmetlerine yakın bir konumda, güvenilir bir ağa kurulur. Kurumsal düzeyde güvenlik ve ani artış durdurma, kota ve analizler gibi bazı önemli eklenti özelliklerini sunar ancak Apigee Edge'in tüm özelliklerini veya ayak izini sunmaz. Edge Microgateway'i, arka uç hizmetlerinizle aynı veri merkezine veya hatta isterseniz aynı makineye yükleyebilirsiniz.
Edge Microgateway'i bağımsız bir işlem olarak veya Docker kapsayıcısında çalıştırabilirsiniz. Edge Microgateway ile Docker'ı kullanma başlıklı makaleye göz atın. Kubernetes kümesinde çalışan hizmetler için Apigee API yönetimi sağlamak üzere Edge Microgateway'i de kullanabilirsiniz. Mevcut hizmetleri ve API'leri Kubernetes yığınına taşıyor veya yeni hizmetler ve API'ler oluşturuyor olun, Edge Microgateway güvenlik, trafik yönetimi, analizler, yayınlama ve daha fazlasını içeren temiz bir API yönetim deneyimi sunmanıza yardımcı olur. Edge Microgateway'i Kubernetes ile entegre etme başlıklı makaleyi inceleyin.
Tipik kullanım durumları
Edge Microgateway gibi karma bir Cloud API yönetim çözümünün tipik kullanım alanları şunlardır:
- Yakın mesafede çalışan hizmetler için API trafiğinin gecikmesini azaltın. Örneğin, API tüketicileriniz ve üreticileriniz birbirine yakınsa API'lerin mutlaka merkezi bir ağ geçidinden geçmesini istemeyebilirsiniz.
- API trafiğini güvenlik veya uygunluk amacıyla kurum tarafından onaylanan sınırlar içinde tutun.
- İnternet bağlantısı geçici olarak kesilirse iletileri işlemeye devam edin.
- Kubernetes kümesinde çalışan hizmetler için Apigee API yönetimi sağlayın. Edge Microgateway'i Kubernetes ile entegre etme başlıklı makaleyi inceleyin.
Diğer kullanım alanları için bu Apigee Topluluğu makalesine bakın.
Temel özellikler ve avantajlar
| Özellik | Avantajları |
|---|---|
| Güvenlik | Edge Microgateway, Apigee Edge tarafından her istemci uygulamasına verilen imzalı bir erişim jetonu veya API anahtarıyla istekleri doğrular. |
| Hızlı dağıtım | Apigee Edge'in tam dağıtımının aksine, Edge Microgateway örneğini dakikalar içinde dağıtıp çalıştırabilirsiniz. |
| Ağ yakınlığı | Edge Microgateway'i, Edge Microgateway'in etkileşimde bulunduğu arka uç hedef API'lerle aynı makine, alt ağ veya veri merkezinde yükleyip yönetebilirsiniz. |
| Analiz | Edge Microgateway, API yürütme verilerini Edge Analytics sistemi tarafından işleneceği Apigee Edge'e asenkron olarak gönderir. Edge Analytics metrikleri, kontrol panelleri ve API'lerinin tümünü kullanabilirsiniz. |
| Azaltılmış gecikme | Apigee Edge ile tüm iletişimler asenkrondur ve istemci API isteklerinin işlenmesi kapsamında gerçekleşmez. Bu sayede Edge Microgateway, API verilerini toplayıp gecikmeyi etkilemeden Apigee Edge'e gönderebilir. |
| Tanıdık olma | Edge Microgateway, Edge yöneticilerinin zaten iyi bildiği Apigee Edge özelliklerini (ör. proxy'ler, ürünler ve geliştirici uygulamaları) kullanır ve bu özelliklerle etkileşim kurar. |
| Yapılandırma | Edge Microgateway'i kurmak ve yönetmek için programlama gerekmez. Her şey yapılandırma üzerinden yönetilir. |
| Kullanışlılık | Edge Microgateway'i mevcut uygulama izleme ve yönetim altyapınız ile süreçlerinizin içine entegre edebilirsiniz. Apigee API İzleme'nin Edge Microgateway için desteklenmediğini unutmayın. |
| Günlük Kaydı | Günlük dosyaları, Edge Microgateway tarafından API işlenirken karşılaşılan tüm normal ve istisnai etkinlikleri ayrıntılı olarak belirtir. |
| KSA | Komut satırı arayüzü, Edge Microgateway'i başlatmanıza, durdurmanıza ve yeniden başlatmanıza, işletim istatistiklerini ayıklamanıza, günlük dosyalarını görüntülemenize, erişim jetonları istemenize ve daha fazlasını yapmanıza olanak tanır. |
Edge Microgateway hakkında bilmeniz gerekenler
Bu bölümde, Edge Microgateway'in işleyiş şekli, temel mimarisi, yapılandırması ve dağıtımı açıklanmaktadır.
Edge Microgateway'i neden kullanmalısınız?
API yönetim bileşenini arka uç hedef uygulamalarına yakın bir yere taşımak ağ gecikmesini azaltabilir. Apigee Edge'i şirket içinde özel bir buluta yükleyebilirsiniz ancak Apigee Edge'in tam özellik grubunu ve anahtar yönetimi, para kazanma ve analizler gibi veri yoğun özelliklerini desteklemek için Apigee Edge'in tam dağıtımı büyük ve karmaşık olmalıdır. Bu nedenle, Apigee Edge'i her veri merkezinde yerel olarak dağıtmak her zaman istenmeyebilir.
Edge Microgateway ile arka uç uygulamalarınıza yakın bir yerde çalışan nispeten küçük bir uygulama elde edersiniz. Ayrıca analizler, güvenlik ve diğer özellikler için Apigee Edge'in tüm özelliklerinden yararlanabilirsiniz.
Örnek dağıtım senaryoları
Bu bölümde, Edge Microgateway için olası çeşitli dağıtım senaryoları gösterilmektedir.
Aynı makine
Şekil 1'de, Edge Microgateway'in mümkün olan en basit yapılandırmasında dağıtıldığı ve Edge Microgateway ile arka uç hedef API'lerin aynı makineye yüklendiği istek işleme yolu gösterilmektedir. Birden fazla arka uç hedef uygulamasını ön plana çıkarmak için tek bir Edge Microgateway örneği kullanılabilir
Farklı makine
İstemciler, Edge Microgateway ve arka uç API uygulamaları arasındaki tüm iletişim HTTP olduğundan Apigee Edge Microgateway'i API uygulamasından farklı bir makineye yükleyebilirsiniz (Şekil 2).
Yük dengeleyiciyle
Edge Microgateway'in kendisi, SSL sonlandırma ve/veya yük dengeleme için Şekil 3'te gösterildiği gibi standart bir ters proxy veya yük dengeleyici tarafından ön uçta kullanılabilir.
Intranet dağıtımı
Şekil 4'te gösterildiği gibi, internet trafiğini Apigee Edge ile korurken intranet trafiğini korumak için Edge Microgateway'i kullanın. /orders API uç noktasının Apigee Edge Cloud üzerinden proxy'lendiği ve arka uç hedefi https://mycompany.com/orders'e isabet ettiğini varsayalım. Bu, soldaki hedef API uygulamasıyla gösterilir. Bu API daha sonra sağdaki hedef uygulamayla temsil edilen birden fazla API uç noktasını çağırabilir. Örneğin, dahili olarak /customers ve /transactions çağrılabilir. Apigee Topluluğu'ndaki
bu yayına da göz atın.
Apigee Edge'e bağımlılık
Edge Microgateway, Apigee Edge'e bağlıdır ve Apigee Edge ile etkileşim kurar. Edge Microgateway'in düzgün bir şekilde çalışabilmesi için Apigee Edge ile iletişim kurması gerekir. Edge Microgateway'in Edge ile etkileşime geçmesinin başlıca yolları şunlardır:
- Edge Microgateway, başlatıldıktan sonra Apigee Edge kuruluşunuzdaki özel "Edge Microgateway farkında" proxy'lerin ve tüm API ürünlerinin listesini alır. Edge Microgateway, gelen her istemci isteği için isteğin bu API proxy'lerinden biriyle eşleşip eşleşmediğini belirler ve ardından gelen erişim jetonunu veya API anahtarını, söz konusu proxy ile ilişkili API ürününde bulunan anahtarlara göre doğrular.
- Apigee Edge Analytics sistemi, Edge Microgateway'ten asenkron olarak gönderilen API verilerini depolar ve işler.
- Apigee Edge, erişim jetonlarını imzalamak veya Edge Microgateway üzerinden API çağrıları yapan istemcilerin ihtiyaç duyduğu API anahtarlarını sağlamak için kullanılan kimlik bilgilerini sağlar. Bu jetonları Edge Microgateway ile sağlanan bir KSA komutunu kullanarak elde edebilirsiniz.
Tek seferlik yapılandırma
Apigee Edge kuruluşunuzla iletişim kurabilmek için öncelikle Edge Microgateway'i yapılandırmanız gerekir. Edge Microgateway, başlatılırken Apigee Edge ile bir önyükleme işlemi başlatır. Edge Microgateway, Apigee Edge'de dağıtılan Edge Microgateway uyumlu proxy'lerin listesi de dahil olmak üzere API çağrılarını kendi başına işlemek için ihtiyaç duyduğu bilgileri Apigee Edge'den alır. Bu proxy'lerden birazdan daha ayrıntılı olarak bahsedeceğiz.
Edge Microgateway'in Apigee Edge ile aynı konumda olması gerekmez. Apigee Edge herkese açık ve özel bulut teklifleri eşit derecede iyi çalışır.
Edge Microgateway'ten haberdar olan proxy'ler hakkında bilmeniz gerekenler
Edge Microgateway'ten haberdar olan proxy'ler, Edge Microgateway'e istemci API isteklerini işlemesine olanak tanıyan belirli bilgiler sağlar. Edge Microgateway başladığında bu proxy'ler hakkındaki bilgiler Apigee Edge'den Edge Microgateway'e indirilir.
Apigee Edge yönetim kullanıcı arayüzünü kullanarak veya dilerseniz başka yöntemlerle Apigee Edge'de bu proxy'leri oluşturmak size veya API ekibinize bağlıdır. Bu işlemin yapılması kolaydır. Ayrıntılar için Edge Microgateway'i ayarlama ve yapılandırma başlıklı makaleyi inceleyin.
Edge Microgateway'ten haberdar proxy'lerin özellikleri şunlardır:
- Bunlar Edge Microgateway'e iki temel bilgi sağlar: temel yol ve hedef URL.
- HTTP hedef uç noktalarına işaret etmelidir. Arka uç hedefi, TargetEndpoint tanımındaki bir ScriptTarget öğesi tarafından referans verilen bir Node.js uygulaması olamaz. Daha fazla bilgi için önceki notu inceleyin.
- Proxy adlarının önüne
edgemicro_eklenmelidir. Örneğin:edgemicro_weather. - Bu proxy'lere politika veya koşullu akış ekleyemezsiniz. Bunu denerseniz bu e-postalar yoksayılır. Aksi takdirde, Edge Microgateway'ten haberdar olan proxy'ler Edge Yönetimi kullanıcı arayüzünde Edge'deki diğer API proxy'leriyle aynı şekilde görünür.
- Bunlar ürünlere paketlenebilir ve geliştirici uygulamalarıyla ilişkilendirilebilir.
- Trafik verileri Edge Analytics'te gösterilir.
- Apigee Edge Trace aracı kullanılarak izlenemez.
Edge Microgateway ve Apigee Edge Analytics hakkında
API trafiği Edge Microgateway üzerinden aktığı sırada Edge Microgateway, API yürütme verilerini arabelleğe alır ve veriler Edge Analytics sistemi tarafından depolanıp işlendiği Apigee Edge'e asenkron olarak gönderir. Bu asenkron iletişim, Edge mikro ağ geçidinin Edge analiz özelliklerinden yararlanmasına olanak tanır. Bu sayede, işleme yükü veya engelleme minimum düzeyde tutularak nispeten küçük bir ayak izi sağlanır. Edge Analytics kontrol panellerinin ve özel raporlama özelliklerinin tamamı, Edge Microgateway'ten geçen trafiği analiz etmek için size ve ekibinize sunulur.
Edge Analytics hakkında daha fazla bilgi için Analytics kontrol panelleri başlıklı makaleyi inceleyin.
Edge Microgateway güvenliği hakkında
Apigee Edge'in rolü
Daha önce de belirtildiği gibi Apigee Edge, Edge Microgateway'e gönderilen tüm istemci isteklerinin güvenliğini sağlamada rol oynar. Apigee Edge'in birincil rolleri şunlardır:
- API anahtarı olarak kullanılan veya istemcilerin Edge Microgateway üzerinden güvenli API çağrıları yapmak için kullandığı geçerli erişim jetonları oluşturmak amacıyla istemci kimlik bilgileri sağlama
- Edge Microgateway'in API yürütme verilerini Apigee Edge Analytics sistemine göndermesi için ihtiyaç duyduğu kimlik bilgilerini sağlama Bu kimlik bilgileri, ilk kurulum adımları sırasında Edge Microgateway tarafından bir kez alınır.
- API kaynaklarını ürünlere dahil etmek, geliştiricileri kaydetmek ve yönetmek, geliştirici uygulamaları oluşturmak ve yönetmek için platform sağlar.
İstemci uygulaması kimlik doğrulaması
Edge Microgateway, erişim jetonları ve API anahtarları aracılığıyla istemci kimlik doğrulamasını destekler. Güvenlik anahtarları ve jetonları Apigee Edge tarafından oluşturulur ve her API çağrısı için Edge Microgateway tarafından doğrulanır. OAuth eklentisi etkinse Edge Microgateway, imzalı bir erişim jetonunu veya API anahtarını kontrol eder ve geçerliyse API çağrısı arka uç hedefine devam eder. Geçerli değilse hata döndürülür.
Erişim jetonlarını ve API anahtarlarını almak ve kullanmak için gereken adımlar için Edge Microgateway'i kurma ve yapılandırma başlıklı makaleyi inceleyin.
Apigee Edge'de Edge Microgateway'in kimliğini doğrulama
Edge Microgateway'ın Apigee Edge'deki analiz verilerini güncellemek için yaptığı asenkron çağrılar kimlik doğrulama gerektirir. Bu kimlik doğrulama, Edge Microgateway'e CLI aracılığıyla veya ortam değişkenleri kullanılarak iletilen bir herkese açık/gizli anahtar çifti aracılığıyla sağlanır. Edge Microgateway'i ilk kez yükleyip başlattığınızda bu anahtarları edinip bir kez kullanırsınız.
API ürün yönetim platformu
Edge, API kaynaklarını ürünlere paketlemek, geliştiricileri kaydedip yönetmek ve geliştirici uygulamaları oluşturup yönetmek için bir platform görevi görür. Örneğin, normal Apigee Edge proxy'leri için ürün ve geliştirici uygulamaları gibi öğeler oluşturup gruplandırabileceğiniz gibi Edge Microgateway proxy'leri için de aynısını yapabilirsiniz. API düzeyinde güvenlik, her "paket" için genel ve özel güvenlik anahtarları oluşturularak sağlanır. Bu mekanizma, Apigee Edge'de API güvenliğinin işleyiş şekliyle aynıdır.
Mevcut Edge proxy uygulamalarımı Edge Microgateway'e taşıyabilir miyim?
İlişkili politikalar veya koşullu akışlar içeren mevcut proxy'leri Edge Microgateway'e taşıyamazsınız. Edge Microgateway, yeni "microgateway farkında" proxy'ler oluşturmanızı gerektirir. Bu proxy'ler edgemicro_ özel ön ekiyle adlandırılmalıdır. Edge Microgateway, başlangıçta bu edgemicro_* proxy'lerini bulur ve her birinin yapılandırma bilgilerini indirir. Bu bilgiler arasında hedef URL'leri ve kaynak yolları bulunur. Bu noktadan itibaren proxy'ler kullanılmaz. Bu proxy'lerdeki politikalar veya koşullu akışlar hiçbir zaman yürütülmez.
Microgateway'ten haberdar proxy'lere sahip olmanın bir diğer nedeni de Edge Microgateway'in, her microgateway'ten haberdar proxy için Analytics verilerini Edge'e eşzamansız olarak göndermesidir. Ardından, Edge Analytics kullanıcı arayüzündeki diğer tüm proxy'ler için yaptığınız gibi mikro ağ geçidi bilinçli proxy'ler için analiz verilerini görüntüleyebilirsiniz.
Kurulum konusunda, Edge Microgateway üzerinden API çağrıları için proxy kullanmaya başlamak üzere uygulamanız gereken tüm adımlarda size yol gösterilir. Bu adımlar arasında, Edge Microgateway'in ihtiyaç duyduğu yapılandırmaları oluşturmak için Apigee Edge'de uygulamanız gereken birkaç basit adım da yer alır. Bu yapılandırmalar arasında, mikro geçit uyumlu proxy'ler oluşturma da bulunur. Edge Microgateway'i kurma ve yapılandırma başlıklı makaleyi inceleyin.
Edge Microgateway hakkında daha fazla bilgi
Apigee şu kaynakları sağlar:
-
Edge Microgateway Belgeleri: Belgeler, yükleme kılavuzu ve başlangıç eğitimi ile birlikte tam referans ve yapılandırma bilgilerini içerir.
-
Videolar: Geliştiriciler İçin Apigee 4 Dakikalık Videolar serisi, Edge Microgateway ile ilgili bir dizi bölüm içerir.
-
Apigee Topluluğu, soru sormanın ve diğer kullanıcıların sorduğu ve yanıtladığı sorulardan yararlanmanın mükemmel bir yoludur.