Knowledgebase

Introduction

Plugin developers and server administrators can add custom ACLs. Custom ACLs can display in WHM's  Edit Reseller Nameservers and Privileges  interface (Home >> Resellers >> Edit Reseller Nameservers and Privileges).

Add a custom ACL

To create a custom ACL, perform the following steps:

1. Create a namespace for the new ACL. The examples below use the ExampleACL namespace.
2. Create a new directory in the /usr/local/cpanel/Cpanel/Config/ConfigObj/Driver directory. 
   • The new directory's name must match the namespace.
   • For example, the /usr/local/cpanel/Cpanel/Config/ConfigObj/Driver/ExampleACL directory.
3. Create the ACL object Perl module in the /usr/local/cpanel/Cpanel/Config/ConfigObj/Driver directory.
   • The new module file's name must match the namespace.
   • For example, the /usr/local/cpanel/Cpanel/Config/ConfigObj/Driver/ExampleACL.pm file.
   • This module configures the ACL's namespace and sets the ACL's defaults and display settings for the WHM interface.
4. Create the ACL metadata Perl module in the namespace's directory.
   • The metadata module must be the META.pm file.
   • For example, the /usr/local/cpanel/Cpanel/Config/ConfigObj/Driver/ExampleACL/META.pm file.