ColdFusion CFLocation Only Passes Referrer Of The Referring URL

Posted May 16, 2007 at 3:36 PM by Ben Nadel

Tags: ColdFusion

That sounds really confusing, but it was causing me some headache on a production site today. I was redirecting a user to a given page and then trying to check which page they came from. The CGI.http_referer value kept coming up empty. But how is that possible? Clearly the user was coming from another page!

After a little bit of testing, it seems that CFLocation passes along the CGI.http_referer value of the referring page, NOT the URL of the page with the CFLocation tag on it. Take a look at this test page that I set up (cflocation_referrer.cfm). It is designed to refresh in one of two ways: an actual link or a ColdFusion CFLocation call:

  • <!--- Kill extra output. --->
  • <cfsilent>
  •  
  • <!--- Param URL variables. --->
  • <cfparam
  • name="URL.cflocation"
  • type="string"
  • default="No"
  • />
  •  
  • <cfparam
  • name="URL.relocate"
  • type="boolean"
  • default="false"
  • />
  •  
  •  
  • <!---
  • Check to see if a CFLocaiton call has been requested.
  • If so, we are just going to CFLocate back to self.
  • This will allow us to see what the referrer is seen
  • as by the target page.
  • --->
  • <cfif URL.relocate>
  •  
  • <cflocation
  • url="#CGI.script_name#?cflocation=Yes"
  • addtoken="false"
  • />
  •  
  • </cfif>
  •  
  • </cfsilent>
  •  
  • <cfoutput>
  •  
  • <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  • <html>
  • <head>
  • <title>ColdFusion CFLocation And HTTP Referer</title>
  • </head>
  • <body>
  •  
  • <p>
  • CFLocation: #URL.cflocation#<br />
  • Referrer: #ListFirst(
  • ListLast( CGI.http_referer, "\/" ),
  • "?"
  • )#
  • </p>
  •  
  • <p>
  • <a
  • href="#CGI.script_name#"
  • >Refresh</a>
  •  
  • &nbsp;|&nbsp;
  •  
  • <a
  • href="#CGI.script_name#?relocate=true"
  • >Refresh With CFLocation</a>
  • </p>
  •  
  • </body>
  • </html>
  •  
  • </cfoutput>

Notice that if you click on the first link, the page just links right back to itself. When you do that, the rendered page gives us this output:

CFLocation: No
Referrer: cflocation_referrer.cfm

The other link links back to itself but flags that a CFLocation should be called to forward the user to the next page (which for testing is also the same page). The rendered page gives us this output:

CFLocation: Yes
Referrer: cflocation_referrer.cfm

Notice that CFLocation was used (YES) and a CGI.http_referer value was available. When I saw this, I was like WTF mate? So then I thought maybe the difference was that this was a development server and the other was a production server. I uploaded this file to the production server (Shhhhhh!) and ran it there. Same exact result!

I started to think I was going crazy. What was going wrong in my other code such that the referring URL was being lost. What was different? Then it occurred to me! On the production server, the page that launched the ColdFusion CFLocation tag was being accessed directly by the user. Meaning, they were manually entering the URL that then cause the CFLocation to take them to the next page:

User enters pageA.cfm in browser location
pageA.cfm performs CFLocation to pageB.cfm
pageB.cfm had no CGI.http_referer value

That was a difference I could test by calling my test page manually. If you look at the code above, when I click on the link, the page refreshes and sees that is should perform a CFLocation. The page then refreshes again to take the user to the CFLocation target page. This is two refreshes. To mimic the production server scenario, all I have to do is manually enter the relocate URL. This will only cause one refresh.

So, when I enter:

./cflocation_referrer.cfm?relocate=true

... directly into the URL (thereby circumventing the first refresh), the rendered page gives us this output:

CFLocation: Yes
Referrer:

As you can see, we are sill using the CFLocation (YES), but this time we have NO referring URL value.

So what does this mean? It means that if PageA CFLocates to PageB, PageB can only see PageA's CGI.http_referer value, NOT its own CGI.http_referer value (which should be PageA). This is very strange to me. The way CFLocation works (as far as I know) is that it actually sends a header value back to the client/browser which then launches a new HTTP request to the target URL. In that case, when the browser gets the CFLocation request, it is sending the control from PageA to PageB. Wouldn't this make PageA the referrer of PageB?



Reader Comments

May 16, 2007 at 3:43 PM // reply »
14 Comments

@Ben

Might be worth looking at a javascript solution instead (something along the lines of an onload script that performs a document.url = pageB). I believe that then you would have the expected referrer value (pageB actually came from pageA, even though the user was automatically forced there).


May 16, 2007 at 3:45 PM // reply »
14 Comments

(forgot to add this in my above response)

CFLocation does not send a full page to the browser, it only sends the header with the new location. What this means is that technically, the client might have asked for page A, but in reality they only got a header response pointing them to page B. The actual loading of Page A and then Page B only occurred on the web server. By doing the javascript method that I suggested, the client machine actually loads page A, then gets pushed to go load page B.


May 16, 2007 at 5:03 PM // reply »
168 Comments

@Ben,

Keep in mind that referrer info is controlled by the browser. Hence, it can be switched off or even even intentionally spoofed by the user. Different browsers may also behave differently.

Perhaps the reason for the behavior you are experiencing lies in how browsers interpret HTTP redirect codes (I'm not sure which one cflocation uses). E.g., code 301 ("Moved Permanently") would indicate to me that the behavior you described would actually be wanted by the server (i.e., the page moved, so you don't want the referrer to simply be the old URL).


May 16, 2007 at 5:15 PM // reply »
168 Comments

Hence, the title of this post is erroneous (ColdFusion never passes referrers). ;-)


May 16, 2007 at 5:19 PM // reply »
10,638 Comments

@Rich,

Yeah, a Javascript page would probably handle it fine, just perhaps a slightly longer drag between pages A and B. I understand that at that point (CFLocation) only headers get sent back, but in terms of client-server contact cycle, it feels like a new cycle.

@Steve,

This is a very good point. In fact, I was working with a client the other day who's firewall was stripping out all referrer in formation for each outgoing request. Basically, I agree that CGI information in general cannot be "depended" on (but I still use script_name).

Plus, I see what you are saying about the redirect and "what" the server wants you to see.

All to say, it was just something I never thought of before and I only came across it when I was trying to implement a quick fix... just goes to show you - quick fixes don't pay!


May 16, 2007 at 5:21 PM // reply »
10,638 Comments

... actually I think this is the second title this week that was dead wrong in it meaning :) The first being that XML nodes are passed by value.


May 17, 2007 at 9:09 AM // reply »
95 Comments

Ben,

have you tried using the redirect method in Java? I don't remember the exact syntax but something like getPageContext().forward("url"). Just curious if that might keep the referrer.


May 17, 2007 at 5:56 PM // reply »
10,638 Comments

@Boyan,

I don't know if it will track that way. I will have to give it a shot.


Jun 15, 2008 at 6:36 PM // reply »
1 Comments

So then, since Google appends its search info within the URL (i.e. /search?hl=en&q=coldfusion+cgi+variables). Are we able to grab this search info and place it into a session when someone gets to a site? This would be very important in tracking a user for online marketing purposes. Doing so would allow us to track whether a users completes a desired call to action on website.


May 13, 2011 at 12:36 AM // reply »
1 Comments

This article looks pretty old, but thanks Ben for posting. You saved me hours from trying to solve the same problem. I am trying to control how my pages get shared so I setup certain pages to look at the http_refer to ensure it was coming from designated pages on my site. Some of those designated pages literally were just redirects using CFLOCATION so my code would fail because the final landing page would still think someone was coming from a 3rd party site and not the page (with the CFLOCATION tag) within my own site.


Post A Comment

Comment Etiquette: Please do not post spam. Please keep the comments on-topic. Please do not post unrelated questions or large chunks of code. And, above all, please be nice to each other - we're trying to have a good conversation here.

Please review the following issues:

Author Name:


Author Email:

Author Website:

Comment:

Supported HTML tags for formatting: <strong>bold</strong>   <em>italic</em>   <code>code</code>







  • Help Wanted - Find Your Next ColdFusion Job
InVision App - Prototyping Made Beautiful With Prototyping Tools Ben Nadel's Company - Epicenter Consulting Recent Blog Comments
Feb 3, 2012 at 10:49 PM
How I Got Node.js Running On A Linux Micro Instance Using Amazon EC2
Wow this was really helpful! Only thing I would add is you need to update your .bash_profile after you edit the secure_path. This is what I did: $ . ~/.bash_profile Otherwise, NPM won't be found. ... read »
Feb 3, 2012 at 10:14 PM
Pushing Base64-Encoded Images Over HTML5 WebSockets With Pusher And ColdFusion
@Ben, Just wanted to let you know that pusher are soon to start limiting sizes on messages. This was the detail that came through in the Feb dispatch: "However, we will soon be limiting the s ... read »
Feb 3, 2012 at 5:05 PM
Regular Expressions Make CSV Parsing In ColdFusion So Much Easier (And Faster)
I tried using your RegEx in my C# program, but it was matching an extra empty-string at the end and so I would end up with an extra field that doesn't exist, so I changed it to this: (^|,)("(?: ... read »
Feb 3, 2012 at 3:47 PM
ColdFusion Supports HTTP Verbs PUT And DELETE (As Well As GET And POST)
Josh Cyr posted this on Twitter just a little bit ago. Thought it was appropriate. http://stackoverflow.com/questions/1619152/how-to-create-rest-urls-without-verbs/1619677#1619677 ... read »
Feb 3, 2012 at 2:28 PM
Changing The Execution Context Of Your Self-Executing Function Blocks In JavaScript
@Michael, You definitely make a good point (and extra points for quoting movies - I love movies). When you use a return() statement to define the object's public API, it does provide a consistent a ... read »
Feb 3, 2012 at 2:04 PM
Changing The Execution Context Of Your Self-Executing Function Blocks In JavaScript
To quote Jurassic Park: "Just because you can doesn't mean you should". I completely, utterly disagree with the thought that this is more readable. Consider the current module pattern: if ... read »
Feb 3, 2012 at 1:10 PM
REST API Design Rulebook By Mark Masse
@Jordan, Yeah, WRML was created by Mark Masse (author of the book). I also found it to be a bit convoluted. I suppose it is intended to allow the Client to be able to programmaticaly respond to cha ... read »
Feb 3, 2012 at 1:08 PM
ColdFusion Supports HTTP Verbs PUT And DELETE (As Well As GET And POST)
@Jason, To be honest, I don't have good answers for that kinds of stuff. And, to the point, that is specifically why I *really* liked the REST API Design Rulebook by Mark Masse - he just cuts throu ... read »