Security - Allowed IP Addresses

Control access to ColdFusion Administrator by IP address

Overview

The Allowed IP Addresses security feature provides IP-based access control for the ColdFusion Administrator. By restricting which IP addresses can access the admin interface, you add an essential layer of defense against unauthorized access, even if credentials are compromised.

Adobe documents only an allowed list: you list the addresses that may connect. By default, localhost and all IP addresses can access the server. Adobe documents individual IP addresses and regular expression patterns such as 10.*.*.*. The same page also holds a separate list of client IP addresses allowed to use exposed services (such as cfdocument, cfpdf, and cfmail web services). Source: Administer ColdFusion security.

IP Access Control Settings

Configure which IP addresses can access the ColdFusion Administrator interface.

Allowed IP Addresses

PurposeSpecify IP addresses that are permitted to access the administrator
DefaultEmpty (all IPs allowed)
RecommendationProduction: Allow only trusted IPs (office, VPN, admin workstations)
FormatIndividual IP addresses or wildcard/regular expression patterns
Examples: 192.168.1.100, 172.16.*.*
Warning: Always include your current IP address before saving. If you lock yourself out, you'll need server console access to modify the configuration file directly.
Best Practices:
  • Always include localhost (127.0.0.1) for local administration
  • Use VPN endpoints rather than individual workstation IPs
  • Document which IPs belong to which users/locations
  • Review and update the list when staff changes occur
  • Test access from allowed IPs before removing broader access

Blocking Specific IPs

In the AdministratorAdobe documents only allowed IP lists for this page
Where to deny instead: Put deny rules (known attackers, guest subnets, entire ranges) in your firewall or web server (IIS IP restrictions, Apache Require not ip), in front of ColdFusion.

IP Address Format Examples

Documented formats for specifying allowed IP addresses.

Single IP Address

Format
192.168.1.100
Use Case
Specific workstation or server

Most restrictive - only one specific IP address

Wildcard Pattern

Format
172.16.*.*
Use Case
Entire subnet or network

Regular expressions are supported; test the pattern before relying on it

Localhost

Format
127.0.0.1
Use Case
Local server access only

Always include this for local administration

Multiple Entries

Format
Enter one address or pattern, click Add, and repeat
Use Case
Multiple IPs or patterns

A comma-separated list is documented only for the installer's Secure Profile screen

Configuration Example

Office Network Only

Restrict access to the office network and a VPN endpoint:

Office Network Allow-List Configuration
Allowed IP Addresses (add each entry separately):
127.0.0.1
192.168.1.*
203.0.113.50

Explanation:
- 127.0.0.1         → Local server access
- 192.168.1.*       → Office network
- 203.0.113.50      → VPN endpoint public IP

Result:
Allowed: Office network users can access
Allowed: VPN users can access
Denied: All other IPs

To block particular addresses inside an allowed range (for example, a guest subnet), use firewall or web server rules. The Administrator setting cannot express exceptions.

Emergency Access Recovery

What to do if you lock yourself out of the administrator.

Restore From the Server

Configuration FilesColdFusion keeps its settings in neo-*.xml files under {cf_root}/cfusion/lib. The Administrator allowed IP list is the allowedAdminIPList entry in neo-security.xml, which ships empty (no restriction). Verified in the ColdFusion 2025 Update 14 configuration shipped in Adobe's official Docker image; Adobe's documentation does not name the file.
Access RequiredDirect server access (SSH, RDP, or console)
Steps1. Try the Administrator from a browser on the server itself, if localhost is still allowed
2. Otherwise stop the ColdFusion service
3. Restore the configuration files you backed up before the change
4. Start the ColdFusion service
Important: Back up the neo-*.xml files in cfusion/lib before changing the allowed IP list, so you have something to restore.

Common Issues & Solutions

Locked Out of Administrator

Symptom: Cannot access administrator, getting "Access Denied" or connection refused
Solutions:
  • Verify your current IP address hasn't changed (check whatismyip.com)
  • Check if accessing through proxy/VPN that changes your IP
  • Use direct server console access to reach the Administrator locally or restore backed-up configuration files
  • SSH to server and modify configuration file manually
  • Contact hosting provider if no direct access available

Restrictions Not Working

Symptom: IP restrictions configured but users from IPs not on the list can still access
Solutions:
  • Verify settings saved correctly in administrator
  • Restart ColdFusion service to apply changes
  • Check if users accessing via load balancer (see X-Forwarded-For header)
  • Verify proxy configuration isn't bypassing restrictions
  • Review web server logs for actual connecting IP addresses
  • Consider additional web server level IP restrictions (Apache/IIS)

Dynamic IP Addresses

Symptom: Admin access works sometimes but not others due to changing IP
Solutions:
  • Use VPN with static endpoint IP instead of workstation IP
  • Request static IP from ISP for admin workstations
  • Allow entire ISP subnet range (less secure, not recommended)
  • Use bastion host/jump server with static IP
  • Implement additional authentication layer (2FA, client certificates)

Security Best Practices

Defense in Depth Strategy:
  • Layer 1: Network firewall blocking admin port from internet
  • Layer 2: Web server IP restrictions (Apache/IIS/Nginx)
  • Layer 3: ColdFusion IP whitelist (this setting)
  • Layer 4: Strong administrator passwords and username
  • Layer 5: Multi-factor authentication if available
  • Layer 6: Regular security audits and access reviews
Production Requirements: Never expose ColdFusion Administrator directly to the internet. Use VPN, bastion hosts, or at minimum strict IP whitelisting combined with strong authentication.

Related Resources

Security - Allowed IP Addresses | ColdFusion Administrator | CFGuide