From: David Carlier <dcarlier@afilias.info>
Date: Fri, 25 Sep 2015 13:06:08 +0000 (+0100)
Subject: DOC: README: DeviceAtlas sample configuration updates
X-Git-Tag: v1.6-dev6~14
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=00d7d61f0c5fa06909f1fea75d87597421141b04;p=thirdparty%2Fhaproxy.git

DOC: README: DeviceAtlas sample configuration updates

Needs to distinguish the convertor and the fetch type samples.
More explanations are made about their specific purposes.
---

diff --git a/README b/README
index 5ebc141550..eb8f139ffc 100644
--- a/README
+++ b/README
@@ -233,8 +233,25 @@ Sample configuration :
     frontend
 	bind *:8881
 	default_backend servers
-	http-request set-header X-DeviceAtlas-Data %[req.fhdr(User-Agent),da-csv(primaryHardwareType,osName,osVersion,browserName,browserVersion)]
 
+There are two distinct methods available, one which leverages all HTTP headers
+and one which uses only a single HTTP header for the detection. The former
+method is highly recommended and more accurate.
+
+
+All HTTP headers
+
+
+      http-request set-header X-DeviceAtlas-Data %[da-csv-fetch(primaryHardwareType,osName,osVersion,browserName,browserVersion)]
+
+
+Single HTTP header (e.g. User-Agent)
+
+
+      http-request set-header X-DeviceAtlas-Data %[req.fhdr(User-Agent),da-csv-conv(primaryHardwareType,osName,osVersion,browserName,browserVersion)]
+
+
+Please find more information about DeviceAtlas and the detection methods at https://deviceatlas.com/resources .
 
 1.2) 51Degrees Device Detection
 -------------------------------