Security - Administrator
Configure administrator passwords, RDS access, and authentication security
Overview
The Security - Administrator page controls access to the ColdFusion Administrator interface and RDS (Remote Development Services). These settings are critical for protecting your server from unauthorized access and potential security breaches. Proper configuration of administrator passwords, authentication options, and access restrictions is essential for maintaining server security.
Administrator Password Settings
Configure secure passwords for ColdFusion Administrator and RDS access.
Administrator Password
cfusion/lib/password.properties; Adobe recommends restricting access to this file- Production profiles enforce complex passwords; aim for 16+ characters
- Mix of uppercase, lowercase, numbers, and special characters
- Avoid dictionary words and common patterns
- Never reuse passwords from other systems
- Rotate password quarterly or after personnel changes
Confirm Password
RDS Authentication
RDS Password
Authentication Options
Choose how users authenticate to the ColdFusion Administrator.
Authentication Type
Separate user name and password authentication (allows multiple users, managed in User Manager)
Access Control Settings
Configure IP restrictions and access auditing for enhanced security.
Allowed IP Addresses
192.168.1.100Wildcard or regular expression:
192.168.1.*Multiple: Add each entry separately
CIDR notation is not documented, so test every entry
- Limit to VPN IPs, office networks, or bastion hosts
- Test configuration before deploying to production
- Keep backup access method in case of lockout
- This is an allow-list only. Put deny rules in your firewall or web server (IIS IP restrictions, Apache
Require not ip, nginxdeny)
Administrator Audit Log
audit.log (viewable under Debugging & Logging > Log Files)RDS (Remote Development Services)
Remote Development Services provides remote access to ColdFusion server resources. Used by development tools like ColdFusion Builder and Dreamweaver for file browsing, database access, and debugging capabilities.
Enable RDS Service
Development: Enable only if using compatible IDE
RDS Configuration Options
- Never enable RDS in production environments
- Use strong, separate password for RDS
- Restrict RDS access to specific developer IPs
- Always use HTTPS/SSL for RDS connections
- Monitor RDS access logs for unauthorized attempts
Password Security Best Practices
Strong Password Requirements
- Length
- Minimum 16 characters (20+ recommended)
- Complexity
- Mix of uppercase, lowercase, numbers, symbols
- Avoid
- Dictionary words, personal information, patterns
- Unique
- Different from other system passwords
Use a password manager to generate and store complex passwords securely.
Password Management
- Rotation
- Change passwords quarterly or after security events
- Sharing
- Never share passwords between team members
- Storage
- Store in encrypted password manager
- Documentation
- Keep secure backup of credentials in safe location
Change passwords immediately when admins leave the organization.
Password Reset Procedure
- Lost Password
- Can be reset via command line utility
- Command
- cfusion/bin/passwordreset.bat and cfusion/bin/cf-passwordreset.jar (Adobe lists these among files to restrict); on Linux the script is cfusion/bin/passwordreset.sh, which ships in ColdFusion 2025 (verified in Adobe's Update 14 Docker image)
- Process
- Requires server restart after password reset (Source: Adobe: Install ColdFusion (2021 release), Change Administrator password)
- Security
- Restrict access to these files to selected users
Document reset procedure for emergencies and test in development.
Best Practices
Production Environment
- Use strong, unique administrator password (16+ characters)
- Configure allowed IP addresses to limit access
- Disable RDS entirely
- Forward audit.log to a SIEM
- Rotate passwords quarterly
- Monitor audit.log login activity for unauthorized attempts
- Use VPN or bastion host for administrator access
- Use SAML or LDAP external authentication for Administrator users (IDP configuration, SP configuration, and External Authentication in the Security section) so MFA can be enforced at your identity provider
- Restrict administrator access to minimal necessary personnel
Development Environment
- Use strong password even in development
- Enable RDS only if actively using compatible IDE
- Set separate RDS password from administrator password
- Still implement IP restrictions if possible
- Test security configurations before production deployment
Security Hardening
- Hide Administrator URL
- Change default /CFIDE/administrator path
- Web Server Restrictions
- Use web server rules to limit access
- SSL/TLS
- Always access administrator over HTTPS
- Network Segmentation
- Place admin interface on separate network
- Jump Box
- Require access through bastion host
- Monitoring
- Alert on failed login attempts
- Rate Limiting
- Implement login rate limiting
Compliance Considerations
- PCI-DSS
- Requires strong passwords, access logging, IP restrictions
- HIPAA
- Audit trail of administrative access required
- SOC 2
- Password complexity, rotation, and access controls
- GDPR
- Limit access to personal data via administrator
Common Issues and Solutions
Forgotten Administrator Password
- Run the password reset utility in
cfusion/bin(passwordreset.baton Windows,passwordreset.shon Linux, both shipped in ColdFusion 2025) as an administrator and follow its prompts - At the prompt, choose whether to reset the Administrator password or the Admin Component (jetty) password, then enter and confirm the new password
- Restart server after password reset
- Store password securely in password manager to prevent recurrence
Locked Out by IP Restrictions
- From the server itself, check whether localhost is still allowed, or restore a backup of the configuration files in
cfusion/lib - The allowed list is stored in
cfusion/lib/neo-security.xmlunder theallowedAdminIPListkey (an empty string as shipped). Back up the file, empty that value, then restart ColdFusion (key verified in the ColdFusion 2025 Update 14 configuration shipped in Adobe's official Docker image) - Remove IP restrictions temporarily, restart server, reconfigure properly
- Ensure your current IP is in the allowed list
- Prevention: Always add new IP before removing old access
RDS Connection Failures
- Verify RDS is enabled in administrator
- Check RDS password is correct
- Ensure the firewall allows the web server port that serves ColdFusion (RDS uses the
/CFIDE/main/ide.cfmmapping, not a separate port) - Verify SSL certificate if using HTTPS
- Check IP restrictions aren't blocking your IP
Multiple Failed Login Attempts
- Investigate source IP address in logs
- Legitimate causes: User forgotten password, typing errors
- Malicious causes: Brute force attack attempt
- Block suspicious addresses at the firewall or web server
- Prevention: Use IP restrictions, strong passwords, rate limiting
Monitoring and Auditing
Access Log Monitoring
- Log File
- audit.log
- Contents
- Administrator login/logout tracking and update actions
- Review
- Daily review of access logs
- Alerts
- Configure alerts for suspicious activity
- Retention
- Keep logs for compliance period (typically 90+ days)
Suspicious Activity Indicators
- Multiple failed login attempts from same IP
- Login attempts from unexpected geographic locations
- Login attempts outside business hours
- Access from unknown IP addresses
- RDS access in production environment
- Configuration changes by unauthorized users
Security Monitoring Tools
- Log Aggregation
- Splunk, ELK Stack, CloudWatch Logs
- SIEM
- Security Information and Event Management systems
- Alerting
- PagerDuty, OpsGenie for critical events
- Intrusion Detection
- Fail2ban, OSSEC for brute force protection
Advanced Security Configuration
Changing Administrator URL
- Purpose
- Obscure default administrator path
- Default
- /CFIDE/administrator
- Method
- Configure web server alias or use URL rewrite
- Example
- Map /secretadmin to /CFIDE/administrator
- Security
- Reduces automated attacks targeting default path
Security through obscurity - not a substitute for strong password and access controls.
Web Server Access Controls
- Apache
- Use Directory or Location directives with IP restrictions
- IIS
- Configure IP Address and Domain Restrictions
- Nginx
- Use allow/deny directives
Blocks access before reaching ColdFusion for better performance and security.
SSL/TLS Configuration
- Requirement
- Always use HTTPS for administrator access
- Certificate
- Valid SSL certificate (not self-signed in production)
- Protocol
- TLS 1.2 or higher
- HSTS
- Enable HTTP Strict Transport Security
- Redirect
- Automatically redirect HTTP to HTTPS