Skip to content

armgit / strix

Public Imported from GitHub
0

Open-source AI penetration testing tool to find and fix your app’s vulnerabilities.

Document HTTPQL footguns on list_requests

0xallam136e2e6ac2db
diff --git a/strix/tools/proxy/tools.py b/strix/tools/proxy/tools.py
index f6ab5b32..7d39be93 100644
--- a/strix/tools/proxy/tools.py
+++ b/strix/tools/proxy/tools.py
@@ -140,6 +140,18 @@ async def list_requests(
Pagination is cursor-based. Pass the ``end_cursor`` from the
``page_info`` of one call as ``after`` to the next.
+ Notes:
+
+ - HTTPQL has **no ``NOT`` operator**. Use the negated form of the
+ operator instead: ``ne``, ``ncont``, ``nlike``, ``nregex``
+ (e.g. ``req.path.ncont:"/static"`` to exclude static paths).
+ - String values **must be quoted**; integer values **must not**.
+ ``resp.code.eq:200`` is right; ``resp.code.eq:"200"`` is a parse
+ error. Same rule for ``cont`` / ``regex`` strings.
+ - A bare quoted string searches both ``req.raw`` and ``resp.raw``,
+ handy for sensitive-data sweeps:
+ ``"password" OR "secret" OR "api_key"``.
+
Args:
httpql_filter: Caido HTTPQL query (optional).
first: Number of entries to return (default 50).