Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info
Edge Microgateway v. 2.4.x
Kitle
Bu konu, Edge Microgateway'e yönelik ve tüm kitlelere yönelik genel bir giriştir.
Apigee Edge Microgateway nedir?
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.
Birincil kullanım alanları
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.
- Apigee Topluluğu'ndaki bu kullanım alanı tartışmasına da göz atın.
Temel özellikler ve avantajlar
- Güvenlik. Edge Microgateway, isteklerin kimliğini Apigee Edge tarafından her istemci uygulamasına verilen imzalı bir erişim jetonu veya API anahtarıyla 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ı makineye, alt ağa veya veri merkezine yükleyip yönetebilirsiniz.
- Analytics. Edge Microgateway, API yürütme verilerini Edge Analytics sistemi tarafından işleneceği Apigee Edge'e asenkron olarak gönderir. Edge Analytics metriklerinin, kontrol panellerinin 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.
- Aşinalık. 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'ya gidin. Edge Microgateway'i kurmak ve yönetmek için programlama gerekmez. Her şey yapılandırma üzerinden yönetilir.
- Kolaylık. Edge Microgateway'i mevcut uygulama izleme ve yönetim altyapınız ile süreçlerinizin içine entegre edebilirsiniz.
- Basit. Kurulumu, yapılandırması ve bakımı kolaydır.
- 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 gösterir.
- CLI. Komut satırı arayüzü, Edge mikro ağ geçidini 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.
Şekil 1: Edge Microgateway'in en basit dağıtımı
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).
Şekil 2: Arka uç hedef API'lerinden ayrılmış Edge mikro geçidi
Birden fazla uygulama için proxy kullanma
Şekil 3'te gösterildiği gibi, birden fazla arka uç hedef uygulamanın önüne tek bir Edge Microgateway örneği yerleştirilebilir.
Şekil 3: Edge Microgateway birden fazla API proxy'sini ön plana çıkarabilir
Yük dengeleyiciyle
Edge Microgateway'in kendisi, SSL sonlandırma ve/veya yük dengeleme için Şekil 4'te gösterildiği gibi standart bir ters proxy veya yük dengeleyici tarafından ön uçta kullanılabilir.
Şekil 4: Edge Microgateway'i yük dengeleyiciyle çalıştırma
İntranet dağıtımı
Şekil 5'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.
Şekil 5: İntranet trafiğini korumak için Edge Microgateway çalıştırma
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 çalışması 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 özel "Edge Microgateway farkında" proxy'lerin ve Apigee Edge kuruluşunuzdaki tüm ürünlerin 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 üründeki 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ı bir KSA komutu 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.
Uygulamalı olarak öğrenmek istiyorsanız Edge Microgateway'i uygun bir CLI komutu kullanarak ayarlama ve yapılandırma sürecini adım adım anlatan Edge Microgateway'i ayarlama ve yapılandırma başlıklı makaleye gidin.
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şlemi yapmak kolaydır. Ayrıntılar için Edge Microgateway'i ayarlama ve yapılandırma başlıklı makaleyi inceleyin.
Edge Microgateway'ten haberdar olan proxy'lerin özellikleri arasında şunlar yer alır:
- Mikro farkındalık sunan proxy'ler, Edge Microgateway'e iki temel bilgi sağlar: temel yol ve hedef URL.
- Mikro farkındalık sahibi proxy'ler, HTTP hedef uç noktalarını 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. - Edge Microgateway proxy'leri, Apigee Edge yönetim kullanıcı arayüzünün Proxy Düzenleyicisi'nde düzenlenemez. Yani politika veya koşullu akış ekleyemezsiniz. (Yoksa denerseniz yoksayılır.)
- Aksi takdirde Edge Microgateway proxy'leri, Edge'deki diğer API proxy'leriyle aynı şekilde Edge Yönetimi kullanıcı arayüzünde görünür.
- Edge'deki tüm API proxy'lerinde olduğu gibi Edge Microgateway proxy'leri de ürünlere dahil edilebilir ve geliştirici uygulamalarıyla ilişkilendirilebilir.
- Diğer tüm proxy'lerde olduğu gibi Edge Microgateway proxy analizlerini de izleyebilirsiniz.
- Edge Microgateway proxy'leri Apigee Edge Trace aracı kullanılarak izlenemez.
Edge Microgateway ve Apigee Edge Analytics hakkında daha fazla bilgi
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.
Şekil 6: Edge'deki Proxy Trafiği kontrol paneli
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. (Ayrıntılı adımlar için Edge Microgateway'i kurma ve yapılandırma başlıklı makaleyi inceleyin.)
- 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, imzalanmış 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ı almak ve kullanmak için gereken adımlar için Edge Microgateway'i ayarlama ve yapılandırma başlıklı makaleyi inceleyin. API anahtarları hakkında bilgi edinmek için Edge Microgateway için işletim ve yapılandırma referansı başlıklı makaledeki "API anahtarı güvenliğini kullanma" bölümüne bakın.
Apigee Edge'de Edge Microgateway'in kimlik doğrulaması
- 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önetimi 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 ayarlama ve yapılandırma başlıklı makaleyi inceleyin.
Politikaları Edge Microgateway proxy'leriyle kullanabilir miyim?
Önceki bölümde açıklandığı gibi, Apigee Edge'deki "mikro ağ geçidi bilinçli" proxy'lere politika ekleyemezsiniz. Edge Microgateway, Edge'deki politikalara benzer işlevler (ör. kota, ani artış durdurma, API anahtarı güvenliği ve OAuth2 güvenliği) sağlamak için eklentiler kullanır. Eklentileri kullanma başlıklı makaleyi inceleyin. Özel eklentiler geliştirme bölümünde açıklandığı gibi özel eklentiler de yazabilirsiniz.
Edge Microgateway hakkında bilgi edinmenin en iyi yolu nedir?
Apigee şu kaynakları sağlar:
-
Edge Microgateway Belgeleri: Belgeler, başlangıç eğitimi ve tam referans ve yapılandırma bilgilerini içerir.
-
Ayrıntılı webinar: Edge Microgateway'in ayrıntılı olarak ele alındığı ve Edge Microgateway'in nasıl kurulacağı ve yapılandırılacağı gösterildiği webinar.
-
Edge Micro forumu: Apigee Topluluğu'ndaki Edge Micro forumu, soru sormanın ve diğer kullanıcıların sorduğu ve yanıtladığı sorulardan yararlanmanın mükemmel bir yoludur.