GraphQLer

एकमात्र निर्भरता-जागरूक GraphQL API परीक्षण उपकरण!

GraphQLer एक अत्याधुनिक उपकरण है जिसे अनुकूलनशीलता पर ध्यान केंद्रित करके GraphQL API का गतिशील रूप से परीक्षण करने के लिए डिज़ाइन किया गया है। यह कई उन्नत सुविधाएँ प्रदान करता है जो परीक्षण प्रक्रिया को सुव्यवस्थित करती हैं और GraphQL API का मजबूत विश्लेषण सुनिश्चित करती हैं। GraphQLer बनाई गई वस्तुओं और संसाधनों का कुशलतापूर्वक प्रबंधन करता है, वस्तुओं, क्वेरी और म्यूटेशन पर निर्भरताओं की प्रभावी ढंग से पहचान करता है, और API की बाधाओं के आधार पर क्वेरी में त्रुटियों को गतिशील रूप से ठीक करता है। GraphQLer का उपयोग प्रोडक्शन-ग्रेड GraphQL API में कई बग खोजने के लिए किया गया है!

मुख्य विशेषताएँ

• निर्भरता जागरूकता: क्वेरी और म्यूटेशन को उनकी निर्भरताओं के आधार पर चलाएँ!
• गतिशील परीक्षण: परीक्षण के दौरान बनाए गए संसाधनों पर नज़र रखें
• त्रुटि सुधार: अनुरोधों को ठीक करने का प्रयास करें ताकि GraphQL API उन्हें स्वीकार करे
• सांख्यिकी संग्रह: आपके परिणामों को एक अच्छी फ़ाइल में दिखाता है
• उपयोग में आसानी: आपको बस एंडपॉइंट और शायद प्रमाणीकरण टोकन की आवश्यकता है 😁

आरंभ करना

GraphQLer का उपयोग शुरू करने के लिए, स्थापना गाइड देखें।

उपयोग

❯ python3 main.py --help
usage: main.py [-h] [--compile] [--fuzz] [--run] --path PATH [--auth AUTH] --url URL

options:
  -h, --help   show this help message and exit
  --compile    runs on compile mode
  --fuzz       runs on fuzzing mode
  --run        run both the compiler and fuzzer (equivalent of running --compile then running --fuzz)
  --path PATH  directory location for saved files and files to be used from
  --auth AUTH  authentication token Example: 'Bearer arandompat-abcdefgh'
  --url URL    remote host URL

नीचे दिए गए वे चरण हैं जिनके द्वारा आप इस प्रोग्राम का उपयोग अपने GraphQL API का परीक्षण करने के लिए कर सकते हैं। उपयोग को 2 चरणों में विभाजित किया गया है: संकलन और फ़ज़िंग.

• संकलन मोड: यह मोड दिए गए API के विरुद्ध एक इंट्रोस्पेक्शन क्वेरी चलाने और निर्भरता ग्राफ़ उत्पन्न करने के लिए जिम्मेदार है
• फ़ज़िंग मोड: यह मोड निर्भरता ग्राफ़ को ट्रैवर्स करने और API को परीक्षण अनुरोध भेजने के लिए जिम्मेदार है

उपयोग में आसानी के लिए तीसरा मोड भी शामिल है, जिसे रन मोड कहा जाता है। यह मोड संकलन और फ़ज़िंग दोनों मोड को एक ही कमांड में संकलित करता है।

संकलन मोड

(.env) python main.py --compile --url <URL> --path <SAVE_PATH>

संकलन के बाद, आप संकलित परिणामों को <SAVE_PATH>/compiled में देख सकते हैं। इसके अतिरिक्त, निरीक्षण के लिए dependency_graph.png नामक एक ग्राफ़ उत्पन्न होगा। संकलित .yaml फ़ाइलों में किसी भी UNKNOWNS को मैन्युअल रूप से चिह्नित किया जा सकता है; हालाँकि, यदि चिह्नित नहीं किया गया है, तो फ़ज़र उन्हें फिर भी चलाएगा, लेकिन बिना निर्भरता श्रृंखला के।

फ़ज़ मोड

(.env) python main.py --fuzz --url <URL> --path <SAVE_PATH>

फ़ज़िंग करते समय, GraphQL API से संबंधित सांख्यिकी और चल रहे अनुरोधों की संख्या कंसोल में लॉग की जाती है। कोई भी अनुरोध रिटर्न कोड <SAVE_PATH>/stats.txt में लिखे जाते हैं। फ़ज़िंग के दौरान सभी लॉग <SAVE_PATH>/logs/fuzzer.log में रखे जाते हैं। लॉग फ़ाइल आपको सटीक रूप से बताएगी कि कौन से अनुरोध किस एंडपॉइंट पर भेजे गए और प्रतिक्रिया क्या थी। इसका उपयोग आगे के परिणाम विश्लेषण के लिए किया जा सकता है।

रन मोड

संकलन मोड और फ़ज़ मोड दोनों चलाता है

(.env) python main.py --run --url <URL> --path <SAVE_PATH>

उन्नत सुविधाएँ

constants.py फ़ाइल में कुछ चर भी हैं जिन्हें संशोधित किया जा सकता है। ये GraphQLer में लागू विशिष्ट सुविधाओं के अनुरूप हैं, और इन्हें आपकी पसंद के अनुसार ट्यून किया जा सकता है।