This site is the archived OWASP Foundation Wiki and is no longer accepting Account Requests.
To view the new OWASP Foundation website, please visit https://owasp.org
Difference between revisions of "Testing for HTTP Verb Tampering (OTG-INPVAL-003)"
Ben Walther (talk | contribs) m |
m (recover the link's PDF sub-link) |
||
(10 intermediate revisions by 5 users not shown) | |||
Line 2: | Line 2: | ||
− | == | + | == Summary == |
+ | The HTTP specification includes request methods other than the standard GET and POST requests. A standards compliant web server may respond to these alternative methods in ways not anticipated by developers. Although the common description is 'verb' tampering, the HTTP 1.1 standard refers to these request types as different HTTP 'methods.' | ||
<br> | <br> | ||
− | |||
− | + | ||
− | |||
− | |||
− | |||
The full HTTP 1.1 specification [http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html] defines the following valid HTTP request methods, or verbs: | The full HTTP 1.1 specification [http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html] defines the following valid HTTP request methods, or verbs: | ||
<pre> | <pre> | ||
Line 22: | Line 19: | ||
</pre> | </pre> | ||
− | However, most web applications only need to respond to GET and POST requests | + | If enabled, the Web Distributed Authoring and Version (WebDAV) extensions [http://www.webdav.org/specs/rfc2518.html] [http://tools.ietf.org/html/rfc4918] permit several more HTTP methods: |
+ | <pre> | ||
+ | PROPFIND | ||
+ | PROPPATCH | ||
+ | MKCOL | ||
+ | COPY | ||
+ | MOVE | ||
+ | LOCK | ||
+ | UNLOCK | ||
+ | </pre> | ||
+ | |||
+ | However, most web applications only need to respond to GET and POST requests, providing user data in the URL query string or appended to the request respectively. The standard <code><a href=""></a></code> style links trigger a GET request; form data submitted via <code><form method='POST'></form></code> trigger POST requests. Forms defined without a method also send data via GET by default. | ||
+ | |||
+ | |||
+ | Oddly, the other valid HTTP methods are not supported by the HTML standard [http://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13.1]. Any HTTP method other than GET or POST needs to be called outside the HTML document. However, JavaScript and AJAX calls may send methods other than GET and POST. | ||
− | |||
As long as the web application being tested does not specifically call for any non-standard HTTP methods, testing for HTTP verb tampering is quite simple. If the server accepts a request other than GET or POST, the test fails. The solutions is to disable all non GET or POST functionality within the web application server, or in a web application firewall. | As long as the web application being tested does not specifically call for any non-standard HTTP methods, testing for HTTP verb tampering is quite simple. If the server accepts a request other than GET or POST, the test fails. The solutions is to disable all non GET or POST functionality within the web application server, or in a web application firewall. | ||
+ | |||
+ | |||
+ | If methods such as HEAD or OPTIONS are required for your application, this increases the burden of testing substantially. Each action within the system will need to be verified that these alternate methods do not trigger actions without proper authentication or reveal information about the contents or workings web application. If possible, limit alternate HTTP method usage to a single page that contains no user actions, such the default landing page (example: index.html). | ||
<br> | <br> | ||
− | == | + | ==How to Test== |
− | + | ||
+ | As the HTML standard does not support request methods other than GET or POST, we will need to craft custom HTTP requests to test the other methods. We highly recommend using a tool to do this, although we will demonstrate how to do manually as well.<br> | ||
===Manual HTTP verb tampering testing=== | ===Manual HTTP verb tampering testing=== | ||
Line 36: | Line 50: | ||
This example is written using the netcat package from openbsd (standard with most Linux distributions). You may also use telnet (included with Windows) in a similar fashion. | This example is written using the netcat package from openbsd (standard with most Linux distributions). You may also use telnet (included with Windows) in a similar fashion. | ||
− | + | 1. Crafting custom HTTP requests | |
− | + | <blockquote> | |
− | + | Each HTTP 1.1 request follows the following basic formatting and syntax. Elements surrounded by brackets <code>[ ]</code> are contextual to your application. The empty newline at the end is required. | |
− | + | ||
− | + | <pre> | |
− | + | [METHOD] /[index.htm] HTTP/1.1 | |
− | + | host: [www.example.com] | |
− | + | ||
− | + | </pre> | |
− | + | ||
− | + | In order to craft separate requests, you can manually type each request into netcat or telnet and examine the response. However, to speed up testing, you may also store each request in a separate file. This second approach is what we'll demonstrate in these examples. Use your favorite editor to create a text file for each method. Modify for your application's landing page and domain. | |
+ | </blockquote> | ||
+ | |||
+ | 1.1 OPTIONS | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | OPTIONS /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | |||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.2 GET | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | GET /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | |||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.3 HEAD | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | HEAD /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | |||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.4 POST | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | POST /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | |||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.5 PUT | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | PUT /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | |||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.6 DELETE | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | DELETE /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | |||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.7 TRACE | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | TRACE /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | </pre> | ||
+ | </blockquote> | ||
+ | 1.8 CONNECT | ||
+ | <blockquote> | ||
+ | <pre> | ||
+ | CONNECT /index.html HTTP/1.1 | ||
+ | host: www.example.com | ||
+ | </pre> | ||
+ | </blockquote> | ||
+ | |||
+ | |||
+ | 2. Sending HTTP requests | ||
+ | <blockquote> | ||
+ | For each method and/or method text file, send the request to your web server via netcat or telnet on port 80 (HTTP): | ||
+ | <pre>nc www.example.com 80 < OPTIONS.http.txt</pre> | ||
+ | </blockquote> | ||
+ | |||
+ | |||
+ | 3. Parsing HTTP responses | ||
+ | <blockquote> | ||
+ | Although each HTTP method can potentially return different results, there is only a single valid result for all methods other than GET and POST. The web server should either ignore the request completely or return an error. Any other response indicates a test failure as the server is responding to methods/verbs that are unnecessary. These methods should be disabled. | ||
+ | |||
+ | <br> | ||
+ | An example of a failed test (ie, the server supports OPTIONS despite no need for it): | ||
+ | <br> | ||
+ | [[File:OPTIONS_verb_tampering.png]] | ||
+ | </blockquote> | ||
===Automated HTTP verb tampering testing=== | ===Automated HTTP verb tampering testing=== | ||
+ | If you are able to analyze your application via simple HTTP status codes (200 OK, 501 Error, etc) - then the following bash script will test all available HTTP methods. | ||
+ | <pre> | ||
+ | #!/bin/bash | ||
+ | |||
+ | for webservmethod in GET POST PUT TRACE CONNECT OPTIONS PROPFIND; | ||
+ | |||
+ | do | ||
+ | printf "$webservmethod " ; | ||
+ | printf "$webservmethod / HTTP/1.1\nHost: $1\n\n" | nc -q 1 $1 80 | grep "HTTP/1.1" | ||
+ | |||
+ | done | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | Code copied verbatim from the Penetration Testing Lab blog [http://pentestlab.wordpress.com/2012/12/20/http-methods-identification/] | ||
+ | |||
== References == | == References == | ||
− | '''Whitepapers''' | + | '''Whitepapers''' |
− | ... | + | * Arshan Dabirsiaghi: “Bypassing URL Authentication and Authorization with HTTP Verb Tampering” - [http://web.archive.org/web/20170517030540/http://cdn2.hubspot.net/hub/315719/file-1344244110-pdf/download-files/Bypassing_VBAAC_with_HTTP_Verb_Tampering.pdf http://www.aspectsecurity.com/research-presentations/bypassing-vbaac-with-http-verb-tampering] |
− | |||
− | ... |
Latest revision as of 00:42, 27 May 2018
This article is part of the new OWASP Testing Guide v4.
Back to the OWASP Testing Guide v4 ToC: https://www.owasp.org/index.php/OWASP_Testing_Guide_v4_Table_of_Contents Back to the OWASP Testing Guide Project: https://www.owasp.org/index.php/OWASP_Testing_Project
Summary
The HTTP specification includes request methods other than the standard GET and POST requests. A standards compliant web server may respond to these alternative methods in ways not anticipated by developers. Although the common description is 'verb' tampering, the HTTP 1.1 standard refers to these request types as different HTTP 'methods.'
The full HTTP 1.1 specification [1] defines the following valid HTTP request methods, or verbs:
OPTIONS GET HEAD POST PUT DELETE TRACE CONNECT
If enabled, the Web Distributed Authoring and Version (WebDAV) extensions [2] [3] permit several more HTTP methods:
PROPFIND PROPPATCH MKCOL COPY MOVE LOCK UNLOCK
However, most web applications only need to respond to GET and POST requests, providing user data in the URL query string or appended to the request respectively. The standard <a href=""></a>
style links trigger a GET request; form data submitted via <form method='POST'></form>
trigger POST requests. Forms defined without a method also send data via GET by default.
Oddly, the other valid HTTP methods are not supported by the HTML standard [4]. Any HTTP method other than GET or POST needs to be called outside the HTML document. However, JavaScript and AJAX calls may send methods other than GET and POST.
As long as the web application being tested does not specifically call for any non-standard HTTP methods, testing for HTTP verb tampering is quite simple. If the server accepts a request other than GET or POST, the test fails. The solutions is to disable all non GET or POST functionality within the web application server, or in a web application firewall.
If methods such as HEAD or OPTIONS are required for your application, this increases the burden of testing substantially. Each action within the system will need to be verified that these alternate methods do not trigger actions without proper authentication or reveal information about the contents or workings web application. If possible, limit alternate HTTP method usage to a single page that contains no user actions, such the default landing page (example: index.html).
How to Test
As the HTML standard does not support request methods other than GET or POST, we will need to craft custom HTTP requests to test the other methods. We highly recommend using a tool to do this, although we will demonstrate how to do manually as well.
Manual HTTP verb tampering testing
This example is written using the netcat package from openbsd (standard with most Linux distributions). You may also use telnet (included with Windows) in a similar fashion.
1. Crafting custom HTTP requests
Each HTTP 1.1 request follows the following basic formatting and syntax. Elements surrounded by brackets
[ ]
are contextual to your application. The empty newline at the end is required.[METHOD] /[index.htm] HTTP/1.1 host: [www.example.com]In order to craft separate requests, you can manually type each request into netcat or telnet and examine the response. However, to speed up testing, you may also store each request in a separate file. This second approach is what we'll demonstrate in these examples. Use your favorite editor to create a text file for each method. Modify for your application's landing page and domain.
1.1 OPTIONS
OPTIONS /index.html HTTP/1.1 host: www.example.com
1.2 GET
GET /index.html HTTP/1.1 host: www.example.com
1.3 HEAD
HEAD /index.html HTTP/1.1 host: www.example.com
1.4 POST
POST /index.html HTTP/1.1 host: www.example.com
1.5 PUT
PUT /index.html HTTP/1.1 host: www.example.com
1.6 DELETE
DELETE /index.html HTTP/1.1 host: www.example.com
1.7 TRACE
TRACE /index.html HTTP/1.1 host: www.example.com
1.8 CONNECT
CONNECT /index.html HTTP/1.1 host: www.example.com
2. Sending HTTP requests
For each method and/or method text file, send the request to your web server via netcat or telnet on port 80 (HTTP):
nc www.example.com 80 < OPTIONS.http.txt
3. Parsing HTTP responses
Although each HTTP method can potentially return different results, there is only a single valid result for all methods other than GET and POST. The web server should either ignore the request completely or return an error. Any other response indicates a test failure as the server is responding to methods/verbs that are unnecessary. These methods should be disabled.
An example of a failed test (ie, the server supports OPTIONS despite no need for it):
Automated HTTP verb tampering testing
If you are able to analyze your application via simple HTTP status codes (200 OK, 501 Error, etc) - then the following bash script will test all available HTTP methods.
#!/bin/bash for webservmethod in GET POST PUT TRACE CONNECT OPTIONS PROPFIND; do printf "$webservmethod " ; printf "$webservmethod / HTTP/1.1\nHost: $1\n\n" | nc -q 1 $1 80 | grep "HTTP/1.1" done
Code copied verbatim from the Penetration Testing Lab blog [5]
References
Whitepapers
- Arshan Dabirsiaghi: “Bypassing URL Authentication and Authorization with HTTP Verb Tampering” - http://www.aspectsecurity.com/research-presentations/bypassing-vbaac-with-http-verb-tampering