Page tree
Skip to end of metadata
Go to start of metadata

Overview

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.

Usage

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.


Warning:


cPanel & WHM no longer develops EasyApache 3 and only releases security updates for it. We will deprecate EasyApache 3 on December 31, 2018. After that date, we will no longer update EasyApache 3. In cPanel & WHM version 78, we will remove support for EasyApache 3. For more information, read our cPanel Long-Term Support documentation.

We strongly recommend that you upgrade to EasyApache 4. For more information, read our EasyApache 4 documentation.

Featured documentation

  EasyApache 3

IntroductionFAQ

Change Log Release Notes  

ProfilesCustomization

Tomcat

Migrate from Tomcat 5.5 to 7

How to Deploy Java Applications

Important:

EasyApache 3 does not support Tomcat for new installations. EasyApache 4 does not support Tomcat and we do not plan to provide support in the future. 

Requirements

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.

Compatibility

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).

    Notes:

    • 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.

    Note:

    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.

      Note:

      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.

History

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
AuthzOwner 
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

AuthnAlias

Apache Module: AuthnAlias

Note:

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