ftw

केवल HTML contains और Status code जाँच के साथ परीक्षण चलाना

• YAML फ़ाइलें बनाएं जो आपके वेबसर्वर की ओर इशारा करती हैं जिसके सामने एक WAF है
• py.test test/test_default.py --ruledir test/yaml

Apache+Modsecurity+OWASP CRS की प्रावधान

यदि आपको WAF नियमों के परीक्षण के लिए एक वातावरण की आवश्यकता है, तो Apache, Modsecurity और OWASP कोर नियम सेट के संस्करण 3.0.0 के साथ एक बनाया गया है। इसे निम्न द्वारा तैनात किया जा सकता है:

• `Checking out the repository: ``git clone https://github.com/fastly/waf_testbed.git```
• `Typing vagrant up

YAML फ़ाइलों में गंतव्य पते को कस्टम डोमेन में ओवरराइड करते हुए परीक्षण चलाना

• अपना परीक्षण वेब सर्वर प्रारंभ करें
• py.test test/test_default.py --ruledir=test/yaml --destaddr=domain.com --port 443 --protocol https

एकीकरण परीक्षण चलाएं, स्थानीय वेबसर्वर, sudo का उपयोग करना पड़ सकता है

• py.test test/integration/test_logcontains.py -s --ruledir=test/integration/

लॉग्स को कैसे एकीकृत करें

1. आवश्यक आयात के साथ एक *.py फ़ाइल बनाएं, एक उदाहरण test/integration/test_logcontains.py में दिखाया गया है
2. शुरुआत में test* वाले सभी फ़ंक्शन py.test द्वारा चलाए जाएंगे, इसलिए एक फ़ंक्शन def test_somewaf बनाएं
3. एक क्लास लागू करें जो LogChecker से विरासत में मिलता है
   1. get_logs() फ़ंक्शन लागू करें। FTW परीक्षण चलाने के बाद इस फ़ंक्शन को कॉल करेगा, और यह self.start और self.end के डेटटाइम सेट करेगा
   2. डेटटाइम वेरिएबल से जानकारी का उपयोग करके अपने WAF से फ़ाइलें प्राप्त करें, चाहे वह फ़ाइल हो या API कॉल
   3. लॉग प्राप्त करें, उन्हें स्ट्रिंग की एक सरणी में संग्रहीत करें और get_logs() से लौटाएं
4. py.test fixtures का उपयोग करें। एक फंक्शन डेकोरेटर @pytest.fixture का उपयोग करें, अपना नया LogChecker ऑब्जेक्ट लौटाएं। जब भी आप अपने परीक्षणों में एक फंक्शन आर्गुमेंट का उपयोग करते हैं जो उस @pytest.fixture के नाम से मेल खाता है, तो यह आपके ऑब्जेक्ट को इंस्टेंटिएट करेगा और परीक्षण चलाना आसान बनाएगा। इसका एक उदाहरण चरण 1 की पायथन फ़ाइल में है।
5. *.yaml प्रारूप में एक परीक्षण कॉन्फ़िगरेशन लिखें जैसा कि test/integration/LOGCONTAINSFIXTURE.yaml में देखा गया है, log_contains पंक्ति में एक स्ट्रिंग की आवश्यकता होती है जो एक regex है। FTW YAML फ़ाइल में प्रत्येक चरण से log_contains स्ट्रिंग को एक regex में संकलित करेगा। फिर इस regex का उपयोग get_logs() से पारित लॉग की पंक्तियों के साथ मिलान खोजने के लिए किया जाएगा। log_contains स्ट्रिंग, तब, एक अद्वितीय नियम-आईडी होनी चाहिए क्योंकि FTW लालची है और पहले मैच पर आगे बढ़ेगा। LogChecker ऑब्जेक्ट को पारित शुरू/अंत समय से झूठी सकारात्मकता को कम किया जाता है, लेकिन सुरक्षित रहने और अद्वितीय regex का उपयोग करना सबसे अच्छा है।
6. प्रत्येक चरण के लिए, get_logs() फ़ंक्शन को कॉल किया जाता है, इसलिए यदि आप इस तरह से अपने लॉग प्राप्त करते हैं तो API कॉल के लिए खाता बनाना सुनिश्चित करें।

प्रोग्रामेटिक रूप से HTTP अनुरोध करना

हालांकि YAML प्रारूप का उपयोग करके अनुरोध करना पसंद किया जाता है, अक्सर स्वचालित परीक्षणों में कई गतिशील अनुरोध करने की आवश्यकता होती है। ऐसे मामले में संपूर्ण के हिस्से के रूप में चलाए जा सकने वाले परीक्षण मामलों का उत्पादन करने के लिए py.test ढाँचे का उपयोग करने की अनुशंसा की जाती है। सामान्यतः HTTP अनुरोध करना सरल है:

1. HttpUA() क्लास का एक इंस्टेंस बनाएं
2. Input() क्लास का एक इंस्टेंस बनाएं जो उन पैरामीटरों को प्रदान करता है जिन्हें आप डिफ़ॉल्ट नहीं करना चाहते हैं
3. इनपुट क्लास का इंस्टेंस HttpUA.send_request() को प्रदान करें

कुछ उदाहरणों के लिए http एकीकरण परीक्षण देखें