Directory traversal attack

A directory traversal (or path traversal) attack exploits insufficient security validation or sanitization of user-supplied file names, such that characters representing "traverse to parent directory" are passed through to the operating system's file system API. An affected application can be exploited to gain unauthorized access to the file system.

Examples

In PHP

A typical example of a vulnerable application in PHP code is:

<?php$template='red.php';if(isset($_COOKIE['TEMPLATE'])){$template=$_COOKIE['TEMPLATE'];}include"/home/users/phpguru/templates/".$template;

An attack against this system could be to send the following HTTP request:

GET/vulnerable.phpHTTP/1.0Cookie:TEMPLATE=../../../../../../../../../etc/passwd

The server would then generate a response such as:

HTTP/1.0200OKContent-Type:text/htmlServer:Apache  root:fi3sED95ibqR6:0:1:System Operator:/:/bin/ksh  daemon:*:1:1::/tmp:  phpguru:f8fk3j1OIf31.:182:100:Developer:/home/users/phpguru/:/bin/csh 

The repeated ../ characters after /home/users/phpguru/templates/ have caused include() to traverse to the root directory, and then include the Unix password file /etc/passwd .

Unix /etc/passwd is a common file used to demonstrate directory traversal, as it is often used by crackers to try cracking the passwords. However, in more recent Unix systems, the /etc/passwd file does not contain the hashed passwords, and they are instead located in the /etc/shadow file, which cannot be read by unprivileged users on the machine. Even in that case, though, reading /etc/passwd does still show a list of user accounts.

Zip Slip vulnerability

Another example is the Zip Slip vulnerability that affects several archive file formats like ZIP. ^[1]

Variations

Directory traversal in its simplest form uses the ../ pattern. Some common variations are listed below:

Microsoft Windows

Microsoft Windows and DOS directory traversal uses the ..\ or ../ patterns. ^[2]

Each partition has a separate root directory (labeled C:\ where C could be any partition), and there is no common root directory above that. This means that for most directory vulnerabilities on Windows, attacks are limited to a single partition.

Directory traversal has been the cause of numerous Microsoft vulnerabilities. ^{[3] [4]}

Percent encoding in URIs

Some web applications attempt to prevent directory traversal by scanning the path of a request URI for patterns such as ../. This check is sometimes mistakenly performed before percent-decoding, causing URIs containing patterns like %2e%2e/ to be accepted despite being decoded into ../ before actual use. ^[5]

Double encoding

Percent decoding may accidentally be performed multiple times; once before validation, but again afterwards, making the application vulnerable to Double percent-encoding attacks ^[6] in which illegal characters are replaced by their double-percent-encoded form in order to bypass security countermeasures. ^[7] For example, in a double percent-encoding attack, ../ may be replaced by its double-percent-encoded form %252E%252E%252F. ^[8] This kind of vulnerability notably affected versions 5.0 and earlier of Microsoft's IIS web server software. ^[9]

UTF-8

A badly implemented UTF-8 decoder may accept characters encoded using more bytes than necessary, leading to alternative character representations, such as %2e and %c0%ae both representing .. This is specifically forbidden by the UTF-8 standard, ^[10] but has still led to directory traversal vulnerabilities in software such as the IIS web server. ^[11]

Archives

Some archive formats like zip allow for directory traversal attacks: files in the archive can be written such that they overwrite files on the filesystem by backtracking. Code that extracts archive files can be written to check that the paths of the files in the archive do not engage in path traversal.

Prevention

A possible algorithm for preventing directory traversal would be to:

1. Process URI requests that do not result in a file request, e.g., executing a hook into user code, before continuing below.
2. When a URI request for a file/directory is to be made, build a full path to the file/directory if it exists, and normalize all characters (e.g., %20 converted to spaces).
3. It is assumed that a 'Document Root' fully qualified, normalized, path is known, and this string has a length N. Assume that no files outside this directory can be served.
4. Ensure that the first N characters of the fully qualified path to the requested file is exactly the same as the 'Document Root'.
5. If so, allow the file to be returned.
6. If not, return an error, since the request is clearly out of bounds from what the web-server should be allowed to serve.

Using a hard-coded predefined file extension to suffix the path does not necessarily limit the scope of the attack to files of that file extension.

<?phpinclude($_GET['file'].'.html');

The user can use the NULL character (indicating the end of the string) in order to bypass everything after the $_GET. (This is PHP-specific.)

See also

• Chroot jails may be subject to directory traversal if incorrectly created. Possible directory traversal attack vectors are open file descriptors to directories outside the jail. The working directory is another possible attack vector.
• Insecure direct object reference

References

1. "Zip Slip Vulnerability". Snyk. The vulnerability is exploited using a specially crafted archive that holds directory traversal filenames (e.g. ../../evil.sh). The Zip Slip vulnerability can affect numerous archive formats, including tar, jar, war, cpio, apk, rar and 7z.
2. "Naming Files, Paths, and Namespaces". Microsoft. File I/O functions in the Windows API convert '/' to '\' as part of converting the name to an NT-style name
3. Burnett, Mark (December 20, 2004). "Security Holes That Run Deep". SecurityFocus. Archived from the original on February 2, 2021. Retrieved March 22, 2016.
4. "Microsoft: Security Vulnerabilities (Directory Traversal)". CVE Details.
5. "Path Traversal". OWASP.
6. "CWE-174: Double Decoding of the Same Data". cwe.mitre.org. Retrieved 24 July 2022. The software decodes the same input twice, which can limit the effectiveness of any protection mechanism that occurs in between the decoding operations.
7. "CAPEC-120: Double Encoding". capec.mitre.org. Retrieved 23 July 2022. This[double encoding] may allow the adversary to bypass filters that attempt to detect illegal characters or strings, such as those that might be used in traversal or injection attacks. [...] Try double-encoding for parts of the input in order to try to get past the filters.
8. "Double Encoding". owasp.org. Retrieved 23 July 2022. For example, ../ (dot-dot-slash) characters represent %2E%2E%2F in hexadecimal representation. When the % symbol is encoded again, its representation in hexadecimal code is %25. The result from the double encoding process ../ (dot-dot-slash) would be %252E%252E%252F
9. "CVE-2001-0333". Common Vulnerabilities and Exposures.
10. Yergeau, F. (2003). "RFC 2279 - UTF-8, a transformation format of ISO 10646". IETF. doi: 10.17487/RFC3629 .
11. "CVE-2002-1744". Common Vulnerabilities and Exposures.

Resources

• Open Web Application Security Project
• The WASC Threat Classification – Path Traversal
• Path Traversal Vulnerability Exploitation and Remediation ^{[ permanent dead link ‍]}
• CWE Common Weakness Enumeration - Path Traversal

External links

• DotDotPwn – The Directory Traversal Fuzzer
• Conviction for using directory traversal.
• "Only bad guys benefit from bad law". comment.zdnet.co.uk. October 7, 2005. Archived from the original on 2006-10-08.
• Bugtraq: IIS %c1%1c remote command execution
• Cryptogram Newsletter July 2001.