Enterprise Vault™ Configuring Internal and External WebApp URLs for OWA

Last Published:
Product(s): Enterprise Vault (14.1, 14.0, 12.5, 12.4, 12.3, 12.2, 12.1, 12.0, 11.0)

Determining when to use the external URL for Enterprise Vault

The table, Table: External URL settings on the Exchange Server, describes three settings available to refine which users access Enterprise Vault using the external web access URL.

The UseExternalWebAppUrl setting forces all connections to use the configured external URL. If you want to configure some connections to use the external URL and others to use the internal URL, use the ExternalHostNames and/or ExternalIPAddresses settings instead.

Add the required settings to the configuration file on the Exchange Servers. On Exchange Server 2003, these settings are added to the EVBackEnd.ini file. On Exchange Server 2007 and 2010, they are added to the Web.Config file.

The settings are read when the user logs into OWA, so changes to the values take effect when the user next logs into OWA.

Table: External URL settings on the Exchange Server

Setting name in Exchange Server 2007 and 2010

Setting name in Exchange Server 2003

Value

EnterpriseVault_UseExternalWebAppUrl

UseExternalWebAppUrl

The value is a simple Boolean value which defines whether the external URL is to be used or not. If the value is set to "True", then all Enterprise Vault connections are forced to use the configured external URL.

If this value is set, then it overrides the settings below.

EnterpriseVault_ExternalHostNames

ExternalHostNames

The value is a semi-colon delimited list of host names. If the host name used to access OWA is in the list, then the external URL will be used to access Enterprise Vault. For example, if a user accesses OWA outside the corporate network using https://owa.company.com/owa, then owa.company.com could be added to this list.

Enterprise Vault connections from hosts that are not listed in this setting , or from IP addresses that are not listed in the ExternalIPAddresses setting, will use the configured internal URL.

EnterpriseVault_ExternalIPAddresses

ExternalIPAddresses

The value is a semi-colon delimited list of IP addresses. If the IP address of the originator of the request to OWA is on this list, then the external URL will be used to access Enterprise Vault. For example, the IP addresses of the firewall servers could be added to this list.

Enterprise Vault connections from addresses that are not listed in this setting, or from hosts that are not listed in the ExternalHostNames setting, will use the configured internal URL.

Note that when using an Exchange CAS proxy, the originator is the Exchange CAS acting as proxy, not the firewall. In this case, it may be better to specify the host names to trigger the use of the external URL.

The Exchange Server 2003 settings are configured at virtual directory level, so that it is possible to use different settings for different OWA virtual directories. In EVBackEnd.ini the setting can be qualified as follows:

server name.website ID.exchange virt dir name.setting name=value

For example:

Exc01.1.exchange.UseExternalWebAppUrl=true

The settings for Exchange Server 2007 and 2010 are configured in the appSettings section of the Web.Config file. For example:

<add key="EnterpriseVault_UseExternalWebAppUrl" value="true"/>