Source profileQuality 94/100

brucesongs/kali-claw/skills/web-ssrf/SKILL.md

web-ssrf

Server-Side Request Forgery (SSRF) attacks including basic, blind, and advanced bypass techniques, internal port scanning, cloud metadata extraction (AWS/GCP/Azure), protocol smuggling (gopher://, dict://, file://), and chained RCE exploitation.

Source repository stars
67
Declared platforms
2
Static risk flags
1
Last source update
2026-08-19
Source checked
2026-08-28

Decision brief

What it does: where it fits

Supplementary Files: - payloads.md — SSRF attack payload allset:basic detect、protocolsmuggling、cloud metadatadata extraction、bypasstechnique、DNS rebinding、blind SSRF、RCE groupcombinechain - test-cases.md — structureizetestinguseexamplechecklist,cover SSRF Detect、internal network…

Best for

    Not for

    • Testing only 127.0.0.1 and localhost: Many SSRF filters block these exact strings but fail to block alternative representations like 0x7f000001, 0177.0.0.1, [::1], 0, or 127.1. Always test a comprehensive list of IP rep…
    • Forgetting cloud metadata endpoints: In cloud environments, SSRF's highest-impact target is the metadata service. Testers sometimes focus on internal port scanning and miss the IAM credential extraction opportunity at 1…

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeDeclaredSource recordInstall path and trigger
    CursorDeclaredSource recordInstall path and trigger
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/brucesongs/kali-claw --skill "skills/web-ssrf"
    Safe inspection promptEditorial

    Inspect the Agent Skill "web-ssrf" from https://github.com/brucesongs/kali-claw/blob/a3205f5484ca8fec9fd809f3c16fe41fbc6ac87e/skills/web-ssrf/SKILL.md at commit a3205f5484ca8fec9fd809f3c16fe41fbc6ac87e. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      Step 1: basic SSRF Detect

      testing loopback addresses (127.0.0.1, localhost) and file protocol (file:///etc/passwd); combine with IP address transformations (hexadecimal, decimal, IPv6, octal, all-zero) to bypass basic filters.

      testing loopback addresses (127.0.0.1, localhost) and file protocol (file:///etc/passwd); combine with IP address transformations (hexadecimal, decimal, IPv6, octal, all-zero) to bypass basic filters.
    2. 02

      Step 2: cloud metadatadata extraction

      Extract AWS IAM rolecredentials、GCP Service Account Token、Azure Managed Identity Token,use IP transformationbypasscloud metadatadataaddressfilter。

      Extract AWS IAM rolecredentials、GCP Service Account Token、Azure Managed Identity Token,use IP transformationbypasscloud metadatadataaddressfilter。
    3. 03

      Step 3: protocolsmugglingexploit

      Exploit gopher:// protocol to manipulate Redis/MySQL, dict:// to detect service versions, file:// to read server sensitive files.

      Exploit gopher:// protocol to manipulate Redis/MySQL, dict:// to detect service versions, file:// to read server sensitive files.
    4. 04

      Step 4: advanced bypasstechnique

      Open Redirect exploit、@ characternumberspoofing、DNS rebinding、URL encoding bypass、URL solveanalysisdifferenceexploit。

      Open Redirect exploit、@ characternumberspoofing、DNS rebinding、URL encoding bypass、URL solveanalysisdifferenceexploit。
    5. 05

      Step 5: automated SSRF Scan

      use SSRFmap automated Detect(readfiles/awsmetadata/portscan module),ffuf batchamountScaninternal networkport,Burp Collaborator Detectblind SSRF。

      use SSRFmap automated Detect(readfiles/awsmetadata/portscan module),ffuf batchamountScaninternal networkport,Burp Collaborator Detectblind SSRF。See payloads.md for detailed payloads, and test-cases.md for complete test checklist。

    Permission review

    Static risk signals and limitations

    Network access

    medium · line 38

    The documentation includes network, browsing, or remote request actions.

    | **curl** | quick testing SSRF payload,verifycloud metadatadataendpoint | `curl "http://target/fetch?url=http://127.0.0.1:8080/admin"` |

    Network access

    medium · line 39

    The documentation includes network, browsing, or remote request actions.

    | **ffuf** | fuzzytesting URL parameter,batchamountdetectinternal network IP andport | `ffuf -u "http://target/fetch?url=http://FUZZ:FUZ2Z" -w ips.txt -w ports.txt` |

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score94/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars67SourceRepository attention, not individual Skill quality
    Compatibility2 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    brucesongs/kali-claw
    Skill path
    skills/web-ssrf/SKILL.md
    Commit
    a3205f5484ca8fec9fd809f3c16fe41fbc6ac87e
    License
    MIT
    Collected
    2026-08-28
    Default branch
    main
    View the original SKILL.md

    Skill: SSRF serviceendrequestforgery / Server-Side Request Forgery

    Supplementary Files:

    • payloads.md — SSRF attack payload allset:basic detect、protocolsmuggling、cloud metadatadata extraction、bypasstechnique、DNS rebinding、blind SSRF、RCE groupcombinechain
    • test-cases.md — structureizetestinguseexamplechecklist,cover SSRF Detect、internal networkScan、cloud metadatadata、bypasstechnique、advanced exploit,with severelevelother

    Summary

    Web Ssrf skill domain covering web attack operations.

    Tools: Burp Suite, curl, ffuf, Gopherus, SSRFmap, Burp Collaborator

    Domain: web-attack

    OWASP: A10:2021-SSRF

    MITRE ATT&CK: T1190-Exploit Public-Facing App

    Description

    Server-Side Request Forgery (SSRF) attacks including basic, blind, and advanced bypass techniques, internal port scanning, cloud metadata extraction (AWS/GCP/Azure), protocol smuggling (gopher://, dict://, file://), and chained RCE exploitation. Also covers defense strategies: URL allowlisting, IP range validation, protocol restrictions, and cloud metadata protection.

    Agent canpowerstatement: already complete OWASP Top 10 2025 SSRF complete learning,masterautomated SSRF ScanTooldevelopmentandcloud metadatadata extractionToolchain。

    Use Cases / Use Cases

    1. Web applicationpenetration testing - Detecttargetapplicationin URL obtain、fileimport、Webhook etc.successcan SSRF vulnerability,exploititsaccessinternalresource
    2. cloudenvironmentsecurity assessment - through SSRF Extract AWS/GCP/Azure realexamplemetadata,obtaintemporarywhen credentialsandsensitiveconfigurationinformation
    3. Internal network penetration pivot - Exploit SSRF as a pivot to scan internal network service ports, access internal APIs, and detect Kubernetes/Docker and other infrastructure.
    4. CTF competition challenges - Quickly identify SSRF challenge types; construct protocol smuggling, DNS rebinding, IP encoding bypass, and other advanced payloads.
    5. security code audit - fromDefense Perspectivereview URL handlinglogic,assessmentfilter bypassrisk,realimplementpartlayerdefensesolution

    Core Tools / Core Tools

    ToolPurposeCommand Example
    Burp Suiteinterceptmodify HTTP request,construct SSRF payload,testing redirect bypassRepeater moduledebug ?url=http://169.254.169.254/
    curlquick testing SSRF payload,verifycloud metadatadataendpointcurl "http://target/fetch?url=http://127.0.0.1:8080/admin"
    ffuffuzzytesting URL parameter,batchamountdetectinternal network IP andportffuf -u "http://target/fetch?url=http://FUZZ:FUZ2Z" -w ips.txt -w ports.txt
    Gopherusgenerate gopher:// protocol payload,exploit Redis/MySQL/FASTCGI etc.python3 gopherus.py --exploit redis
    SSRFmapautomated SSRF Detectandexploitframework,supportsmultiplekindattackmodulepython3 ssrfmap.py -r request.txt -p url -m readfiles

    Methodology / Methodology

    Attack Chain / Attack Chain

    URL 参数发现 → 协议走私 → 内网扫描 → 云元数据提取 → RCE 组合链
    

    1. URL parameterdiscovery (Discovery)

    • Identifyaccept URL parameter:url=path=src=dest=redirect=callback=
    • testing Webhook、PDF generate、imageload、fileimportetc.successcanpoint
    • use Burp Suite Hunter or ffuf automated discoveryhideparameter

    2. protocolsmuggling (Protocol Smuggling)

    • file:///etc/passwd - readlocalfile
    • gopher://host:port/_DATA - sendarbitrary TCP data(Redis/MySQL/SMTP)
    • dict://host:port/COMMAND - executedictionaryprotocolcommand
    • ldap://host:port/ - LDAP query
    • http/https - standard HTTP requesttointernalservice

    3. internal networkScan (Internal Network Scanning)

    • Scancommon internal networknetworksegment:10.0.0.0/8172.16.0.0/12192.168.0.0/16
    • detectcommon port:22、80、443、3306、5432、6379、8080、8443、9200、27017
    • exploitresponsewhen intervaldifferencejudgeportopenstatus(blind SSRF)

    4. cloud metadatadata extraction (Cloud Metadata Extraction)

    • AWS: http://169.254.169.254/latest/meta-data/iam/security-credentials/
    • GCP: http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token
    • Azure: http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01
    • obtaintemporarywhen credentialsafterlateral movementtoitsothercloudresource

    5. RCE groupcombinechain (RCE Chain)

    • SSRF + Redis not authorization: gopher://127.0.0.1:6379/_CONFIG SET dir /var/www/html write Webshell
    • SSRF + MySQL: gopher://127.0.0.1:3306/ construct MySQL protocolpackageexecute SQL
    • SSRF + FASTCGI: construct FastCGI protocolpackageexecutearbitrarycode
    • SSRF + AWS IAM: obtaintemporarywhen credentialsafterthrough AWS CLI takeovercloudresource

    Defense Perspective

    Defense MeasureDescriptionPriority
    URL whitelistAllow access only to a predefined domain name list; deny all other requestsCRITICAL
    IP scope validationAfter DNS resolution, check target IP; block private/loopback/link-local addressesCRITICAL
    disabledangerousprotocolonlyallows http/https protocol,prohibit file/gopher/dict/ldapHIGH
    cloud metadatadataprotectuse IMDSv2(AWS)/ deploymentfirewallruleblockfor 169.254.169.254 accessHIGH
    networkisolationapplicationserverdeploymentinindependentnetworksegment,limitationoutputsiteflowamounttonecessaryserviceHIGH
    responsesizelimitationlimitation SSRF request responsebodysize,preventlargeamountdataleakageMEDIUM
    Disable redirect followingDo not auto-follow HTTP 3xx redirects; prevents open-redirect bypassMEDIUM

    Practical Steps / Practical Steps

    Step 1: basic SSRF Detect

    testing loopback addresses (127.0.0.1, localhost) and file protocol (file:///etc/passwd); combine with IP address transformations (hexadecimal, decimal, IPv6, octal, all-zero) to bypass basic filters.

    Step 2: cloud metadatadata extraction

    Extract AWS IAM rolecredentials、GCP Service Account Token、Azure Managed Identity Token,use IP transformationbypasscloud metadatadataaddressfilter。

    Step 3: protocolsmugglingexploit

    Exploit gopher:// protocol to manipulate Redis/MySQL, dict:// to detect service versions, file:// to read server sensitive files.

    Step 4: advanced bypasstechnique

    Open Redirect exploit、@ characternumberspoofing、DNS rebinding、URL encoding bypass、URL solveanalysisdifferenceexploit。

    Step 5: automated SSRF Scan

    use SSRFmap automated Detect(readfiles/awsmetadata/portscan module),ffuf batchamountScaninternal networkport,Burp Collaborator Detectblind SSRF。

    See payloads.md for detailed payloads, and test-cases.md for complete test checklist。

    Common Pitfalls

    • Testing only 127.0.0.1 and localhost: Many SSRF filters block these exact strings but fail to block alternative representations like 0x7f000001, 0177.0.0.1, [::1], 0, or 127.1. Always test a comprehensive list of IP representations to avoid false negatives.
    • Forgetting cloud metadata endpoints: In cloud environments, SSRF's highest-impact target is the metadata service. Testers sometimes focus on internal port scanning and miss the IAM credential extraction opportunity at 169.254.169.254.
    • Ignoring blind SSRF: Not all SSRF returns visible response data. Blind SSRF can be exploited through timing differences, error messages, or out-of-band callbacks (Burp Collaborator) to infer internal service behavior.

    Automation and Scripting

    Automate SSRF discovery by fuzzing all URL-accepting parameters with ffuf using lists of internal IP addresses and common cloud metadata endpoints. Use SSRFmap for automated exploitation chains (port scanning, file reading, cloud metadata extraction) once a vulnerable parameter is identified. Script custom DNS rebinding attacks with Python to bypass IP-based filtering by alternating DNS responses between an allowed external IP and the internal target IP within a single TCP connection.

    Reporting and Documentation

    SSRF findings must document the vulnerable parameter, the full request payload, and the data accessible through the vulnerability. For cloud metadata extraction, include the specific IAM role credentials or instance metadata exposed and calculate the blast radius (what cloud resources those credentials can access). Provide a network diagram showing the trust boundary violated by the SSRF and include specific code-level remediation recommendations (URL validation library, allowlist approach) rather than generic advice.

    Legal and Ethical Considerations

    SSRF testing against cloud environments carries heightened risk because successful exploitation may expose production infrastructure credentials. Never use extracted cloud credentials to access resources beyond what is necessary to demonstrate impact. AWS metadata credentials are temporary but can grant broad permissions — document the permissions available without exercising all of them. When testing SSRF against internal services, be cautious not to disrupt critical internal APIs or services that other customers or users depend on.

    Integration with Other Tools

    SSRF findings chain directly into multiple attack paths. Extracted cloud credentials enable cloud-security assessment of the broader infrastructure. Internal port scanning results from SSRF feed into network-pentest methodology for further service enumeration. Gopher protocol SSRF that hits Redis or MySQL connects to database exploitation techniques from web-sqli. DNS rebinding SSRF that accesses internal web applications leads into web-xss and web-auth-bypass testing. Use the SSRF as a pivot point to expand the assessment scope within authorized boundaries.

    Case Studies and Examples

    • AWS metadata extraction via SSRF: A web application's PDF generation feature accepted a URL parameter. By submitting http://169.254.169.254/latest/meta-data/iam/security-credentials/, the attacker extracted AWS IAM temporary credentials that had full S3 read access to the company's customer data buckets.
    • Redis RCE via gopher protocol: An SSRF vulnerability allowed the gopher:// protocol. By crafting a gopher payload targeting the internal Redis instance on port 6379, the attacker wrote a cron reverse shell to /var/spool/cron/root, achieving remote code execution without any authentication.
    • Kubernetes API access via SSRF: A pod's web application had an SSRF vulnerability that allowed access to the Kubernetes API server at https://10.0.0.1:443. The default ServiceAccount token mounted in the pod had sufficient permissions to read Secrets across the namespace, exposing database credentials.

    Detection Methods

    SSRF attacks are detected through: web application firewalls that flag requests to private IP ranges, server-side monitoring of outbound connections to suspicious destinations (169.254.169.254, 127.0.0.1, 10.0.0.0/8), DNS query logs showing unusual internal domain resolutions, and cloud provider metadata access alerts (AWS detects IMDSv1 usage patterns). Defenders should implement network egress filtering, log all outbound connections from application servers, and use IMDSv2 with hop-count limits on all cloud instances.

    Defense Evasion Techniques

    Evade SSRF detection by: using DNS rebinding to bypass IP-based blocklists (the DNS lookup returns an allowed IP, then resolves to the target IP on the actual request), encoding IP addresses in decimal/hex/octal formats to bypass string-matching filters, using URL parser inconsistencies (e.g., http://evil.com#@safe.com where different parsers disagree on the hostname), and leveraging open redirects on trusted domains to chain through an allowed host to the internal target. For cloud metadata, use IP representations of 169.254.169.254 that may not be in the blocklist.

    Advanced Techniques

    Advanced SSRF exploitation includes: HTTP request smuggling combined with SSRF to bypass frontend proxy restrictions, DNS rebinding with precise timing to win race conditions between DNS resolution and application request, SSRF through HTTP headers (Host, X-Forwarded-For, Referer) that get reflected into backend requests, exploiting PDF generators and image processors that fetch external resources, and chaining SSRF with server-side template injection for full code execution. For Kubernetes environments, explore SSRF targeting the cloud metadata service to steal pod service account tokens.

    Tool Comparison Matrix

    ToolBest ForAutomationSkill Level
    Burp SuiteManual SSRF testing and debuggingManualBeginner
    ffufParameter fuzzing for SSRF discoverySemi-automatedIntermediate
    SSRFmapAutomated exploitation chainsFully automatedIntermediate
    GopherusGopher protocol payload generationSemi-automatedIntermediate
    curlQuick payload verificationManualBeginner
    Burp CollaboratorBlind SSRF detectionAutomated (OOB)Beginner

    Hacker Laws / Hacker Laws

    1. Minimize Attack Surface - SSRF exists because the application exposes unnecessary URL-fetch capabilities. Defense core is to reduce user-controllable request parameters; use whitelist not blacklist; disable unneeded protocols.

    2. Trust but Verify - Even when a URL appears to point to a legitimate domain, you must verify the actual IP address after DNS resolution. DNS rebinding, open redirect, and @ character spoofing all exploit "trust at face value" vulnerabilities. Each layer requires independent verification.

    3. Defense in Depth - A single filter (such as IP blacklist) is not enough to block SSRF. Combine URL whitelist + IP scope validation + protocol restriction + network isolation + cloud metadata protection to form a layered defense system.

    4. Assume Breach - In cloud environments, assume attackers can obtain instance metadata via SSRF. Use IMDSv2, least-privilege IAM roles, short-lived credentials, and network segmentation to limit lateral movement impact.

    Learning Resources / Learning Resources

    Skill supplementary files: payloads.md, test-cases.md

    Related Skills:

    • skills/web-sqli/SKILL.md — SQL injection:SSRF+MySQL groupcombinechain follow-upexploit
    • skills/web-xss/SKILL.md — XSS:Web applicationpenetration testingRelated Skills

    External Resources:

    Frequently asked questions

    What to verify before installation and use

    What does the web-ssrf source document cover?

    Supplementary Files: - payloads.md — SSRF attack payload allset:basic detect、protocolsmuggling、cloud metadatadata extraction、bypasstechnique、DNS rebinding、blind SSRF、RCE groupcombinechain - test-cases.md — structureizetestinguseexamplechecklist,cover SSRF Detect、internal network…

    How do I install web-ssrf?

    The source record exposes this install command: npx skills add https://github.com/brucesongs/kali-claw --skill "skills/web-ssrf". Inspect the command and pinned source before running it.

    Which Agent platforms does the source record declare?

    The pinned source record declares support for: claude code, cursor.

    Which permission-related actions were detected?

    Static rules flagged network in the source; the page lists the matching lines and excerpts.

    Alternatives

    Compare before choosing