[tor-commits] [ooni-probe/master] Add meek fronted requests documentation

[art at torproject.org]

commit 91cc6993c019fb40356dcb40822fb2f92129e776
Author: anadahz <kojgelo at inbox.com>
Date:   Fri Oct 16 01:33:35 2015 +0200

    Add meek fronted requests documentation
---
 docs/source/tests/meek_fronted_requests.rst |  176 +++++++++++++++++++++++++++
 1 file changed, 176 insertions(+)

diff --git a/docs/source/tests/meek_fronted_requests.rst b/docs/source/tests/meek_fronted_requests.rst
new file mode 100644
index 0000000..b865e18
--- /dev/null
+++ b/docs/source/tests/meek_fronted_requests.rst
@@ -0,0 +1,176 @@
+Details
+=======
+
+*Test Name*: Meek Fronted Request Test
+
+*Current version*: 0.0.1
+
+*NetTest*: HTTP Requests (https://gitweb.torproject.org/ooni-probe.git/blob/HEAD:/ooni/nettests/blocking/meek_fronted_requests.py)
+
+*Test Helper*: None
+
+*Test Type*: Content Blocking, Traffic Manipulation
+
+*Requires Root*: No
+
+Description
+===========
+
+Performs a HTTP GET request to a list of fronted domains with the Host
+Header of the "inside" meek-server. The meek-server handles a GET request and
+response with: "I’m just a happy little web server.\n".
+
+It tests if the fronted request/response to the meek server is successful.
+
+
+How to run the test
+===================
+
+To test if the default meek servers are blocked:
+
+`ooniprobe blocking/meek_fronted_requests`
+
+To test a set of meek servers from a list containing hosts to test run:
+
+`ooniprobe blocking/meek_fronted_requests -f <input_file>`
+
+*input file* a list of domainName:hostHeader pairs to perform the test.
+
+Optional test options
+=====================
+
+*-B* Expected body content from GET response (meek server default: 'I’m just a
+happy little web server.\n')
+*-D* Specify a single fronted domainName to test.
+*-H* Specify "inside" Host Header to test.
+
+Sample report
+=============
+
+`ooniprobe blocking/meek_fronted_requests`
+
+::
+
+###########################################
+# OONI Probe Report for meek_fronted_requests_test (0.0.1)
+# Thu Oct 15 22:01:32 2015
+###########################################
+---
+input_hashes: []
+options: []
+probe_asn: AS20676
+probe_cc: DE
+probe_city: null
+probe_ip: 127.0.0.1
+report_id: null
+software_name: ooniprobe
+software_version: 1.3.1
+start_time: 1444932091.0
+test_helpers: {}
+test_name: meek_fronted_requests_test
+test_version: 0.0.1
+...
+---
+agent: agent
+input: [a0.awsstatic.com, d2zfqthxsdq309.cloudfront.net]
+requests:
+- request:
+    body: null
+    headers:
+    - - Host
+      - [d2zfqthxsdq309.cloudfront.net]
+    method: GET
+    tor: {is_tor: false}
+    url: https://a0.awsstatic.com
+  response:
+    body: "I\u2019m just a happy little web server.\n"
+    code: 200
+    headers:
+    - - Content-Length
+      - ['38']
+    - - Via
+      - [1.1 15191055e43ba835d0fead01ae84015c.cloudfront.net (CloudFront)]
+    - - X-Cache
+      - [Hit from cloudfront]
+    - - Age
+      - ['530']
+    - - Connection
+      - [close]
+    - - X-Amz-Cf-Id
+      - [PKUBrpXDpoi2rSZ-WV0YUzX1wPg6JylZ_37iQeRQJB-xDLtJddcxzw==]
+    - - Date
+      - ['Thu, 15 Oct 2015 19:52:47 GMT']
+    - - Content-Type
+      - [text/plain; charset=utf-8]
+socksproxy: null
+success: true
+test_runtime: 0.3198120594024658
+test_start_time: 1444932097.0
+...
+---
+agent: agent
+input: [ajax.aspnetcdn.com, az668014.vo.msecnd.net]
+requests:
+- request:
+    body: null
+    headers:
+    - - Host
+      - [az668014.vo.msecnd.net]
+    method: GET
+    tor: {is_tor: false}
+    url: https://ajax.aspnetcdn.com
+  response:
+    body: "I\u2019m just a happy little web server.\n"
+    code: 200
+    headers:
+    - - Date
+      - ['Thu, 15 Oct 2015 20:01:37 GMT']
+    - - Content-Length
+      - ['38']
+    - - Content-Type
+      - [text/plain; charset=utf-8]
+    - - Connection
+      - [close]
+    - - Server
+      - [ECAcc (fcn/40C4)]
+socksproxy: null
+success: true
+test_runtime: 0.4580512046813965
+test_start_time: 1444932097.0
+...
+---
+agent: agent
+input: [www.google.com, meek-reflect.appspot.com]
+requests:
+- request:
+    body: null
+    headers:
+    - - Host
+      - [meek-reflect.appspot.com]
+    method: GET
+    tor: {is_tor: false}
+    url: https://www.google.com
+  response:
+    body: "I\u2019m just a happy little web server.\n"
+    code: 200
+    headers:
+    - - Alternate-Protocol
+      - ['443:quic,p=1']
+    - - Content-Length
+      - ['38']
+    - - Server
+      - [Google Frontend]
+    - - Connection
+      - [close]
+    - - Date
+      - ['Thu, 15 Oct 2015 20:01:38 GMT']
+    - - Alt-Svc
+      - ['quic=":443"; p="1"; ma=604800']
+    - - Content-Type
+      - [text/plain; charset=utf-8]
+socksproxy: null
+success: true
+test_runtime: 0.5862560272216797
+test_start_time: 1444932097.0
+...
+    ...