Properties:
Applicable To | MySQL Server |
Server Startup Option | --max_connect_errors=<value> |
Scope | Global |
Dynamic | Yes |
Possible Values | Integer Range: 1 - 4294967295 |
Default Value | 10 |
Category | Security |
Description:
This variable determines how many interrupted connections can occur from a host. If the number of interrupted connections from this host surpasses this number, that host is blocked from further connections. All of the following, as listed here, will cause the counter to be incremented.
- Client program did not call mysql_close() before exiting.
- Client had been sleeping more than wait_timeout or interactive_timeout without issuing any requests to the server.
- Client program ended abruptly in the middle of a data transfer.
- Client doesn't have privileges to connect to a database.
- Client uses incorrect password.
- It takes more than connect_timeout seconds to get a connect packet.
You can always unblock the hosts with a FLUSH HOSTS statement.
Prior to 5.1, any error would just increment the counter for a host. In 5.1, if a host is not yet blocked, any successful handshake resets the counter to 0.
Usage:
It depends on the system admin, how they want to use this variable. For example, If the MySQL server is at a physically distant location from it's clients, one might not want unnecessary network issues to get a host blocked. Otherwise, if the expected client machines are somewhat known, one might not want to invite hackers.
I generally consider a higher value for this variable to be a security threat, as some unfriendly people may use it for a DOS attack. It's better to keep the value low and system admin aware of the hosts being blocked.
Read More:
- MySQL manual entry on max_connect_errors
- Communication Errors and Aborted Connections
- Nice discussion on resetting counter
- Possible feature in future
- Host 'host_name' is blocked error explained
Hope this post was helpful to you. Keep posting your comments.