Bulguları bilet sisteminize devretme

Bulgu, bir kişinin bir tespitin önemli olduğunu söylemesi ve sahibini adlandırmasıdır. Bu devir, o cümleyi ait olduğu yere — mevcut bilet kuyruğunuza — tek bir genel imzalı webhook üzerinden koyar ve bilet referansını geri alır.

Bu nedir, ne değildir

CID222 bilinçli olarak hiçbir Jira istemcisi ve hiçbir ServiceNow istemcisi ile gelmez. Bilet sistemi olan her kurumun önünde zaten bir ara katman, bir otomasyon kuralı ya da bir webhook alıcısı vardır ve alan eşlemesi, proje yönlendirmesi ile kimlik bilgileri zaten o katmanda yaşar. Birinci taraf bir sağlayıcı istemcisi; üçünü de yapılandırmak için ikinci bir yer, bunların bayatlaması için ikinci bir yer ve sonsuza dek sahiplenilecek sağlayıcı başına bir kimlik doğrulama öyküsü demek olurdu.

Bu yüzden sözleşme tek bir biçimdedir: SIEM webhook'uyla aynı toplu gönderim zarfı ve aynı imza altında bir bulgu; böylece biri için yazılmış bir alıcı diğerini de ayrıştırır.

Devri yapılandırın

Yük

Standart toplu gönderim zarfının içinde, durum değişikliği başına bir olay:

{
  "event_id": "cid-finding-ac4d0a31863259669e3409836c94b852",
  "event_type": "finding.created",
  "occurred_at": "2026-09-02T15:17:31.539Z",
  "source": "cid222",
  "finding": {
    "id": "d40448b0-1208-4e26-9cb7-c52f39cc77c6",
    "title": "Redacted on browser: EMAIL, PHONE, privacy",
    "status": "open",
    "owner_email": "dpo@example.com",
    "due_date": "2026-09-30",
    "next_step": "Confirm the export was re-run without the sheet",
    "detection_ref": "inspection:3d3dd9fd-…",
    "regulation_ids": ["gdpr", "kvkk", "iso_27001"],
    "itsm_ref_id": null,
    "itsm_ref_url": null,
    "itsm_ref_status": null
  },
  "correlation_id": "cid-finding-d40448b0-1208-4e26-9cb7-c52f39cc77c6",
  "deep_link": "https://cid.example.com/compliance?tab=findings&finding_id=d40448b0-…",
  "defaults": { "project_key": "SEC", "issue_type": "Task", "priority": "P3" },
  "seq": 1
}

Bir alıcıda işi iki alan yapar:

• correlation_id, bulgunun ömrü boyunca kararlıdır. Her güncellemeyi bununla tek bir bilete bağlayın.
• event_id, bulgunun durumunun bir özetidir; yani değişmemiş bir satırın yeniden denenmesi bayt bayt aynı yükü üretir. Yinelenenleri bunun üzerinden ayıklayın — ama birkaç hedef arasında değil, tek bir hedef içinde; çünkü aynı durumu alan iki hedef meşru biçimde aynı kimliği gönderir.

Yalnızca üstveri, tek bir dürüst istisnayla. Bir bulgu karar kaydından türetilir; bu yüzden varlık türlerini ve sayılarını taşır, eşleşen bir değeri asla taşımaz. İstisna next_step alanıdır: işletmecinin serbest metnidir ve olduğu gibi iletilir. Ağ geçidi buraya hiçbir zaman tespit edilmiş bir değer yazmaz, ama oraya bir değer yazan bir insan onu göndermiş olur. Bunu kabul edemeyen bir kurum, bir ITSM hedefi bağlamamalıdır.

Bilet referansını geri yazın

CID222, bilet kimliğini devir anında öğrenmez; çünkü bu, aktarımı ITSM'inizin yanıtına bağlamak ve o yanıtı ayrıştıracak kadar API'sini konuşmak demek olurdu.

Bunun yerine alıcınız — ya da bileti açmış bir kişi — üç değeri sıradan bulgular uç noktası üzerinden bulgunun üzerine geri yazar: referans kimliği, referans URL'si ve referans durumu. Bulgular sekmesi bundan sonra üç ayırt edilebilir durumu olan bir Bilet sütunu gösterir: bir URL biliniyorsa bir bağlantı, yalnızca bir kimlik döndüyse çıplak referans ve devir gerçekleşmiş ama hiçbir şey dönmemişse Gönderildi.

Referans durumu, bulgunun kendi durumuna asla eşlenmez. Bulgunun durumu, CID222'nin bir kişinin verdiği kararı kaydettiği şeydir; uzak bir iş akışı geçişinin bunu yeniden yazmasına izin vermek, bilet sisteminizin bir uyumluluk kaydını düzenlemesine izin vermek olurdu.

Bir referans yazmak, onu taşıyan bir güncelleme olayı daha üretir; bu da alıcıya bağlantının yerine oturduğunu doğrular. İş orada biter — doğrulayan olay, bir başkasını doğuracak hiçbir şeyi değiştirmez.

Doğrulama

1. Test bulgusu alıcınıza yukarıdaki biçimde ulaşır ve imzası, ayarladığınız gizli anahtara karşı doğrulanır.
2. Uyumluluk sayfasının Bulgular sekmesinde gerçek bir bulgu açın. Bir yoklama aralığı içinde alıcı, ilişki kimliği eşleşen bir oluşturma olayı alır.
3. O bulguyu düzenleyin. Alıcı aynı ilişki kimliğine ve farklı bir olay kimliğine sahip bir güncelleme olayı alır.
4. Bir bilet referansını geri yazın ve Bilet sütununun Gönderildi durumundan bir bağlantıya döndüğünü doğrulayın.
5. Hedefi kapalı bir porta yönlendirin ve cihazın, ITSM önekli bir gerekçeyle bir SIEM_EXPORT_DEGRADED olayı ürettiğini doğrulayın. Bu, SIEM aktarımının kullandığı olay türünün aynısıdır ve bu bilinçlidir: teslim edemeyen bir hedef, teslim edemediği haberini de teslim edemez; bu yüzden duyuru sağlıklı bir SIEM hedefinden dışarı çıkar.

Başarısız olursa

• Hiçbir şey gelmiyor ama hedef sağlıklı görünüyor — gönderilecek bir şeyin olmadığı bir döngü başarı sayılır. Sessiz bir cihazda ölü bir hedef, kendisine iş geldiğinde duyurulur, öncesinde değil.
• Her bulgu bir oluşturma değil güncelleme olarak geliyor — hedef, o bulgular var olduktan sonra eklenmiştir. Bu tasarım gereğidir; geriye dönük doldurma yoktur.
• Alıcı yinelenenler görüyor — teslim en az bir kezdir ve alıcınız işledikten sonra zaman aşımına uğrayan bir gönderim yeniden gelir. Olay kimliği üzerinden yinelenenleri ayıklayın.
• Uzlaştırmanız sıra numaralarında bir boşluk bildiriyor — bildirmemeli. Alıcıya hiç ulaşmayan bir gönderim numaralarını geri alır; yani yineleme olabilir, boşluk olamaz. Gerçek bir boşluk, olayların kaybolduğunu değil bir kapsamla süzüldüğünü gösterir.
• Bir referans URL'si reddediliyor — yalnızca mutlak bir http ya da https URL'si kabul edilir; çünkü bulgular tablosu bunu bir bağlantı olarak görüntüler ve onu uzak bir sistem yazar.
• Başka bir departmanın bulguları geliyor — hedefte kapsam ayarlanmamıştır. Kapsamsız bir hedef her departmanı görür.

Planlananlar

Çevredeki tasarım belgeleri sürüme girenden fazlasını anlattığı için açıkça belirtiliyor:

• Bir onay iş akışı yoktur. Bulgu bir durum makinesi değil, bir kayıttır: hiçbir şey yüksek riskli bir olayı bir onaylayıcıya göndermez ve onaylandı ya da reddedildi kararını geri almaz. Eklentinin paneli, satır uydurmak yerine tam da bu nedenle boş bir onay listesi bildirir.
• Hiçbir şey bilet sisteminizi yoklamaz. Durum yalnızca yukarıda anlatılan yönde, bulgunun üzerine geri yazılarak ilerler.
• Sağlayıcı başına bir bağlayıcı yoktur ve planlanmamıştır. Genel webhook, bir yer tutucu değil, tasarımın kendisidir.

Sonraki adımlar

• Tespitleri SIEM'inize aktarma — diğer giden kanal ve bunun yeniden kullandığı ortak teslim ile sağlık düzeneğinin kaynağı.
• Tümleşmeler — ayarlar sayfası, alan alan.