Genel Bakış
Amacı Nedir?
Amacı Nedir?
Merkezi Bağlantı Yönetimi
Yapılandırma Hatası Azaltma
Ortam Bazlı Yönetim
Hızlı Devreye Alma
Ç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ı
Gözlemleme Platformları
CI/CD Bildirimleri
Olay Yönlendirme
SaaS Entegrasyonları
Teknik Özellikler ve Yetenekler
Temel Özellikler
Temel Özellikler
Dinamik HTTP Metot Seçimi
URL Ve Payload Yönetimi
Akıllı Header Sözlüğü
Ortam Bazlı Yapılandırma
Enable/Disable Kontrolü
İleri Düzey Özellikler
İleri Düzey Özellikler
Otomatik İsim Benzersizlik Kontrolü
Header Yönetiminde Otomatik Doğrulama
Global/Proje Taşıma
Connection Test Özelliği
Export/Import Özelliği
Connection Monitoring
Connection Parametreleri
Zorunlu Parametreler
Zorunlu Parametreler
Name
Örnek Değer:
Production_WebhookNotlar: Boşlukla başlamaz, özel karakter kullanılmaz
Environment
Örnek Değer:
Prod-BlueNotlar: Environment listesi EnvironmentService tarafından doldurulur
HTTP Method
Örnek Değer:
POSTNotlar: GET/POST/PUT/DELETE/HEAD/OPTIONS/PATCH/TRACE desteklenir
Full URL
Örnek Değer:
https://hooks.partner.com/api/logsNotlar: HTTPS kullanılması önerilir, query parametreleri desteklenir
Timeout
Örnek Değer:
10Notlar: UI’da minimum 1 sn, model varsayılan 2 sn
İsteğe Bağlı Parametreler
İsteğe Bağlı Parametreler
Description
Varsayılan Değer: -
Önerilen Değer: Kısa ve eyleme dönük açıklama
Header List
Varsayılan Değer: (Boş liste)
Önerilen Değer: Authorization: Bearer token gibi güvenlik başlıkları
Enabled
Varsayılan Değer: true
Önerilen Değer: Test aşamasında false, Production’da true
Timeout ve Connection Pool Parametreleri
Connection Timeout
Varsayılan: 2000
Min: 1000 | Max: 60000
Birim: milisaniye
Request Timeout
Varsayılan: 2000
Min: 1000 | Max: 60000
Birim: milisaniye
Pool Size
Varsayılan: 0
Min: 0 | Max: 0
Birim: adet
Webhook Retry Delay
Varsayılan: -
Birim: saniye
Kullanım Senaryoları
Operasyon Logları
Çözüm: POST + JSON payload + Authorization header
Beklenen Sonuç: SIEM webhook’u her entegrasyon sonunda log kaydını alır
Deployment Bildirimi
Çözüm: POST https://hooks.slack.com/… + ContentType: application/json
Beklenen Sonuç: Slack kanalında build/deployment sonucu paylaşılır
Üçüncü Taraf Alarmı
Çözüm: POST https://api.servicenow.com/… + API key
Beklenen Sonuç: ServiceNow üzerinde otomatik incident oluşur
SaaS Entegrasyonu
Çözüm: PUT https://crm.partner.com/events/id + Bearer token
Beklenen Sonuç: CRM kaydı güncellenir ve mutabakat akışı devam eder
Gözlemleme Webhook'u
Çözüm: POST https://api.datadoghq.com/api/v1/webhooks
Beklenen Sonuç: Datadog metrik panosunda custom event açılır
Audit Trail
Çözüm: POST https://audit.internal/api/event + X-Trace-Id header
Beklenen Sonuç: Audit servisi çağrıyı kaydeder ve geri dönüş verir
Connection Yapılandırma
Yeni Webhook Entegrasyonu Oluşturma

Yapılandırma Adımları
Oluşturma Sayfasına Gitme
- Sol menüden Connection → Webhook Entegrasyonu 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_Webhook - Benzersiz isim girin, boşlukla başlamaz.
- Sistem otomatik kontrol eder. Yeşil tik: kullanılabilir. Kırmızı çarpı: mevcut isim.
- Örnek: “Prod log forwarding webhook’u”
- 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.
HTTP Bağlantı Parametreleri
- HTTP Method listesinden GET/POST/PUT vb. seçin.
- Full URL alanına https:// ile başlayan tam uç noktayı girin.
- Gerekirse query parametreleri veya path değişkenleri için placeholder kullanın.
Başlık Yönetimi
- Headers sekmesinde + ile yeni satır ekleyin.
- Header Name ve Header Value alanları boş bırakılamaz.
- Otomatik tamamlama listesinden yaygın başlıkları seçebilirsiniz.
Timeout ve Connection Pool Ayarları
- Settings sekmesindeki Timeout alanı isteğin tamamlanması için maksimum süreyi (saniye) belirler.
- Pool size sunucu tarafından yönetildiği için UI üzerinde sadece timeout değeri değiştirilir.
Güvenlik ve Authentication Ayarları
- API anahtarları veya Bearer token’ları Authorization başlığına yazın.
- Temel HTTP auth gerekiyorsa Authorization: Basic … oluşturun.
- HTTPS URL’leriyle SSL/TLS koruması sağlanır; gerektiğinde mutual TLS için sertifika bağlantısını environment seviyesinde yapılandırın.
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}-webhook-integration-{ConnectionName}-export.zipÖrnek:
13 Nov 2025-webhook-integration-Production_Webhook-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 Webhook Entegrasyonu] 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
HTTP Metot Yönetimi
İyi: Hedef servisin gerektirdiği metodu seçmek
En İyi: CRUD operasyonları için GET/POST/PUT/PATCH/DELETE kullanımını sözleşmeye göre ayarlamak
URL Sürümleme
İyi: Yeni connection oluşturarak farklı versiyonları ayırmak
En İyi: Parametrik URL tanımı kullanıp ortam bazlı olarak versiyonları yönetmek
Header Güvenliği
İyi: API anahtarlarını sadece ilgili connection’da saklamak
En İyi: Secret Manager üzerinden dinamik olarak çekilen token’ları kullanmak
Deployment Yönetimi
İyi: Test ortamında doğruladıktan sonra kopyalamak
En İyi: Export/Import ile versiyonlayıp değişiklik kaydını saklamak
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ı
API Anahtar Yönetimi
Header Maskeleme
Yetkilendirme Seviyesi
Kimlik Bilgileri Yönetimi
SSL/TLS Kullanımı
Erişim Kontrolü
Kaçınılması Gerekenler
Kaçınılması Gerekenler
Sabit Token Kullanımı
Alternatif: Ortam bazlı farklı Authorization değerleri kullanın
HTTP Üzerinden Gönderim
Alternatif: URL’yi HTTPS yapın, gerekirse hedef tarafa sertifika sağlayın
Header Çakışmaları
Alternatif: Header tablosunu düzenli gözden geçirip gereksiz satırları kaldırın
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ı
Payload Boyutu
Etki: Daha kısa yanıt süreleri ve daha düşük timeout oranı
Paralel Çağrı Yönetimi
Etki: Hedef sistem aşırı yüklenmez, hata oranı düşer
Retry Stratejisi
Etki: Kritik işlemlerde veri kaybı önlenir
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)
Webhook 4xx Hatası
Webhook 4xx Hatası
URL ve HTTP Metodu
Header Kontrolü
Payload Formatı
Test Connection Başarısız ve 5xx Döndü
Test Connection Başarısız ve 5xx Döndü
Servis Sağlığı
Sertifika Doğrulama
Rate Limit
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)
Aynı webhook connection'ı hem Slack hem de Teams için kullanabilir miyim?
Aynı webhook connection'ı hem Slack hem de Teams için kullanabilir miyim?
Name alanı neden kaydetmeden önce hata veriyor?
Name alanı neden kaydetmeden önce hata veriyor?
Header tablosuna kaç adet satır ekleyebilirim?
Header tablosuna kaç adet satır ekleyebilirim?
Timeout alanı hangi birimde çalışıyor?
Timeout alanı hangi birimde çalışıyor?
Test Connection hangi ortamda çalışır?
Test Connection hangi ortamda çalışır?
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

