How to setup IronGate as the ColdFusion Site-Wide Error Handler

If you have administrator access to your server, it is better to have server wide error handler than setting up individual error handlers on each application. It is easy to manage and you do not have to set it up over and over again. IronGate is easy to install as the Site-Wide Error Handler.

Download IrongGate, unzip into your web site and browser to it. It will prompt you to the installation wizard. Complete the installation, it is quite easy, but do not include IronGate.cfm into you Application.cfc/cfm file at the end, we don't need to do that. (IronGate need application.cfm file for it to run, since it uses session variables to manage logins. If you do not have an Application.cfc/cfm file above IronGate/Administrator folder, please create one and set SessionManagment = True.)

Copy (cut) the irongate.cfm file and paste it into ColdFusion website root. If you have a single website in IIS, you can copy it to wwwroot folder. If you have multiple websites, best place to copy this is your CFIDE or CFIDE/Scripts folder, since it mapped into all your websites.


This server has a single site and file copied into the interpub\wwwroot folder


This server has a multiple site and file copied into commonly mapped folder. 

Go to ColdFusion Administrator, Expand the Server Settings tab and go to Settings. Scroll down to the bottom of the page and find Site-wide Error Handler filed. Enter relative path to irongate.cfm file. For example, if the file is in the root of the web directly, it should be \irongate.cfm.

That’s it. Crate an test error in a test page, IronGate should trigger and pass you the error details. 

4 Comments :
Misty
Thursday 22 May 2014 01:28 PM
IPAddress constantly Changes, How this can show the Debug ouput, does not seems to work that way, i enert IP and then i see logs, until i restart my stsem and gets different ip generated and debug does not appear
Friday 23 May 2014 10:12 AM
I agree there is an issue with that. I still could not think of a good way to handle that situation. After all, we have to separate the developer and and normal user without a sign in process. I will think bit more on that. If you have any ideas how to do that, please let me know.
Jenny
Thursday 30 May 2013 01:24 PM
Could you use IronGate if the main site is a mix of ColdFusion and .NET? The issue I've been having is trying to get my IIS 7 to throw a global error page for both app types, and all server errors (like 400, 500, etc.).
Monday 03 June 2013 12:01 PM
No. Not really. IronGate only have access to ColdFusion variables. You can display a single error message using IIS, but if you want the same details IronGate provide, you must have two (or may be more) handlers.