This function sets the ACL or specific ACL items for a reseller.
NOTE: Calling the XML API function without defining an ACL option will
disable that ACL option (See EXAMPLES for more detail).
reseller (string)
This is the username of the reseller to effect.
acllist (string)
Name of the ACL list. NOTE: Can not be used with specific acl-x-x variables. You must either use a acllist or a set of specific variables.
acl-add-pkg (boolean)
Allow the creation of packages (Use =1 to enable, do not include in the URL string to disable)
acl-add-pkg-ip (boolean)
Allow the creation of packages with dedicated IPs (Use =1 to enable, do not include in the URL string to disable)
acl-add-pkg-shell (boolean)
Allow the creation of packages with shell access (Use =1 to enable, do not include in the URL string to disable)
acl-all (boolean)
All features (Warning: Root Access!) (Use =1 to enable, do not include in the URL string to disable)
acl-allow-addoncreate (boolean)
Allow the creation of packages with unlimited addon domains (Use =1 to enable, do not include in the URL string to disable)
acl-allow-parkedcreate (boolean)
Allow the creation of packages with parked domains (Use =1 to enable, do not include in the URL string to disable)
acl-allow-unlimited-disk-pkgs (boolean)
Allow the creation of packages with unlimited disk space (Use =1 to enable, do not include in the URL string to disable)
acl-allow-unlimited-pkgs (boolean)
Allow the creation of packages with unlimited bandwidth (Use =1 to enable, do not include in the URL string to disable)
acl-clustering (boolean)
Enable Clustering (Use =1 to enable, do not include in the URL string to disable)
acl-create-acct (boolean)
Create a New Account (Use =1 to enable, do not include in the URL string to disable)
acl-create-dns (boolean)
Add DNS Zones (Use =1 to enable, do not include in the URL string to disable)
acl-demo-setup (boolean)
Turn an account into a demo account (Use =1 to enable, do not include in the URL string to disable)
acl-disallow-shell (boolean)
Never allow creation of accounts with shell / ssh access (Use =1 to enable, do not include in the URL string to disable)
acl-edit-account (boolean)
Modify an Account (Use =1 to enable, do not include in the URL string to disable)
acl-edit-dns (boolean)
Edit DNS Zones (Use =1 to enable, do not include in the URL string to disable)
acl-edit-mx (boolean)
Edit MX Entries (Use =1 to enable, do not include in the URL string to disable)
acl-edit-pkg (boolean)
Edit Packages (Use =1 to enable, do not include in the URL string to disable)
acl-frontpage (boolean)
Install / Uninstall FrontPage Extensions (Use =1 to enable, do not include in the URL string to disable)
acl-kill-acct (boolean)
Terminate an Account (Use =1 to enable, do not include in the URL string to disable)
acl-kill-dns (boolean)
Remove DNS Entry (Use =1 to enable, do not include in the URL string to disable)
acl-limit-bandwidth (boolean)
Modify Bandiwdth Limits. WARNING: This will allow the reseller to circumvent package bandiwdth limits if you are not using resource limits! (Use =1 to enable, do not include in the URL string to disable)
acl-list-accts (boolean)
List Accounts (Use =1 to enable, do not include in the URL string to disable)
acl-mailcheck (boolean)
Mail Troubleshooter (Use =1 to enable, do not include in the URL string to disable)
acl-mod-subdomains (boolean)
Enable / Disbale Subdomains (Use =1 to enable, do not include in the URL string to disable)
acl-news (boolean)
Modify cPanel/WHM news (Use =1 to enable, do not include in the URL string to disable)
acl-onlyselfandglobalpkgs (boolean)
Prevent creation of accounts with packages that are not global or not owned by this user (Use =1 to enable, do not include in the URL string to disable)
acl-park-dns (boolean)
Park Domains (Use =1 to enable, do not include in the URL string to disable)
acl-passwd (boolean)
Password Modification (Use =1 to enable, do not include in the URL string to disable)
acl-quota (boolean)
Quota Modification WARNING: This will resellers to circumvent package limits for disk space if you are not using resource limits! (Use =1 to enable, do not include in the URL string to disable)
acl-rearrange-accts (boolean)
Rearrange Accounts (Use =1 to enable, do not include in the URL string to disable)
acl-res-cart (boolean)
Reset Shopping Cart (Use =1 to enable, do not include in the URL string to disable)
acl-resftp (boolean)
Synchronize FTP Passwords (Use =1 to enable, do not include in the URL string to disable)
acl-restart (boolean)
Restart Services (Use =1 to enable, do not include in the URL string to disable)
acl-show-bandwidth (boolean)
View Account Bandwidth Usage (Use =1 to enable, do not include in the URL string to disable)
acl-ssl (boolean)
SSL Manager (Use =1 to enable, do not include in the URL string to disable)
acl-ssl-buy (boolean)
Purchase and Install SSL Certificates (Use =1 to enable, do not include in the URL string to disable)
acl-ssl-gencrt (boolean)
SSL CSR/CRT Generator (Use =1 to enable, do not include in the URL string to disable)
acl-stats (boolean)
View Account Statistics (Use =1 to enable, do not include in the URL string to disable)
acl-status (boolean)
View Server Status (Use =1 to enable, do not include in the URL string to disable)
acl-suspend-accts (boolean)
Suspend accounts (Use =1 to enable, do not include in the URL string to disable)
acl-upgrade-account (boolean)
Account upgrades / downgrades (Use =1 to enable, do not include in the URL string to disable)
setacls
Operation information container
results
Results of the operation container
acls (string)
Name of an ACL that has been set.
statusmsg (string)
Related status / error message
Enabling / Disabling ACL Options
NOTE: If you do not explicitly enable an option when enabling/disabling ACL options, it
will be disabled (even if you do not include that option in the URL string). For example:
Calling this URL in WebHost Manager: xml-api/sectacls?reseller=andy
will disable all ACL options for the reseller "andy"
Calling this URL in WebHost Manager: xml-api/sectacls?reseller=andy&acl-create-acct=1
will enable only the create account ACL option for the reseller "andy"
NOTE: Options that are not explicitly enabled during a call will be disabled.
Using an ACL list
Calling this URL in WebHost Manager:
/xml-api/setacls?reseller=bob&acllist=bob
will produce output similar to:
<setacls>
<result>
<acls>ssl</acls>
<status>1</status>
<statusmsg>Reseller Acls Saved</statusmsg>
</result>
</setacls>
Using specific ACL items
Calling this URL in WebHost Manager:
/xml-api/setacls?reseller=bob&acl-all=1&acl-ssl=1
will produce output similar to:
<result>
<acls>ssl</acls>
<acls>all</acls>
<status>1</status>
<statusmsg>Reseller Acls Saved</statusmsg>
</result>
</setacls>
Copyright 2007 cPanel Inc.