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
| Mod | Girdi | Çıktı |
|---|---|---|
| Sadece raporla | Kişisel veri içeren istek | İstek olduğu gibi gider, kayıt düşer |
| Maskele | TC 10000000146, tel 0532 123 45 67 | TC 100*****46, tel ***4567 |
| Yer tutucu | 0532 123 45 67 numaralı müşteriye… | Modele: <TELEFON_1> numaralı müşteriye… |
| Redact | TC 10000000146 | TC [REDACTED:TC_KIMLIK] |
| Engelle | Aynı cümle | 403 pii_blocked; istek modele gitmez |
| Gizli anahtar · engelle | OPENAI_API_KEY=sk-proj-Q7mZ2xK9… | 403 secret_blocked |
| Gizli anahtar · maskele / redact | sk-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
| Grup | Türler |
|---|---|
| Kimlik ve iletişim | TC kimlik, telefon, e-posta |
| Resmî kimlik | Vergi kimlik no, pasaport, araç plakası, doğum tarihi |
| Referans numaraları | Müşteri no, hesap no, poliçe no |
| Kart ve hesap | Kredi 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.
| Durum | HTTP | Hata kodu | Mesaj |
|---|---|---|---|
| Gizli anahtar, mod engelle | 403 | secret_blocked | Request blocked: credential or secret detected… |
| Kişisel veri, mod engelle | 403 | pii_blocked | Request 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.
| Özellik | Lisans | Varsayılan |
|---|---|---|
| Gizli anahtar taraması | Her lisansta | Açık · engelle |
| Kişisel veri maskeleme | pii_masking | Kapalı · maskele |
| Cevap taraması | İstek kuralını izler | Ayarlar neyse o |
| Olay kaydı ve sayaçlar | Her lisansta | Açık · 90 gün |
| Teams / Slack bildirimi | Her lisansta | Kapalı |
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.