Web isteği işleme sürecini kesmek ve değiştirmek için özel Lua betikleri yazarak WAF'in yerleşik kurallarının ötesinde güvenlik mantığı uygulayın. Yapılandırılabilir betikler ve parametreler, karmaşık ve işe özel gereksinimleri daha esnek bir şekilde karşılamanıza olanak tanır.
Extensions özelliğini etkinleştirme
Extensions özelliğini kullanmak için aşağıdaki etkinleştirme adımlarını tamamlayın:
Uygulanabilir sürümler: Bu özellik yalnızca Abonelik tabanlı WAF Enterprise Edition, Ultimate Edition ve Pay-As-You-Go Edition sürümlerinde desteklenir.
Faturalama: Bu ücretli bir hizmettir. Faturalandırma yöntemi şu şekildedir:
Pay-As-You-Go Edition: Önceden satın alım yapmadan doğrudan kullanabilirsiniz. Gerçek kullanıma göre ek ücretler uygulanır.
Subscription Edition: Kullanımdan önce özelliği satın almanız gerekir.
Web Application Firewall 3.0 konsolu üzerinde oturum açın. Üst menü çubuğundan WAF örneği için kaynak grubunu ve bölgeyi (Chinese Mainland veya Outside Chinese Mainland) seçin.
Sol gezinme bölmesinde seçeneklerini belirleyin.
Buy Now seçeneğine tıklayın ve ekrandaki talimatları izleyerek özelliği etkinleştirin.
Extension oluşturma
Extensions sayfasında Create Extension seçeneğine tıklayın ve ardından aşağıdaki parametreleri yapılandırın.
Basic Info: Tanınabilir bir Plugin Name ve Plugin Description girin.
-
Plugin Code: Özel güvenlik mantığınızı uygulamak için Lua betiğini buraya yazın. Örnek: API hakkında daha fazla bilgi için bkz. Ek: Özel Lua betiği API referansı.
NotAlibaba Cloud, WAF Lua Extension Development Skill'i yayınladı. Bu Skill, Lua extension betiklerini hızlıca oluşturmak ve hata ayıklamak için bir AI programlama asistanı kullanarak geliştiriciler için giriş engelini düşürür. Skill'e aşağıdaki bağlantılardan erişebilirsiniz:
-- Custom Lua script example: Extract a query parameter and compare it with a custom parameter. Block if they do not match. -- Step 1: Extract the request parameter local token = aliwaf.req.get_arg('token') -- Step 2: Compare with the custom parameter if token ~= params.token then aliwaf.func.punish() endÖnemliWAF sistem kararlılığını sağlamak amacıyla, tek bir Lua betiğinin istek başına yürütme süresi 2 ms ile sınırlıdır. Debug and Test aşamasında yürütme süresi bu sınırı aşarsa betik testi geçemez ve oluşturma işlemi başarısız olur. Gerçek çalışma zamanında bir betiğin yürütme süresi bir istek için 2 ms'yi aşarsa sistem bu yürütmeyi atlar.
Kodunuza hassas bilgileri (anahtarlar gibi) sabit kodlamayın. Bunun yerine aşağıdaki Parameter Definition özelliğini kullanın.
-
Parameter Definition: Sabit kodlanmış değerleri betiklerden yapılandırılabilir parametrelere çıkararak mantığı veriden ayırın. Bu yaklaşım, kodu değiştirmeden ilkeleri dinamik olarak ayarlamanıza ve anahtarları güvenli bir şekilde yönetmenize olanak tanır. Add Parameter seçeneğine tıklayın ve aşağıdaki yapılandırmayı tamamlayın:
Parameter Name: Betikte başvurulan değişken adı (örneğin,
secret_key).Parameter Type: Desteklenen türler arasında String, Number, Boolean, JSON Object ve JSON Array bulunur. Türün betiğinizdeki işleme mantığıyla eşleştiğinden emin olun.
Parameter Description: Parametrenin amacını açıklar.
-
Parameter Value: Aşağıdaki iki modu destekler:
Manual Input: Değeri doğrudan girin.
-
Use KMS Credential: Hassas verileri güvenli bir şekilde depolamak için Key Management Service içinde önceden oluşturulmuş bir kimlik bilgisine başvurun. WAF'in kimlik bilgisine başarıyla başvurabilmesi için buna aşağıdaki etiketi eklemeniz gerekir:
Tag Key:
waf:access:enableTag Value:
true
-
Debug and Test:
Plugin Action Parameters: Şu anda yalnızca isteği engelleyen Block modunu destekler.
-
Traffic Parameters: Gerçek HTTP istek trafiğini simüle eder. Add Parameter seçeneğine tıklayın ve bir Parameter Name (örneğin,
method,uriveyaargs) ile ilgili Parameter Value değerini girin.Örnek: Bir oturum açma uç noktası için koruma mantığını test etmek üzere
methoddeğeriniPOSTveurideğerini/loginolarak ayarlayın.
Execution Result: Run and Debug seçeneğine tıklayın. Sistem betiği simüle edilmiş trafiğe karşı çalıştırır ve sağ taraftaki Execution Result panelini görüntüleyebilirsiniz. Sonuç başarısızlık gösteriyorsa belirli hata mesajlarına dayanarak kodu düzeltin.
Sonraki adımlar
Bir extension oluşturduktan sonra bunu bir Custom Rule koruma şablonunda referans almanız gerekir. Daha fazla bilgi için bkz. Custom rules.
Günlük işlemler
Extensions sayfasında aşağıdaki işlemleri gerçekleştirebilirsiniz:
Eklenti listesini görüntüleme: Tüm extension'ları görüntüler. Hızlı arama yapmak için arama kutusuna bir eklenti adı girin.
İlişkili koruma kurallarını görüntüleme: Hedef eklentiyi bulun ve ilişkili koruma kuralı kimliklerini görüntülemek için Associated Rules sütunundaki
simgesine tıklayın. Bir kimliği kopyalayabilir ve Core Web Protection veya Security Reports sayfasında arayabilirsiniz.Extension düzenleme: Hedef eklentiyi bulun ve yapılandırmasını değiştirmek için Actions sütunundaki Edit seçeneğine tıklayın.
Extension silme: Hedef eklentiyi bulun ve extension'ı kaldırmak için Actions sütunundaki Delete seçeneğine tıklayın.
Ek: Özel Lua betiği API referansı
Özel Lua betikleri için temel arabirimler; istek verilerini okuma, şifreleme ve şifre çözme ile istek akışı denetimini kapsar.
HTTP isteği örneği
POST /api/v1/orders?source=web&campaign=spring2024 HTTP/1.1
Host: shop.example.com
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)
Cookie: session_id=abc123xyz; user_prefs=lang%3Den%26theme%3Ddark
Content-Type: application/json
Content-Length: 68
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxx
Accept: application/json
eyJwcm9kdWN0X2lkIjogNzg5LCAicXVhbnRpdHkiOiAyLCAidXJnZW50IjogdHJ1ZX0=
İstek verilerini okuma
Tüm arabirimler bir dize döndürür. Bir alan yoksa boş bir dize döndürülür.
Yöntemi okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- POST --
local method = aliwaf.req.get_method()
URI'yi okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- /api/v1/orders --
local uri = aliwaf.req.get_uri()
Alan adını okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- shop.example.com --
local domain = aliwaf.req.get_domain()
Sorguyu okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- source=web&campaign=spring2024 --
local query = aliwaf.req.get_query()
Sorgu parametresini okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- web --
local source = aliwaf.req.get_arg('source')
Çerez okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- abc123xyz --
local session_id = aliwaf.req.get_cookie('session_id')
Üstbilgi okuma
|
|
|
|
|
|
|
|
|
|
|
|
-- Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxx --
local auth = aliwaf.req.get_header('Authorization')
Gövdeyi okuma
İstek gövdesi durumunu kontrol etme
-
Gövdenin tamamen alınıp alınmadığı
Öğe
Tür
Açıklama
Parametre
-
-
Dönüş değeri
boolean
true, istek gövdesinin tamamen alındığını gösterir. false, daha fazla verinin beklemede olduğunu gösterir.local last = aliwaf.func.is_last_fragment_arrived() -
Gövdenin kısaltılıp kısaltılmadığı
Öğe
Tür
Açıklama
Parametre
-
-
Dönüş değeri
booleantrue, istek gövdesinin sınırı aştığını ve kısaltıldığını gösterir. false, istek gövdesinin bozulmamış olduğunu gösterir.
Varsayılan olarak WAF, istek gövdesinden en fazla 128 KB depolar. Bu sınırı aşan istekler kısaltılır (aşan kısım atılır).
local discard = aliwaf.func.is_request_body_discarded()
Gövdeyi bekletme
İstek gövdeleri WAF'e akış şeklinde ulaşır, bu nedenle betik çalıştırıldığında gövde henüz tamamen alınmamış olabilir. Tam gövdeyi işlemek için çerçeveyi açıkça bilgilendirerek betiği yeniden çalıştırmadan önce tam gövdenin gelmesini bekletin.
|
|
|
|
|
|
|
|
|
|
|
|
aliwaf.func.wait_request_body()
Örnek: İstek gövdesini okuma
-- Body not fully received; wait for it --
if not aliwaf.func.is_last_fragment_arrived() then
aliwaf.func.wait_request_body()
return
end
-- Body fully received; check if truncated --
if aliwaf.func.is_request_body_discarded() then
return
end
-- eyJwcm9kdWN0X2lkIjogNzg5LCAicXVhbnRpdHkiOiAyLCAidXJnZW50IjogdHJ1ZX0= --
local body = aliwaf.req.get_body()
-- TODO: Apply business logic to the complete body --
Ortak yardımcı işlevler
Temel kodlama ve kod çözme
URL, hex ve base64 kodlama/kod çözme arabirimleri bir dize parametresi alır ve işlenmiş bir dize döndürür. Başarısız olurlarsa boş bir dize döndürürler.
URL kodlama ve kod çözme
-
escape_uri
Öğe
Tür
Açıklama
Parametre
dize
Kodlanacak ham dize.
Dönüş değeri
dize
Kodlanmış dize. -
unescape_uri
Öğe
Tür
Açıklama
Parametre
dize
Kodu çözülecek URL kodlu dize.
Dönüş değeri
dize
Kodu çözülmüş ham dize.
-- a%20b --
local data1 = aliwaf.util.escape_uri('a b')
-- a b --
local data2 = aliwaf.util.unescape_uri('a%20b')
Hex kodlama ve kod çözme
-
hex_encode
Öğe
Tür
Açıklama
Parametre
dize
Kodlanacak ikili dize.
Dönüş değeri
dize
Büyük harfli hex kodlu dize. -
hex_decode
Öğe
Tür
Açıklama
Parametre
dize
Kodu çözülecek hex dizesi.
Dönüş değeri
dize
Kodu çözülmüş ham dize. Giriş geçersizse boş bir dize "" döndürür.
-- DEADBEEF --
local data1 = aliwaf.util.hex_encode(string.char(0xDE, 0xAD, 0xBE, 0xEF))
-- \xDE\xAD\xBE\xEF --
local data2 = aliwaf.util.hex_decode('DEADBEEF')
Base64 kodlama ve kod çözme
-
base64_encode
Öğe
Tür
Açıklama
Parametre
dize
Kodlanacak ham dize.
Dönüş değeri
dize
Base64 kodlu dize. -
base64_decode
Öğe
Tür
Açıklama
Parametre
dize
Kodu çözülecek Base64 dizesi.
Dönüş değeri
dize
Kodu çözülmüş ham dize. Giriş geçersizse boş bir dize "" döndürür.
-- aGVsbG8= --
local data1 = aliwaf.util.base64_encode('hello')
-- hello --
local data2 = aliwaf.util.base64_decode('aGVsbG8=')
MD5/CRC/SHA
-
md5
Öğe
Tür
Açıklama
Parametre
dize
Hash'lenecek ham dize.
Dönüş değeri
dize
32 karakterli küçük harfli hex formatında MD5 özeti. -
sha256
Öğe
Tür
Açıklama
Parametre
dize
Hash'lenecek ham dize.
Dönüş değeri
dize
64 karakterli küçük harfli hex formatında SHA-256 özeti. -
crc32
Öğe
Tür
Açıklama
Parametre
dize
Hesaplanacak ham dize.
Dönüş değeri
tamsayı
CRC32 sağlama toplamı (işaretsiz 32 bit tamsayı).
-- 5d41402abc4b2a76b9719d911017c592 --
local md5 = aliwaf.util.md5('hello')
-- 2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824 --
local sha = aliwaf.util.sha256('hello')
-- 3287646509 --
local crc = aliwaf.util.crc32('hello')
Şifreleme ve şifre çözme (AES/DES)
-
evp_encrypt
Öğe
Tür
Açıklama
Parametre 1
dize
"aes-128-cbc" gibi şifreleme algoritması türü.
Parametre 2
dize
Şifreleme anahtarı (ikili güvenli dize).
Parametre 3
dize
Başlatma vektörü. IV kullanılmıyorsa boş bir dize "" olabilir.
Parametre 4
dize
Şifrelenecek düz metin.
Dönüş değeri
dize
Şifrelenmiş şifreli metin. Parametreler geçersizse veya şifreleme başarısız olursa boş bir dize "" döndürür. -
evp_decrypt
Öğe
Tür
Açıklama
Parametre 1
dize
Şifre çözme algoritması türü. "aes-128-cbc" gibi şifrelemede kullanılan algoritmayla eşleşmelidir.
Parametre 2
dize
Şifre çözme anahtarı. Şifrelemede kullanılan anahtarla eşleşmelidir.
Parametre 3
dize
Başlatma vektörü. Şifrelemede kullanılan IV ile eşleşmelidir. Boş bir dize "" olabilir.
Parametre 4
dize
Kodu çözülecek şifreli metin.
Dönüş değeri
dize
Kodu çözülmüş düz metin. Parametreler geçersizse veya şifre çözme başarısız olursa boş bir dize "" döndürür.
local data1 = aliwaf.util.evp_encrypt('aes-128-cbc', 'key-12345678-key', 'iv-1234567890-iv', 'hello')
local data2 = aliwaf.util.evp_decrypt('aes-128-cbc', 'key-12345678-key', 'iv-1234567890-iv', data1)
İmzalama ve doğrulama (ES256)
-
es256_sign
Öğe
Tür
Açıklama
Parametre 1
dize
PEM formatındaki ES256 özel anahtarı.
Parametre 2
dize
İmzalanacak ham veri.
Dönüş değeri
dize
İmza sonucu (ikili dize). Parametreler geçersizse veya imzalama başarısız olursa boş bir dize "" döndürür. -
es256_verify
Öğe
Tür
Açıklama
Parametre 1
dize
PEM formatındaki ES256 genel anahtarı.
Parametre 2
dize
İmzalama için kullanılan ham veri (imzalama sırasında kullanılan veriyle eşleşmelidir).
Parametre 3
dize
Doğrulanacak imza değeri (es256_sign tarafından oluşturulur).
Dönüş değeri
boolean
true, imza doğrulamanın başarılı olduğunu gösterir. false, doğrulama başarısızlığını veya geçersiz parametreleri gösterir.
local sign = aliwaf.util.es256_sign('private_key-1234', 'hello')
local result = aliwaf.util.es256_verify('public_key-12345', 'hello', sign)
Zaman
|
|
|
|
|
|
|
|
|
|
|
|
-- Current millisecond-level timestamp (integer) --
local timestamp = aliwaf.util.get_current_ms()
İş yardımcısı işlevleri
İş yardımcısı işlevleri, Lua betikleri ile WAF çerçevesi arasındaki koordinasyonu sağlar.
Eylem
|
|
|
|
|
|
|
|
|
|
|
|
-- Take action on the current request based on the pre-selected action --
aliwaf.func.punish()