مقدمة

هذه الأداة مصممة لأتمتة عملية استخراج الأسرار من واجهات برمجة التطبيقات العامة على SwaggerHub. الأداة متعددة الخيوط ووضع الأنابيب (pipe mode) متاح :)

المتطلبات

python3 (sudo apt install python3)
pip3 (sudo apt install python3-pip)

التثبيت

pip3 install swaggerhole

أو استنساخ هذا المستودع وتشغيل

git clone https://github.com/Liodeus/swaggerHole.git
pip3 install .

الاستخدام

   _____ _      __ ____ _ ____ _ ____ _ ___   _____
  / ___/| | /| / // __ `// __ `// __ `// _ \ / ___/
 (__  ) | |/ |/ // /_/ // /_/ // /_/ //  __// /    
/____/  |__/|__/ \__,_/ \__, / \__, / \___//_/     
    __  __        __   /____/ /____/               
   / / / /____   / /___                            
  / /_/ // __ \ / // _ \                           
 / __  // /_/ // //  __/                           
/_/ /_/ \____//_/ \___/                            
                                                   
usage: swaggerhole [-h] [-s SEARCH] [-o OUT] [-t THREADS] [-j] [-q] [-du] [-de]

optional arguments:
  -h, --help            show this help message and exit
  -s SEARCH, --search SEARCH
                        Term to search
  -o OUT, --out OUT     Output directory
  -t THREADS, --threads THREADS
                        Threads number (Default 25)
  -j, --json            Json ouput
  -q, --quiet           Remove banner
  -du, --deactivate_url
                        Deactivate the URL filtering
  -de, --deactivate_email
                        Deactivate the email filtering

بحث عن أسرار متعلقة بنطاق معين

swaggerHole -s test.com

echo test.com | swaggerHole

بحث عن أسرار متعلقة بنطاق معين وإخراجها بصيغة JSON

swaggerHole -s test.com --json

echo test.com | swaggerHole --json

بحث عن أسرار متعلقة بنطاق معين وبسرعة :)

swaggerHole -s test.com -t 100

echo test.com | swaggerHole -t 100

شرح المخرجات

المخرجات العادية

Finding_Type - Finding - [Swagger_Name][Date_Last_Update][Line:Number]

المخرجات بصيغة JSON

{"Finding_Type": Finding, "File": File_path, "Date": Date_Last_Update, "Line": Number}

إلغاء تنشيط تصفية الروابط/البريد الإلكتروني

استخدام الخيارين -du أو -de يلغي التصفية التي تقوم بها الأداة. قد ينتج عن ذلك نتائج إيجابية خاطئة أكثر.

شكر وتقدير

TODO

swaggerHole

الأكثر شعبية