Configuring Internet Information Services for Business Central
This topic describes the configuration of Internet Information Service (IIS) that is required for running Business Central. When you install the Business Central Web Server components, you can use the Business Central Setup to install and configure the IIS features, so you do not have to do this manually.
Required IIS Features
IIS must have the following features enabled:
HTTP Activation
NET Extensibility 4.5, .NET Extensibility 4.6, or .NET Extensibility 4.6 (depending on Windows version)
ASP.NET 4.5, ASP.NET 4.6, or ASP.NET 4.7 (depending on Windows version)
ISAPI Extensions
ISAPI Filters
Request Filtering
Windows Authentication
Default Document
Directory Browsing
HTTP Errors
Static Content
Configure Headers in Application Request Routing (ARR) Rules
If you are hosting the Business Central Web Server components on an IIS server farm that is using Application Request Routing (ARR), you must configure headers. Business Central Web Server runs on ASP .NET Core, which requires both an X-Forwarded-For
header and X-Forwarded-Proto
header in ARR routing rules. However, by default, ARR only adds the X-Forwarded-For
header; not the X-Forwarded-Proto
header. So will have to configure the X-Forwarded-Proto
header manually.
On the server farm in IIS, add or edit a routing rule to include a server variable for X-Forwarded-Proto
. For example, using IIS Manager, select Routing Rules > URL Rewrite > Edit > Server Variables, and then add a server variable that has the following settings:
Name | Value | Replace |
---|---|---|
HTTP_X_FORWARDED_PROTO |
http or https |
true |