BlueDragon Blog
Here you'll find tips and information about making the most of BlueDragon, which offers several compelling implementation alternatives for your CFML applications. This blog was created originally by Charlie Arehart, who was New Atlanta CTO from 2003-2006.,He has since moved on to become an independent consultant but continues to answer comments raised in existing blog entries. BlueDragon continues, and you should look to the newer BlueDragon blog, from New Atlanta president, Vince Bonfanti, for more updated information.

Accessing the BlueDragon Admin outside your localhost

posted Monday, 7 July 2003

Are you interested in accessing your BlueDragon Administrator from outside the machine on which it's installed? Or have you tried to access it (even on a localhost) by way of an integrated web server (like Apache or IIS)? You've then found that it can't be done.

The fact is, these are security precautions that we've set by default. They're discussed in the Admin help pages. But if you can't get into the admin to read that, then it doesn't help much I suppose. :-) So let me explain the situation.

We've set things up by default (for your security) so that the Admin is available only through our built-in web server. By default, that's accessible as port 8080. Even if you do integration with Apache (or IIS, etc.), you can still only access the Admin through the built-in web server. This is preconfigured and can't be changed.

Further, we've set the built-in web server so that it can only be accessible from the localhost. So if you try to connect to it remotely, even with the correct port number for the built-in web server, it still won't work.

The good news is that you CAN change that. Of course, you may want to set it to a limited IP address or range, so as not to expose your BlueDragon Admin too widely. But indeed, if you want to access the Admin remotely, you may well have to change it. (I say "may well" because there are some other alternatives that have been identified using SSH and other tunneling approachs, which I will describe in later blog entries, that may offer a better approach.)

Anyway, to modify the built-in web server to allow other than just localhost access, you have two choices.

  1. If you can access the Admin and want to modify it to allow other IP addresses to access it, note that the "License & Security" link (under "General" in the left nav bar) has a field called "Allowed IP addresses".
  2. If you can't access the Admin, you can instead modify the bluedragon-server.properties file in the config directory where BlueDragon is installed. It has an entry of the same name.

In either case (whether using the Admin or editing the file), the value is set by default to 127.0.0.1. It accepts a comma separated list of IP addresses or ranges using the "*" wildcard (e.g. 192.168.1.*). Again, just be careful about opening it up too broadly. The whole point of restricting it is to help restrict access to the Admin.

Once you change it, be sure to restart BlueDragon.

Of course, changing this may be useful for more than just accessing the Admin, if indeed you chose not to implement web server integration and want to allow others to get into your applications (in addition to the Admin). Just be aware of the security implications when opening it to IPs on more than just your own internal network.

Indeed, a couple more points to keep in mind:

  • If you're just wanting to open the web server to access the Admin from machines other than that on which it's installed but within your own network, you may want to also set your firewall to block access to the BlueDragon built-in web server port (8080 by default) from outside of your network.
  • The admin password will be passed in clear text from your browser to the server. Unfortunately, we don't currently support SSL in our built-in web server. That's on the list to address in BlueDragon 4. For now, again, if you're concerned about security, a better approach is to use SSH or other approaches to tunnel into the machine. I'll document those in another entry.



1. a reader left...
Monday, 14 February 2005 1:16 pm

Doesn't anyone document how to actually "restart" blue dragon?

Kevin Kohrt [product.tester@planetbuilder.com]


2. Charlie Arehart left...
Sunday, 27 February 2005 2:07 pm

Can you explain what you're asking, Kevin? Also, which edition are you referring to? It does matter.

This blog entry is mostly about the Server or Server JX editions. Restarting them is quite straightforward (on windows it's a service, on Linux or OS X it's a daemon).

In the J2EE edition, you'd restart/redeploy the web app using the mechanism/service provided in the J2EE server.

In the .NET edition, there are several ways to restart a web app (again, generic to .NET, not about BD specifically), which are documented in the BD/.NET documentation as of 6.2 RC1.

Hope that helps.


3. a reader left...
Wednesday, 23 March 2005 6:22 pm

I am trying to get bluedragon 6.1 installed on debian & apache 1.3.

I have installed the bluedragon server. Installation went OK - no problem.

How do I know what daemon to look for when I start up bluedragon?

Sue


4. Charlie Arehart left...
Wednesday, 23 March 2005 8:25 pm

Sue, I'd recommend that the interest list would be a much better place to ask this sort of question. I'm afraid I'm not as familiar with the linux daemon details. The list is not hi-volume and is staffed by our engineers and other loyal fans. For more info on signing up, searching the archives, etc, see http://www.newatlanta.com/products/bluedragon/self_help/archive_s earch/index.cfm.