Goreport v3.0, एक Gophish रिपोर्टिंग टूल

यह स्क्रिप्ट आपके Gophish अभियान आईडी (IDs) को पैरामीटर के रूप में स्वीकार करती है और फिर अभियान के परिणाम एकत्र करके आँकड़े प्रस्तुत करती है, साथ ही उपयोगकर्ता-एजेंट पार्सिंग और IP पतों के लिए जियोलोकेशन लुकअप करती है। Goreport IP पतों, ऑपरेटिंग सिस्टम, ब्राउज़र प्रकारों और संस्करणों, और स्थानों की सूची उत्पन्न करता है, जिसमें प्रत्येक को अभियान के दौरान कितनी बार देखा गया, इसकी गणना शामिल होती है।

आँकड़ों पर एक नोट: Goreport घटनाओं की कुल संख्या और प्रत्येक घटना में भाग लेने वाले ईमेल प्राप्तकर्ताओं की संख्या रिपोर्ट करेगा। दूसरे शब्दों में, Goreport दिखाएगा कि Gophish ने कितनी बार "लिंक पर क्लिक किया गया" घटना दर्ज की और कितने प्राप्तकर्ताओं ने लिंक पर क्लिक किया। ये बहुत अलग संख्याएँ हैं। 10 लोगों को भेजे गए अभियान में 9 "लिंक पर क्लिक" घटनाएँ हो सकती हैं, जबकि केवल 3 प्राप्तकर्ताओं ने लिंक पर क्लिक किया। यह जानना कि प्राप्तकर्ताओं ने एक से अधिक बार किसी लिंक पर क्लिक किया या डेटा सबमिट किया, मूल्यवान जानकारी है, लेकिन सुनिश्चित करें कि आप संख्याओं को सीधा रखें।

Goreport आवश्यकताएँ

इस स्क्रिप्ट के लिए एक Gophish सर्वर, एक सक्रिय या पूर्ण अभियान, और आपके Gophish एप्लिकेशन के लिए API कुंजी आवश्यक है। यह कुंजी प्राप्त करने के लिए Settings टैब पर क्लिक करें। API कुंजी पहले पृष्ठ पर मिलेगी। प्रत्येक Gophish उपयोगकर्ता खाते की अपनी API कुंजी होती है जो उस उपयोगकर्ता के लिए Gophish API में प्रमाणीकरण की विधि के रूप में कार्य करती है। यदि आप Gophish के साथ कई खातों का उपयोग करते हैं, तो सुनिश्चित करें कि आप सही उपयोगकर्ता की API कुंजी लेते हैं।

इन Python पुस्तकालयों की भी आवश्यकता है:

• Gophish
• requests
• xlsxwriter
• configparser
• python-docx
• click
• user-agents
• python-dateutil (Gophish पुस्तकालय द्वारा आवश्यक)

Goreport सेटअप

आरंभ करने के लिए आपको कुछ चीजें करने की आवश्यकता है:

• pip install -r requirements.txt चलाएँ।
• नीचे दिए गए जैसा एक Gophish.config कॉन्फ़िगरेशन फ़ाइल संपादित/बनाएँ।
  • नोट: पूर्ण होस्ट URL आवश्यक है, इसलिए http://IP:PORT या https://IP:PORT प्रदान करें।
    • HTTP बनाम HTTPS का उपयोग करने से सावधान रहें। यदि आप गलत URL टाइप करते हैं तो आपको कनेक्शन त्रुटियाँ प्राप्त होंगी।
• अपने अभियान (अभियानों) पर क्लिक करके और URL(s) का संदर्भ लेकर अपनी अभियान आईडी प्राप्त करें (यह अंत में संख्या है)।
• यदि आप Word docx रिपोर्ट बनाने में सक्षम होना चाहते हैं, तो Goreport निर्देशिका में एक "template.docx" टेम्पलेट फ़ाइल डालें (नीचे रिपोर्ट आउटपुट चुनने में अधिक जानकारी)।

मूल उपयोग

यह उदाहरण मान लेगा कि Gophish किसी अन्य सर्वर पर है और HTTPS का उपयोग किया जा रहा है। API एंडपॉइंट तक पहुँचने के लिए, आपको पोर्ट 3333 (या कोई अन्य स्थानीय पोर्ट जो आप उपयोग करना चाहते हैं) के साथ SSH पोर्ट फ़ॉरवर्डिंग का उपयोग करने की आवश्यकता होगी:

Gophish.config

[Gophish]
gp_host: https://127.0.0.1:3333
api_key: <YOUR_API_KEY>

[ipinfo.io]
ipinfo_token: <IPINFO_API_KEY>

[Google]
geolocate_key: <GEOLOCATE_API_KEY>

एक मूल आदेश

python3 Goreport.py --id 26 --format excel

यह https://localhost:3333/api/campaigns/26/?api_key=<Your_API_Key> से अभियान 26 के परिणाम लाएगा और परिणामों को xlsx फ़ाइल में आउटपुट करेगा।

एक साथ कई रिपोर्टों के लिए कई IDs प्रदान की जा सकती हैं। IDs को अल्पविराम से अलग की गई सूची, एक श्रेणी, या दोनों का उपयोग करके प्रदान किया जा सकता है।

उदाहरण: python3 Goreport.py --id 26,29-33,54 --format csv

कॉन्फ़िगरेशन फ़ाइलें बदलना

यदि आप कई Gophish उपयोगकर्ता खातों या सर्वरों का उपयोग करते हैं, तो आपके पास कई API कुंजियाँ होंगी। कुंजियों के बीच स्विच करना आसान बनाने के लिए, Goreport का --config विकल्प आपको डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल, gophish.config, को आपके द्वारा नामित कॉन्फ़िगरेशन फ़ाइल से ओवरराइड करने में सक्षम बनाता है। यदि यह तर्क एक मान्य, पठनीय कॉन्फ़िगरेशन फ़ाइल के साथ प्रदान किया गया है, तो Goreport API कनेक्शन स्थापित करने के लिए gophish.config के बजाय इसका उपयोग करेगा।

आप इस विकल्प का उपयोग कर सकते हैं यदि, उदाहरण के लिए, तीन फ़िशिंग सर्वर Gophish चला रहे हों। आप तीन कॉन्फ़िगरेशन फ़ाइलें बना सकते हैं, प्रत्येक में एक अलग Gophish API कुंजी हो, और फिर आवश्यकतानुसार उनका उपयोग करें।

उदाहरण: python3 Goreport.py --id 26,29-33,54 --format csv --config phish_server_2.config

रिपोर्टों को संयोजित करना

यदि आपने विभिन्न लक्ष्य समूहों के लिए समान सेटिंग्स का उपयोग करके कई अभियान चलाए, तो आप एक साथ इन सभी अभियानों के विरुद्ध Goreport चलाना चाह सकते हैं और फिर परिणामों को एक रिपोर्ट में संयोजित करना चाह सकते हैं। यह Goreport के --combine फ़्लैग को जोड़कर पूरा किया जा सकता है।

उदाहरण: python3 Goreport.py --id 26,29-33,54 --format excel --combine

यह आदेश अभियान 26, 29, 30, 31, 32, 33, और 54 के परिणाम एकत्र करेगा। सामान्यतः, Goreport सात xlsx फ़ाइलें आउटपुट करेगा, लेकिन --combine जोड़ने से Goreport परिणामों को संयोजित करने और केवल एक रिपोर्ट आउटपुट करने का निर्देश देता है, जैसे कि वे सभी एक बड़ा अभियान हों।

रिपोर्ट आउटपुट स्विच करना

Goreport या तो एक Excel स्प्रेडशीट (xlsx) या एक Word दस्तावेज़ (docx) आउटपुट कर सकता है। एक "त्वरित" रिपोर्ट विकल्प भी है। बस ऊपर नमूना उपयोग अनुभाग में दिखाए अनुसार --format कमांड लाइन तर्क का उपयोग करके अपना पसंदीदा प्रारूप चुनें। csv प्रारूप के बारे में ज्यादा कहने की आवश्यकता नहीं है।

Word दस्तावेज़ एक टेम्पलेट, template.docx से बनाया गया है। अपनी टेम्पलेट फ़ाइल, जिसका नाम template.docx है, को मुख्य स्क्रिप्ट के साथ Goreport निर्देशिका में रखें। आपके टेम्पलेट में एक तालिका शैली होनी चाहिए जिसका आप उपयोग करना चाहते हैं और Heading 1 और Heading 2 के लिए शीर्षक शैलियाँ होनी चाहिए। अपनी पसंदीदा तालिका शैली को "Goreport" नाम दें और अपनी Heading 1 और 2 शैलियाँ सेट करें।

बेझिझक एक कस्टम शैली बनाएं या मौजूदा शैली का उपयोग करें। केवल इतना मायने रखता है कि एक template.docx फ़ाइल मौजूद है और इसमें "Goreport" तालिका शैली है।

किसी शैली का नाम बदलने के लिए, शैली पर राइट-क्लिक करें, तालिका शैली संशोधित करें चुनें, और एक नया नाम सेट करें।

Excel विकल्प एक सुंदर ढंग से स्वरूपित Excel कार्यपुस्तिका को कई कार्यपत्रकों के साथ आउटपुट करता है, जो परिणामों और आँकड़ों के विभिन्न संग्रहों के लिए होते हैं। यह एक अच्छा विकल्प है यदि आप परिणाम तालिकाओं को आसानी से सॉर्ट या फ़िल्टर करना चाहते हैं।

अंत में, एक "त्वरित" विकल्प है। यह कोई रिपोर्ट दस्तावेज़ उत्पन्न नहीं करता है। इसके बजाय, यह अभियान के बारे में बुनियादी जानकारी आपके टर्मिनल पर आउटपुट करता है। यह अभियान की प्रगति की शीघ्र जाँच करने या अभियान पूरा होने के बाद परिणामों का संदर्भ देने के लिए सुविधाजनक है।

अभियानों को पूर्ण के रूप में चिह्नित करना

यदि आप अपनी रिपोर्ट चलाते समय किसी अभियान की स्थिति को "पूर्ण" पर सेट करना चाहते हैं, तो Goreport --complete फ़्लैग के साथ स्वचालित रूप से ऐसा करने में आपकी सहायता कर सकता है। यदि आप यह फ़्लैग प्रदान करते हैं, तो Goreport प्रत्येक अभियान आईडी को "पूर्ण" के रूप में चिह्नित करने के लिए API का उपयोग करेगा ताकि अभियान समाप्त हो जाए और Gophish में स्थिति अपडेट हो जाए।

अतिरिक्त जानकारी

Gophish IP पतों के साथ अपने स्वयं के जियोलोकेशन लुकअप करता है और अक्षांश और देशांतर लौटाता है। यह ठीक काम करता है, लेकिन विफल हो सकता है और 0,0 के निर्देशांक लौटा सकता है या पुरानी जानकारी लौटा सकता है।

Goreport में दो विकल्प हैं जिनका उपयोग स्थान परिणामों को बेहतर बनाने के लिए किया जा सकता है। पहला और अनुशंसित विकल्प ipinfo.io API है। API एक्सेस तब तक मुफ्त है जब तक आप 24 घंटे की अवधि में 1,000 से कम क्वेरी करते हैं। फ़िशिंग अभियान के लिए यह बहुत कठिन नहीं होना चाहिए।

यदि ipinfo.io API कुंजी कॉन्फ़िगरेशन फ़ाइल में जोड़ी जाती है, तो Goreport स्वचालित रूप से प्रत्येक अद्वितीय IP पते के लिए वर्तमान जियोलोकेशन जानकारी एकत्र करने के लिए ipinfo.io का उपयोग करेगा।

दूसरा विकल्प Google Maps API है। Goreport v1.0 ने Maps API का उपयोग तब किया जब वह मुफ्त था। Google अब Geolocate API (जैसा कि इसे अब कहा जाता है) के लिए $0.005/अनुरोध शुल्क लेता है। यदि आप ipinfo.io का उपयोग नहीं करना चाहते हैं, तो किसी Google खाते पर Maps Geolocate API सक्रिय करें और API कुंजी को Goreport कॉन्फ़िगरेशन फ़ाइल में जोड़ें। फिर अपने Goreport कमांड में --google फ़्लैग जोड़ें जब भी आप चाहते हैं कि Goreport Gophish के निर्देशांकों को देखने के लिए API का उपयोग करके एक स्वरूपित पता प्राप्त करे।

तकनीकी जानकारी

यदि आप कोड की समीक्षा करना चाहते हैं, तो प्रक्रिया की एक बुनियादी रूपरेखा यहाँ दी गई है: