{"id":13845163,"url":"https://github.com/nemesida-waf/waf-bypass","last_synced_at":"2025-05-14T15:09:13.645Z","repository":{"id":44450967,"uuid":"273780935","full_name":"nemesida-waf/waf-bypass","owner":"nemesida-waf","description":"Check your WAF before an attacker does","archived":false,"fork":false,"pushed_at":"2025-05-05T14:29:45.000Z","size":745,"stargazers_count":1366,"open_issues_count":2,"forks_count":172,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-05-05T15:50:40.297Z","etag":null,"topics":["api-security-testing","bypass","graphql-injection","lfi","nosql-injection","path-traversal","python","python3","rce","rfi","sqli-injection","ssti","waf","waf-bypass-tool","waf-testing","xss"],"latest_commit_sha":null,"homepage":"https://nemesida-waf.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nemesida-waf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-20T20:39:36.000Z","updated_at":"2025-05-05T14:29:50.000Z","dependencies_parsed_at":"2023-10-01T14:34:09.754Z","dependency_job_id":"ff173f6d-0df3-400d-9d19-f32c05c4c997","html_url":"https://github.com/nemesida-waf/waf-bypass","commit_stats":{"total_commits":392,"total_committers":10,"mean_commits":39.2,"dds":0.09438775510204078,"last_synced_commit":"47ec4fafd8ab3268e3af1a14c87c0b3d181bcaeb"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemesida-waf%2Fwaf-bypass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemesida-waf%2Fwaf-bypass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemesida-waf%2Fwaf-bypass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nemesida-waf%2Fwaf-bypass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nemesida-waf","download_url":"https://codeload.github.com/nemesida-waf/waf-bypass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254169975,"owners_count":22026217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-security-testing","bypass","graphql-injection","lfi","nosql-injection","path-traversal","python","python3","rce","rfi","sqli-injection","ssti","waf","waf-bypass-tool","waf-testing","xss"],"created_at":"2024-08-04T17:03:14.784Z","updated_at":"2025-05-14T15:09:13.609Z","avatar_url":"https://github.com/nemesida-waf.png","language":"Python","funding_links":[],"categories":["Awesome Tools","Python"],"sub_categories":["Evasion:"],"readme":"# WAF Bypass Tool\n\nWAF Bypass Tool is an open source tool to analyze the security of any WAF for False Positives and False Negatives using predefined and customizable payloads. Check your WAF before an attacker does. WAF Bypass Tool is developed by Nemesida WAF team with the participation of community.\n\n![WAF Bypass Tool](https://github.com/user-attachments/assets/7b0034f8-34bc-4b4f-9e7a-516d804c7ccf)\n\n## Do not do anything illegal\nIt is forbidden to use for illegal and illegal purposes. Don't break the law. We are not responsible for possible risks associated with the use of this software.\n\n## How to run\n\n### Run using Docker\nThe latest waf-bypass always available via the [Docker Hub](https://hub.docker.com/r/nemesida/waf-bypass). It can be easily pulled via the following command:\n\n\u003cpre\u003e\n# docker pull nemesida/waf-bypass\n# docker run nemesida/waf-bypass --host='example.com'\n\u003c/pre\u003e\n\n### Run using pipx\n\u003cpre\u003e\n# pipx install git+https://github.com/nemesida-waf/waf-bypass.git\n# \u0026ltpipx bin dir\u0026gt/waf-bypass\n\u003c/pre\u003e\n\n### Run directly from source code using CLI\n\u003cpre\u003e\n# git clone https://github.com/nemesida-waf/waf_bypass.git /opt/waf-bypass/\n# python3 -m pip install -r /opt/waf-bypass/requirements.txt\n# python3 /opt/waf-bypass/main.py --host='example.com'\n\u003c/pre\u003e\n\n#### Options\n\n- \u003ccode\u003e'--proxy'\u003c/code\u003e (\u003ccode\u003e--proxy='http://proxy.example.com:3128'\u003c/code\u003e) - option allows to specify where to connect to instead of the host.\n\n- \u003ccode\u003e'--header'\u003c/code\u003e (\u003ccode\u003e--header 'Authorization: Basic YWRtaW46YWRtaW4=' --header 'X-TOKEN: ABCDEF'\u003c/code\u003e) - option allows to specify the HTTP header to send with all requests (e.g. for authentication). Multiple use is allowed.\n\n- \u003ccode\u003e'--user-agent'\u003c/code\u003e (\u003ccode\u003e--user-agent 'MyUserAgent 1/1'\u003c/code\u003e) - option allows to specify the HTTP User-Agent to send with all requests, except when the User-Agent is set by the payload (\u003ccode\u003e\"USER-AGENT\"\u003c/code\u003e).\n\n- \u003ccode\u003e'--block-code'\u003c/code\u003e (\u003ccode\u003e--block-code='403' --block-code='222'\u003c/code\u003e) - option allows you to specify the HTTP status code to expect when the WAF is blocked. (default is \u003ccode\u003e403\u003c/code\u003e). Multiple use is allowed.\n\n- \u003ccode\u003e'--threads'\u003c/code\u003e (\u003ccode\u003e--threads=15\u003c/code\u003e) - option allows to specify the number of parallel scan threads (default is \u003ccode\u003e10\u003c/code\u003e).\n\n- \u003ccode\u003e'--timeout'\u003c/code\u003e (\u003ccode\u003e--timeout=10\u003c/code\u003e) - option allows to specify a request processing timeout in sec. (default is \u003ccode\u003e30\u003c/code\u003e).\n\n- \u003ccode\u003e'--exclude-dir'\u003c/code\u003e - exclude the payload's directory (\u003ccode\u003e--exclude-dir='SQLi,XSS')\u003c/code\u003e.\n\n- \u003ccode\u003e'--json-format'\u003c/code\u003e - an option that allows you to display the result of the work in JSON format (useful for integrating the tool with security platforms). If the option is not specified, the output will be in table format (the default format).\n\n- \u003ccode\u003e'--details'\u003c/code\u003e - display the False Positive and False Negative payloads. Not compatible with option \u003ccode\u003e--json-format\u003c/code\u003e option.\n\n- \u003ccode\u003e'--no-progress'\u003c/code\u003e - do not display progress bar.\n\n- \u003ccode\u003e'--curl-replay'\u003c/code\u003e - display the cURL command to reproduce False Positive, False Negative or Failed requests. Not compatible with option \u003ccode\u003e--json-format\u003c/code\u003e option.\n\n## JSON format\n\nJSON output specification example:\n\n\u003cpre\u003e\n{\n  \"TARGET\": \"https://example.com\", // defined by --host option\n  \"PROXY\": {},                     // defined by --proxy option\n  \"HEADERS\": {                     // defined by --header option\n    \"User-Agent\": \"\"\n  },\n  \"BLOCK-CODE\": [                  // defined by --block-code option\n    ...\n  ],\n  \"THREADS\": 50,                   // defined by --threads option\n  \"TIMEOUT\": 30,                   // defined by --timeout option\n  \"EXCLUDE-DIR\": [                 // defined by --exclude-dir option\n    ...\n  ],\n  \"FAILED\": {                      // requests with failed processing status\n    \"MFD/7.json\": {\n      \"BODY\": \"WBHTTPSConnectionPool(host='example.com', port=443): Read timed out. (read timeout=1)\"\n    },\n    ...\n  },\n  \"PASSED\": {                      // passed requests\n    \"UWA/3.json\": {\n      \"URL\": \"403 RESPONSE CODE\"\n    },\n    ...\n  },\n  \"FALSED\": {                      // requests with false positive processing status\n    ...\n  },\n  \"BYPASSED\": {                    // requests with false negative processing status\n    \"UWA/26.json\": {\n      \"URL\": \"200 RESPONSE CODE\"\n    },\n    ...\n  },\n  \"TestRequest\": {                // test requests with processing status, exclude passed\n    \"FAILED\": {},\n    \"FALSED\": {\n        \"UWA/3.json\": {\n        \"URL\": \"403 RESPONSE CODE\"\n        },\n        ...\n    }\n    \n  },\n  \"CURL\": {                       // cURL command to reproduce false positive and false negative requests\n    \"FALSED\": {},\n    \"BYPASSED\": {\n      \"UWA/26.json\": {\n        \"URL\": \"curl -X GET -H 'Accept: */*' -H 'Accept-Encoding: gzip, deflate' -H 'Connection: keep-alive' -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36' 'https://example.com/do.php#.png'\"\n      },\n      ...\n    }\n  }\n}\n\u003c/pre\u003e\n\n## Payloads\n\nDepending on the purpose, payloads are located in the appropriate folders:\n\n- FP - False Positive payloads\n- API - API testing payloads\n- CM - Custom HTTP Method payloads\n- GraphQL - GraphQL testing payloads\n- LDAP - LDAP Injection payloads\n- LFI - Local File Include payloads\n- MFD - multipart/form-data payloads\n- NoSQLi - NoSQL Injection payloads\n- OR - Open Redirect payloads\n- RCE - Remote Code Execution payloads\n- RFI - Remote File Inclusion payloads\n- SQLi - SQL Injection payloads\n- SSI - Server-Side Includes payloads\n- SSRF - Server-Side Request Forgery payloads\n- SSTI - Server-Side Template Injection payloads\n- UWA - Unwanted Access payloads\n- XSS - Cross-Site Scripting payloads\n\n### Write your own payloads\n\nWhen compiling a payload, the following zones, method and options are used:\n\n- URL - request's path\n- ARGS - request's query\n- BODY - request's body\n- COOKIE - request's cookie\n- USER-AGENT - request's user-agent\n- REFERER - request's referer\n- HEADER - request's header\n- METHOD - request's method\n- BOUNDARY - specifies the contents of the request's boundary. Applicable only to payloads in the MFD directory.\n- ENCODE - specifies the type of payload encoding (\u003ccode\u003eBase64\u003c/code\u003e, \u003ccode\u003eHTML-ENTITY\u003c/code\u003e, \u003ccode\u003eUTF-16\u003c/code\u003e) in addition to the encoding for the payload. Multiple values are indicated with a space (e.g. \u003ccode\u003eBase64 UTF-16\u003c/code\u003e). Applicable only to for \u003ccode\u003eARGS\u003c/code\u003e, \u003ccode\u003eBODY\u003c/code\u003e, \u003ccode\u003eCOOKIE\u003c/code\u003e and \u003ccode\u003eHEADER\u003c/code\u003e zone. Not applicable to payloads in API and MFD directories. Not compatible with option \u003ccode\u003eJSON\u003c/code\u003e.\n- JSON - specifies that the request's body should be in JSON format\n- BLOCKED - specifies that the request should be blocked (FN testing) or not (FP)\n\nExcept for some cases described below, the zones are independent of each other and are tested separately (those if 2 zones are specified - the script will send 2 requests - alternately checking one and the second zone).\n\nFor the zones you can use \u003ccode\u003e%RND%\u003c/code\u003e suffix, which allows you to generate an arbitrary string of 6 letters and numbers. (e.g.: \u003ccode\u003eparam%RND=my_payload\u003c/code\u003e or \u003ccode\u003eparam=%RND%\u003c/code\u003e OR \u003ccode\u003eA%RND%B\u003c/code\u003e)\n\nYou can create your own payloads, to do this, create your own folder on the '/payload/' folder, or place the payload in an existing one (e.g.: '/payload/XSS'). Allowed data format is JSON.\n\n#### API directory\nAPI testing payloads located in this directory are automatically appended with a header \u003ccode\u003e'Content-Type: application/json'\u003c/code\u003e.\n\n#### MFD directory\nFor MFD (multipart/form-data) payloads located in this directory, you must specify the \u003ccode\u003eBODY\u003c/code\u003e (required) and \u003ccode\u003eBOUNDARY\u003c/code\u003e (optional). If \u003ccode\u003eBOUNDARY\u003c/code\u003e is not set, it will be generated automatically (in this case, only the payload must be specified for the \u003c/code\u003eBODY\u003c/code\u003e, without additional data (\u003ccode\u003e'... Content-Disposition: form-data; ...'\u003c/code\u003e).\n\nIf a \u003ccode\u003eBOUNDARY\u003c/code\u003e is specified, then the content of the \u003ccode\u003eBODY\u003c/code\u003e must be formatted in accordance with the RFC, but this allows for multiple payloads in \u003ccode\u003eBODY\u003c/code\u003e a separated by \u003ccode\u003eBOUNDARY\u003c/code\u003e.\n\nOther zones are allowed in this directory (e.g.: \u003ccode\u003eURL\u003c/code\u003e, \u003ccode\u003eARGS\u003c/code\u003e etc.). Regardless of the zone, header \u003ccode\u003e'Content-Type: multipart/form-data; boundary=...'\u003c/code\u003e will be added to all requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnemesida-waf%2Fwaf-bypass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnemesida-waf%2Fwaf-bypass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnemesida-waf%2Fwaf-bypass/lists"}