Connector tipinde API Proxy oluşturma
Gelen HTTP isteklerini Kafka, RabbitMQ, ActiveMQ, Mail gibi farklı protokol ve sistemlere dönüştürerek iletir.
Kod yazmadan konnektör tipini seçer, bağlantı tanımını yapılandırır ve API Proxy'yi oluşturursunuz.
Konnektörde değişken kavramı yer almaz; istemciden gelen veri dış sisteme ham olarak gönderilir.
Önceden tanımlanan bağlantılar (Connection) üzerinden hedef sisteme güvenli ve merkezi erişim sağlanır.
Connector API Proxy, klasik REST/SOAP proxy'lerden farklı olarak isteği bir backend HTTP servisine iletmek yerine seçilen konnektöre yönlendirir. Böylece HTTP üzerinden mesaj kuyruğuna veri bırakmak veya e-posta göndermek gibi senaryolar mümkün olur.
Desteklenen Konnektörler
Apinizer üzerinde Connector API Proxy oluştururken kullanabileceğiniz başlıca konnektörler:
ActiveMQ bağlantıları için kullanılır.
Elasticsearch bağlantıları için kullanılır.
FTP üzerinde dosya listeleme için kullanılır.
FTP üzerinden dosya okuma için kullanılır.
Graylog bağlantıları için kullanılır.
Kafka bağlantıları için kullanılır.
Logback bağlantıları için kullanılır.
E-posta gönderimi için kullanılır.
RabbitMQ bağlantıları için kullanılır.
SNMP bağlantıları için kullanılır.
Syslog bağlantıları için kullanılır.
Bağlantı tanımlarını oluşturmak için Bağlantı Yönetimi ve konnektör detayları için Konnektörler sayfalarına bakabilirsiniz.
Yeni Connector API Proxy Oluşturma
Ana menüde Geliştirme → API Proxy'ler (Development → API Proxies) ögesi seçilir.
Açılan arayüzde sağ üstteki +Add API Proxy tuşuna tıklanır.
API Proxy tip seçenekleri arasından Connector kartındaki Create an API Proxy bağlantısına tıklanır.
Name alanına API Proxy adı girilir. Connector alanının yanındaki + tuşuna tıklanarak açılan Connectors penceresinden kullanılacak konnektör tipi seçilir. Ardından Client Route alanları doldurulup Kaydet (Save) tuşuna tıklanır.
Connector API Proxy Tanım Alanları
Connector API Proxy tanımı için kullanılan alanlar aşağıdaki tabloda görülmektedir.
| Alan | Açıklama |
|---|---|
| Ad (Name) | API Proxy'ye kullanıcı tarafından verilen addır. Arayüzlerde bu ad görünür. |
| Connector | Kullanılacak konnektör tipidir. + tuşu ile açılan listeden seçilir: ActiveMQ, Elasticsearch, FTP List, FTP Read, Graylog, Kafka, Logback, Email, RabbitMQ, SNMP, Syslog. |
| Relative Paths | API Proxy'nin erişime açılan adresinin bir parçasıdır. Proje bazında tekil olmalıdır. Örnek: /order-to-kafka |
| Hosts | İsteğe bağlı host tanımlarıdır. |
| Methods | Bu API Proxy için izin verilen HTTP metodlarıdır (GET, POST, PUT, DELETE, PATCH vb.). |
| Headers | API Proxy seviyesinde eklenecek veya değiştirilecek HTTP header'larıdır. |
Client Route alanlarının detayı için Client Route Ayarları sayfasına bakabilirsiniz.
Konnektör Yapılandırması
Konnektör tipi seçildikten sonra ekranda ilgili konnektöre özel yapılandırma alanları görünür. Bu alanlar, seçilen konnektöre göre değişir.
Mesaj Kuyruğu Konnektörleri (Kafka / RabbitMQ / ActiveMQ)
HTTP isteğinin gövdesi seçilen mesaj kuyruğuna iletilir. Tipik kullanım: event üretme, asenkron iş kuyruğuna mesaj bırakma.
| Alan | Açıklama |
|---|---|
| Bağlantı Tanımı | Kafka, RabbitMQ veya ActiveMQ bağlantı havuzundan seçilir. |
| Hedef / Topic / Queue | Mesajın yazılacağı topic veya queue bilgisidir. Konnektör tipine göre adlandırma değişebilir. |
Email Connector
HTTP isteği alındığında yapılandırılan bağlantı üzerinden e-posta gönderimi yapılır.
| Alan | Açıklama |
|---|---|
| Bağlantı Tanımı | SMTP / e-posta bağlantı tanımı seçilir. |
| Alıcı / Konu / İçerik | E-posta gönderimi için kullanılan alanlardır. Konnektör ekranında görünen alanlara göre doldurulur. |
Elasticsearch / FTP / Graylog / Logback / SNMP / Syslog
Seçilen konnektör tipine göre indeks, dosya yolu, log hedefi veya trap ayarları gibi alanlar görünür. Alanların detayı için ilgili konnektör sayfasına bakınız.
Konnektörde değişken kavramı kullanılmaz. İstemciden gelen veri, seçilen hedefe ham olarak iletilir. Mapping veya dönüşüm gerekiyorsa API Proxy üzerinde ilgili politikalar ayrıca tanımlanmalıdır.
Oluşturma Sonrası
Kaydetme adımından sonra yapılabilecekler diğer API Proxy türleriyle aynıdır:
- Politika ekleme ve yönetim
- API trafik log ayarları
- Deploy / Redeploy / Undeploy
Detay için API Proxy Oluşturma ve Yükleme ve Sürüm Yönetimi sayfalarına bakabilirsiniz.
Yükle (Deploy) / Yeniden Yükle (Redeploy)
API Proxy oluşturulduktan sonra istemcilerin erişebilmesi için ilgili ortama yüklenmesi gerekir. Detay için Yükleme ve Sürüm Yönetimi sayfasına bakabilirsiniz.
Konnektör tipi veya Client Route alanında değişiklik yapıldığında değişikliklerin geçerli olabilmesi için API Proxy'nin yeniden yüklenmesi (Redeploy) gerekir.
Connector API Proxy Silme
Bir Connector API Proxy silindiğinde önce ortamdan kaldırılır (undeploy), ardından silinir.
Bağlantı tanımı (Connection) silinmez; yalnızca bu proxy ile ilişkisi sonlanır. Aynı bağlantı başka proxy, Task Flow veya log konnektörlerinde kullanılmaya devam edebilir.