Genel Bakış
Amacı Nedir?
Amacı Nedir?
Merkezi Yönetim
Otomatik Kimlik Doğrulama
Güvenlik
Yeniden Deneme
Ortam Bazlı Yönetim
Çalışma Prensibi
Çalışma Prensibi
Bağlantı Başlatma
Connection Pool Yönetimi
Kimlik Doğrulama
Veri İletişimi
Bağlantı Yönetimi
Hata Yönetimi
Kullanım Alanları
Kullanım Alanları
Partner Dosya Alımı
Toplu Rapor Yükleme
SFTP Finansal Veri
FTPS Regülasyon
Legacy Sistem Entegrasyonu
Teknik Özellikler ve Yetenekler
Temel Özellikler
Temel Özellikler
Çoklu Protokol Desteği
Çalışma Dizini İzolasyonu
Retry Politikası
Ortam Bazlı Yapılandırma
Enable/Disable Kontrolü
İleri Düzey Özellikler
İleri Düzey Özellikler
Implicit / Explicit FTPS Anahtarı
Dinamik Proje veya Global Konumlandırma
100 MB'a Kadar Import
Connection Test Özelliği
Export/Import Özelliği
Connection Monitoring
Connection Parametreleri
Zorunlu Parametreler
Zorunlu Parametreler
Name
Örnek Değer:
Production_FTPNotlar: Boşlukla başlamaz, özel karakterler kullanılmamalı
Host
Örnek Değer:
ftp.partner.localNotlar: IPv4/IPv6 veya FQDN kabul edilir
Port
Örnek Değer: 21
Notlar: SFTP için 22, FTPS için 990 önerilir
Username
Örnek Değer:
partner_syncNotlar: Least privilege prensibine göre oluşturulmalı
WorkingDir
Örnek Değer:
/outboundNotlar: İlgili kullanıcının erişim izni olmalı
Protocol
Örnek Değer: FTP / SFTP / FTPS
Notlar: EnumFtpProtocol listesinden seçilir
Timeout
Örnek Değer: 30
Notlar: 1-120 sn aralığında olmalı
RetryCount
Örnek Değer: 3
Notlar: Ağ kesintilerinde kaç tekrar yapılacağını belirtir
SSL Protocol
Örnek Değer: TLS
Notlar: FTPS kullanımında zorunludur
İsteğe Bağlı Parametreler
İsteğe Bağlı Parametreler
Password
Varsayılan Değer: (Boş)
Önerilen Değer: Secret Manager referansı
UseImplicit
Varsayılan Değer: false
Önerilen Değer: true (FTPS implicit gereken ortamlarda)
UseExplicit
Varsayılan Değer: true
Önerilen Değer: true (varsayılan; FTPS dışı senaryolarda false yapılabilir)
Timeout ve Connection Pool Parametreleri
Connection Timeout
Varsayılan: 30000
Min: 5000 | Max: 120000
Birim: milisaniye
Request Timeout
Varsayılan: 60000
Min: 10000 | Max: 180000
Birim: milisaniye
Pool Size
Varsayılan: 10
Min: 1 | Max: 50
Birim: adet
Retry Interval
Varsayılan: 2000
Min: 500 | Max: 10000
Birim: milisaniye
Kullanım Senaryoları
Partner Dosya Alımı
Çözüm: WorkingDir=/inbox, Protocol=SFTP, RetryCount=5
Beklenen Davranış: Gece job’ı dosyaları güvenli şekilde indirir
Regülasyon FTPS Aktarımı
Çözüm: UseImplicit=true, Port=990, SSL Protocol=TLS1.2
Beklenen Davranış: TLS el sıkışması başarılı olur, dosyalar şifreli taşınır
Legacy FTP Push
Çözüm: Protocol=FTP, Port=21, Timeout=45
Beklenen Davranış: Gateway klasik FTP üzerinden yükleme yapar
Büyük Dosya Segmentasyonu
Çözüm: Timeout=90, Pool Size=20, Flow’da chunk upload
Beklenen Davranış: Uzun süren transferlerde kopma yaşanmaz
Disaster Recovery
Çözüm: Ortam=Production, Host=dr-ftp.local, UseExplicit=false
Beklenen Davranış: Ana ve DR sistemleri senkron tutulur
Güvenlik Taraması
Çözüm: Ortam=Test, Protocol=SFTP, WorkingDir=/audit
Beklenen Davranış: Sadece audit klasörü erişilir
Connection Yapılandırma
Yeni FTP Bağlantısı Oluşturma

Yapılandırma Adımları
Oluşturma Sayfasına Gitme
- Sol menüden Connection → FTP Bağlantısı bölümüne gidin.
- Sağ üstteki [+ Create] butonuna tıklayın.
Temel Bilgileri Girme
- Toggle ile aktif/pasif durumu ayarlayın. Yeni connection’lar varsayılan olarak aktiftir.
- Örnek:
Production_FTP - Benzersiz isim girin, boşlukla başlamaz.
- Sistem otomatik kontrol eder. Yeşil tik: kullanılabilir. Kırmızı çarpı: mevcut isim.
- Örnek: “Partner FTP yüklemeleri”
- Maks. 1000 karakter.
- Connection’ın amacını açıklayın.
Environment (Ortam) Seçimi
- Dropdown menüden ortam seçin: Development, Test, veya Production.
- Her ortam için farklı connection parametreleri tanımlanabilir.
FTP Specific Parametreler - Bölüm 1
- Host & Port: Hedef FTP adresini girin, protokole göre port ayarlayın.
- Protocol: FTP, SFTP veya FTPS seçin.
- WorkingDir: Erişilecek klasörün tam yolunu yazın.
- Username/Password: Opsiyonel parolayı girin veya boş bırakıp credential store kullanın.
FTP Specific Parametreler - Bölüm 2
- UseImplicit / UseExplicit: FTPS el sıkışma şeklini seçin.
- SSL Protocol: TLS sürümünü belirleyin (örn. TLS1.2).
- Deploy to Worker: Bağlantının worker üzerinde tutulmasını istiyorsanız aktif bırakın.
Timeout ve Connection Pool Ayarları
- Timeout: Ağ gecikmesine göre 30-90 sn arası ayarlayın.
- RetryCount: Kararsız bağlantılarda 3-5 arası önerilir.
- Gerekirse Integration Flow adımında Request Timeout ve Pool Size değerleri özelleştirilir.
Güvenlik ve Authentication Ayarları
- Kullanıcı adı/şifre veya SSH anahtarını secret manager’dan çekin.
- FTPS için gerekli sertifikaları trust store’a yükleyin.
- Uyarı: Production ortamında anonim FTP erişimine izin vermeyin.
Test Connection
- [Test Connection] butonuna tıklayın.
- Bağlantı parametrelerinin doğru olup olmadığını test edin.
- Başarılı: Yeşil onay mesajı
- Başarısız: Hata detayları gösterilir
Kaydetme
- Sağ üstteki [Save and Deploy] butonuna tıklayın.
- Benzersiz isim
- Zorunlu alanlar dolu
- Test connection başarılı (önerilir)
- Connection listeye eklenir
- Integration Flow ve Connector adımlarında kullanılabilir hale gelir
- Ortama göre aktif olur
Connection’ı Silme
Connection’ı silmek için:Yöntem 1: Liste Ekranından
- Connection listesinde satır sonundaki ⋮ menüsünden Delete seçeneğini tıklayın.
- Onay dialogunda silme işlemini onaylayın.
Silme İpuçları
- Integration Flow veya Connector adımlarında kullanılıyor olabilir.
- Gerekirse alternatif bir connection atayın.
- Silmeden önce Export ile yedek alın.
Alternatif: Deaktif Etme
- Silmek yerine connection’ın aktif durumunu pasif hale getirin.
- Connection pasif olur ancak silinmez.
- Gerektiğinde aktif hale getirerek yeniden kullanabilirsiniz.
Connection’ı Dışa/İçe Aktarma
Dışa Aktarma (Export)
Dışa Aktarma (Export)
Yöntem 1: Liste Ekranından
- Connection listesinde satır sonundaki ⋮ menüsünden Export seçeneğini tıklayın.
- ZIP dosyası otomatik olarak indirilir.
Dosya Formatı
{Date}-ftp-integration-{ConnectionName}-export.zipÖrnek:
13 Nov 2025-ftp-integration-Production_FTP-export.zipZIP İçeriği
- Connection JSON dosyası
- Metadata bilgileri
- Bağımlılık bilgileri (örneğin sertifikalar, key store)
Kullanım Alanları
- Yedekleme
- Ortamlar arası taşıma (Test → Prod)
- Versiyonlama
- Ekip veya proje bazlı paylaşım
İçe Aktarma (Import)
İçe Aktarma (Import)
İçe Aktarma Adımları
- Ana listede [Import FTP Bağlantısı] butonuna tıklayın.
- İndirilen ZIP dosyasını seçin.
- Sistem kontrolleri: Format geçerli mi? İsim çakışması var mı? Bağımlılıklar mevcut mu?
- Ardından [Import] butonuna tıklayın.
İçe Aktarma Senaryoları
Connection’ın Kullanım Alanları
Connection Oluşturma ve Aktif Etme
- Connection’ı oluşturun
- Test Connection ile bağlantıyı doğrulayın
- Save and Deploy ile kaydedin ve etkinleştirin
- Connection’ın Enabled durumda olduğundan emin olun.
Integration / Connector Adımlarında Kullanım
Scheduled Job Kullanımı
Test Amaçlı Kullanım
Best Practices
Yapılması Gerekenler ve En İyi Uygulamalar
Yapılması Gerekenler ve En İyi Uygulamalar
Çalışma Dizini Yönetimi
İyi: Yalnızca gerekli klasöre izin vermek
En İyi: Her senaryo için ayrı workingDir tanımlayıp ACL ile sınırlandırmak
Kimlik Bilgileri Yönetimi
İyi: Şifreyi Secret Manager’da tutup referanslamak
En İyi: SSH anahtar veya Vault tabanlı dinamik kimlik bilgileri kullanmak
Protokol Seçimi
İyi: Gerektiğinde SFTP veya FTPS seçmek
En İyi: Ortam bazlı protokol yönetip güvenlik gereksimiyle eşlemek
İzleme ve Alarm
İyi: Pool ve timeout metriklerini dashboard’a taşımak
En İyi: Alarm eşikleri tanımlayıp otomatik incident oluşturmak
Ortam Yönetimi
İyi: Her ortam için ayrı connection oluşturmak
En İyi: Environment seçeneğini kullanarak tek connection’da tüm ortamları yönetmek, ortamlar arası geçişte sadece environment değiştirmek
Connection Test
İyi: Kaydetmeden önce Test Connection ile doğrulamak
En İyi: Her parametre değişikliğinden sonra test etmek, production’a geçmeden önce test ortamında tam entegrasyon testi yapmak
Güvenlik En İyi Uygulamaları
Güvenlik En İyi Uygulamaları
SFTP Anahtar Yönetimi
IP ve Firewall Kısıtları
Dosya Bütünlüğü
Kimlik Bilgileri Yönetimi
SSL/TLS Kullanımı
Erişim Kontrolü
Kaçınılması Gerekenler
Kaçınılması Gerekenler
Anonim FTP Kullanımı
Alternatif: Kimlik bilgisi zorunlu kullanıcılar tanımlayın
Geniş Yetkili Kullanıcılar
Alternatif: Salt okunur veya sadece gerekli dizinlere yetkili hesaplar kullanın
Yanlış Protokol Seçimi
Alternatif: Gereksinime göre SFTP/FTPS seçin, protokolü dökümante edin
Production Connection'ı Test Ortamında Kullanma
Alternatif: Her ortam için ayrı connection oluşturun, environment parametresini kullanın, connection isimlerini ortama göre prefix ekleyerek ayırın (Test_, Prod_)
Çok Düşük Timeout Değerleri
Alternatif: Gerçek kullanım senaryolarına göre timeout değerlerini ayarlayın, network latency’yi ölçün ve timeout’ları buna göre belirleyin
Connection Pool Kullanmama
Alternatif: Connection pool aktif edin, pool size’ı trafik hacmine göre ayarlayın, pool monitoring kurun
Performans İpuçları
Performans İpuçları
Dosya Segmentasyonu
Etki: Transfer süresi kısalır, yeniden deneme maliyeti düşer
Pasif/aktif FTP Seçimi
Etki: Ağ sorunları azalır, bağlantı stabilitesi artar
SFTP Cipher Ayarı
Etki: CPU yükü ve gecikme azalır
Connection Pool Optimizasyonu
Etki: Bağlantı açma maliyeti %80 azalır, yanıt süreleri düşer, kaynak kullanımı optimize edilir
Timeout Değerleri Optimizasyonu
Etki: Gereksiz beklemeler önlenir, hızlı fail-over sağlanır, kullanıcı deneyimi iyileşir
Connection Monitoring
Etki: Sorunlar proaktif tespit edilir, performans darboğazları erken belirlenir, kesinti süresi azalır
Sorun Giderme (Troubleshooting)
Directory Listing Başarısız
Directory Listing Başarısız
WorkingDir Doğrulama
Kullanıcı İzinleri
Pasif Port Aralığı
SSL/TLS Negotiation Hatası
SSL/TLS Negotiation Hatası
TLS Sürümü
Sertifika Yenileme
FTPS Modu
Connection Timeout
Connection Timeout
Network Kontrolü
Sistem Sağlığı
Timeout Ayarları
Log İnceleme
Authentication Failed
Authentication Failed
Kimlik Bilgileri
Kullanıcı Durumu
Yetki Kontrolü
Sertifika Kontrolü
Pool Exhausted
Pool Exhausted
Pool Size
Connection Kontrolü
Idle Timeout
Metrik İzleme
Connection Test Başarılı Ama Entegrasyon Akışı Hata Veriyor
Connection Test Başarılı Ama Entegrasyon Akışı Hata Veriyor
Enable Toggle
Connection Seçimi
Connection Deploy
Flow/Job Deploy
Log Kontrolü
Sık Sorulan Sorular (SSS)
FTP ve SFTP için ayrı connection tanımlamak zorunda mıyım?
FTP ve SFTP için ayrı connection tanımlamak zorunda mıyım?
Çalışma dizinini sonradan değiştirmek akışları etkiler mi?
Çalışma dizinini sonradan değiştirmek akışları etkiler mi?
Pasif FTP port aralığını nereden yönetebilirim?
Pasif FTP port aralığını nereden yönetebilirim?
SFTP anahtar dosyasını nasıl bağlarım?
SFTP anahtar dosyasını nasıl bağlarım?
Aynı bağlantıyı hem indirme hem yüklemede kullanabilir miyim?
Aynı bağlantıyı hem indirme hem yüklemede kullanabilir miyim?
Aynı connection'ı birden fazla Integration Flow'da kullanabilir miyim?
Aynı connection'ı birden fazla Integration Flow'da kullanabilir miyim?
Connection pool kullanmak zorunlu mudur?
Connection pool kullanmak zorunlu mudur?
Test ve Production için farklı connection'lar mı oluşturmalıyım?
Test ve Production için farklı connection'lar mı oluşturmalıyım?
Test Connection başarılı ama Integration Flow'da çalışmıyor, neden?
Test Connection başarılı ama Integration Flow'da çalışmıyor, neden?
- Connection enable toggle’ı pasif olabilir
- Integration adımında farklı bir connection seçili olabilir
- Connection deploy edilmemiş olabilir
- Integration Flow henüz redeploy edilmemiş olabilir

