Ek A · Ağ erişimi ve firewall talebi
Bu ek, ağ ve güvenlik ekiplerine verilmek üzere yazılmıştır; tek başına da okunabilir. Entegrasyonlar çalışmadan önce buradaki erişimlerin açılmış olması gerekir.
- Talep tipiTuruncuhat / firewall
- Ortamlardev + prod
- Hazırlayan
« DOLDURULACAK » - İletişim
« DOLDURULACAK »
A.1 İki yön, tek talep
Bölüm başlığı “A.1 İki yön, tek talep”- ← GelenDış sistemlerin ve son kullanıcıların bize ulaşması. Bizim tarafımızda yeni bir kayıt gerekmiyor: servisler internete açık. Karşı tarafın kendi çıkış kuralında bölüm 1.1’deki adresleri açması yeterlidir.
- Giden →Bizim dış sistemlere bağlanmamız (Dengage FTPS, Unica SFTP, Notifigate HTTPS). Turuncuhat kaydı gereken kısım budur: karşı taraf bizim çıkış IP’lerimizi kendi erişim listesine eklemelidir.
A.2 Çıkış IP adreslerimiz
Bölüm başlığı “A.2 Çıkış IP adreslerimiz”Aşağıdaki adresler, bağlandığımız sistemlerin erişim listelerine eklenmelidir.
| Ortam | Çıkış IP sayısı | Adres(ler) |
|---|---|---|
| Dev | 1 | « DOLDURULACAK » |
| Prod | 2 | « DOLDURULACAK » · « DOLDURULACAK » |
Değerler altyapı tanımından okunur:
cd infrastructure/terraform
# devAWS_PROFILE=dev AWS_REGION=eu-west-1 terraform init -reconfigure \ -backend-config="bucket=tk-assistant-terraform-state-dev" \ -backend-config="key=tk-assistant/terraform.tfstate"terraform output nat_gateway_ips
# prodAWS_PROFILE=prod AWS_REGION=eu-west-1 terraform init -reconfigure \ -backend-config="bucket=tk-assistant-terraform-state-prod" \ -backend-config="key=tk-assistant/terraform.tfstate"terraform output nat_gateway_ipsA.3 Hedefler ve portlar Giden →
Bölüm başlığı “A.3 Hedefler ve portlar Giden →”| Entegrasyon | Protokol | Port | Hedef adres |
|---|---|---|---|
| Unica → anket girdisi (dosya okuma) | SFTP (SSH) | 22/TCP | « DOLDURULACAK » |
| Dengage → linkli çıktı (dosya yazma) | FTPS (implicit) | 990/TCP + pasif veri | « DOLDURULACAK » |
| Notifigate → e-posta gönderimi | HTTPS | 443/TCP | « DOLDURULACAK » |
A.4 Gelen trafik ← dış sistem
Bölüm başlığı “A.4 Gelen trafik ← dış sistem”Bizim tarafımızda kayıt gerektirmez; listelenmesinin sebebi karşı ekibin kendi çıkış kuralını doğru adrese açabilmesidir. Hepsi HTTPS / TCP 443.
| Akış | Kaynak | Hedef |
|---|---|---|
| Link kampanyası | Notifigate / Unica / kampanya sistemi | api.<ortam> |
| Mobil SDK açılışı | TK mobil uygulama (son kullanıcı cihazı) | api.<ortam> |
| Web widget | Ziyaretçi tarayıcısı | api.<ortam> + form adresi |
| Anket linkinin doldurulması | Yolcu / çalışan tarayıcısı | form adresi + api.<ortam> |
A.5 Karşı taraftan istenecek bilgiler
Bölüm başlığı “A.5 Karşı taraftan istenecek bilgiler”Firewall kaydı açılsa bile bunlar olmadan bağlantı kurulamaz.
SFTP (Unica tarafı)
Bölüm başlığı “SFTP (Unica tarafı)”- Sunucu ve port
« DOLDURULACAK » - Kullanıcı adı
« DOLDURULACAK » - Kimlik yöntemiparola veya SSH anahtarı
- Dizin yolu
« DOLDURULACAK » - Host key parmak izi
« DOLDURULACAK »
FTPS (Dengage tarafı)
Bölüm başlığı “FTPS (Dengage tarafı)”- Sunucu adresiör.
ftps.dengage.com - Port / mod990 · implicit FTPS
- Kullanıcı / parola
« DOLDURULACAK » - Çıktı dizini
« DOLDURULACAK » - Pasif port aralığı
« DOLDURULACAK »
Notifigate
Bölüm başlığı “Notifigate”- API adresi
« DOLDURULACAK » - Token adresivarsa ayrı uç nokta
- Kullanıcı / parola
« DOLDURULACAK » - Firewall kimliğiayrı isteniyorsa
Kimlik bilgilerinin hiçbiri bu dokümana yazılmaz; şifreli secret deposunda tutulur ve geri okunamaz. Güvenli kanaldan iletilmelidir.
A.6 Uygulama seviyesi limitler
Bölüm başlığı “A.6 Uygulama seviyesi limitler”Ağ erişimi açıldıktan sonra karşılaşılabilecek engeller. Firewall kaynaklı değildir ama testte aynı belirtiyi verir.
| Akış | Limit | Engel | Anahtar |
|---|---|---|---|
| Anonim link · yanıt gönderimi | 5 / saat | 1 saat | IP |
| Kişisel link · tüm istekler | 60 / dk | 5 dk | token + IP |
| Sayfa geçişi / koşul değerlendirme | 180 / dk | 90 sn | anket + IP |
| Web widget ve mobil SDK açılışı | 600 / dk | 1 dk | kanal + IP |
| Mobil SDK · reddedilen açılış | 10 / dk | 10 dk | kanal + IP |
| Link kampanyası · link üretimi | 60 / dk | 5 dk | kampanya |
| Dosya yükleme (anket içi) | 30 / saat | 1 saat | anket + IP |
Değerler varsayılandır ve ortam bazında yükseltilebilir. Yük testi planlanıyorsa hedef ortamdaki limitler önceden gözden geçirilmelidir.
A.7 Kayıt açıldıktan sonra doğrulama
Bölüm başlığı “A.7 Kayıt açıldıktan sonra doğrulama”- Gelen · API erişimi. Karşı sistemin sunucusundan
curl -I https://api.<ortam>/healthçalıştırılır;200beklenir. Zaman aşımı = firewall;403= erişim var, yetki sorunu. - Giden · SFTP / FTPS. Panelde dosya pipeline ayarlarındaki “Bağlantıyı Test Et” kullanılır. Gerçek bağlantı kurar, dosya aktarmaz.
- Giden · Notifigate. Ayarlar → Eposta Sağlayıcıları altındaki test gönderimi kullanılır; gerçek istek atılır.
- Uçtan uca. Bir test anketi için kişisel link üretilip doldurulur ve yanıt panelde görünür.