ooniprobe - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

ooniprobe - एक नेटवर्क सेंसरशिप माप उपकरण।

SYNOPSIS

ooniprobe [-एचएनएसपी] [--संस्करण] [--स्पू] [-o रिपोर्ट फ़ाइल] [-i टेस्टडेक] [-c कलेक्टर] [-b
शेख़ीबाज़] [-l लॉग फ़ाइल] [-O pcapfile] [-f कॉन्फिगफाइल] [-d दातादिर] परीक्षण का नाम

वर्णन

ooniprobe इंटरनेट सेंसरशिप माप करने के लिए उपकरण है। हमारा लक्ष्य हासिल करना है
सेंसरशिप से संबंधित अनुसंधान करने के लिए एक सामान्य डेटा प्रारूप और कार्यप्रणाली का सेट।

विकल्प

-h or --मदद
यह सहायता प्रदर्शित करें और बाहर निकलें।

-n or --नहीं-कलेक्टर
ओनिब कलेक्टर को नेट परीक्षण परिणामों की रिपोर्ट करना अक्षम करें।

-s or --सूची
सभी उपलब्ध नेट परीक्षणों की सूची बनाएं।

-p or --प्रिंटडेक
ओओनिप्रोब परीक्षण के रूप में निर्दिष्ट कमांड लाइन विकल्पों को मानक आउटपुट पर प्रिंट करें
डेक.

-o or --रिपोर्ट फ़ाइल
रिपोर्ट फ़ाइल को लिखने का पथ निर्दिष्ट करें।

-i or --टेस्टडेक
इनपुट के रूप में एक परीक्षण डेक निर्दिष्ट करें: एक yaml फ़ाइल जिसमें चलाने के लिए परीक्षण और उनके
तर्क।

-c or --एकत्र करनेवाला
नेट परीक्षण परिणामों के संग्रहकर्ता का पता निर्दिष्ट करें। यह हमेशा करने की सलाह दी जाती है
निर्दिष्ट करें और बाउंसर करें और इसे आपके परीक्षण या परीक्षण डेक के लिए एक कलेक्टर वापस करने दें
चल रहा है।

-b or --बाउंसर
बाउंसर का पता जो जांच को सूचित करेगा कि किस कलेक्टर का उपयोग करना है और
परीक्षण सहायकों के पते. डिफ़ॉल्ट: httpo://nkvphnp3p6agi5qq.onion

-l or --बोटा दस्तावेज
लिखने के लिए लॉग फ़ाइल का पथ

-O or --pcapfile
pcap फ़ाइल नाम के लिए उपसर्ग.

-f or --कॉन्फ़िगफ़ाइल
ooniprobe कॉन्फ़िगरेशन फ़ाइल के लिए पथ निर्दिष्ट करें।

-d or --दातादिर
ooniprobe डेटा निर्देशिका के लिए एक पथ निर्दिष्ट करें

--स्पू जो कुछ भी घटित होता है उसका एक बेहद विस्तृत लॉग प्रिंट करें। डिबगिंग करते समय उपयोगी
जटिल कोड को फ्रीज या लॉक कर देता है।

--संस्करण
ooniprobe संस्करण प्रदर्शित करें और बाहर निकलें।

ONIPROBE

यह वह उपकरण है जो परियोजना में डेटा का योगदान करने में रुचि रखने वाले स्वयंसेवकों और अनुसंधानकर्ताओं को प्रदान करता है
चलना चाहिए.

ooniprobe उपयोगकर्ता को यह चुनने की अनुमति देता है कि कौन सा परीक्षण चलाया जाना चाहिए और कौन सा बैकएंड होना चाहिए
परीक्षण रिपोर्ट संग्रहीत करने और/या परीक्षण चलाने में उनकी सहायता करने के लिए उपयोग किया जाता है।

ओनीप्रोब परीक्षणों को दो श्रेणियों में विभाजित किया गया है: यातायात जोड़ - तोड़ और सामग्री
अवरूध्द.

यातायात जोड़ - तोड़ परीक्षणों का उद्देश्य किसी प्रकार की छेड़छाड़ की उपस्थिति का पता लगाना है
जांच और दूरस्थ परीक्षण सहायक बैकएंड के बीच इंटरनेट ट्रैफ़िक। वैसे तो वे आम तौर पर
परीक्षण चलाने के लिए ओनिब बैकएंड घटक के चयन की आवश्यकता है।

सामग्री अवरूध्द इसका उद्देश्य उस प्रकार की सामग्री की गणना करना है जिसे ब्लॉक किया गया है
नेटवर्क के दृष्टिकोण से जांच करता है। इस प्रकार उन्हें आमतौर पर एक इनपुट सूची निर्दिष्ट करने की आवश्यकता होती है
परीक्षण चलाने के लिए.

धमकी आदर्श
हमारा प्रतिद्वंद्वी देशव्यापी नेटवर्क की निगरानी और हेराफेरी करने में सक्षम है
प्रसार यातायात।

हमारे प्रतिद्वंद्वी के लक्ष्य हैं:

· कुछ सामग्री तक पहुंच प्रतिबंधित करें, जबकि समग्र गुणवत्ता में गिरावट न हो
नेटवर्क

· नेटवर्क की इस तरह निगरानी करें कि वे वास्तविक समय में इसके दुरुपयोग की पहचान कर सकें

नेटवर्क फ़िल्टरिंग डिटेक्शन परीक्षण चलाने के बारे में अधिक जानकारी:

1. सेंसरशिप डिटेक्शन परीक्षण करने वाले अभिनेताओं का पता लगाएं

2. ऐसे परीक्षण चलाने वाले लोगों को यह विश्वास दिलाकर मूर्ख बनाना कि नेटवर्क अप्रतिबंधित है

नोट जबकि 2) => 1) यह सच नहीं है कि 1) => 2) ऐसे अभिनेताओं की पहचान के रूप में
जरूरी नहीं कि यह वास्तविक समय में घटित हो। जबकि हमारा इरादा इसे कम करना है
OONI जांच चलाने वाले उपयोगकर्ताओं के जोखिम की पहचान की जाएगी, यह सटीकता में एक ट्रेडऑफ़ के साथ आता है।
इसलिए कुछ परीक्षणों में फ़िंगरप्रिंट योग्यता को पक्ष में करना आवश्यक है
सटीकता का परीक्षण करता है।

यही कारण है कि हम परीक्षणों को इस आधार पर विभाजित करते हैं कि इसे चलाने वाले उपयोगकर्ता को किस जोखिम का सामना करना पड़ सकता है, जिससे इसकी अनुमति मिलती है
उपयोगकर्ता स्वतंत्र रूप से चुन सकते हैं कि वे किस खतरे के मॉडल का पालन करना चाहते हैं।

स्थापना
पढ़ना इसका से पहले दौड़ना ओनीप्रोब!

ओओनीप्रोब चलाना एक संभावित जोखिम भरी गतिविधि है। यह काफी हद तक इस पर निर्भर करता है
आप किस क्षेत्राधिकार में हैं और आप कौन सी परीक्षा चला रहे हैं। यह तकनीकी रूप से है
आपके इंटरनेट कनेक्शन का अवलोकन करने वाले व्यक्ति के लिए यह संभव है कि वह इस तथ्य से अवगत हो कि आप
ओनीप्रोब चला रहे हैं। इसका मतलब यह है कि यदि नेटवर्क माप परीक्षण चलाना कुछ है
आपके देश में अवैध माना जाता है तो आपको पकड़ा जा सकता है।

इसके अलावा, ओनिप्रोब इंस्टॉल लक्ष्य मशीन की सुरक्षा के लिए कोई सावधानी नहीं बरतता है
फोरेंसिक विश्लेषण. यदि तथ्य यह है कि आपने ओओनी जांच स्थापित या उपयोग किया है तो यह एक दायित्व है
आपके लिए, कृपया इस जोखिम से अवगत रहें।

डेबियन आधारित सिस्टम
sudo sh -c 'गूंज' "देब http://deb.ooni.nu/ooni खरखरा मुख्य" >> / Etc / apt / sources.list'

GPG --कीसर्वर pgp.mit.edu --recv कुंजी 0x49B8CDF4

GPG --निर्यात 89AB86D4788F3785FE9EDA31F9E2D9B049B8CDF4 | sudo उपयुक्त कुंजी जोड़ना -

sudo उपयुक्त - मिल अद्यतन && sudo उपयुक्त - मिल स्थापित ooniprobe

Linux
हमारा मानना ​​है कि ओनिप्रोब डेबियन जीएनयू/लिनक्स व्हीज़ी पर भी यथोचित रूप से चलता है
उबंटू के संस्करण जैसे नैटी और बाद में रिलीज़। इंस्टॉल किए बिना ooniprobe चला रहा हूं
यह निम्नलिखित आदेशों के साथ समर्थित है:

Git क्लोन https://git.torproject.org/ooni-probe.git

cd ऊनी-जांच

./सेटअप-निर्भरता.श

अजगर setup.py स्थापित

की स्थापना up विकास वातावरण
डेबियन आधारित प्रणालियों पर यह इसके साथ किया जा सकता है:

Vsudo उपयुक्त - मिल स्थापित libgeoip-dev पायथन-वर्चुअलएनवी वर्चुअलएन्व्रैपर

mkvirtualenv ooniprobe

अजगर setup.py स्थापित

रंज स्थापित -r आवश्यकताएँ-dev.txt

अन्य प्लेटफार्मों (साथ में आवारा)
स्थापित करें आवारा और स्थापित करें Virtualbox

On ओएसएक्स:

यदि आपके पास यह इंस्टॉल नहीं है homebrew

शराब बनाना स्थापित Git

On डेबियन/उबंटू:

sudo उपयुक्त - मिल स्थापित Git

1. एक टर्मिनल खोलें और चलाएँ:

Git क्लोन https://git.torproject.org/ooni-probe.git

cd ऊनी-जांच/

आवारा up

2. बॉक्स में लॉगिन करें:

आवारा एसएसएच

ooniprobe को स्थापित किया जाएगा /ऊनी.

3. आप इसके साथ परीक्षण चला सकते हैं:

ooniprobe ब्लॉकिंग/http_requests -f /ooni/inputs/input-pack/alexa-top-1k.txt

का प्रयोग ooniprobe
जाल परीक्षण यह आकलन करने के लिए मापों का एक सेट है कि किस प्रकार की इंटरनेट सेंसरशिप हो रही है।

डेक कुछ संबद्ध इनपुट के साथ ओओनीप्रोब नेटटेस्ट का संग्रह है।

कलेक्टर माप के परिणामों की रिपोर्ट करने के लिए उपयोग की जाने वाली सेवा है।

टेस्ट सहायक यह एक ऐसी सेवा है जिसका उपयोग जांच द्वारा अपने मापों को सफलतापूर्वक निष्पादित करने के लिए किया जाता है।

शेख़ीबाज़ एक सेवा है जिसका उपयोग परीक्षण सहायकों और संग्राहकों के पते खोजने के लिए किया जाता है।

का विन्यास ooniprobe
आप मिली कॉन्फ़िगरेशन फ़ाइल को संपादित करके ooniprobe के लिए कॉन्फ़िगरेशन को संपादित कर सकते हैं
का भीतर ~/.ooni/ooniprobe.conf.

डिफ़ॉल्ट रूप से ooniprobe परीक्षण परिणाम में व्यक्तिगत पहचान संबंधी जानकारी शामिल नहीं करेगा,
न ही कोई pcap फ़ाइल बनाएँ। यह व्यवहार वैयक्तिकृत किया जा सकता है.

रनिंग डेक
आपको अंदर सभी स्थापित डेक मिलेंगे /usr/share/ooni/decks.

फिर आप कमांड लाइन विकल्प का उपयोग करके डेक चला सकते हैं -i:

जड़ के रूप में:

ooniprobe -i /usr/share/ooni/decks/mlab.deck

या एक उपयोगकर्ता के रूप में:

ooniprobe -i /usr/share/ooni/decks/mlab_no_root.deck

या:

जड़ के रूप में:

ooniprobe -i /usr/share/ooni/decks/complete.deck

या एक उपयोगकर्ता के रूप में:

ooniprobe -i /usr/share/ooni/decks/complete_no_root.deck

आपके नेटवर्क के आधार पर उपरोक्त परीक्षणों को पूरा करने में लगभग 20-30 मिनट की आवश्यकता होगी
गति।

यदि आप कुछ तेज़ परीक्षण चलाना पसंद करेंगे तो आपको निम्न चलाना चाहिए: रूट के रूप में:

ooniprobe -i /usr/share/ooni/decks/fast.deck

या एक उपयोगकर्ता के रूप में:

ooniprobe -i /usr/share/ooni/decks/fast_no_root.deck

रनिंग जाल परीक्षण
आप सभी स्थापित स्थिर नेट परीक्षणों को इसके साथ सूचीबद्ध कर सकते हैं:

ooniprobe -s

फिर आप उदाहरण के लिए इसका नाम निर्दिष्ट करके नेटटेस्ट चला सकते हैं:

ooniprobe हेरफेर/http_header_field_manipulation

परीक्षणों के इनपुट को यूआरएल के रूप में निर्दिष्ट करना भी संभव है:

ooniprobe ब्लॉकिंग/http_requests -f httpo://ihiderha53f36lsd.onion/input/
37e60e13536f6afe47a830bfb6b371b5cf65da66d7ad65137344679b24fdccd1

आप परीक्षण का परिणाम अपनी वर्तमान कार्यशील निर्देशिका में पा सकते हैं।

डिफ़ॉल्ट रूप से रिपोर्ट परिणाम डिफ़ॉल्ट ओओएनआई कलेक्टर द्वारा एकत्र किया जाएगा
परीक्षण सहायकों के पते डिफ़ॉल्ट बाउंसर से प्राप्त किए जाएंगे।

आप विकल्पों के साथ अपना स्वयं का कलेक्टर या बाउंसर भी निर्दिष्ट कर सकते हैं -c और -b.

(वैकल्पिक) स्थापित करें obfproxy
अपने प्लेटफ़ॉर्म के लिए obfsproxy का नवीनतम संस्करण स्थापित करें।

डाउनलोड ओब्फ्स्प्रॉक्सी

सेतु और obfproxy सेतु
ooniprobe एक छिपी हुई सेवा के लिए Tor के माध्यम से oonib रिपोर्ट संग्राहकों को रिपोर्ट प्रस्तुत करता है
समापनबिंदु. डिफ़ॉल्ट रूप से, ooniprobe स्थापित सिस्टम Tor का उपयोग करता है, लेकिन इसे कॉन्फ़िगर भी किया जा सकता है
Tor लॉन्च करने के लिए (ooniprobe.conf में Advanced.start_tor विकल्प देखें), और ooniprobe
पुलों का समर्थन करता है (और ओबीएफएसप्रॉक्सी पुल, यदि ओबीएफएसप्रॉक्सी स्थापित है)। टोर.ब्रिज
ooniprobe.conf में विकल्प एक फ़ाइल का पथ सेट करता है जिसमें "ब्रिज" का एक सेट होना चाहिए
पंक्तियाँ (उसी प्रारूप की जैसा कि torc में उपयोग किया जाता है, और जैसा लौटाया जाता है
https://bridges.torproject.org). यदि ओबीएफएसप्रॉक्सी पुलों का उपयोग किया जाना है, तो पथ
obfsproxy बाइनरी को कॉन्फ़िगर किया जाना चाहिए। विकल्प Advanced.obfsproxy_binary, में देखें
ooniprobe.conf.

की स्थापना क्षमताओं on तुंहारे Virtualenv अजगर बाइनरी
यदि आपका वितरण क्षमताओं का समर्थन करता है तो आप OONI को रूट के रूप में चलाने की आवश्यकता से बच सकते हैं:

सेटकैप कैप_नेट_एडमिन, कैप_नेट_रॉ+ईआईपी /पथ/से/आपका/वर्चुअलएनवी/पायथन

मूल ooniprobe टेस्ट
के लिए स्रोत सामग्री ब्लॉकिंग परीक्षण और यातायात जोड़ - तोड़ परीक्षण में पाया जा सकता है
क्रमशः नेटटेस्ट/ब्लॉकिंग और नेटटेस्ट/हेरफेर निर्देशिका।

सामग्री अवरूध्द टेस्ट
· डीएनएस संगति

· HTTP अनुरोधों

· टीसीपी जुड़ें

यातायात जोड़ - तोड़ टेस्ट
· HTTP अमान्य निवेदन रेखा:

· डीएनएस चकमा देना

· HTTP हैडर क्षेत्र जोड़ - तोड़

· ट्रेसरूट

· HTTP मेजबान

अन्य परीक्षण
हमारे पास कुछ अन्य परीक्षण भी हैं जो वर्तमान में पूरी तरह से समर्थित नहीं हैं या अभी भी समर्थित हैं
के साथ प्रयोग किया।

आप इन्हें यहां पा सकते हैं:

· ऊनी/नेटटेस्ट/प्रयोगात्मक

ऐसे परीक्षण जो माप नहीं करते लेकिन स्कैनिंग के लिए उपयोगी होते हैं, इन्हें यहां पाया जा सकता है:

· ओओएनआई/नेटटेस्ट/स्कैनिंग

ऐसे परीक्षण जिनमें तृतीय पक्ष उपकरण चलाना शामिल है, वे यहां पाए जा सकते हैं:

· ओओनी/नेटटेस्ट/थर्ड_पार्टी

रिपोर्ट
ooniprobe द्वारा एकत्र की गई रिपोर्टें संग्रहीत की जाती हैं https://ooni.torproject.org/reports/0.1/
CC /

कहा पे CC द्वारा निर्दिष्ट दो अक्षर वाला देश कोड है आईएसओ 31666-2.

उदाहरण के लिए इटली के लिए रिपोर्ट (CC is it) में पाया जा सकता है:

https://ooni.torproject.org/reports/0.1/IT/

इस निर्देशिका में निम्नलिखित का उपयोग करके परीक्षण के लिए विभिन्न रिपोर्टें शामिल होंगी
सम्मेलन:

परीक्षण का नाम - dateInISO8601फ़ॉर्मेट - जांचएएसनंबर .यमलू

दिनांक का उपयोग करके व्यक्त किया जाता है आईएसओ 8601 सेकंड सहित और संख्या सहित : घंटों का परिसीमन करना,
मिनट, दिन.

इस तरह:

वर्ष - महीना - दिन T घंटे मिनट सेकंड Z

देखिए यहाँ उत्पन्न करें एसटी la up सेवा मेरे डेटा सूची of आईएसओ 8601 देश कोड

समय है हमेशा यूटीसी में व्यक्त किया गया।

यदि टकराव का पता चलता है तो परीक्षण में एक इंट (1 से शुरू) जोड़ दिया जाएगा।

उदाहरण के लिए यदि दो रिपोर्टें पहली जनवरी 2012 को दोपहर (UTC समय) पर बनाई गई हैं
MIT (AS3) से शार्प को यहां संग्रहित किया जाएगा:

https://ooni.torproject.org/reports/0.1/US/2012-01-01T120000Z_AS3.yamloo
https://ooni.torproject.org/reports/0.1/US/2012-01-01T120000Z_AS3.1.yamloo

ध्यान दें: इसकी अत्यधिक संभावना नहीं है कि रिपोर्टें उसी सटीक टाइमस्टैम्प के साथ बनाई जाएं
वही सटीक ASN. यदि ऐसा होता है तो यह किसी दुर्भावनापूर्ण रिपोर्ट का सूचकांक हो सकता है
ज़हर का हमला चल रहा है.

रिपोर्ट प्रारूप संस्करण changelog
यहां रिपोर्टिंग प्रारूप में प्रमुख बदलावों के बारे में विवरण दिया जाएगा।

संस्करण 0.1
प्रारंभिक प्रारूप संस्करण.

लेखन ऊँनी परीक्षण
OONI परीक्षण एपीआई अत्यधिक प्रभावित है और आंशिक रूप से पायथन पर आधारित है अध्याय परीक्षा
मॉड्यूल और मुड़.परीक्षण.

टेस्ट केसेस
OONI परीक्षण के परमाणु को टेस्ट केस कहा जाता है। एक टेस्ट केस क्लास में एकाधिक शामिल हो सकते हैं
परीक्षण विधियाँ।

कक्षा ooni.nettest.NetTestCase
यह OONI नेटटेस्ट ब्रह्मांड का आधार है। जब आप नेटटेस्ट लिखेंगे तो आप ऐसा करेंगे
इस ऑब्जेक्ट को उपवर्गित करें।

· इनपुट: इनपुट के स्थिर सेट पर सेट किया जा सकता है। सभी परीक्षण (तरीके शुरू हो रहे हैं
"परीक्षण" उपसर्ग के साथ) प्रति इनपुट एक बार चलाया जाएगा। प्रत्येक रन पर _इनपुट_
TestCase उदाहरण की विशेषता को वर्तमान के मान पर सेट किया जाएगा
इनपुट पर पुनरावृत्ति। किसी भी पायथन पुनरावर्तनीय वस्तु को इनपुट पर सेट किया जा सकता है।

· इनपुटफ़ाइल: विशेषता को कमांड लाइन वाले सरणी पर सेट किया जाना चाहिए
तर्क जिसे इनपुट फ़ाइल के रूप में उपयोग किया जाना चाहिए। ऐसी सरणी इस तरह दिखती है:
["कमांडलिनर्ग", "सी", "चूक जाना कीमत" " विवरण"]

ऐसे एरे का दूसरा मान कमांड लाइन आर्ग के लिए शॉर्टहैंड है।
इसके बाद उपयोगकर्ता परीक्षण के लिए इनपुट निर्दिष्ट करने में सक्षम होगा:
ooniprobe mytest.py --commandlinearg पथ/से/फ़ाइल.txt

or
ooniprobe mytest.py -c पथ/से/फ़ाइल.txt

· इनपुटप्रोसेसर: को एक फ़ंक्शन पर सेट किया जाना चाहिए जो तर्क के रूप में फ़ाइल नाम लेता है और
यह परीक्षण उदाहरण में पारित किए जाने वाले इनपुट को वापस कर देगा।

· नाम: परीक्षण के नाम पर सेट किया जाना चाहिए.

· लेखक: परीक्षण लेखक का नाम और संपर्क विवरण शामिल होना चाहिए।
ऐसी स्ट्रिंग का प्रारूप इस प्रकार है:
RSI नाम <[ईमेल संरक्षित]>

· संस्करण: परीक्षण की संस्करण स्ट्रिंग है.

· रूट की आवश्यकता है: यदि परीक्षण को रूट के रूप में चलाया जाना चाहिए तो इसे सही पर सेट करें।

· उपयोगविकल्प: प्रसंस्करण के लिए ट्विस्टेड.पायथन.उपयोग.विकल्पों का एक उपवर्ग
कमांड लाइन तर्क

· स्थानीय विकल्प: इसमें पार्स की गई कमांड लाइन तर्क शामिल हैं।

विचित्रताएँ: प्रत्येक वर्ग जिसके पहले परीक्षण लगा होता है चाहिए वापसी a
ट्विस्टेड.इंटरनेट.डेफर.डेफरर्ड.

यदि आप जिस परीक्षा को लिखने की योजना बना रहे हैं वह सूचीबद्ध नहीं है टो ऊँनी Trac पृष्ठ, आपको इसे जोड़ना चाहिए
सूची में जोड़ें और उसके बाद इसके बारे में एक विवरण जोड़ें टेस्ट टेम्पलेट

परीक्षण इनपुट द्वारा संचालित होते हैं। प्रत्येक इनपुट के लिए आंतरिक रूप से एक नया परीक्षण उदाहरण बनाया जाता है
_setUp विधि को वह कहा जाता है जिसे परीक्षण टेम्पलेट्स के अंदर परिभाषित किया जाता है, फिर सेटअप विधि
जो उपयोगकर्ताओं द्वारा अधिलेखित किया जा सकता है।

गोचा: कभी नहीँ अपनी परीक्षण विधि के अंदर रिएक्टर.स्टार्ट ऑफ रिएक्टर.स्टॉप को कॉल करें और सभी करेंगे
अच्छा बनो।

निविष्टियां
इनपुट वे हैं जो टेस्ट केस के प्रत्येक पुनरावृत्ति के लिए इनपुट के रूप में दिए जाते हैं। यदि आपके पास 100 हैं
इनपुट, तो प्रत्येक परीक्षण केस 100 बार चलाया जाएगा।

इनपुट के एक स्थिर सेट को कॉन्फ़िगर करने के लिए आपको इसे परिभाषित करना चाहिए ooni.nettest.NetTestCase
गुण निविष्टियां. परीक्षण चलाया जाएगा लेन(इनपुट) बार. कोई भी पुनरावर्तनीय वस्तु वैध है
निविष्टियां विशेषता।

यदि आप चाहते हैं कि इनपुट उपयोगकर्ता द्वारा निर्दिष्ट इनपुट फ़ाइल से निर्धारित किया जाए, तो आप
सेट करना होगा इनपुट फ़ाइल गुण। यह एक सरणी है जो निर्दिष्ट करती है कि कौन सा कमांड लाइन विकल्प है
इस मान को नियंत्रित करने के लिए उपयोग किया जा सकता है।

डिफ़ॉल्ट रूप से इनपुटप्रोसेसर फ़ाइल को लाइन दर लाइन पढ़ने और न्यूलाइन स्ट्रिप करने के लिए सेट किया गया है
पात्र। इस व्यवहार को बदलने के लिए आपको इसे सेट करना होगा इनपुटप्रोसेसर ए को विशेषता
फ़ंक्शन जो फ़ाइल डिस्क्रिप्टर को तर्क के रूप में लेता है और अगला आइटम उत्पन्न करता है। डिफ़ॉल्ट
इनपुटप्रोसेसर इस तरह दिखता है:

डीईएफ़ लाइनबायलाइन(फ़ाइल नाम):
एफपी = खुला (फ़ाइल नाम)
fp.xreadlines() में x के लिए:
उपज x.strip()
fp.बंद करें()

व्यवस्था और आदेश line गुजर
परीक्षण परिभाषित कर सकते हैं स्थापित करना वह विधि जिसे हर बार टेस्ट केस ऑब्जेक्ट कहा जाएगा
तत्काल, यहां आप अपनी सभी परीक्षण विधियों के लिए कुछ सामान्य तर्क रख सकते हैं जो कि होने चाहिए
कोई भी परीक्षण होने से पहले चलाया जाए।

ट्विस्टेड की बदौलत कमांड लाइन तर्कों को पार्स किया जा सकता है
ट्विस्टेड.पायथन.उपयोग.उपयोग विकल्प वर्ग.

आपको इसे उपवर्गित करना होगा और इंगित करने के लिए NetTestCase विशेषता उपयोग विकल्प को परिभाषित करना होगा
इसके एक उपवर्ग के लिए.

वर्ग उपयोग विकल्प(उपयोग विकल्प):
optParameters = [['बैकएंड', 'बी', 'http://127.0.0.1:57001',
'परीक्षण बैकएंड का यूआरएल उपयोग करने के लिए']
]

वर्ग MyTestCase(nettest.NetTestCase):
उपयोग विकल्प = उपयोग विकल्प

इनपुटफ़ाइल = ['फ़ाइल', 'एफ', कोई नहीं, "कुछ फू फ़ाइल"]
आवश्यक विकल्प = ['बैकएंड']

def test_my_test(स्वयं):
self.localOptions['बैकएंड']

फिर आप क्लास विशेषता के माध्यम से पार्स किए गए कमांड लाइन तर्कों तक पहुंचने में सक्षम होंगे
स्थानीयविकल्प.

RSI आवश्यक विकल्प विशेषताएँ उन मापदंडों की एक श्रृंखला निर्दिष्ट करती हैं जो इसके लिए आवश्यक हैं
ठीक से चलाने के लिए परीक्षण करें।

इनपुट फ़ाइल एक विशेष वर्ग विशेषता है जिसका उपयोग इनपुटफ़ाइल के प्रसंस्करण के लिए किया जाएगा।
यहां पढ़ा गया फ़ाइल नाम दिया जाएगा
ooni.nettest.NetTestCase.inputProcessor वह विधि जो डिफ़ॉल्ट रूप से, एक पंक्ति उत्पन्न करेगी
एक समय में फ़ाइल.

टेस्ट तरीके
इन्हें आपके अंदर परिभाषित किया जाएगा ooni.nettest.NetTestCase उपवर्ग. ये होंगे
कक्षा विधियाँ.

परीक्षण_ के साथ उपसर्ग वाली सभी वर्ग विधियाँ चलाई जाएंगी। कार्य जो प्रासंगिक हैं
आपके परीक्षण में सभी लोअरकेस को अंडरस्कोर से अलग किया जाना चाहिए।

परीक्षण रिपोर्ट में डेटा जोड़ने के लिए आप सीधे रिपोर्ट ऑब्जेक्ट पर इस प्रकार लिख सकते हैं:

डीईएफ़ test_my_function():
परिणाम = कुछ करो()
self.रिपोर्ट['कुछ'] = परिणाम

इसके बाद ओओएनआई अंतिम परीक्षण रिपोर्ट में डेटा लिखने का काम संभालेगा।

वर्तमान इनपुट तक पहुंचने के लिए आप इसका उपयोग कर सकते हैं निवेश विशेषता, उदाहरण के लिए:

डीईएफ़ test_with_input():
do_something_with_input(self.input)

यह इनपुट की सूची पर प्रत्येक पुनरावृत्ति पर इनपुट के साथ कुछ करेगा।

टेस्ट टेम्पलेट्स
टेस्ट टेम्प्लेट आपको परीक्षण लिखने में सहायता करते हैं। उनमें पहले से ही सभी सामान्य चीजें शामिल हैं
वह कार्यक्षमता जो उस प्रकार का परीक्षण चलाने के लिए उपयोगी है। वे देखभाल भी करते हैं
उनके द्वारा एकत्र किए गए डेटा को रिपोर्ट फ़ाइल में परीक्षण चलाने के लिए प्रासंगिक लिखना।

वर्तमान में कार्यान्वित परीक्षण टेम्पलेट हैं ooni.templates.scapyt स्कैपी पर आधारित परीक्षणों के लिए,
ooni.templates.tcpt टीसीपी पर आधारित परीक्षणों के लिए, ooni.templates.httpt HTTP पर आधारित परीक्षणों के लिए,
और ooni.templates.dnst DNS पर आधारित परीक्षणों के लिए।

स्केप आधारित परीक्षण
स्कैपी आधारित परीक्षण का एक उपवर्ग होगा ooni.templates.scapyt.BaseScapyTest.

यह स्कैपी सेंड और रिसीव फ़ंक्शन के चारों ओर एक रैपर प्रदान करता है जो भेजे गए को लिखेगा
और स्रोत और गंतव्य आईपी के स्वच्छताकरण के साथ रिपोर्ट में पैकेट प्राप्त किए
पतों।

इसमें स्कैपी एसआर फ़ंक्शन के समान सिंटैक्स है, सिवाय इसके कि यह एक विलंबित रिटर्न देगा।

इस फ़ंक्शन के आधार पर एक सरल ICMP पिंग लागू करने के लिए आप ऐसा कर सकते हैं (से लिया गया)।
Nettest.examples.example_scapyt.ExampleICMPPingScapy)

ट्विस्टेड.पायथन आयात उपयोग से

scapy.all से आईपी, आईसीएमपी आयात करें

ooni.templates से स्कैपिट आयात करें

वर्ग उपयोग विकल्प(उपयोग विकल्प):
optParameters = [['लक्ष्य', 'टी', '127.0.0.1', "पिंग के लिए लक्ष्य निर्दिष्ट करें"]]

वर्ग उदाहरणICMPPingScapy(scapyt.BaseScapyTest):
नाम = "उदाहरण आईसीएमपी पिंग टेस्ट"

उपयोग विकल्प = उपयोग विकल्प

डीईएफ़ test_icmp_ping(स्वयं):
डीईएफ़ समाप्त(पैकेट):
पैकेट प्रिंट करें
उत्तर दिया गया, अनुत्तरित = पैकेट
उत्तर में एसएनडी, आरसीवी के लिए:
rcv.शो()

पैकेट = आईपी(डीएसटी=स्वयं.स्थानीय विकल्प['लक्ष्य'])/आईसीएमपी()
d = self.sr(पैकेट)
d.कॉलबैक जोड़ें(समाप्त)
वापसी डी

self.sr() द्वारा लिए गए तर्क बिल्कुल स्कैपी भेजने और प्राप्त करने के समान हैं
फ़ंक्शन, अंतर केवल इतना है कि नियमित स्कैपी सुपर सॉकेट का उपयोग करने के बजाय
इसके चारों ओर हमारे मुड़े हुए चालित आवरण का उपयोग करता है।

वैकल्पिक रूप से यह परीक्षा का उपयोग करके भी लिखी जा सकती है ट्विस्टेड.डेफर.इनलाइनकॉलबैक्स()
डेकोरेटर, जो इसे नियमित अनुक्रमिक कोड के समान बनाता है।

ट्विस्टेड.पायथन आयात उपयोग से
ट्विस्टेड.इंटरनेट से आयात स्थगित

scapy.all से आईपी, आईसीएमपी आयात करें

ooni.templates से स्कैपिट आयात करें

वर्ग उपयोग विकल्प(उपयोग विकल्प):
optParameters = [['लक्ष्य', 'टी', '127.0.0.1', "पिंग के लिए लक्ष्य निर्दिष्ट करें"]]

क्लास उदाहरणICMPPingScapyYield(scapyt.BaseScapyTest):
नाम = "उदाहरण आईसीएमपी पिंग टेस्ट"

उपयोग विकल्प = उपयोग विकल्प

@defer.inlineCallbacks
डीईएफ़ test_icmp_ping(स्वयं):
पैकेट = आईपी(डीएसटी=स्वयं.स्थानीय विकल्प['लक्ष्य'])/आईसीएमपी()
उत्तर दिया गया, अनुत्तरित = उपज self.sr(पैकेट)
उत्तर में एसएनडी, आरसीवी के लिए:
rcv.शो()

रिपोर्ट प्रारूप
#########################################
उदाहरण के लिए ICMP पिंग परीक्षण परीक्षण के लिए #OONI जांच रिपोर्ट
# गुरु 22 नवंबर 18:20:43 2012
#########################################
---
{जांच_एएसएन: शून्य, जांच_सीसी: शून्य, जांच_आईपी: 127.0.0.1, सॉफ्टवेयर_नाम: ओओनीप्रोब, सॉफ्टवेयर_संस्करण: 0.0.7.1-अल्फा,
प्रारंभ_समय: 1353601243.0, परीक्षण_नाम: उदाहरण आईसीएमपी पिंग परीक्षण, परीक्षण_संस्करण: 0.1}
...
---
इनपुट: अशक्त
रिपोर्ट:
उत्तर_झंडे: [आईपीएसआरसी]
उत्तर_पैकेट:
- - raw_packet: !!बाइनरी |
RQAAHAEdAAAuAbjKCAgICH8AAEAAAAAAAAA==
सारांश: आईपी/आईसीएमपी 8.8.8.8 > 127.0.0.1 इको-उत्तर 0
भेजे गए_पैकेट:
- - raw_packet: !!बाइनरी |
RQAAHAABAAAevPfwAAAQgICAgIAPf/AAAAAA==
सारांश: आईपी / आईसीएमपी 127.0.0.1 > 8.8.8.8 इको-अनुरोध 0
परीक्षण_नाम: test_icmp_ping
परीक्षण_प्रारंभ: 1353604843.553605
...

टीसीपी आधारित परीक्षण
टीसीपी आधारित परीक्षण उपवर्ग होंगे ooni.templates.tcpt.TCPTest.

यह परीक्षण टेम्पलेट टीसीपी पेलोड को तार पर भेजने और रिकॉर्ड करने की सुविधा प्रदान करता है
प्रतिक्रिया.

ट्विस्टेड.इंटरनेट.एरर से ConnectionReusedError आयात करें
ooni.utils से आयात लॉग
ooni.templates से tcpt आयात करें

वर्ग उदाहरणTCPT(tcpt.TCPTest):
डीईएफ़ test_hello_world(स्वयं):
डीईएफ़ मिला_प्रतिक्रिया(प्रतिक्रिया):
"यह डेटा मिला %s" % प्रतिक्रिया प्रिंट करें

डीईएफ़ कनेक्शन_असफल(विफलता):
विफलता.ट्रैप (कनेक्शन रिफ्यूज्ड एरर)
"कनेक्शन अस्वीकृत" प्रिंट करें

स्व.पता = "127.0.0.1"
सेल्फ.पोर्ट = 57002
पेलोड = "हैलो वर्ल्ड!\n\r"
डी = self.sendPayload(पेलोड)
d.addErrback(कनेक्शन_असफल)
d.कॉलबैक जोड़ें(मिल गया_प्रतिक्रिया)
वापसी डी

टीसीपी कनेक्शन की संभावित विफलताएँ हैं:

ट्विस्टेड.इंटरनेट.एरर.नोरूटएरर यह errno.ENETUNREACH से मेल खाता है

ट्विस्टेड.इंटरनेट.एरर.कनेक्शन रिफ्यूज्ड एरर यह errno.ECONNREFUSED से मेल खाता है

ट्विस्टेड.इंटरनेट.एरर.TCPTimedOutError यह errno.ETIMEDOUT से मेल खाता है

रिपोर्ट प्रारूप
टीसीपी परीक्षण की मूल रिपोर्ट निम्नलिखित की तरह दिखती है (यह एक रिपोर्ट है जो उत्पन्न होती है
उपरोक्त उदाहरण को टीसीपी इको सर्वर के विरुद्ध चलाना)।

#########################################
बेस टीसीपी परीक्षण परीक्षण के लिए # OONI जांच रिपोर्ट
# गुरु 22 नवंबर 18:18:28 2012
#########################################
---
{जांच_एएसएन: शून्य, जांच_सीसी: शून्य, जांच_आईपी: 127.0.0.1, सॉफ्टवेयर_नाम: ओओनीप्रोब, सॉफ्टवेयर_संस्करण: 0.0.7.1-अल्फा,
प्रारंभ_समय: 1353601108.0, परीक्षण_नाम: बेस टीसीपी परीक्षण, परीक्षण_संस्करण: '0.1'}
...
---
इनपुट: अशक्त
रिपोर्ट:
त्रुटियाँ: []
प्राप्त: ["हैलो वर्ल्ड!\n\r"]
भेजा गया: ["हैलो वर्ल्ड!\n\r"]
परीक्षण_नाम: परीक्षण_हैलो_विश्व
परीक्षण_प्रारंभ: 1353604708.705081
...

TODO इसे अधिक विवरण के साथ समाप्त करें

HTTP आधारित परीक्षण
HTTP आधारित परीक्षण इसका एक उपवर्ग होगा ooni.templates.httpt.HTTPTest.

यह तरीके प्रदान करता है ooni.templates.httpt.HTTPTest.processResponseBody() और
ooni.templates.httpt.HTTPTest.processResponseHeaders() प्रतिक्रिया के साथ बातचीत के लिए
क्रमशः बॉडी और हेडर।

उदाहरण के लिए, एक HTTP परीक्षण लागू करने के लिए जो प्रतिक्रिया निकाय का sha256 हैश लौटाता है
(पर आधारित Nettests.examples.example_httpt):

ooni.utils से आयात लॉग
ooni.templates से httpt आयात करें
हैशलिब आयात sha256 से

कक्षा SHA256HTTPबॉडीटेस्ट(httpt.HTTPTest):
नाम = "चेकसमHTTPबॉडीटेस्ट"
लेखक = "आरोन गिब्सन"
संस्करण = 0.1

इनपुटफ़ाइल = ['यूआरएल फ़ाइल', 'एफ', कोई नहीं,
'अनुरोध प्राप्त करने के लिए यूआरएल की सूची']
आवश्यक विकल्प = ['यूआरएल फ़ाइल']

डीईएफ़ test_http(स्वयं):
यदि स्व.इनपुट:
यूआरएल = self.input
self.doRequest(url) वापस करें
अन्य:
अपवाद बढ़ाएँ ("कोई इनपुट निर्दिष्ट नहीं")

डीईएफ़ प्रक्रियारिस्पॉन्सबॉडी(स्वयं, शरीर):
body_sha256sum = sha256(body).hexdigest()
self.रिपोर्ट['चेकसम'] = body_sha256sum

रिपोर्ट प्रारूप
#########################################
#चेकसमHTTPबॉडीटेस्ट परीक्षण के लिए OONI जांच रिपोर्ट
# गुरु 6 दिसंबर 17:31:57 2012
#########################################
---
विकल्प हैं:
संग्राहक: शून्य
सहायता: 0
लॉगफ़ाइल: शून्य
pcapफ़ाइल: शून्य
रिपोर्टफ़ाइल: शून्य
बायोडाटा: 0
उपवर्ग: [-f, होस्ट]
परीक्षण: नेटटेस्ट/उदाहरण/उदाहरण_http_checksum.py
जांच_एएसएन: शून्य
जांच_सीसी: शून्य
जांच_आईपी: 127.0.0.1
सॉफ़्टवेयर_नाम: ooniprobe
सॉफ़्टवेयर_संस्करण: 0.0.7.1-अल्फ़ा
प्रारंभ_समय: 1354786317.0
परीक्षण_नाम: चेकसमHTTPबॉडीटेस्ट
परीक्षण_संस्करण: 0.1
...
---
इनपुट: http://www.google.com
रिपोर्ट:
एजेंट: एजेंट
checksum: d630fa2efd547d3656e349e96ff7af5496889dad959e8e29212af1ff843e7aa1
अनुरोध:
- अनुरोध:
शरीर: शून्य
शीर्षलेख:
- - उपयोगकर्ता एजेंट
- - [ओपेरा/9.00 (विंडोज एनटी 5.1; यू; एन), 'ओपेरा 9.0, विंडोज एक्सपी']
विधि: प्राप्त करें
यूआरएल: http://www.google.com
प्रतिक्रिया:
शरीर: ' '
कोड: एक्सएनएनएक्स
शीर्षलेख:
- - एक्स-एक्सएसएस-संरक्षण
- [1; मोड=ब्लॉक]
- - सेट-कुकी
- ['PREF=ID=fada4216eb3684f9:FF=0:TM=1354800717:LM=1354800717:S=IT-2GCkNAocyXlVa;
expires=Sat, 06-Dec-2014 13:31:57 GMT; path=/; domain=.google.com', 'NID=66=KWaLbNQumuGuYf0HrWlGm54u9l-DKJwhFCMQXfhQPZM-qniRhmF6QRGXUKXb_8CIUuCOHnyoC5oAX5jWNrsfk-LLJLW530UiMp6hemTtDMh_e6GSiEB4GR3yOP_E0TCN;
समाप्त हो रहा है=शुक्र, 07-जून-2013 13:31:57 जीएमटी; पथ=/; डोमेन=.google.com; केवल Http']
- - समाप्त हो रहा है
- ['-1']
- - सर्वर
- [जीडब्ल्यूएस]
- - कनेक्शन
- [बंद करना]
- - कैश-नियंत्रण
- ['निजी, अधिकतम आयु=0']
- - तारीख
- ['गुरु, 06 दिसंबर 2012 13:31:57 जीएमटी']
- - पी3पी
- ['सीपी='यह पी3पी नीति नहीं है! देखें http://www.google.com/support/accounts/bin/answer.py?hl=hi&answer=151657
अधिक जानकारी के लिए।"']
- - सामग्री प्रकार
- [पाठ/एचटीएमएल; वर्णसेट=UTF-8]
- - एक्स-फ़्रेम-विकल्प
- [समेओरिजिन]
सॉक्सप्रॉक्सी: शून्य
परीक्षण_नाम: परीक्षण_http
टेस्ट_रनटाइम: 0.08298492431640625
परीक्षण_प्रारंभ: 1354800717.478403
...

डीएनएस आधारित परीक्षण
डीएनएस आधारित परीक्षण इसका एक उपवर्ग होगा ooni.templates.dnst.DNSTest.

यह तरीके प्रदान करता है ooni.templates.dnst.DNSTest.performPTRLookup() और
ooni.templates.dnst.DNSTest.performALookup()

उदाहरण के लिए (से लिया गया) Nettests.examples.example_dnst):

ooni.templates.dnst से DNSTest आयात करें

कक्षा उदाहरणDNSTest(DNSTest):
def test_a_lookup(स्वयं):
def मिलापरिणाम(परिणाम):
# परिणाम एक सरणी है जिसमें सभी ए रिकॉर्ड लुकअप परिणाम शामिल हैं
परिणाम प्रिंट करें

d = self.performALookup('torproject.org', ('8.8.8.8', 53))
d.कॉलबैक जोड़ें(परिणाम मिला)
वापसी डी

रिपोर्ट प्रारूप
#########################################
बेस डीएनएस टेस्ट परीक्षण के लिए # OONI जांच रिपोर्ट
# गुरु 6 दिसंबर 17:42:51 2012
#########################################
---
विकल्प हैं:
संग्राहक: शून्य
सहायता: 0
लॉगफ़ाइल: शून्य
pcapफ़ाइल: शून्य
रिपोर्टफ़ाइल: शून्य
बायोडाटा: 0
उपवर्ग: []
परीक्षण: नेटटेस्ट/उदाहरण/example_dnst.py
जांच_एएसएन: शून्य
जांच_सीसी: शून्य
जांच_आईपी: 127.0.0.1
सॉफ़्टवेयर_नाम: ooniprobe
सॉफ़्टवेयर_संस्करण: 0.0.7.1-अल्फ़ा
प्रारंभ_समय: 1354786971.0
test_name: बेस डीएनएस टेस्ट
परीक्षण_संस्करण: 0.1
...
---
इनपुट: अशक्त
रिपोर्ट:
प्रश्न:
- पते: [82.195.75.101, 86.59.30.40, 38.229.72.14, 38.229.72.16]
उत्तर:
- [ ,
ttl=782>]
- [ ,
ttl=782>]
- [ ,
ttl=782>]
- [ ,
ttl=782>]
क्वेरी: '[क्वेरी(''torproject.org'', 1, 1)]'
क्वेरी_प्रकार: ए
रिज़ॉल्वर: [8.8.8.8, 53]
परीक्षण_नाम: परीक्षण_ए_लुकअप
टेस्ट_रनटाइम: 0.028924942016601562
परीक्षण_प्रारंभ: 1354801371.980114
...

अधिक जटिल उदाहरण के लिए, देखें: Nettests.blocking.dnsconsistency

शब्दावली

यहां हम कुछ ऐसे शब्दजाल का सारांश देंगे जो OONI के लिए अद्वितीय हैं।

टेस्ट मामला: परीक्षण किए जाने वाले नेटवर्क पर किए गए मापों का एक सेट जो तार्किक रूप से होता है
समूहबद्ध

रिपोर्ट: एक परीक्षण रन का आउटपुट है जिसमें वह सभी जानकारी शामिल होती है जिसकी आवश्यकता होती है
शोधकर्ता यह आकलन करता है कि परीक्षण का परिणाम क्या है।

यमलूनी: रिपोर्ट के लिए हम जिस प्रारूप का उपयोग करते हैं, वह YAML पर आधारित है।

निवेश: माप करने के लिए टेस्टकेस में इनपुट के रूप में क्या दिया जाता है।

onworks.net सेवाओं का उपयोग करके ऑनलाइन ooniprobe का उपयोग करें