IIS and Apache Connectors for ColdFusion 2025

Getting IIS and Apache to talk to ColdFusion properly

You need to configure web server connectors to proxy requests from IIS or Apache to ColdFusion's Tomcat engine. Proper connector configuration is essential for both security and performance.

IIS Configuration

Use the ColdFusion Web Server Configuration Tool to set up the IIS connector. Follow these steps:

  1. Before running the tool, enable these IIS features (Server Manager on Windows Server, or Turn Windows features on or off): ISAPI Extensions, ISAPI Filters, CGI, and ASP.NET
  2. Launch the Web Server Configuration Tool from the ColdFusion program group in your Start menu (or run wsconfig.exe from cf_root/cfusion/runtime/bin)
  3. Click Add, select IIS as the web server, and choose the site (typically All)
  4. Verify that the tool created cf_root/config/wsconfig/1, the jakarta virtual directory, the tomcat ISAPI filter, and the cfm/cfc/cfml handlers

Apache Configuration

For Apache, you should use mod_jk or the supported AJP connector. It is critical to configure the AJP secret for security to prevent unauthorized access:

Configure AJP Secret in server.xml
# cf_root/cfusion/runtime/conf/server.xml (ColdFusion side)
# Use the port already on your AJP/1.3 connector line
<Connector port="8009"
           protocol="AJP/1.3"
           secretRequired="true"
           secret="your-strong-secret-here"
           redirectPort="8443" />

In your Apache configuration file, you must use the same secret value to authenticate the connection:

Configure AJP Secret in Apache
# cf_root/config/wsconfig/1/workers.properties
worker.cfusion.secret=your-strong-secret-here

Security Hardening

You must restrict access to the ColdFusion Administrator and CFIDE directories to prevent unauthorized access. Implement these security measures:

  • Block all public internet access to /CFIDE/administrator/
  • Restrict Administrator access to localhost or VPN connections only
  • Implement IP address allowlisting to limit who can access administrative interfaces
  • Always enable HTTPS for all administrative traffic to prevent credential interception

IIS Example:

IP Restriction for CF Administrator (IIS)
<location path="CFIDE/administrator">
    <system.webServer>
        <security>
            <ipSecurity allowUnlisted="false">
                <add ipAddress="127.0.0.1" allowed="true" />
                <add ipAddress="10.0.0.0" subnetMask="255.255.255.0" allowed="true" />
            </ipSecurity>
        </security>
    </system.webServer>
</location>

Apache Example:

IP Restriction for CF Administrator (Apache)
<Location /CFIDE/administrator>
    Require ip 127.0.0.1
    Require ip 10.0.0.0/24
</Location>

HTTPS Configuration

Always use HTTPS in production environments to protect data in transit. Configure your web server with these security settings:

  • Automatically redirect all HTTP requests to HTTPS to ensure encrypted connections
  • Support only TLS 1.2 or 1.3, disabling older, insecure protocol versions
  • Enable HTTP Strict Transport Security (HSTS) headers to prevent protocol downgrade attacks
  • Configure strong cipher suites and disable weak or deprecated ciphers

Connector Checklist

  • HTTPS only in production
  • AJP secret configured (Apache)
  • IIS features enabled: ISAPI Extensions, ISAPI Filters, CGI, ASP.NET
  • CF Administrator not internet-exposed
  • CFIDE directories restricted
  • TLS 1.0/1.1 disabled
  • HSTS headers enabled

Gotchas

  • Missing AJP secret: Causes connector authentication failures - always set secretRequired="true" and configure matching secrets
  • IIS features: Adobe lists ISAPI Extensions, ISAPI Filters, CGI, and ASP.NET as IIS features to enable before configuring the connector. If sites are added after configuring the connector for All sites, reconfigure the connector
  • Connector updates: May be required after applying ColdFusion hotfixes to maintain compatibility
  • Load balancer timeout: Settings must be configured to exceed your ColdFusion request timeout to avoid premature termination
  • Connector logs: Check the connector logs in {cf_root}/config/wsconfig/ directory when troubleshooting connection issues

Need Help?

Convective can help configure and troubleshoot web server connectors for ColdFusion deployments.

Find out more