Kontrol

Hassas veri maskeleme

Hassas veri maskeleme, Base Interactive'in AI gateway'i BaseLLM'in, modele giden metindeki kişisel veriyi ve gizli anahtarları istek kurum dışına çıkmadan bulup maskeleyen ya da engelleyen katmanıdır. BaseLLM modele gidecek metni kurum dışına çıkmadan tarar; bilinen biçimdeki kişisel veriyi ve gizli anahtarları yakalar, kayda geçirir. Uygulamalarınızda değişiklik gerekmez.

Nasıl çalışır

Tarama, gateway'in içinde ve istek modele gitmeden önce yapılır. Tespit tamamen sunucu içinde, kural tabanlı çalışır; metin hiçbir dış servise gönderilmez. Kurallar proje bazındadır: hukuk projesi engellerken çağrı merkezi maskeleyebilir.

  • Kişisel veri (PII) kişiyi tanımlar: TC kimlik no, telefon, e-posta, IBAN, kart numarası gibi bilgiler.
  • Gizli anahtar (secret) sisteme giriş verir: API anahtarı, erişim token'ı (PAT), parola, veritabanı bağlantı bilgisi.
  • Maskeleme kısmen gizle: Değerin bir kısmı gizlenir; model bağlamı anlar, değeri göremez.
  • Redact türünü yazarak sil: Değer tamamen kaldırılır, yerine türü yazılır: [REDACTED:PHONE].
  • Yer tutucu geri konur: Modele <TELEFON_1> gider; cevapta gerçek değer geri konur.

Beş mod

ModGirdiÇıktı
Sadece raporlaKişisel veri içeren istekİstek olduğu gibi gider, kayıt düşer
MaskeleTC 10000000146, tel 0532 123 45 67TC 100*****46, tel ***4567
Yer tutucu0532 123 45 67 numaralı müşteriye…Modele: <TELEFON_1> numaralı müşteriye…
RedactTC 10000000146TC [REDACTED:TC_KIMLIK]
EngelleAynı cümle403 pii_blocked; istek modele gitmez
Gizli anahtar · engelleOPENAI_API_KEY=sk-proj-Q7mZ2xK9…403 secret_blocked
Gizli anahtar · maskele / redactsk-proj-…sk-proj-**** / [REDACTED:SECRET]

Yer tutucu modunda kullanıcı tam metni görür, model görmez; normal, akışlı ve Decisions (JEV) cevaplarında çalışır. Kişisel veri koruması varsayılan olarak kapalıdır; açıldığında varsayılan mod maskeledir. API'de modların adları mask, redact, block, pseudonymize ve report'tur.

Tanınan türler ve doğrulama

GrupTürler
Kimlik ve iletişimTC kimlik, telefon, e-posta
Resmî kimlikVergi kimlik no, pasaport, araç plakası, doğum tarihi
Referans numaralarıMüşteri no, hesap no, poliçe no
Kart ve hesapKredi kartı, CVV, son kullanma, TR ve yurt dışı IBAN
AğIP adresi

TC, vergi no, IBAN, kart ve plakada kontrol hanesi doğrulanır; kredi kartında Luhn algoritması kullanılır. Böylece sipariş ve müşteri numaraları gereksiz yere maskelenmez. Boşluklu ve tireli yazılışlar da yakalanır: +90 (532) 123-45-67, ahmet [at] banka.com, TC 100 000 001 46.

Gizli anahtar taraması

Tarama 29 kural ve dört aileden oluşur: yapay zekâ, kod ve DevOps, bulut ve servisler, genel kalıplar. Her lisansta, her projede açık gelir ve varsayılan davranışı engellemektir. Proje yöneticisi modu maskele (sk-proj-****) ya da redact ([REDACTED:SECRET]) olarak değiştirebilir.

DurumHTTPHata koduMesaj
Gizli anahtar, mod engelle403secret_blockedRequest blocked: credential or secret detected…
Kişisel veri, mod engelle403pii_blockedRequest blocked by PII policy

Kurum ayarları, kayıt ve lisans

  • Kuruma özel desen kelime listesi ya da kalıp: Ör. POL- + 6 hane; eşleşince maskele, yalnız etiketle ya da engelle.
  • KVKK madde 6 anahtar kelimeyle: Sağlık, din, ceza kaydı gibi konular; kapalı (varsayılan), raporla, engelle.
  • Dene kutusu önce dene, sonra aç: Örnek metin kayıtlı ayarlarla denenir; hiçbir yere gönderilmez, kaydedilmez.
ÖzellikLisansVarsayılan
Gizli anahtar taramasıHer lisanstaAçık · engelle
Kişisel veri maskelemepii_maskingKapalı · maskele
Cevap taramasıİstek kuralını izlerAyarlar neyse o
Olay kaydı ve sayaçlarHer lisanstaAçık · 90 gün
Teams / Slack bildirimiHer lisanstaKapalı

Kayıtta ham değer tutulmaz; yalnız maskelenmiş örnek, sayaçlar ve konum bilgisi saklanır, her tespit audit'e pii.detection olarak yazılır. Olay kayıtları varsayılan 90 gün tutulur; süre PII_EVENT_RETENTION_DAYS ile 0–3650 gün arasında ayarlanır. Bildirim açıksa aynı proje için 5 dakikada en çok bir mesaj gider ve mesajda anahtarın kendisi yer almaz.

Sık sorulan sorular

LLM gateway'de PII maskeleme nasıl çalışır?

İstek modele gitmeden önce BaseLLM'in içinde, kural tabanlı olarak taranır. Bulunan değer seçilen moda göre maskelenir, yer tutucuyla değiştirilir, silinir ya da istek 403 ile engellenir. Metin hiçbir dış servise gönderilmez. Modlar için Beş mod bölümüne bakın.

Maskelenen veri audit log'a yazılır mı?

Ham değer hiçbir kayıtta tutulmaz. Her tespit Audit Log'a pii.detection olarak yazılır; kayıtta yalnız maskelenmiş örnek, sayaçlar ve konum bilgisi bulunur. Audit kaydının değiştirilip değiştirilmediği SHA-256 parmak izi zinciriyle doğrulanır.

Hangi kişisel veri türleri yakalanır?

TC kimlik, telefon, e-posta, vergi kimlik no, pasaport, plaka, doğum tarihi, müşteri / hesap / poliçe numarası, kredi kartı, CVV, son kullanma tarihi, TR ve yurt dışı IBAN ve IP adresi. Ad-soyad ve adres kapsam dışıdır; bunlar için kuruma özel desen tanımlanabilir.

Uygulamalarımızı değiştirmemiz gerekir mi?

Hayır. Tarama gateway'de yapılır; uygulama yalnız OpenAI uyumlu uç noktaya bağlanır. Kurallar proje bazında açılıp kapatılır.

KVKK için yeterli mi?

Maskeleme bir teknik tedbirdir; KVKK uyumunun tamamı kurumun hukuki değerlendirmesine bağlıdır. BaseLLM bu değerlendirmeye kayıt, maskeleme ve madde 6 anahtar kelime kontrolüyle destek verir.