Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 3.67 KB

configure-web-server-to-accept-host-names-for-tenants.md

File metadata and controls

46 lines (31 loc) · 3.67 KB
Raw
title description ms.custom ms.date ms.reviewer ms.service ms.topic ms.assetid caps.latest.revision author
Web Client Configuration for Tenants
To deploy the Dynamics NAV Web Client in a multitenant development architecture, URLs must specify the tenant ID to access a specific tenant.
bap-template
10/27/2021
jswymer
dynamics-365-op
conceptual
eb87ee8c-be21-4fed-a5f7-2229c4101c61
6
jswymer

Configuring [!INCLUDEwebserver] to Accept Host Names for Tenants

[!INCLUDEazure-ad-to-microsoft-entra-id]

When you deploy the [!INCLUDEwebserver] in a multitenant deployment architecture, URLs that must access a specific tenant must specify the tenant ID. However, the [!INCLUDEnav_web] can be also accessed from URLs that specify a host name. To use host names for tenants, you must enable the corresponding URL rewrite rule in the web.config configuration file for the [!INCLUDEwebserver].

Enable the URL rewrite rule to configure the [!INCLUDEwebserver] to accept host names for tenants

  1. Setting up URL rewrite rules requires that the Microsoft URL Rewrite module is installed in IIS on the computer running the [!INCLUDEwebserver]. If the module isn't installed already, download and install it from Microsoft Supported & Community Downloads for IIS.

    [!TIP] To see whether the URL Rewrite module is installed, open Internet Information Services (IIS Manager). In the Features View, look under the IIS group for URL Rewrite. If you see it, the module's installed.

  2. Open the web.config configuration file that is located in the physical path of the web application for the [!INCLUDEnav_web].

    The path is rootdrive\inetpub\wwwroot\[VirtualDirectoryName]\. For example, the folder for the default [!INCLUDEnav_web] application is C:\inetpub\wwwroot\[!INCLUDEserverinstance]\.

    [!NOTE]
    You must open the web.config file as an administrator or have permission to modify the file.

  3. In the <system.webServer> </system.webServer>element, delete the comments tags <!-- --> before and after the <rewrite> </rewrite> element, if any.

  4. In the <rule name="Hostname (without port) to tenant" enabled="false" stopProcessing="true"> element, change the value of the enabled attribute to true.

  5. Save and close the web.config file.

Host names for the [!INCLUDEwebserver] can now be used. If a tenant's mounted with a host name as an alternative ID, the [!INCLUDEwebserver] will accept a URL that contains this host name to identify the tenant.

If you create a non-tenant specific app for SharePoint that accesses the [!INCLUDEwebserver] by using Microsoft Microsoft Entra ID, the resulting URL includes a parameter that specifies a SharePoint host URL. This parameter represents the URL for opening the [!INCLUDEnav_web] that you've specified in the app manifest. You must enable a URL rewrite rule to accept the URL.

See Also

Multitenant Deployment Architecture
Configuring the Business Central Web Server