Görev 13 — SA-MP MySQL Güvenliği ve Hata Ayıklama
Kazanacağın yetenek: “Sorgu çalışmadı” sorununu bağlantı, kuyruk, SQL yürütme, callback ve cache katmanlarına ayırmak; oyuncu girdisini ve kimlik bilgilerini güvenli yönetmek.
Asenkron MySQL kodu iki farklı zamanda çalışır: sorguyu gönderdiğin an ve callback’in daha sonra çağrıldığı an. Hataların çoğu bu iki an aynıymış gibi kod yazmaktan çıkar.
OnQueryError callback’ini ekle
Bölüm başlığı “OnQueryError callback’ini ekle”Threaded sorgudaki syntax, bağlantı veya constraint hatalarını merkezi callback ile kaydet:
public OnQueryError( errorId, const errorMessage[], const callbackName[], const query[], MySQL:handle){ #pragma unused query #pragma unused handle
printf( "[database] query error=%d callback=%s message=%s", errorId, callbackName, errorMessage );
return 1;}Plugin bu callback’in return değerini işlemez. return 1, yalnızca Pawn tarafındaki tutarlı fonksiyon bitişidir.
a_mysql.inc, OnQueryError için gereken forward bildirimini zaten içerir. callbackName, sorgu gönderilirken sonuç callback’i verilmediyse boş olabilir.
Production log’una sorgunun tamamını otomatik yazmıyoruz. INSERT veya UPDATE metni e-posta, token ya da başka özel veri içerebilir. Sorunu bulmak için callback adı, güvenli bir işlem etiketi ve MySQL hata kodu çoğu zaman yeterlidir.
Hata hangi aşamada?
Bölüm başlığı “Hata hangi aşamada?”mysql_tquery 0 döndü → sorgu kuyruğa alınamadı
mysql_tquery 1 döndü, OnQueryError geldi → sorgu kuyruğa alındı fakat MySQL çalıştırırken hata verdi → normal sonuç callback'i çağrılmaz
sonuç callback'i geldi, rowCount 0 → sorgu başarılı; koşula uyan kayıt yok
callback hiç gelmedi → public/forward adı, plugin logu, bağlantı veya sorgu hatası kontrol edilir“Satır bulunamadı” ile “cache okunamadı” aynı durum değildir. Her native dönüşünü kontrol ederek bu ayrımı loglarda koru.
Hata yoluna kurtarma davranışı ekle
Bölüm başlığı “Hata yoluna kurtarma davranışı ekle”OnQueryError sorguya verdiğin playerid ve session gibi ek callback parametrelerini almaz. Bu nedenle yalnızca merkezi hata loguna güvenirsen profil SELECT’i hata veren oyuncu yükleme ekranında kalabilir.
Oyuncu verisi görevindeki session doğrulamalı yükleme timer’ı bu durumu sınırlar:
SELECT veya INSERT kuyruğa alınır ├─ başarı → sonuç callback'i → timer durdurulur → profil etkinleşir ├─ SQL hatası → OnQueryError log yazar → timer oyuncuyu kontrollü çıkarır └─ oyuncu ayrılır → timer durdurulur → session değişir → eski sonuç yok sayılırProduction sisteminde kullanıcıya genel bir hata göster; SQL metni, tablo yapısı veya bağlantı bilgisini oyun içi mesaja koyma. Geçici bağlantı sorunlarında otomatik yeniden deneme ekleyeceksen deneme sayısını sınırlayıp artan bekleme süresi kullan.
MySQL dönüş değerlerini doğru yorumla
Bölüm başlığı “MySQL dönüş değerlerini doğru yorumla”| Fonksiyon | Başarı | Dikkat edilmesi gereken |
|---|---|---|
mysql_tquery |
Sorgu kuyruğa alındıysa 1 |
SQL’in başarılı çalıştığını kanıtlamaz |
cache_get_row_count |
Output yazıldıysa 1 |
Satır sayısı ayrıca 0 olabilir |
cache_get_value_name_int |
Değer yazıldıysa 1 |
Kolon adı veya aktif cache yanlışsa 0 |
cache_insert_id |
Yeni auto increment ID | Aktif cache yoksa -1; ID üretilmediyse 0 olabilir |
cache_affected_rows |
Etkilenen satır sayısı | Hata durumunda -1; 0 her zaman hata değildir |
mysql_errno |
Hata yoksa 0 |
Yalnızca belirli, çoğunlukla unthreaded işlemlerin son hatasını verir |
Threaded sorgu hatasını mysql_tquery sonrasında mysql_errno ile yakalamaya çalışma. Sorgu başka thread’de daha sonra çalışacağı için doğru kanal OnQueryError callback’idir.
SQL injection’ı önle
Bölüm başlığı “SQL injection’ı önle”Yanlış:
format( query, sizeof query, "SELECT `id` FROM `players` WHERE `username` = '%s'", inputText);Doğru:
mysql_format( g_Database, query, sizeof query, "SELECT `id` FROM `players` WHERE `username` = '%e' LIMIT 1", inputText);%e, string değerindeki özel karakterleri MySQL bağlantısının kurallarına göre escape eder. Sayısal değerlerde %d veya %f kullan ve girdinin iş kurallarına uygun aralığını ayrıca doğrula.
%e, LIKE sorgularındaki % ve _ wildcard karakterlerini etkisizleştirmez. Kullanıcı girdisiyle LIKE kullanıyorsan wildcard davranışını ayrıca sınırla; tam kullanıcı adı aramasında rehberdeki gibi = kullan.
Escape, yetkilendirme değildir. Bir oyuncunun playerId parametresi vermesi o kaydı değiştirme hakkı olduğu anlamına gelmez; UPDATE anahtarını sunucunun belleğinde tuttuğun playerDatabaseId üzerinden kur.
Dinamik tablo ve kolon adlarını sınırlı tut
Bölüm başlığı “Dinamik tablo ve kolon adlarını sınırlı tut”%e tablo adı güvenli hale getirmek için kullanılmaz. Şunun gibi kod yazma:
mysql_format(g_Database, query, sizeof query, "SELECT * FROM `%e`", inputText);Sıralama veya tablo seçimi dinamik olacaksa girdi metnini doğrudan SQL’e koymak yerine sabit whitelist kullan:
new const SortColumns[][] ={ "score", "money", "mission_count"};Önce geçerli dizi indeksini doğrula, ardından yalnızca bu sabitlerden birini sorgu yapısına ekle.
Parolaları MySQL’de nasıl saklamamalısın?
Bölüm başlığı “Parolaları MySQL’de nasıl saklamamalısın?”- düz metin parola,
- yalnızca MD5 veya SHA-256,
- bütün kullanıcılar için aynı sabit salt,
- SQL sorgusu içinde hızlı hash hesaplama,
- parola veya hash değerini loglama.
Hızlı hash fonksiyonları parola denemelerini de hızlı hale getirir. Hesap sistemi geliştirirken parola için tasarlanmış, maliyeti ayarlanabilen Argon2id veya bcrypt kullan. Her parola için benzersiz salt ve güncel maliyet ayarı üret; veritabanında yalnızca ortaya çıkan hash’i sakla.
MySQL sorgusu parola doğrulaması yapmamalıdır. Önce kullanıcı adına göre hash’i yükle, parola doğrulamasını uygun kütüphanede yap, başarılıysa profil verisini etkinleştir.
Hesap girişi eklendiğinde akış şu şekilde kurulabilir:
SELECT username ve password_hash → sonuç callback'inde hash okunur → profil sonucu daha sonra gerekecekse cache_save → parola dialog'u gösterilir → Argon2id/bcrypt doğrulaması başlatılır ├─ başarılı → session kontrolü → cache_set_active → profil verisini kopyala └─ başarısız → deneme sayısını artır → başarı, iptal, timeout veya disconnect yolunda cache_deleteBu tasarımda parola hiçbir SQL sorgusuna eklenmez. Saklanan Cache: handle yalnızca aynı player session için kullanılmalı ve tek bir kod yolu tarafından serbest bırakılmalıdır.
Asenkron playerid yarışını kapat
Bölüm başlığı “Asenkron playerid yarışını kapat”Her oyuncu sorgusunda şu üç parçayı birlikte kullan:
- sorgu gönderilirken
playeridyanında session numarası taşı, - callback’te
IsPlayerConnected(playerid)kontrol et, - gönderilen session ile güncel
PlayerSession[playerid]değerini karşılaştır.
Sadece oyuncu adını yeniden karşılaştırmak yeterli değildir; aynı isimle hızlı yeniden bağlantı veya isim değişimi gibi uç durumlar kalır. Session numarası sorgunun hangi bağlantı örneğine ait olduğunu doğrudan belirtir.
Cache ömrünü yönet
Bölüm başlığı “Cache ömrünü yönet”mysql_tquery sonuç callback’i içinde cache aktiftir. Normal akışta değerleri hemen PlayerData içine kopyala ve callback bittiğinde pluginin geçici cache’i temizlemesine izin ver.
cache_save kullanırsan sahiplik sana geçer:
new Cache:playerCache = cache_save();Bu handle için şu yolların tamamında cache_delete gerekir:
- başarılı kullanım sonrası,
- login veya dialog iptali,
- timeout,
- oyuncu disconnect’i,
- gamemode kapanışı.
Handle’ı sildikten sonra MYSQL_INVALID_CACHE ile işaretle. Aynı cache’i iki kez silmek veya geçersiz handle’ı aktif yapmak yeni hata üretir.
Sorgu sırasını koru
Bölüm başlığı “Sorgu sırasını koru”Aynı profile ait şu iki işlem paralel ve sıra garantisiz çalışırsa eski değer son yazan olabilir:
UPDATE score = 500UPDATE score = 750Bu nedenle başlangıçta mysql_tquery kullan. mysql_pquery sorguları paralel çalıştırabilir, tamamlanma sırası garanti etmez ve transaction akışı desteklemez. Yalnızca birbirinden bağımsız sorgularda, ölçülmüş bir ihtiyaç varsa kullan.
Veritabanını her tick’te çağırma
Bölüm başlığı “Veritabanını her tick’te çağırma”Kötü örnekler:
OnPlayerUpdateiçinde UPDATE,- her
/statuskomutunda SELECT, - her skor değişiminde önce SELECT sonra UPDATE,
- oyuncu başına çalışan kısa timer ile otomatik kayıt.
Doğru model:
- bağlantıda bir kez load,
- oyun boyunca
PlayerDatabelleğinde işlem, - görev tamamlama, satın alma veya kritik değişimde save,
- kontrollü aralıkla dirty profilleri toplu save,
- disconnect ve shutdown sırasında son snapshot.
Bu yapı sorgu sayısını azaltır ve aynı profile ait yazma sırasını daha anlaşılır hale getirir.
Kimlik bilgilerini koru
Bölüm başlığı “Kimlik bilgilerini koru”mysql.inidosyasını repository dışında tut veya.gitignoreile dışla.- Production ve yerel geliştirme için ayrı kullanıcı kullan.
- MySQL portunu gerekmedikçe internete açma.
- Uygulama hesabına
DROP,ALTER,GRANTgibi schema yetkileri verme. - Yedekleri ve logları da parola kadar dikkatli koru.
- Bir parola Git geçmişine girdiyse yalnızca dosyadan silme; parolayı değiştir.
Sorun giderme tablosu
Bölüm başlığı “Sorun giderme tablosu”| Belirti | Olası neden | İlk kontrol |
|---|---|---|
| Runtime error 19 | a_mysql.inc ile binary farklı veya plugin yüklenmedi |
server_log.txt, plugins satırı ve R41-4 dosyaları |
MySQL plugin Failed |
32 bit çalışma zamanı veya bağımlılık eksik | Windows DLL’leri, Linux client library ve mimari |
| Access denied | Kullanıcı, parola veya izin kapsamı yanlış | mysql.ini ve MySQL kullanıcı host’u |
| Unknown database/table | Migration uygulanmadı veya database adı yanlış | Şema ve bağlantı ayarı |
| Callback bulunamadı | İsim veya forward/public imzası yanlış |
mysql_tquery callback metni |
Cache native 0 dönüyor |
Aktif cache yok ya da kolon adı yanlış | Çağrının sonuç callback’i içinde olması |
| Başka oyuncunun verisi geliyor | Eski sorgu sonucu yeniden kullanılan playerid’ye uygulandı |
Session kontrolü |
| Türkçe metin bozuk | Bağlantı ve tablo charset’i uyuşmuyor | utf8mb4 bağlantısı ve tablo collation’ı |
Yerel geliştirmede kısa süreyle mysql_log(ALL) kullanabilirsin. Sorunu yakaladıktan sonra production seviyesini ERROR | WARNING değerine geri getir; debug logları gereksiz hacim ve hassas sorgu metni üretebilir.
Güvenlik kontrol noktası
Bölüm başlığı “Güvenlik kontrol noktası”- Threaded hatalar
OnQueryErroriçinde görünür. - Sonuç callback’i gelmezse kullanıcı akışını bitirecek zaman aşımı var.
- Kullanıcı stringleri
%e, sayılar uygun formatla yazılıyor. - Dinamik SQL identifier’ları whitelist dışında üretilmiyor.
- Parolalar hızlı hash veya düz metin olarak tutulmuyor.
- Her player callback’i bağlantı ve session doğrulaması yapıyor.
- Saklanan cache’lerin bütün çıkış yollarında sahibi belli.
- MySQL hesabı minimum yetkiye sahip.
Sıradaki görev: SA-MP hata ayıklama tamirhanesi.