WHM API.
Download OpenAPI description
Overview
URL
WebPros International, LLC
License
Languages
Servers
Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/
A server running WHM.
https://{host}:{port}/json-api/
- Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/enable_cphulk
- A server running WHM.
https://whm-server.tld:2087/json-api/enable_cphulk
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/enable_cphulkResponse
application/json
{ "metadata": { "command": "enable_cphulk", "reason": "OK", "result": 1, "version": 1 } }
- Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/load_cphulk_config
- A server running WHM.
https://whm-server.tld:2087/json-api/load_cphulk_config
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/load_cphulk_configResponse
application/json
{ "data": { "cphulk_config": { … } }, "metadata": { "command": "load_cphulk_config", "reason": "OK", "result": 1, "version": 1 } }
Query
Whether to use the server firewall to block brute force attacks.
1— Use the firewall.0— Do not use the firewall.
Default 0
Enum01
Example: block_brute_force_with_firewall=0
Whether to use the server firewall to block excessive brute force attacks.
1— Use the firewall.0— Do not use the firewall.
Default 0
Enum01
Example: block_excessive_brute_force_with_firewall=0
The number of minutes over which cPHulk measures all login attempts to a specific user's account.
Default 5
Example: brute_force_period_mins=5
The command to run when an IP address triggers brute force protection.
Note:
For a list of commands, read the Command variables section of our cPHulk Brute Force Protection documentation.
Default ""
Example: command_to_run_on_brute_force=
The command to run when the system blocks an IP address for a one day period.
Note:
For a list of commands, read the Command variables section of our cPHulk Brute Force Protection documentation.
Default ""
Example: command_to_run_on_excessive_brute_force=
Whether to enable IP address-based protection on all requests.
1— Enable IP-based protection.0— Disable IP-based protection.
Note:
If you set this parameter to 0, you cannot use the following parameters:
block_brute_force_with_firewallblock_excessive_brute_force_with_firewallip_brute_force_period_mins
Default 1
Enum01
Example: ip_based_protection=1
The number of minutes in which cPHulk measures an attacker's login attempts.
Default 15
Example: ip_brute_force_period_mins=15
The number of minutes over which cPHulk counts failed logins against a user.
Default 360
Example: lookback_period_min=360
The maximum number of failures from a specific IP address before cPHulk blocks that address for a two-week period.
Default 30
Example: mark_as_brute=30
The maximum number of failures that cPHulk allows per account within the defined time range.
Default 30
Example: max_failures=30
The maximum number of failures from a specific IP address before cPHulk locks out that address.
Default 5
Example: max_failures_byip=5
Whether cPHulk will send a notification when it detects a brute force attack.
1— Send the notification.0— Do not send the notification.
Default 0
Enum01
Example: notify_on_brute=0
Whether cPHulk will send a notification when the root user successfully logs in from an IP address that is not on the whitelist.
1— Send the notification.0— Do not send the notification.
Default 0
Enum01
Example: notify_on_root_login=0
Whether cPHulk sends a notification upon successful root login when the IP address is not on the whitelist, but from a known netblock.
1— Send the notification.0— Do not send the notification.
Default 0
Enum01
Example: notify_on_root_login_for_known_netblock=0
Whether to skip checking if cPHulk runs on the server.
1— Don't check cPHulk's status.0— Check cPHulk's status.
Note:
If cPHulk is disabled, the function returns the following message: cPHulk is disabled on the server.
Default 0
Enum01
Example: skip_enabled_check=0
Whether to enable username-based protection on all requests.
1— Enable.0— Disable.
Default 0
Enum01
Example: username_based_protection=0
Whether to allow username-based protection to lock out the root user.
1— Allow.0— Do not allow.
Default 0
Enum01
Example: username_based_protection_for_root=0
- Mock server
https://api.docs.cpanel.net/_mock/specifications/whm.openapi/save_cphulk_config
- A server running WHM.
https://whm-server.tld:2087/json-api/save_cphulk_config
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/save_cphulk_config?block_brute_force_with_firewall=0&block_excessive_brute_force_with_firewall=0&brute_force_period_mins=5&ip_based_protection=1&ip_brute_force_period_mins=15&lookback_period_min=360&mark_as_brute=30&max_failures=30&max_failures_byip=5¬ify_on_brute=0¬ify_on_root_login=0¬ify_on_root_login_for_known_netblock=0&skip_enabled_check=0&username_based_protection=0&username_based_protection_for_root=0&username_based_protection_local_origin=1'Response
application/json
{ "data": { "cphulk_config": { … }, "restart_ssh": 1, "warning": null }, "metadata": { "command": "save_cphulk_config", "reason": "OK", "result": 1, "version": 1 } }