Entegrasyon Sayfası Kılavuzu

Entegrasyonlar sayfası, IT, güvenlik ve iş birliği araçlarınıza giden her bağlantının yapılandırıldığı, test edildiği ve izlendiği tek yönetici yüzeyidir. Bu bir veritabanındaki kimlik bilgileri listesi değil - Moftgate’in geri kalan yığınınızla nasıl konuştuğunun operasyonel kontrol düzlemidir.

General > Settings > Integrations altındadır ve General navigasyonundan, ana Settings sayfası kartından ve global Spotlight aramasından ulaşılabilir. Yönetici olmayan kullanıcılar erişemez.

Dört farklı yeteneği gruplandırır; hepsi ortak bir temayı paylaşır: Moftgate’in kendi dışındaki sistemlerle nasıl iletişim kurduğu.

Aktif sekme bir query parametresiyle ayarlanır; böylece yer imi eklenebilir, paylaşılabilir ve sayfa yeniden yüklendiğinde korunur.

Görseli kapat

Entegrasyonlar sekmesi operatörlerin en çok zaman geçirdiği yerdir. Desteklenen her entegrasyon tipini bir kart olarak gösterir - tablo olarak değil - çünkü entegrasyonlar yapılandırılmış nesnelerdir, telemetri satırları değil. Her kart sağlayıcı logosu, yetenek rozetleri, düz bir açıklama ve kullanım faydasını gösterir; operatör harici dokümantasyon okumadan seçim yapabilir.

Moftgate on yerleşik entegrasyon tipiyle birlikte gelir; her birinin kendi kimlik bilgisi, teslimat davranışı ve yetenek seti vardır. Her tip tam teşekküllü bir bağlayıcıdır; etiketi değişmiş genel bir webhook değildir.

Her outbound çağrı - bir olay teslimatı veya asset senkronizasyonu - olay adı, URL, HTTP durumu, sonuç, süre ve mesajla kaydedilir. Bu entegrasyon katmanının audit izidir. Entegrasyon başına Olaylar modalı bu logu sayfalandırır; operatörler başarısız teslimatları sorun giderir ve kart modal açmadan en son sonucu gösterir.

Entegrasyon yapılandırmak tek bir uzun form değildir. Her adımı ilerlemeden önce doğrulayan, üstte ilerlemeyi gösteren ve tamamlanmış adımlara geri atlamaya izin veren çok adımlı bir sihirbazdır.

1. 1
   Detaylar

   Sağlayıcı logosu, açıklaması, faydası ve entegrasyon için bir görünen ad.

2. 2
   Yapılandırma

   Tipe özgü alanlar: URL, API anahtarı, token, proje anahtarı veya site.

3. 3
   Olaylar

   Entegrasyonun hangi Moftgate olaylarını alacağı.

4. 4
   Asset senkronizasyonu

   Assets yeteneği olan tipler için: senkronizasyonu aç ve grupları sağlayıcı şirket/site’lerine eşle.

5. 5
   İnceleme

   Özet, bağlantı testi, aktif toggle ve kaydet.

Webhook’lar, yerleşik entegrasyonların sağlayıcıdan bağımsız genel karşılığıdır. Yerleşik entegrasyon Jira veya Splunk ile nasıl konuşacağını bilirken, webhook yapılandırdığınız herhangi bir URL’ye imzalı bir JSON payload’u POST eder. Webhook’ları Moftgate’in yerleşik bağlayıcısı olmayan bir sisteme olay teslim etmek istediğinizde kullanın.

Bir webhook’ta secret yapılandırıldığında, her teslimat JSON gövdesi üzerinden HMAC-SHA256 ile imzalanır ve X-Moftgate-Signature header’ında gönderilir. Alıcı imzayı doğrulayarak payload’un Moftgate’ten geldiğini ve yolda değiştirilmediğini teyit eder.

Teslimatlar kuyruğa alınır ve geri çekilme ile en fazla üç kez yeniden denenir; böylece yavaş veya geçici olarak erişilemeyen bir alıcı istek işlemeyi asla engellemez. Webhook kartından manuel test payload’u göndererek endpoint’inizi doğrulayabilirsiniz.

API anahtarları Moftgate REST API’sine programatik erişim sağlar. Bir script’e, CI işlem hattına veya Moftgate verisini okuyup yazması gereken üçüncü taraf bir araca vereceğiniz kimlik bilgisidir.

• Anahtarlar hash olarak saklanır - düz metin token asla kalıcı olarak kaydedilmez.
• Token formatı bir ön ek ve ardından 64 hex karakterdir (32 rastgele bayt), yalnızca oluşturmada bir kez gösterilir.
• Kimlik doğrulama Bearer token header’ı kullanır. Panel anahtarı ön eke göre bulur, ardından hash’i doğrular.
• İki yetenek: read (salt okunur) ve write (okuma ve yazma).
• İptal: anahtarı silin veya devre dışı bırakın. İkisi de token’ı anında durdurur.

Tek oturum açma, panel kullanıcıları için OIDC uyumlu kimlik sağlayıcı girişi sağlar. Bu tam işlevsel giriştir, yalnızca yapılandırma depolaması değil. Dört sağlayıcı tipi desteklenir: Microsoft Entra ID, Google Workspace, Okta ve Özel OIDC.

SSO modalı iki sütunlu bir düzendir: solda form, sağda kopyalanabilir callback ve discovery URL’leri ve adım adım talimatlar içeren kalıcı bir kurulum kılavuzu. Kılavuz formu doldururken görünür kalır; böylece odak asla kaybolmaz ve dar ekranlarda formun altına yığılır. Kılavuzdaki her URL tıklayınca kopyalanan bir çiptir; metni manuel seçmeniz gerekmez.

Her OIDC sağlayıcı için bir client ID ve client secret gereklidir - bunlar bu paneli kimlik sağlayıcıda bir OAuth2 istemcisi olarak tanımlar. Client secret şifreli saklanır ve asla tarayıcıya açıklanmaz. Bir sağlayıcıyı yeni secret girmeden düzenlerseniz mevcut değer korunur.

Giriş sayfası her aktif SSO sağlayıcıyı bir giriş düğmesi olarak listeler. Kullanıcı giriş yaptığında panel kimlik token’ını doğrular, kullanıcıyı e-posta ile eşleştirir ve ya kullanıcıyı giriş yaptırır ya da yeni bir hesap otomatik sağlar. Yerel 2FA atlanır çünkü MFA’yı kimlik sağlayıcı yönetir. Modaldeki test bağlantısı düğmesi, kaydetmeden önce discovery dokümanını ve imzalama anahtarlarını yükleyerek yapılandırmayı doğrular.

SIEM log yönlendirme, Entegrasyonlar sayfasından ayrı olarak, ana Settings sayfasındaki SIEM Log Forwarding kartundan yönetilir. UDP, TCP ve HTTPS taşıyıcılarını ve CEF, LEEF, RFC 5424 ve JSON formatlarını destekler; böylece HTTP API yerine syslog tarzı giriş tercih eden herhangi bir SIEM’e log akışı gönderebilirsiniz.

Bu, Entegrasyonlar sekmesindeki yerleşik Splunk entegrasyonunu tamamlar: HTTP Event Collector yönlendirmesi için Splunk entegrasyonunu, Splunk, QRadar veya başka bir toplayıcıya syslog akışı için SIEM yönlendirmeyi kullanın.

• Outbound-only: her entegrasyon, webhook ve asset senkronizasyonu outbound’dur. Panel tüm istekleri başlatır - gelen firewall kuralı, public callback URL veya açık listener yoktur.
• Şifreli gizli değerler: API anahtarları, client secret’lar, HEC token’ları ve private key’ler disk üzerinde şifreli veya hash’lenmiş olarak saklanır. Düz metin API token’ı yalnızca oluşturma sırasında bir kez gösterilir ve düzenleme formlarında tarayıcıya asla gönderilmez.
• Entegrasyon başına kimlik bilgisi: her entegrasyonun kendi kimlik bilgisi vardır. Sızdırılmış bir Slack webhook URL’si Jira API token’ınızı açığa çıkarmaz - en az ayrıcalık ilkesi entegrasyon sınırında uygulanır.
• Audit loglama: yöneticinin Entegrasyonlar sayfasındaki her eylemi isimli parametrelerle loglanır ve audit log’unun kendisi webhook’lar için bir olay kaynağıdır.
• Transaction’a alınan yazmalar: kritik işlemler - grup eşlemeleriyle entegrasyon oluşturma, API anahtarı oluşturma, SSO sağlayıcı saklama - tek bir veritabanı transaction’ı içinde yürütülür; kısmi başarısızlık sistemi tutarsız bırakmaz.