Configuration File - ez.conf
Ezeelogin configuration file - ez.conf : Complete guide
Overview: This article explains the Ezeelogin configuration file and provides detailed information about its parameters, usage, and customization options. It helps administrators understand how to modify configuration values to suit their environment. The Ezeelogin configuration file controls how Ezeelogin operates, and administrators can customize it to align with their specific infrastructure and operational requirements.
Refer below example of basic and default Ezeelogin configuration file:
root@gateway ~]# cat /usr/local/etc/ezlogin/ez.conf
cver 2
system_folder /var/www/ezlogin/
www_folder /var/www/html/ezlogin/
uri_path /ezlogin/
force_https yes
db_host localhost
db_port /var/run/mysqld/mysqld.sock
db_name ezlogin_fvzyly
db_user ezlogin_trrwai
db_pass 9DnrC/q87WOkCmXY9RUVlBMoBvMzU/nDR6bYjU0RpQSldgfwIO2hctrdba6WjZjir2Bdkaw8Q/xn7l4UMeFsRA==
db_prefix baz_
cookie_encryption_key 3bGoCfIxOE8q3DZqpjF3mg8WTl4Cq0brDdBmrqhTn/+F2nEtf9ShyZMeXkpWsB1nkszegVAql+3BjCktTq1TCSTsOAFHCFawxPNRYLwWkqw=
cookie_name rzpv
cookie_path /ezlogin/
admin_user ezadmin
mysql_encrypt no
noproxy 1
Explanation of basic configuration file:
| cver | Ezeelogin configuration file version |
| system_folder | Path of system folder files |
| www_folder | Path of web panel files |
| uri_path | Path to access web panel |
| force_https | Force browser to use https by default |
| db_host | Hostname or IP of MySQL to Ezeelogin to connect |
| db_port | Ezeelogin database port or socket |
| db_name | Ezeelogin database name |
| db_user | Ezeelogin database user name |
| db_pass | Encrypted Ezeelogin database user's password |
| db_prefix | Ezeelogin table name prefix |
| cookie_encryption_key | Encryption key for cookies |
| cookie_name | Name for the cookie |
| cookie_path | Path for cookie |
| admin_user | Ezeelogin super admin username |
| mysql_encrypt | Connectivity to MySQL using SSL |
| noproxy | Detect if proxy is available or not |
Customizable parameters in the configuration file:
| system_folder | Path of system folder files |
| www_folder | Path of web panel files |
| uri_path | Path to access web panel |
| force_https | 'yes' to enable and 'no' to disable |
| cookie_path | Path for cookie |
| mysql_encrypt | 'yes' to enable and 'no' to disable |
| noproxy | '1' to enable and '0' to disable |
Additional parameters that can add to ez.conf:
host_url https://mycompany.org
log_level trace
csp_enable = no
cookie_expiration 3600
cookie_match_ip 0
cookie_name mysession #any string, e.g. mysession, default: ezsess
cookie_prefix gw1_ #any string, e.g. gw1_, default: ez_
cookie_domain mycompany.org #e.g. .mycompany.org (for all sub-domains), default: auto detected based on the accessed URL
csrf_protection 1 #0 (disabled) or 1 (enabled), default: 1
csrf_expire 3600
enable_gzip 1
proxy_ips 10.0.1.200,10.0.1.201 #Comma-delimited list of IPs, default: empty
| cookie_expiration | Expiration time for cookies in seconds |
| cookie_match_ip | If using any WAF or cloudflare |
| cookie_name | Name for the session cookie in the web browser |
| cookie_prefix | Sets a prefix in order to avoid collisions |
| cookie_domain | sub/main domain where the session cookie should be valid |
| cookie_path | Path for cookie |
| csrf_protection | Enable/disable cross-site request forgery protection |
| csrf_expire |
Expiry for CSRF tokens in seconds |
| enable_gzip |
Enable compression for the responses from Ezeelogin web panel |
| proxy_ips |
Whitelist the proxy IPs if behind a proxy server |