What is the meaning of ^ON$ and ^OFF$ in url rewrite pattern and what matches this pattern

Question

I came across this rule:

<rule name="Redirect to HTTPS" stopProcessing="true">
<match url="(.*)" />
<conditions>
<add input="{HTTPS}" pattern="^OFF$" />
</conditions>
 <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="SeeOther" />
</rule>

what is ON or OFF in pattern and what matches this pattern?

Why `pattern="^OFF$"` and not just `pattern="off"` ? `{https}` can return off or on. so why the regex boundries ? — Royi Namir, Jan 04 '17 at 13:54

score 24 · Accepted Answer · answered Jun 24 '15 at 03:28

24

The pattern OFF is make sure that the rule executes only when the request comes in over http or else you might end up in an infinite loop.

So add a condition stating that {HTTPS} is OFF.

the ^ = (start of string, or "negative" if at the start of a range)

the $ = (end of string)

though the extra start/stop characters seem redundant for this purpose

Here is a blog that discusses inbound rules

answered Jun 24 '15 at 03:28

SteveFerg

3,466
7
19
31

Thanks a lot for your nice answer – Ashkan Mobayen Khiabani Jun 24 '15 at 03:30
1

I have the OFF rule as perscribed in the guide but I still get the "ERR_TOO_MANY_REDIRECTS". Looks like an infinite loop on http/https requests. Do you have any idea why this is happening? I even tried clearing the cookies as some sites suggest but no luck. – Sam Aug 05 '19 at 08:05
Dead link, results in a 404 now – JoshBerke Jul 29 '20 at 13:45

score 0 · Answer 2 · answered Nov 15 '18 at 07:38

input={HTTPS} could provide two input values, either OFF (for NO-HTTPS request) or ON(for an HTTPS request). Hence, to which if the pattern value matches, the rule gets executed. And that is why pattern="OFF" makes sure that the request comes in over http. Accordingly the rule gets executed.

What is the meaning of ^ON$ and ^OFF$ in url rewrite pattern and what matches this pattern

2 Answers2