Maskink ile log veya betikleri yapay zekaya ulaşmadan maskeleyin

Yapay zeka asistanları, hata veren bir günlük kaydını ya da çalışmayan bir betiği incelemekte oldukça başarılı. Ancak metni yapıştırırken yanında başka bilgiler de gidebiliyor: iç IP adresleri, sunucu adları, kullanıcı adları, bazen de bir yapılandırma satırında unutulmuş bir parola veya API anahtarı.

Safa PAKSU tarafından geliştirilen Maskink, bu sorun için hazırlanmış ücretsiz ve açık kaynaklı bir araç. Hassas değerleri metin modele ulaşmadan önce etiketlerle değiştiriyor, yanıttaki etiketleri ise yeniden gerçek değerlere çeviriyor. Aracı kurmadan canlı demoda deneyebilirsiniz.

Nasıl çalışıyor?

Maskink kendi sunucunuzda çalışıyor ve yapay zeka modeli yalnızca maskelenmiş metni görüyor:

Özgün:    Accepted password for john.smith from 10.20.30.40 port 52144
          mysql -u app_user -p'S3cr3t!2024' -h db01.corp.local

Maskeli:  Accepted password for <USER_1> from <IP_1> port 52144
          mysql -u <USER_2> -p'<PASS_1>' -h <FQDN_1>

Aynı değer, metnin ve sohbetin tamamında aynı etiketi koruyor. Böylece model, adresi hiç öğrenmeden <IP_1> üzerinden yorum yapabiliyor. Etiketlerle gerçek değerler arasındaki eşleme tablosu ise yalnızca tarayıcınızda tutuluyor.

Neleri maskeliyor?

Araçta 19 kategoride 95 hazır kural bulunuyor; bunların 91'i varsayılan olarak açık:

• Gizli bilgiler: Parolalar, SNMP community değerleri, PEM ve SSH anahtarları, JWT'ler, Bearer belirteçleri; AWS, GitHub ve Slack belirteçleri.
• Ağ bilgileri: IPv4 ve IPv6 adresleri, MAC adresleri, sunucu ve alan adları, Active Directory etki alanları.
• Kişi bilgileri: Kullanıcı adları, ad soyadlar, e-posta adresleri ve telefon numaraları.
• Doğrulanan numaralar: Kart numaraları Luhn, IBAN'lar mod-97, T.C. kimlik numaraları ise sağlama algoritmasıyla denetlenerek maskeleniyor.
• Size özel terimler: Proje veya müşteri adları gibi ifadeleri sözlüğe ekleyebiliyorsunuz.

Bir yerde parola olarak yakalanan değer, metnin geçtiği diğer yerlerde de maskeleniyor. password veya token gibi sözcükler içerdiği hâlde hiçbir şey maskelenmemiş satırlar da işaretleniyor.

Başka neler sunuyor?

• Maskeli sohbet: OpenAI uyumlu bir hizmet, Ollama veya vLLM ağ geçidi bağlanabiliyor. Sohbetler tarayıcıda kalıyor.
• Ekran görüntüleri: Görseldeki metin tarayıcıda okunuyor, hassas alanlar kapatılıyor; elle düzeltme de yapılabiliyor.
• Düzenlenebilir kurallar: Her kural örnek bir metinle canlı denenebiliyor, değiştirilebiliyor veya kapatılabiliyor. Kendi kurallarınızı da ekleyebiliyorsunuz.
• JSON API: Kendi uygulamalarınız metin gönderip maskelenmiş sonucu alabiliyor.

Sınırları neler?

Maskink kurallarla çalışıyor. Bu nedenle tanımadığı bir biçimdeki değeri kaçırabilir, zararsız bir ifadeyi de maskeleyebilir. Hassas içeriklerde "Göndermeden önce önizle" seçeneğini açıp modele gidecek metni okuyun. Bir parola daha önce açığa çıktıysa maskelemek yeterli olmaz; parolayı değiştirin.

Nasıl kurulur?

PHP 8.1 veya üzeri, MySQL 8 ya da MariaDB 10.4 ve Apache gerekiyor:

git clone https://github.com/Spaksu/maskink.git
cd maskink
cp config.example.php config.php

config.php dosyasına veritabanı bilgilerinizi girip uygulamayı tarayıcıda açmanız yeterli. Veritabanı, tablolar ve kurallar ilk açılışta oluşturuluyor. Arayüz Türkçe ve İngilizce olarak kullanılabiliyor; kaynak kodu MIT lisansıyla GitHub'da yer alıyor.

Yapay zekaya gönderdiğiniz metni bir kez daha okuyun: Maskeleme kolaylaştırır, dikkatin yerini tutmaz.