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.


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:

Apache versionDocumentation
2.2 Apache Module mod_auth_basic

 Apache Module mod_auth_basic

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