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 "Review Webserver Metafiles for Information Leakage (OTG-INFO-003)"

From OWASP
Jump to: navigation, search
 
(23 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{Template:OWASP Testing Guide v4}}
 
{{Template:OWASP Testing Guide v4}}
  
== Brief Summary ==
+
== Summary ==
This section describes how to test the robots.txt file.
+
This section describes how to test the robots.txt file for information leakage of the web application's directory or folder path(s). Furthermore, the list of directories that are to be avoided by Spiders, Robots, or Crawlers can also be created as a dependency for [[Map_execution_paths_through_application_(OTG-INFO-007) |Map execution paths through application (OTG-INFO-007)]]
  
== Description of the Issue ==
 
Web spiders/robots/crawlers retrieve a web page and then recursively traverse hyperlinks to retrieve further web content. Their accepted behavior is specified by the ''Robots Exclusion Protocol'' of the robots.txt file in the web root directory [1].
 
  
As an example, the robots.txt file from http://www.google.com/robots.txt taken on 24 August 2008 is quoted below:
+
== Test Objectives ==
 +
1. Information leakage of the web application's directory or folder path(s).
 +
 
 +
2. Create the list of directories that are to be avoided by Spiders, Robots, or Crawlers.
 +
 
 +
 
 +
== How to Test ==
 +
===robots.txt===
 +
Web Spiders, Robots, or Crawlers retrieve a web page and then recursively traverse hyperlinks to retrieve further web content. Their accepted behavior is specified by the ''Robots Exclusion Protocol'' of the robots.txt file in the web root directory [1].
 +
<br>
 +
 
 +
As an example, the beginning of the robots.txt file from http://www.google.com/robots.txt sampled on 11 August 2013 is quoted below:
 
<pre>
 
<pre>
 
User-agent: *
 
User-agent: *
Allow: /searchhistory/
 
Disallow: /news?output=xhtml&
 
Allow: /news?output=xhtml
 
 
Disallow: /search
 
Disallow: /search
 +
Disallow: /sdch
 
Disallow: /groups
 
Disallow: /groups
 
Disallow: /images
 
Disallow: /images
 +
Disallow: /catalogs
 
...
 
...
 
</pre>
 
</pre>
  
The ''User-Agent'' directive refers to the specific web spider/robot/crawler.  For example the ''User-Agent: Googlebot'' refers to the ''GoogleBot'' crawler while ''User-Agent: *'' in the example above applies to all web spiders/robots/crawlers [2] as quoted below:
+
 
 +
The ''User-Agent'' directive refers to the specific web spider/robot/crawler.  For example the ''User-Agent: Googlebot'' refers to the spider from Google while "User-Agent: bingbot"[http://www.bing.com/blogs/site_blogs/b/webmaster/archive/2010/06/28/bing-crawler-bingbot-on-the-horizon.aspx] refers to crawler from Microsoft/Yahoo!.  ''User-Agent: *'' in the example above applies to all web spiders/robots/crawlers [2] as quoted below:
 
<pre>
 
<pre>
 
User-agent: *
 
User-agent: *
 
</pre>
 
</pre>
 +
  
 
The ''Disallow'' directive specifies which resources are prohibited by spiders/robots/crawlers. In the example above, directories such as the following are prohibited:
 
The ''Disallow'' directive specifies which resources are prohibited by spiders/robots/crawlers. In the example above, directories such as the following are prohibited:
Line 28: Line 38:
 
...  
 
...  
 
Disallow: /search
 
Disallow: /search
 +
Disallow: /sdch
 
Disallow: /groups
 
Disallow: /groups
 
Disallow: /images
 
Disallow: /images
 +
Disallow: /catalogs
 
...
 
...
 
</pre>
 
</pre>
Web spiders/robots/crawlers can intentionally ignore the ''Disallow'' directives specified in a robots.txt file [3].  Hence, robots.txt should not be considered as a mechanism to enforce restrictions on how web content is accessed, stored, or republished by third parties.  
+
 
 +
 
 +
Web spiders/robots/crawlers can intentionally ignore the ''Disallow'' directives specified in a robots.txt file [3], such as those from Social Networks[https://www.htbridge.com/news/social_networks_can_robots_violate_user_privacy.html] to ensure that shared linked are still valid.  Hence, robots.txt should not be considered as a mechanism to enforce restrictions on how web content is accessed, stored, or republished by third parties.  
 
<br>
 
<br>
  
== Black Box testing and example ==
+
'''robots.txt in webroot - with "wget" or "curl"<br>
'''wget'''<br>
 
The robots.txt file is retrieved from the web root directory of the web server.
 
  
For example, to retrieve the robots.txt from www.google.com using ''wget'':
+
The robots.txt file is retrieved from the web root directory of the web server. For example, to retrieve the robots.txt from www.google.com using "wget" or "curl":
 
<pre>
 
<pre>
$ wget http://www.google.com/robots.txt
+
cmlh$ wget http://www.google.com/robots.txt
--23:59:24-- http://www.google.com/robots.txt
+
--2013-08-11 14:40:36-- http://www.google.com/robots.txt
          => 'robots.txt'
+
Resolving www.google.com... 74.125.237.17, 74.125.237.18, 74.125.237.19, ...
Resolving www.google.com... 74.125.19.103, 74.125.19.104, 74.125.19.147, ...
+
Connecting to www.google.com|74.125.237.17|:80... connected.
Connecting to www.google.com|74.125.19.103|:80... connected.
 
 
HTTP request sent, awaiting response... 200 OK
 
HTTP request sent, awaiting response... 200 OK
 
Length: unspecified [text/plain]
 
Length: unspecified [text/plain]
 +
Saving to: ‘robots.txt.1’
 +
 +
    [ <=>                                  ] 7,074      --.-K/s  in 0s     
 +
 +
2013-08-11 14:40:37 (59.7 MB/s) - ‘robots.txt’ saved [7074]
  
    [ <=>                                 ] 3,425        --.--K/s
+
cmlh$ head -n5 robots.txt
 +
User-agent: *
 +
Disallow: /search
 +
Disallow: /sdch
 +
Disallow: /groups
 +
Disallow: /images
 +
cmlh$
 +
</pre>
 +
<pre>
 +
cmlh$ curl -O http://www.google.com/robots.txt
 +
  % Total    % Received % Xferd  Average Speed  Time    Time    Time  Current
 +
                                Dload  Upload  Total  Spent    Left  Speed
 +
101  7074    0  7074    0    0  9410      0 --:--:-- --:--:-- --:--:-- 27312
  
23:59:26 (13.67MB/s) - 'robots.txt' saved [3425]
+
cmlh$ head -n5 robots.txt
 +
User-agent: *
 +
Disallow: /search
 +
Disallow: /sdch
 +
Disallow: /groups
 +
Disallow: /images
 +
cmlh$
 
</pre>
 
</pre>
 +
 +
 +
'''robots.txt in webroot - with rockspider'''<br>
 +
"rockspider"[https://github.com/cmlh/rockspider/releases] automates the creation of the initial scope for Spiders/Robots/Crawlers of files and directories/folders of a web site.
 +
 +
 +
For example, to create the initial scope based on the Allowed: directive from www.google.com using "rockspider"[https://github.com/cmlh/rockspider/releases]:
 +
<pre>
 +
cmlh$ ./rockspider.pl -www www.google.com
 +
 +
"Rockspider" Alpha v0.1_2
 +
 +
Copyright 2013 Christian Heinrich
 +
Licensed under the Apache License, Version 2.0
 +
 +
1. Downloading http://www.google.com/robots.txt
 +
2. "robots.txt" saved as "www.google.com-robots.txt"
 +
3. Sending Allow: URIs of www.google.com to web proxy i.e. 127.0.0.1:8080
 +
/catalogs/about sent
 +
/catalogs/p? sent
 +
/news/directory sent
 +
...
 +
4. Done.
 +
 +
cmlh$
 +
</pre>
 +
 +
 
'''Analyze robots.txt using Google Webmaster Tools'''<br>
 
'''Analyze robots.txt using Google Webmaster Tools'''<br>
Google provides an "Analyze robots.txt" function as part of its "Google Webmaster Tools", which can assist with testing [4] and the procedure is as follows:
+
Web site owners can use the Google "Analyze robots.txt" function to analyse the website as part of its "Google Webmaster Tools" (https://www.google.com/webmasters/tools). This tool can assist with testing and the procedure is as follows:
 +
 
 +
1. Sign into Google Webmaster Tools with a Google account.<br>
 +
2. On the dashboard, write the URL for the site to be analyzed.<br>
 +
3. Choose between the available methods and follow the on screen instruction.<br>
 +
 
 +
 
 +
===META Tag===
 +
 
 +
<META> tags are located within the HEAD section of each HTML Document and should be consistent across a web site in the likely event that the robot/spider/crawler start point does not begin from a document link other than webroot i.e. a "deep link"[http://en.wikipedia.org/wiki/Deep_linking].
 +
 
 +
 
 +
If there is no "<META NAME="ROBOTS" ... >" entry then the "Robots Exclusion Protocol" defaults to "INDEX,FOLLOW" respectively.  Therefore, the other two valid entries defined by the "Robots Exclusion Protocol" are prefixed with "NO..." i.e. "NOINDEX" and "NOFOLLOW".
 +
 
 +
 
 +
Web spiders/robots/crawlers can intentionally ignore the "<META NAME="ROBOTS"" tag as the robots.txt file convention is preferred.  Hence, <b><META> Tags should not be considered the primary mechanism, rather a complementary control to robots.txt</b>.
 +
 
 +
'''<META> Tags - with Burp'''<br>
 +
 
 +
 
 +
Based on the Disallow directive(s) listed within the robots.txt file in webroot, a regular expression search for "<META NAME="ROBOTS"" within each web page is undertaken and the result compared to the robots.txt file in webroot.
 +
 
 +
 
 +
For example, the robots.txt file from facebook.com has a "Disallow: /ac.php" entry[http://facebook.com/robots.txt] and the resulting search for "<META NAME="ROBOTS"" shown below:
 +
<br>
 +
[[File:CMLH-Meta Tag Example-Facebook-Aug 2013.png]]
 +
<br>
 +
 
 +
The above might be considered a fail since "INDEX,FOLLOW" is the default <META> Tag specified by the "Robots Exclusion Protocol" yet "Disallow: /ac.php" is listed in robots.txt.
 +
 
 +
 
 +
== Tools ==
  
1. Sign into Google Webmaster Tools with your Google Account.<br>
+
* Browser (View Source function)
2. On the Dashboard, click the URL for the site you want.<br>
+
* curl
3. Click Tools, and then click Analyze robots.txt.<br>
+
* wget
 +
* rockspider[https://github.com/cmlh/rockspider/releases]
  
== Gray Box testing and example ==
 
The process is the same as Black Box testing above.
 
<br><br>
 
  
 
== References ==
 
== References ==
 
'''Whitepapers'''<br>
 
'''Whitepapers'''<br>
 
* [1] "The Web Robots Pages" - http://www.robotstxt.org/
 
* [1] "The Web Robots Pages" - http://www.robotstxt.org/
* [2] "How do I block or allow Googlebot?" - http://www.google.com/support/webmasters/bin/answer.py?answer=40364&query=googlebot&topic=&type=
+
* [2] "Block and Remove Pages Using a robots.txt File" - https://support.google.com/webmasters/answer/156449
 
* [3] "(ISC)2 Blog: The Attack of the Spiders from the Clouds" - http://blog.isc2.org/isc2_blog/2008/07/the-attack-of-t.html
 
* [3] "(ISC)2 Blog: The Attack of the Spiders from the Clouds" - http://blog.isc2.org/isc2_blog/2008/07/the-attack-of-t.html
* [4] "How do I check that my robots.txt file is working as expected?" - http://www.google.com/support/webmasters/bin/answer.py?answer=35237
+
* [4] "Telstra customer database exposed" - http://www.smh.com.au/it-pro/security-it/telstra-customer-database-exposed-20111209-1on60.html
 
<br>
 
<br>

Latest revision as of 12:37, 8 August 2014

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

This section describes how to test the robots.txt file for information leakage of the web application's directory or folder path(s). Furthermore, the list of directories that are to be avoided by Spiders, Robots, or Crawlers can also be created as a dependency for Map execution paths through application (OTG-INFO-007)


Test Objectives

1. Information leakage of the web application's directory or folder path(s).

2. Create the list of directories that are to be avoided by Spiders, Robots, or Crawlers.


How to Test

robots.txt

Web Spiders, Robots, or Crawlers retrieve a web page and then recursively traverse hyperlinks to retrieve further web content. Their accepted behavior is specified by the Robots Exclusion Protocol of the robots.txt file in the web root directory [1].

As an example, the beginning of the robots.txt file from http://www.google.com/robots.txt sampled on 11 August 2013 is quoted below:

User-agent: *
Disallow: /search
Disallow: /sdch
Disallow: /groups
Disallow: /images
Disallow: /catalogs
...


The User-Agent directive refers to the specific web spider/robot/crawler. For example the User-Agent: Googlebot refers to the spider from Google while "User-Agent: bingbot"[1] refers to crawler from Microsoft/Yahoo!. User-Agent: * in the example above applies to all web spiders/robots/crawlers [2] as quoted below:

User-agent: *


The Disallow directive specifies which resources are prohibited by spiders/robots/crawlers. In the example above, directories such as the following are prohibited:

... 
Disallow: /search
Disallow: /sdch
Disallow: /groups
Disallow: /images
Disallow: /catalogs
...


Web spiders/robots/crawlers can intentionally ignore the Disallow directives specified in a robots.txt file [3], such as those from Social Networks[2] to ensure that shared linked are still valid. Hence, robots.txt should not be considered as a mechanism to enforce restrictions on how web content is accessed, stored, or republished by third parties.

robots.txt in webroot - with "wget" or "curl"

The robots.txt file is retrieved from the web root directory of the web server. For example, to retrieve the robots.txt from www.google.com using "wget" or "curl":

cmlh$ wget http://www.google.com/robots.txt
--2013-08-11 14:40:36--  http://www.google.com/robots.txt
Resolving www.google.com... 74.125.237.17, 74.125.237.18, 74.125.237.19, ...
Connecting to www.google.com|74.125.237.17|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: unspecified [text/plain]
Saving to: ‘robots.txt.1’

    [ <=>                                   ] 7,074       --.-K/s   in 0s      

2013-08-11 14:40:37 (59.7 MB/s) - ‘robots.txt’ saved [7074]

cmlh$ head -n5 robots.txt
User-agent: *
Disallow: /search
Disallow: /sdch
Disallow: /groups
Disallow: /images
cmlh$ 
cmlh$ curl -O http://www.google.com/robots.txt
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
101  7074    0  7074    0     0   9410      0 --:--:-- --:--:-- --:--:-- 27312

cmlh$ head -n5 robots.txt
User-agent: *
Disallow: /search
Disallow: /sdch
Disallow: /groups
Disallow: /images
cmlh$ 


robots.txt in webroot - with rockspider
"rockspider"[3] automates the creation of the initial scope for Spiders/Robots/Crawlers of files and directories/folders of a web site.


For example, to create the initial scope based on the Allowed: directive from www.google.com using "rockspider"[4]:

cmlh$ ./rockspider.pl -www www.google.com

"Rockspider" Alpha v0.1_2

Copyright 2013 Christian Heinrich
Licensed under the Apache License, Version 2.0

1. Downloading http://www.google.com/robots.txt
2. "robots.txt" saved as "www.google.com-robots.txt"
3. Sending Allow: URIs of www.google.com to web proxy i.e. 127.0.0.1:8080
	 /catalogs/about sent
	 /catalogs/p? sent
	 /news/directory sent
	...
4. Done.

cmlh$


Analyze robots.txt using Google Webmaster Tools
Web site owners can use the Google "Analyze robots.txt" function to analyse the website as part of its "Google Webmaster Tools" (https://www.google.com/webmasters/tools). This tool can assist with testing and the procedure is as follows:

1. Sign into Google Webmaster Tools with a Google account.
2. On the dashboard, write the URL for the site to be analyzed.
3. Choose between the available methods and follow the on screen instruction.


META Tag

<META> tags are located within the HEAD section of each HTML Document and should be consistent across a web site in the likely event that the robot/spider/crawler start point does not begin from a document link other than webroot i.e. a "deep link"[5].


If there is no "<META NAME="ROBOTS" ... >" entry then the "Robots Exclusion Protocol" defaults to "INDEX,FOLLOW" respectively. Therefore, the other two valid entries defined by the "Robots Exclusion Protocol" are prefixed with "NO..." i.e. "NOINDEX" and "NOFOLLOW".


Web spiders/robots/crawlers can intentionally ignore the "<META NAME="ROBOTS"" tag as the robots.txt file convention is preferred. Hence, <META> Tags should not be considered the primary mechanism, rather a complementary control to robots.txt.

<META> Tags - with Burp


Based on the Disallow directive(s) listed within the robots.txt file in webroot, a regular expression search for "<META NAME="ROBOTS"" within each web page is undertaken and the result compared to the robots.txt file in webroot.


For example, the robots.txt file from facebook.com has a "Disallow: /ac.php" entry[6] and the resulting search for "<META NAME="ROBOTS"" shown below:
CMLH-Meta Tag Example-Facebook-Aug 2013.png

The above might be considered a fail since "INDEX,FOLLOW" is the default <META> Tag specified by the "Robots Exclusion Protocol" yet "Disallow: /ac.php" is listed in robots.txt.


Tools

  • Browser (View Source function)
  • curl
  • wget
  • rockspider[7]


References

Whitepapers