Tüm Ürünler
Search
Belge Merkezi

Web Application Firewall:Extensions

Son Güncelleme:Oct 05, 2026

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:

Not

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.

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

  2. Sol gezinme bölmesinde Protection Config > Global Configuration > Extensions seçeneklerini belirleyin.

  3. 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ı.

    Not

    Alibaba 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 
    Önemli
    • WAF 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:enable

        • Tag 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, uri veya args) ile ilgili Parameter Value değerini girin.

      Örnek: Bir oturum açma uç noktası için koruma mantığını test etmek üzere method değerini POST ve uri değerini /login olarak 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 image 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


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


dize


"GET" veya "POST" gibi HTTP istek yöntemi.

-- POST --
local method = aliwaf.req.get_method()

URI'yi okuma


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


dize


İsteğin URI yolu.

-- /api/v1/orders --
local uri = aliwaf.req.get_uri()

Alan adını okuma


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


dize


İsteğin Host alan adı.

-- shop.example.com --
local domain = aliwaf.req.get_domain()

Sorguyu okuma


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


dize


İsteğin tam sorgu dizesi.

-- source=web&campaign=spring2024 --
local query = aliwaf.req.get_query()

Sorgu parametresini okuma


Öğe


Tür


Açıklama


Parametre


dize


Sorgu parametre adı.


Dönüş değeri


dize


İlgili parametre değeri. Parametre yoksa boş bir dize "" döndürür.

-- web --
local source = aliwaf.req.get_arg('source')

Çerez okuma


Öğe


Tür


Açıklama


Parametre


dize


Çerez adı.


Dönüş değeri


dize


İlgili çerez değeri. Çerez yoksa boş bir dize "" döndürür.

-- abc123xyz --
local session_id = aliwaf.req.get_cookie('session_id')

Üstbilgi okuma


Öğe


Tür


Açıklama


Parametre


dize


HTTP istek üstbilgi adı.


Dönüş değeri


dize


İlgili üstbilgi değeri. Üstbilgi yoksa boş bir dize "" döndürür.

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


    boolean

    true, 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.


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


-


-

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


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


tamsayı


Mevcut milisaniye düzeyindeki UNIX zaman damgası.

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


Öğe


Tür


Açıklama


Parametre


-


-


Dönüş değeri


-


-

-- Take action on the current request based on the pre-selected action --
aliwaf.func.punish()