Skip to content

Commit 3a65e4d

Browse files
pedrosousapedrosousa
authored
Firewall - Add reference for raw URI fields (#1669)
1 parent cac9d22 commit 3a65e4d

File tree

1 file changed

+65
-8
lines changed
  • products/firewall/src/content/cf-firewall-language

1 file changed

+65
-8
lines changed

‎products/firewall/src/content/cf-firewall-language/fields.md‎

Lines changed: 65 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ The Cloudflare Firewall Rules language supports these standard fields:
7070
</p>
7171
</td>
7272
</tr>
73-
<tr>
73+
<tr id="field-http-request-full-uri">
7474
<td valign="top"><code>http.request.full_uri</code><br /><Type>String</Type></td>
7575
<td>
7676
<p>Represents the full URI as received by the web server (does not include <code class="InlineCode">#fragment</code>, which is not sent to web servers).
@@ -102,17 +102,17 @@ The Cloudflare Firewall Rules language supports these standard fields:
102102
</p>
103103
</td>
104104
</tr>
105-
<tr>
105+
<tr id="field-http-request-uri">
106106
<td valign="top"><code>http.request.uri</code><br /><Type>String</Type></td>
107107
<td>
108-
<p>Represents the absolute URI of the request.
108+
<p>Represents the URI path and query string of the request.
109109
</p>
110110
<p>Example value:
111111
<br /><code class="InlineCode">/articles/index?section=539061&expand=comments</code>
112112
</p>
113113
</td>
114114
</tr>
115-
<tr>
115+
<tr id="field-http-request-uri-path">
116116
<td valign="top"><code>http.request.uri.path</code><br /><Type>String</Type></td>
117117
<td>
118118
<p>Represents the URI path of the request.
@@ -122,7 +122,7 @@ The Cloudflare Firewall Rules language supports these standard fields:
122122
</p>
123123
</td>
124124
</tr>
125-
<tr>
125+
<tr id="field-http-request-uri-query">
126126
<td valign="top"><code class>http.request.uri.query</code><br /><Type>String</Type></td>
127127
<td>
128128
<p>Represents the entire query string, without the <code class="InlineCode">?</code> delimiter.
@@ -239,6 +239,42 @@ The Cloudflare Firewall Rules language supports these standard fields:
239239
</p>
240240
</td>
241241
</tr>
242+
<tr id="field-raw-http-request-full-uri">
243+
<td valign="top"><code>raw.http.request.full_uri</code><br /><Type>String</Type></td>
244+
<td>
245+
<p>Similar to the <a href="#field-http-request-full-uri"><code>http.request.full_uri</code></a> non-raw field. Represents the full URI as received by the web server without the URI fragment (if any) and without any transformation.
246+
</p>
247+
<p>Note: This raw field may include some basic normalization done by Cloudflare's HTTP server. However, this can change in the future.
248+
</p>
249+
</td>
250+
</tr>
251+
<tr id="field-raw-http-request-uri">
252+
<td valign="top"><code>raw.http.request.uri</code><br /><Type>String</Type></td>
253+
<td>
254+
<p>Similar to the <a href="#field-http-request-uri"><code>http.request.uri</code></a> non-raw field. Represents the URI path and query string of the request without any transformation.
255+
</p>
256+
<p>Note: This raw field may include some basic normalization done by Cloudflare's HTTP server. However, this can change in the future.
257+
</p>
258+
</td>
259+
</tr>
260+
<tr id="field-raw-http-request-uri-path">
261+
<td valign="top"><code>raw.http.request.uri.path</code><br /><Type>String</Type></td>
262+
<td>
263+
<p>Similar to the <a href="#field-http-request-uri-path"><code>http.request.uri.path</code></a> non-raw field. Represents the URI path of the request without any transformation.
264+
</p>
265+
<p>Note: This raw field may include some basic normalization done by Cloudflare's HTTP server. However, this can change in the future.
266+
</p>
267+
</td>
268+
</tr>
269+
<tr id="field-raw-http-request-uri-query">
270+
<td valign="top"><code>raw.http.request.uri.query</code><br /><Type>String</Type></td>
271+
<td>
272+
<p>Similar to the <a href="#field-http-request-uri-query"><code>http.request.uri.query</code></a> non-raw field. Represents the entire query string without the <code class="InlineCode">?</code> delimiter and without any transformation.
273+
</p>
274+
<p>Note: This raw field may include some basic normalization done by Cloudflare's HTTP server. However, this can change in the future.
275+
</p>
276+
</td>
277+
</tr>
242278
<tr>
243279
<td valign="top"><code>ssl</code><br /><Type>Boolean</Type></td>
244280
<td>
@@ -577,7 +613,7 @@ The Cloudflare Firewall Rules language supports these URI argument and value fie
577613
</tr>
578614
</thead>
579615
<tbody>
580-
<tr>
616+
<tr id="field-http-request-uri-args">
581617
<td valign="top"><code>http.request.uri.args</code><br /><Type>Map&lt;String&gt;&lt;Array&gt;</Type></td>
582618
<td>
583619
<p>Represents the HTTP URI arguments associated with a request as a Map (associative array).
@@ -596,7 +632,7 @@ The Cloudflare Firewall Rules language supports these URI argument and value fie
596632
</p>
597633
</td>
598634
</tr>
599-
<tr>
635+
<tr id="field-http-request-uri-args-names">
600636
<td valign="top"><code>http.request.uri.args.names</code><br /><Type>Array&lt;String></Type></td>
601637
<td>
602638
<p>Represents the names of the arguments in the HTTP URI query string. Names are not pre-processed and retain the case used in the request.
@@ -614,7 +650,7 @@ The Cloudflare Firewall Rules language supports these URI argument and value fie
614650
</p>
615651
</td>
616652
</tr>
617-
<tr>
653+
<tr id="field-http-request-uri-args-values">
618654
<td valign="top"><code>http.request.uri.args.values</code><br /><Type>Array&lt;String></Type></td>
619655
<td>
620656
<p>Represents the values of arguments in the HTTP URI query string. Values are not pre-processed and retain the case used in the request. They are in the same order as in the request.
@@ -632,6 +668,27 @@ The Cloudflare Firewall Rules language supports these URI argument and value fie
632668
</p>
633669
</td>
634670
</tr>
671+
<tr id="field-raw-http-request-uri-args">
672+
<td valign="top"><code>raw.http.request.uri.args</code><br /><Type>Map&lt;String&gt;&lt;Array&gt;</Type></td>
673+
<td>
674+
<p>Contains the same field values as <a href="#field-http-request-uri-args"><code>http.request.uri.args</code></a>.
675+
</p>
676+
</td>
677+
</tr>
678+
<tr id="field-raw-http-request-uri-args-names">
679+
<td valign="top"><code>raw.http.request.uri.args.names</code><br /><Type>Array&lt;String></Type></td>
680+
<td>
681+
<p>Contains the same field values as <a href="#field-http-request-uri-args-names"><code>http.request.uri.args.names</code></a>.
682+
</p>
683+
</td>
684+
</tr>
685+
<tr id="field-raw-http-request-uri-args-values">
686+
<td valign="top"><code>raw.http.request.uri.args.values</code><br /><Type>Array&lt;String></Type></td>
687+
<td>
688+
<p>Contains the same field values as <a href="#field-http-request-uri-args-names"><code>http.request.uri.args.values</code></a>.
689+
</p>
690+
</td>
691+
</tr>
635692
</tbody>
636693
</table>
637694

0 commit comments

Comments
 (0)