cPanel & WHM no longer develops or updates EasyApache 3. We deprecated EasyApache 3 on December 31, 2018. We removed support for EasyApache 3 in cPanel & WHM version 78.
Apache Module: AuthnAlias - EasyApache - cPanel Documentation
Page tree
Skip to end of metadata
Go to start of metadata


If you create extended authentication providers in your Apache configuration, the mod_authn_alias Apache module allows you to assign alias names to them. The mod_authn_alias Apache module does not provide authentication, it only provides the functionality to refer to authentication modules with an alias.


If you install the mod_authn_alias Apache module, you can use Apache directives to reference extended authentication providers via alias names. This module also allows you to reference the same extended authentication provider from multiple locations.

Featured documentation

  EasyApache 3


Change Log Release Notes  



Migrate from Tomcat 5.5 to 7

How to Deploy Java Applications


EasyApache 3 does not support new installations of Tomcat.

As of cPanel & WHM version 76, EasyApache 4 now supports Tomcat 8.5. For more information, read our Tomcat documentation.


Front-end Apache authentication module

The mod_authn_alias Apache module requires a front-end Apache authentication module. EasyApache includes the mod_auth_basic front-end Apache module by default.

For information on the mod_auth_basic Apache module, click the following links:

For information on how to enable the alternative Apache front-end authentication module mod_auth_digest, read our Apache Module: AuthDigest documentation. 

Apache 2.2

The mod_authn_alias Apache module is only available for Apache version 2.2. However, the mod_authn_core Apache module for Apache version 2.4 provides the same functionality as the mod_authn_alias Apache module.

If you select the Apache 2.4 option in EasyApache, EasyApache enables the mod_authn_core module and the mod_authn_alias functionality by default.


This module has no known compatibility issues.

How to install or uninstall mod_authn_alias

The EasyApache profiles do not provide the mod_auth_digest Apache module by default.

To install or uninstall the mod_authn_alias Apache module, perform the following steps:

  1. Run EasyApache in WHM's EasyApache 3 interface (Home >> Software >> EasyApache 3).


    • To access EasyApache from the command line interface, run the /scripts/easyapache script as the root user.
    • For more information on EasyApache, read our EasyApache documentation.
  2. Select the profile that you wish to modify.

  3. Click the  icon that corresponds to your selection.


    If you select the Apache 2.4 option in the Apache Version interface, EasyApache will build the functionality of the mod_authn_alias by default.

  4. Click Next Step in the Apache Version stage.
  5. Click Next Step in the PHP Version stage.
  6. Click Exhaustive Options List in the Short Options List stage.

  7. Perform one of the following actions in the Exhaustive Options List stage: 
    • To install the mod_authn_alias Apache module, select the AuthnAlias option.


      If you select this option, EasyApache will add --enable-authn-alias to Apache's build options.

    • To uninstall the mod_authn_alias Apache module, deselect the AuthnAlias option.
  8. Click Save and Build.

How to enable or disable the module in a custom EasyApache profile file

The following table provides information about how EasyApache refers to the mod_authn_alias Apache module: 

EasyApache module namemod_authn_alias
EasyApache Profile EntryApache::optmods::AuthnAlias

To enable or disable the mod_authn_alias Apache module in a custom EasyApache profile file, set the Apache::optmods::AuthnAlias profile entry to one of the following values:

  • 1 - This value enables the module.
  • 0 - This value disables the module.


The following table provides information on changes to the mod_authn_alias Apache module within EasyApache and content changes to this document:

DateEasyApache versionActionDetails
2/11/20143.24.11Doc updateImplemented case 73225: Remove Apache 1.3 and 2.0
1/31/20133.18.0Doc updateImplemented case 51105: Update for Apache 2.4

Related documentation

Apache authentication and authorization

For more information on Apache authentication and authorization, click the following links:

Apache authorization modules

The following table includes the Apache authorization modules that are available in EasyApache:

EasyApache optionEasyApache's documentationApache's documentation
AuthzDBMApache Module: AuthzDBM
AuthnzLDAPApache Module: AuthnzLDAP

Apache authentication modules

The following table includes the Apache authentication modules that are available in EasyApache:

EasyApache optionEasyApache's documentationApache's documentation
AuthnDBDApache Module: AuthnDBD
AuthnAnonApache Module: AuthnAnon


Apache Module: AuthnAlias


The mod_authn_alias Apache module does not provide authentication. It allows you to configure aliases to refer to authentication provider modules.

AuthnDBMApache Module: AuthnDBM
AuthnDefaultApache Module: AuthnDefault
AuthnzLDAPApache Module: AuthnzLDAP