KKV tespiti
CID222'nin tespit ettiği kişisel veri varlık türleri, regex ile NER modelinin işi nasıl paylaştığı ve bir tespitin nasıl yer tutucuya dönüştüğü.
- Sürüm: 0.4
- Rol: admin_user, normal_user, viewer
CID222, kişisel veriyi bir prompt bir sağlayıcıya ulaşmadan önce ve bir yanıt kullanıcıya ulaşmadan önce tespit eder. İşi iki katman yapar: sağlama toplamlı deterministik desenler ve çok dilli bir ONNX NER modeli.
Sorun
Kişisel veri etiketli gelmez. Bir kişinin yazdığı paragrafın içinde, sizin seçmediğiniz bir dilde, bazen bir belgenin taraması olarak gelir. Bir desen, biçimi olanı yakalar — bir kart numarası, bir IBAN, bir ulusal kimlik — ve hiç görmediği bir adı kaçırır. Bir model adı yakalar ama kart numarasının gerçek olduğunu kanıtlayamaz. Yalnızca birini çalıştırmak ya sızdırmak ya da işi durdurmak demektir; ikisini birden çalıştırmak, aynı on beş karakter hakkındaki iki görüşü uzlaştırmak demektir.
CID222 bunu nasıl yapar
İki katman, tek katalog
Regex katmanı desenlerini veritabanındaki girdi filtresi satırlarından yükler; böylece katalog, bir yöneticinin genişletebileceği bir veridir, kod değildir. NER katmanı, 21 yerel etiket üreten tek bir çok dilli ONNX DistilBERT modelidir. Kavram örtüştüğünde her iki katman da aynı varlık türünü bildirir; böylece aynı aralığa ilişkin tespitler iki kez sayılmak yerine birleştirilir.
Neler tespit edilir
Aşağıdaki her satır paketle gelen bir filtredir. Varsayılan eylem, tohumun ayarladığıdır; bir yönetici bunu kural bazında değiştirir ve kiracı veya grup bazlı bir geçersiz kılma, kurala hiç dokunmadan tek bir departman için değiştirebilir.
Kişisel tanımlayıcılar
| Varlık | Açıklama | Tespit eden | Varsayılan eylem |
|---|---|---|---|
PERSON_NAME | Kişi adları | NER ve Türk kimlik kartlarındaki büyük harfli adlar için bir regex | mask |
EMAIL | E-posta adresleri | Regex, NER | mask |
PHONE | Telefon numaraları — ABD, uluslararası, Türkiye mobil ve sabit hat, altı desen | Regex, NER | mask |
SSN | ABD Sosyal Güvenlik numarası | us.ssn sağlama toplamlı regex, NER | mask |
TC_KIMLIK, ID_NUMBER | T.C. kimlik numarası, OCR toleranslı ve bağlam çapalı biçimler dahil | tr.tckimlik sağlama toplamlı regex, NER | mask |
ID_DOCUMENT_NO | Türk kimlik kartı belge ve seri numarası | Regex | mask |
PASSPORT | Pasaport numaraları — ABD, genel AB, Türkiye | Regex, NER | mask |
DATE_TIME | Tarih ve saatler | Yalnızca NER | flag |
Finansal veriler
| Varlık | Açıklama | Tespit eden | Varsayılan eylem |
|---|---|---|---|
CREDIT_CARD | Kart numaraları; düz, boşluklu ve noktalı | Luhn ile marka ve uzunluk doğrulamalı regex, NER | mask |
IBAN, ACCOUNT_NUMBER | IBAN, Türkiye IBAN'ı ve Türkiye yurt içi hesap numaraları | ISO 13616 mod-97'li regex, NER | mask |
VKN, TAX_ID | Vergi kimlik numarası | tr.vkn sağlama toplamlı regex | mask |
CRYPTO_ADDRESS | Kripto cüzdan adresleri | Yalnızca NER | mask |
Konum ve ağ verileri
| Varlık | Açıklama | Tespit eden | Varsayılan eylem |
|---|---|---|---|
LOCATION, STREET_ADDRESS, CITY, ZIPCODE | Adresler, şehirler, bölgeler, posta kodları | NER ve il aralığı denetimli bir Türkiye posta kodu regex'i | flag |
IP_ADDRESS | IPv4 ve IPv6 | Regex, NER | mask |
LICENSE_PLATE | Türkiye araç plakaları, il aralığı denetimli | Regex, NER | mask |
URL | URL'ler | Yalnızca NER | flag |
ORGANIZATION | Şirket ve kurum adları | Yalnızca NER | flag |
mac_colon, mac_hyphen | MAC adresleri | Yalnızca regex | mask |
Sağlık verileri
| Varlık | Açıklama | Tespit eden | Varsayılan eylem |
|---|---|---|---|
mrn_labeled, mrn_format | Tıbbi kayıt numaraları, etiketli ve çıplak biçimler | Yalnızca regex | mask |
Warning
Tıbbi kayıt numaraları ve MAC adresleri, model etiketi olmayan yalnızca regex kurallarıdır; bu
yüzden bir API yanıtındaki type değerleri düzgün bir MRN veya MAC_ADDRESS değil, yukarıda
görülen desen adıdır. value değerleri yine yer tutucuyu taşır — [MRN], [MAC_ADDRESS].
Kararlı bir kategoriye ihtiyacınız varsa yer tutucuya göre eşleştirin. Daha geniş bir sağlık
verisi tespit motoru yoktur: CID222 durumları, ilaçları veya tanıları sınıflandırmaz.
Note
Kişisel verinin ötesinde, ayrı bir DLP kural kümesi sızdırılan sırları tespit eder — API anahtarları, parolalar, özel anahtarlar, veritabanı bağlantı dizeleri, OAuth ve yenileme token'ları, webhook sırları, CVE tanımlayıcıları. Tam katalog içerik tespiti sayfasındadır.
Güvenmeden önce doğrulama
Bir tespit, doğrulamadan geçmeden uygulanmaz. Kurallar sekiz kategoride gelir — length,
boundary, context, confidence, pattern, content, checksum ve intent_gate — ve filtre
satırlarına veri olarak iliştirilir.
Sağlama toplamı kategorisi bunların en güçlüsüdür ve üç durumlu bir karar döndürür:
| Karar | Anlamı | Etkisi |
|---|---|---|
valid | Biçim doğru ve denetim geçti | Tespit geçerli kalır |
invalid | Biçim doğru, denetim başarısız | Düşürülür veya kural söylüyorsa mask'tan flag'e indirilir |
unknown | Bu doğrulayıcının biçiminde değil | Doğrulayıcı hiç çalışmamış gibi davranılır |
Bu üçüncü durum göründüğünden önemlidir. Bir ulusal kimlik alanı B1234567 gibi belge numaraları da taşır, bir banka hesabı alanı çıplak hesap numaraları da taşır. Yalnızca sayı okuyan bir sağlama toplamı ikisini de okuyamaz ve açığa düşmek, bunların sessizce atılmasını engelleyen şeydir.
Doğrulanan bir varlık yalnızca nihai güveni 0.6'ya ulaştığında geçer. Bir tespit, varlık türü
için kayıtlı bir bağlam anahtar kelimesi aralığın 50 karakter yakınında göründüğünde 0.1
artırılır ve 1.0'da sınırlanır — örneğin email kuralı contact ve communication kelimelerini
kaydeder. Anahtar kelime–tür haritası etkin filtre satırlarından yüklenir.
Maskeleme
Maskelenen bir varlık bir yer tutucuyla değiştirilir ve yer tutucu iki yerden birinden gelir.
- Bir regex kuralı kendi
replacement_textdeğerini kullanır.[EMAIL],[PHONE],[SSN],[CREDIT_CARD],[IBAN],[NATIONAL_ID],[DOCUMENT_NO],[PASSPORT],[LICENSE_PLATE],[POSTAL_CODE],[BANK_ACCOUNT],[TAX_ID],[NAME],[MRN]. - Kuraldan bir eylem almayan bir model tespiti üretilmiş bir yer tutucu alır: alt çizgileri
boşluk yapılmış varlık türü ve sonuna eklenen dört yıldız.
PERSON_NAME,[PERSON NAME****]olur.
Sağlayıcıya giden, maskelenmiş metindir. Geri döndürülebilir maskeleme yapılandırıldığında, orijinale geri eşleme oturum başına AES-256-GCM ile şifrelenir; anahtar olmadan yanıtlar maskeli kalır ve hiçbir eşleme yazılmaz.
Kendi desenlerinizi ekleme
Kuruluşa özgü bir tanımlayıcı, bir veya daha çok regex deseni olan yeni bir filtre satırıdır. Yapısı paketle gelen kurallarla aynıdır:
ml_entity_types[0], çağıranlara bildirilen type değeri olur. context_types, güven artırımını
kazandıran anahtar kelimelerdir. Deseni etkinleştirmeden önce kontrol panelinin filtre test
aracıyla sınayın.
Sınırlar ve bilinen boşluklar
- Doğruluk koşulludur ve tek bir sayı değildir. Varlık türüne, dile, metin uzunluğuna ve filtre yapılandırmasına göre değişir. Sağlama toplamı olan yapılandırılmış tanımlayıcılar deterministiğe yakın davranır; adlar, konumlar ve kuruluşlar NER modeline ve bağlamına bağlıdır. Çıplak bir yüzde değil, performans ve doğruluk sayfasındaki koşullu değerleri aktarın.
- Tespit, CID222'nin kendi modelleri ve kurallarıdır. Yolun hiçbir yerinde Presidio, spaCy veya bir OPA/Rego politika motoru yoktur. Katalog, PostgreSQL'deki filtre satırları ve tek bir ONNX NER modelidir.
- Serbest metin varlıkları varsayılan olarak maskelenmez, işaretlenir.
LOCATION,ORGANIZATION,DATE_TIMEveURLflag kuralı olarak gelir; çünkü bunları NER kesinliğinde maskelemek sıradan prompt'ları bozar. Maskelenmelerini istiyorsanız eylemi bilinçli olarak değiştirin ve kabul ettiğiniz yanlış pozitifleri ölçün. - Türkçe kapsamı diğer tüm ulusal kapsamlardan derindir. T.C. kimlik numarası, vergi numarası, IBAN, yurt içi hesap, posta kodu, araç plakası ve kimlik kartı belge numarasının hepsinin özel desenleri ve doğrulayıcıları vardır. Başka bir ülkenin tanımlayıcılarının, siz eklemedikçe hiçbiri yoktur.
- Bozuk bir desen sessizce hiçbir şeyi korumaz. Derlenemeyen, kayıtlı bir regex yükleme sırasında atlanır. Ağ geçidi bunu yüksek sesle günlüğe yazar ve filtreyi kontrol panelinde bozuk işaretler, ancak filtre yine de etkin görünür.
- Desen önbelleği beş dakikaya kadar bayat olabilir. Regex katmanı derlenmiş desenlerini beş dakikalık bir TTL ile yeniler; bu yüzden yeni veya düzenlenmiş bir kural bir sonraki istekte mutlaka yürürlükte olmaz.
- Sağlık verisi sınıflandırıcısı yoktur. Tıbbi kayıt numaraları iki regex deseniyle eşleştirilir. Serbest metindeki durumlar, ilaçlar ve tanılar sağlık verisi olarak tespit edilmez.
- Parçalanmış bir yüklemenin içindeki KKV incelenmez. Hiçbir şey bir gövdeyi istekler arasında tamponlamaz; bu yüzden parçalı ve sürdürülebilir yüklemeler taranmak yerine reddedilir.
İlgili sayfalar
- İçerik güvenliği hattı — KKV tespitinin yeri ve eylemi neyin belirlediği.
- İçerik tespiti API'si — tespit motorunu doğrudan çağırın ve yanıtını okuyun.
- Belge analizi — aynı kataloğun dosyalara uygulanması.
Son güncelleme