İçeriğe geç

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.

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.

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.

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ır

Production 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.

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.

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.

%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.

  • 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_delete

Bu 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.

Her oyuncu sorgusunda şu üç parçayı birlikte kullan:

  1. sorgu gönderilirken playerid yanında session numarası taşı,
  2. callback’te IsPlayerConnected(playerid) kontrol et,
  3. 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.

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.

Aynı profile ait şu iki işlem paralel ve sıra garantisiz çalışırsa eski değer son yazan olabilir:

UPDATE score = 500
UPDATE score = 750

Bu 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.

Kötü örnekler:

  • OnPlayerUpdate içinde UPDATE,
  • her /status komutunda 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 PlayerData belleğ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.

  • mysql.ini dosyasını repository dışında tut veya .gitignore ile 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, GRANT gibi 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.
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.

  • Threaded hatalar OnQueryError iç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.