From 0ed761187a400ead61e924fed814670667183491 Mon Sep 17 00:00:00 2001
From: Ads Dawson <104169244+GangGreenTemperTatum@users.noreply.github.com>
Date: Wed, 6 Nov 2024 16:50:04 -0500
Subject: [PATCH] docs: katana example

---
 .../information-gathering/katana.yml          | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 cybersecurity/offensive/information-gathering/katana.yml

diff --git a/cybersecurity/offensive/information-gathering/katana.yml b/cybersecurity/offensive/information-gathering/katana.yml
new file mode 100644
index 0000000..4931981
--- /dev/null
+++ b/cybersecurity/offensive/information-gathering/katana.yml
@@ -0,0 +1,60 @@
+description: Katana is a fast crawler focused on execution in automation pipelines offering both headless and non-headless crawling.
+
+functions:
+  katana_headless_crawler:
+    description: "Crawls a target or list of targets in headless mode"
+    parameters:
+      target:
+        type: string
+        description: "target url / list to crawl"
+        examples:
+          - https://target.tld
+          - https://tesla.com,https://google.com
+
+    container:
+      image: projectdiscovery/katana # https://github.com/projectdiscovery/katana
+      args:
+        - --net=host
+
+    cmdline:
+      - katana
+      - -u
+      - ${target}
+      - -system-chrome
+      - -headless
+      - -sb
+      - -jsonl
+
+  katana_proxied_crawler_scope:
+    description: "Crawls a target or list of targets with a proxy and defined crawl scope using regex"
+    parameters:
+      target:
+        type: string
+        description: "target url / list to crawl"
+        examples:
+          - https://target.tld
+          - https://tesla.com,https://google.com
+      proxy:
+        type: string
+        description: The upstream proxy dstip and dstport
+        examples:
+          - http://127.0.0.1:8080 # burp default
+      crawl_scope:
+        type: string
+        description: For advanced scope control, -cs option can be used that comes with regex support.
+        examples:
+          - login
+
+    container: # https://github.com/projectdiscovery/katana
+      image: projectdiscovery/katana
+      args:
+        - --net=host
+
+    cmdline:
+      - katana
+      - -u
+      - ${target}
+      - -proxy
+      - ${proxy}
+      - -cs
+      - ${crawl_scope}
\ No newline at end of file