Ağ Bağlantı Matrisi
Bu sayfa, Apinizer platformunun bileşenleri arasındaki ağ bağlantılarını ve port gereksinimlerini detaylı bir şekilde açıklar. Inbound, Outbound ve Internal trafik akışları için port matrisi sağlanmıştır.
Ağ Trafik Kategorileri
Dış Dünyadan Gelen
- Internet'ten Load Balancer'a
- İstemcilerden API Gateway'e
Dış Dünyaya Giden
- Backend API'lere
- Dış servislere
- Internet'e
Bileşenler Arası
- Manager ↔ Worker
- Manager → Integration
- Worker ↔ Database
- Worker ↔ Cache
Port Matrisi - Detaylı Tablo
Inbound Trafik (Internet → Apinizer)
| Kaynak | Hedef | Port | Protokol | Açıklama | Gerekli |
|---|---|---|---|---|---|
| Internet | Load Balancer | 443 | HTTPS | API erişimi (Production) | Gerekli |
| Internet | Load Balancer | 80 | HTTP | HTTP → HTTPS redirect | Gerekli |
| Internet | Load Balancer | 22 | SSH | Yönetim erişimi (VPN üzerinden önerilir) | Zorunlu Değil |
Outbound Trafik (Apinizer → Internet)
| Kaynak | Hedef | Port | Protokol | Açıklama | Gerekli |
|---|---|---|---|---|---|
| Worker | Backend API | 443 | HTTPS | Backend API çağrıları | Gerekli |
| Worker | Backend API | 80 | HTTP | HTTP Backend API çağrıları | Zorunlu Değil |
| Worker | External Services | 443 | HTTPS | Dış servis entegrasyonları | Zorunlu Değil |
| Manager | External Services | 443 | HTTPS | Monitoring, webhook'lar | Zorunlu Değil |
| Manager | SMTP Server | 25/587 | SMTP | E-posta gönderimi | Zorunlu Değil |
| Manager | DNS Server | 53 | UDP/TCP | DNS sorguları | Gerekli |
Internal Trafik (Bileşenler Arası)
Manager ↔ Worker
| Kaynak | Hedef | Port | Protokol | Açıklama | Yön |
|---|---|---|---|---|---|
| Manager | Worker | 8091 (HTTPS: 8443) | HTTP/HTTPS | Deployment işlemleri (/apinizer/deployment/*) | Manager → Worker |
| Manager | Worker | 8091 (HTTPS: 8443) | HTTP/HTTPS | Health check ve yönetim (/apinizer/management/*) | Manager → Worker |
Manager, Worker'a Environment üzerinde tanımlı Gateway Management API URL adresi üzerinden bağlanır (örneğin http://worker-management-api-http-service.<namespace>.svc.cluster.local:8091). Worker, Manager'a bağlantı açmaz.
Manager → Integration
| Kaynak | Hedef | Port | Protokol | Açıklama | Yön |
|---|---|---|---|---|---|
| Manager | Integration | 8092 | HTTP | Task flow zamanlama ve çalıştırma (/api/integration/execute) ve health check (/apinizer/management/health) | Manager → Integration |
Manager, Integration modülüne genel ayarlarda tanımlı API Integration (Task Flow) Module URL adresi üzerinden bağlanır (örneğin http://integration-http-service.<namespace>.svc.cluster.local:8092). Bu portu yalnızca task flow kullanıyorsanız açın.
Worker ↔ Database (MongoDB)
| Kaynak | Hedef | Port | Protokol | Açıklama | Yön |
|---|---|---|---|---|---|
| Worker | MongoDB | 25080 | TCP | Veri okuma/yazma | Worker → MongoDB |
| Manager | MongoDB | 25080 | TCP | Konfigürasyon yönetimi | Manager → MongoDB |
| Integration | MongoDB | 25080 | TCP | Konfigürasyon okuma ve Quartz job store | Integration → MongoDB |
| MongoDB | MongoDB | 25080 | TCP | Replica set iletişimi | MongoDB ↔ MongoDB |
Worker ↔ Elasticsearch
| Kaynak | Hedef | Port | Protokol | Açıklama | Yön |
|---|---|---|---|---|---|
| Worker | Elasticsearch | 9200 | HTTP | Log gönderimi | Worker → Elasticsearch |
| Manager | Elasticsearch | 9200 | HTTP | Analitik sorguları | Manager → Elasticsearch |
| Elasticsearch | Elasticsearch | 9300 | TCP | Cluster iletişimi | Elasticsearch ↔ Elasticsearch |
Worker ↔ Cache (Hazelcast)
| Kaynak | Hedef | Port | Protokol | Açıklama | Yön |
|---|---|---|---|---|---|
| Worker | Cache | 8090 | HTTP | Cache REST API | Worker → Cache |
| Manager | Cache | 8090 | HTTP | Cache yönetimi (REST) | Manager → Cache |
| Cache | Cache | 5701 | TCP | Cluster iletişimi | Cache ↔ Cache |
Kubernetes İletişimi
| Kaynak | Hedef | Port | Protokol | Açıklama | Yön |
|---|---|---|---|---|---|
| Kubelet | API Server | 6443 | HTTPS | API erişimi | Kubelet → API Server |
| Kube-proxy | API Server | 6443 | HTTPS | API erişimi | Kube-proxy → API Server |
| Pod | Pod | Dynamic | TCP/UDP | Pod-to-Pod iletişim | Pod ↔ Pod |
Ağ Topolojisi Bazlı Port Gereksinimleri
DMZ Zone Portları
Worker Nodes:
- 443/80: İstemci erişimi (Load Balancer'dan)
- 8091 / 8443: Gateway dinleyicisi ve Manager'dan deployment işlemleri (Kubernetes NodePort: varsayılan 30080)
- 8090: Cache REST API erişimi (LAN'dan)
- 25080: MongoDB erişimi (LAN'dan)
- 9200: Elasticsearch erişimi (LAN'dan)
Load Balancer:
- 443/80: Internet erişimi
- 8091 / 8443 (Kubernetes NodePort: 30080): Worker'lara trafik yönlendirme
LAN Zone Portları
Manager Module:
- 8080: Web Manager ve Management API
- 25080: MongoDB erişimi
- 9200: Elasticsearch erişimi
- 8090: Cache erişimi (REST)
- 8092: Integration erişimi (task flow)
Integration Module:
- 8092: Task flow API (Manager'dan)
- 25080: MongoDB erişimi
MongoDB:
- 25080: Veritabanı erişimi (Worker, Manager ve Integration'dan)
Elasticsearch:
- 9200: HTTP API (Worker ve Manager'dan)
- 9300: Transport protocol (cluster içi)
Cache (Hazelcast):
- 8090: Cache REST API (Worker ve Manager'dan)
- 5701: Hazelcast cluster iletişimi (Cache node'ları arasında)
Firewall Kuralları Özeti
DMZ Firewall Kuralları
Inbound:
Internet → Load Balancer: 443, 80
VPN → Load Balancer: 22 (opsiyonel)
Outbound:
Load Balancer → Worker: 8091 / 8443 (Kubernetes NodePort: 30080)
Worker → MongoDB: 25080
Worker → Elasticsearch: 9200
Worker → Cache: 8090
Worker → Backend API: 443, 80
LAN Firewall Kuralları
Inbound:
DMZ → MongoDB: 25080
DMZ → Elasticsearch: 9200
DMZ → Cache: 8090
VPN → Manager: 22, 8080
Outbound:
Manager → Worker: 8091 / 8443
Manager → MongoDB: 25080
Manager → Elasticsearch: 9200
Manager → Cache: 8090
Manager → Integration: 8092
Manager → External Services: 443, 25, 587
Port Gereksinimleri - Bileşen Bazlı
Worker Node Portları
Client-Facing Ports
- 443: HTTPS API erişimi
- 80: HTTP API erişimi (redirect için)
- 8091 / 8443: Gateway HTTP/HTTPS ve Management API (Manager'dan)
Backend Communication Ports
- 443/80: Backend API çağrıları (outbound)
- 25080: MongoDB erişimi (outbound)
- 9200: Elasticsearch log gönderimi (outbound)
- 8090: Cache erişimi (outbound)
Internal Ports
- 8091 / 8443: Manager ile iletişim (Manager → Worker)
- Dynamic: Kubernetes service discovery
Manager Node Portları
Web Interface Ports
- 8080: Web Manager UI
- 8080: Management API
Database Ports
- 25080: MongoDB erişimi (outbound)
- 9200: Elasticsearch erişimi (outbound)
- 8090: Cache erişimi (outbound)
- 8092: Integration erişimi (outbound, task flow)
External Service Ports
- 443: External API çağrıları (webhook, monitoring)
- 25/587: SMTP (e-posta gönderimi)
- 53: DNS sorguları
Network Security Best Practices
Güvenlik Kuralları:
- Asla MongoDB ve Elasticsearch portlarını Internet'e açmayın
- Asla Manager portunu (8080) Internet'e açmayın
- Mutlaka TLS/SSL kullanın (production'da)
- Mutlaka firewall kurallarını en az ayrıcalık prensibi ile yapılandırın
- Mutlaka network segmentation uygulayın (DMZ/LAN)
Port Açma Checklist
- Sadece gerekli portlar açıldı
- DMZ ve LAN ayrımı yapıldı
- Firewall kuralları en az ayrıcalık prensibi ile yapılandırıldı
- TLS/SSL sertifikaları yapılandırıldı
- Network segmentation uygulandı
- Port tarama testleri yapıldı
- Monitoring ve alerting yapılandırıldı
Trafik Akış Diyagramı
Internet
│
▼ (443/80)
┌──────────────┐
│Load Balancer │
└──────┬───────┘
│ (8091 / 30080)
▼
┌──────────────┐
│ Worker Node │
└──────┬───────┘
│
├───► (25080) MongoDB
├───► (9200) Elasticsearch
├───► (8090) Cache
└───► (443) Backend API
Önemli: Bu port matrisi standart kurulumlar için geçerlidir. Özel konfigürasyonlar ve custom port kullanımları için port numaraları değişebilir. Production ortamları için mutlaka network security audit yapılmalıdır.