UAPI Functions - ModSecurity::enable_all_domains - Knowledgebase

Description

This function enables ModSecurity™ on a cPanel account's domains.

Examples

cPanel or Webmail Session URL

https://hostname.example.com:2083/cpsess##########/execute/ModSecurity/enable_all_domains

LiveAPI PHP Class

$cpanel = new CPANEL(); // Connect to cPanel - only do this once.

// Enable ModSecurity for all domains.

$enable_all_modsec = $cpanel->uapi(

'ModSecurity', 'enable_all_domains'

);

LiveAPI Perl Module

my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once.

# Enable ModSecurity's for all domains.

my $enable_all_modsec = $cpliveapi->uapi(

'ModSecurity', 'enable_all_domains',

);

 cPanel Template Toolkit

<!-- Get a hash of all the data, then display the enabled values. -->
[% data = execute( 'ModSecurity', 'enable_all_domains' ); %]
[% FOREACH q = data.enabled %]
     <p>
         [% q %]
     </p>
[% END %]
    
<!-- Get only the enabled value. -->
[% execute('ModSecurity', 'enable_all_domains' ).data.enabled %]

Command Line

uapi --user=username ModSecurity enable_all_domains

Notes:

You must URI-encode values.
username represents your account-level username.

 Output (JSON)

{
    "messages": null,
    "errors": null,
    "status": 1,
    "metadata": {
        "transformed": 1
    },
    "data": [
        {
            "domain": "dallas.example.com",
            "dependencies": [
                "dallas.com"
            ],
            "type": "sub",
            "searchhint": "dallas.com",
            "enabled": 0
        },
        {
            "domain": "example.com",
            "dependencies": [
                "arkansas.com",
                "kansas.com",
                "nevada.com",
                "newmexico.com",
                "texas.com"
            ],
            "type": "main",
            "searchhint": "arkansas.com,kansas.com,nevada.com,newmexico.com,texas.com",
            "enabled": 0
        },
        {
            "domain": "galveston.example.com",
            "dependencies": [
                "galveston.com"
            ],
            "type": "sub",
            "searchhint": "galveston.com",
            "enabled": 0
        },
        {
            "domain": "houston.example.com",
            "dependencies": [
                "houston.com"
            ],
            "type": "sub",
            "searchhint": "houston.com",
            "enabled": 0
        },
        {
            "domain": "neworleans.example.com",
            "dependencies": [
                "neworleans.com"
            ],
            "type": "sub",
            "searchhint": "neworleans.com",
            "enabled": 0
        },
        {
            "domain": "sanantonio.example.com",
            "dependencies": [
                "sanantonio.com"
            ],
            "type": "sub",
            "searchhint": "sanantonio.com",
            "enabled": 0
        }
    ]
}

Note:

Use cPanel's API Shell interface (Home >> Advanced >> API Shell) to directly test cPanel API calls.

Parameters

This function does not accept parameters.

Returns

Return	Type	Description	Possible values	Example
domain	string	The domain.	A valid domain on the cPanel account.	example.com
dependencies	array	An array of domains that your changes to a selected domain affect.	An array of valid domains on the cPanel account.	"arkansas.com", "kansas.com", "nevada.com", "newmexico.com", "texas.com"
type	string	The domain type.	main — A main domain. sub — A subdomain.	main
searchhint	string	A list of domain-related search terms.	A comma-separated list of string values.
enabled	Boolean	Whether ModSecurity is enabled on the account.	1 — Enabled. 0 — Disabled.	0

Knowledgebase

Categories

Categories