Configuring Business Central Web Server instance - Business Central (2024)

AadApplicationIdSpecifies the application (client) ID assigned to the registered application for Business Central in the Azure Active Directory tenant. This setting is only used for Azure Active Directory authentication in Business Central, version 20.0 and later. The value must match the value of the Valid Audiences setting on the Business Central Server. For more information, see Authenticating Business Central Users with Azure Active DirectoryAadAuthorityUriSpecifies the URI of the Azure Active Directory authority used for Azure Active Directory authentication. This setting is only used for Azure Active Directory authentication in Business Central, version 20.0 and later. The value has the format https://login.microsoftonline.com/<AADTenentID>, where <AADTenentID> is the Azure AD tenant ID. For more information, see Authenticating Business Central Users with Azure Active DirectoryAllowedCrossFrameMessageAncestorsSpecifies the host name of any web domain that is allowed to send messages to iframes hosting Business Central or parts of it. By default, the Business Central web server won't allow messages to be sent to the iframes, unless the website is hosted on the same web server. This condition can affect the browser printing functionality of the product. The value of this setting is a comma-separated list of host names (URIs). Wildcard names are accepted. For example: https://mysite.sharepoint.com, https://*.myportal.com.AllowedFrameAncestorsSpecifies the host name of any web sites in which the Business Central Web client or parts of are embedded. By default, the Business Central Web Server won't allow a website to display it inside an iframe unless the website is hosted on the same web server. This value of this setting is a comma-separated list of host names (URIs). Wildcard names are accepted. For example: https:mysite.sharepoint.com, https:*.myportal.comAllowNtlmSpecifies whether NT LAN Manager (NTLM) fallback is permitted for authentication.

To require Kerberos authentication, set this value to false.

Values: true, false

Default value: true

AuthenticateServerSpecifies whether enable service identity checks on the protocol between the web server and the Business Central Server instance.

Values: true, false
Default value: true

ClientServicesCredentialTypeSpecifies the authorization mechanism that is used to authenticate users who try to connect to the Business Central Web Server. For more information, see Authentication and User Credential Type.

The credential type must match the credential type configured for the Business Central Server instance that the Business Central Web Server connects to. For information about how to set up the credential type on Business Central Server, see Configuring Business Central Server.

Values: Windows, UserName, NavUserPassword, AccessControlService

Default value: Windows

ClientServicesChunkSizeSets the maximum size, in kilobytes, of a data chunk that is transmitted between Business Central Web Server and Business Central Server. Data that's transmitted between Business Central Web Server and Business Central Server is broken down into smaller units called chunks. It's then reassembled when it reaches its destination.

Values: From 4 to 80.

Default value: 28

APPLIES TO: Business Central 2022 release wave 1 (version 20) and earlier.

ClientServicesCompressionThresholdSets the threshold in memory consumption at which Business Central Web Server starts compressing data sets. This setting limits amount of consumed memory. The value is in kilobytes.

Default value: 64

ClientServicesPortSpecifies the TCP port for the Business Central Server. The port is part of the Business Central Server's URL.

Values: 1-65535

Default value: 7085 (7046 in version 20 and earlier)

ClientServicesProtectionLevelSpecifies the security services used to protect the data stream between the Business Central Web Server and Business Central Server. This value must match the value that is specified in the Business Central Server configuration file. For more information, see Configuring Business Central Server.

Values: EncryptAndSign, Sign, None

Default value: EncryptAndSign

APPLIES TO: Business Central 2022 release wave 1 (version 20) and earlier.

DefaultRelativeHelpPathSpecifies the default Help article to open if no other context-sensitive link is specified.

Default value: none

DesignerSpecifies whether the in-client designer is enabled in the Business Central Web client. Set to true to enable designer.

For more information, see Using Designer.

DnsIdentitySpecifies the subject name or common name of the service certificate for Business Central Server.

This parameter is only relevant when security certificates are used on the Business Central Web Server and Business Central Server to protect communication. Note: You can find the subject name by opening the certificate in the Certificates snap-in for Microsoft Management Console (MMC). The MMC is available on the computer that's running Business Central Web Server or Business Central Server.

For more information, see Authentication and User Credential Type.

Value: The subject name of the certificate.

Default value: none

GlobalEndPointsSpecifies the comma-separated list of global endpoints that are allowed to call this website. The values must include http scheme and fully qualified domain name (FDQN), such as https://businesscentral.microsoft.com.

"GlobalEndPoints": "null,ms://businesscentral,ms://dynamicsnav"

Default value: none

HelpServerSpecifies the name of the Business Central Help Server if the deployment uses Help Server. If the deployment uses an online library, remove this setting.

Default value: none

HelpServerPortSpecifies the TCP port on the specified Business Central Help Server if the deployment uses Help Server. If the deployment uses an online library, remove this setting.

Default value: none

LoadScriptsFromCdnSpecifies whether to load scripts from Content Distribution Networks (CDNs). This setting only applies to scripts that are available from a CDN, like jQuery.

If set to false, scripts will be loaded from the web server, which is useful in, for example, an intranet scenario where there's no internet access.
Default value: true

DISCONTINUED AFTER: Business Central Spring 2019

ManagementServicesPortThe listening TCP port for the Business Central management endpoint.

Valid range: 1-65535
Default value: 7045

OfficeSuiteShellServiceClientTimeoutDefines the time Business Central will wait for the Office Suite Shell Service to respond.

Important: This setting has been deprecated in Business Central, and it has no effect on the Web Server instance.

Default value: 10

PersonalizationEnabledSpecifies whether personalization is enabled in the Business Central Web client. Set to true to enable personalization.

For more information, see Managing Personalization.

ProductNameSpecifies the full name of the application.ProductNameShortSpecifies the short name of the application.ProductNameMarketingSpecifies the marketing name of the application.RequireSslSpecifies whether SSL (https) is required. If the value is set to true, all cookies will be marked with a \u0027secure\u0027 attribute. If SSL is enabled on the web server, you should set this setting to true.

Values: true, false
Default value: false

ServerSpecifies the name of the computer that is running the Business Central Server.

Default value: localhost

ServerInstanceSpecifies the name of the Business Central Server instance that the Business Central Web Server connects to.

Default value: BC190

ServerHttpsSpecifies whether https is used over the connection to the Business Central Server instance. If the ClientServicesSSLEnabled setting of the Business Central Server is set to true then ServerHttps must also be set to true.

For more information, see Using Security Certificates with Business Central On-Premises.

Default value: false

ServicePrincipalNameRequiredIf this parameter is set to true, then the Business Central Web Server can only connect to a Business Central Server instance that has been associated with a service principal name (SPN).

If this parameter is set to false, then the Business Central Web Server attempts to connect to the configured Business Central Server service, even if the service isn't associated with an SPN.

For more information about SPNs, see Configure Delegation.

Default: false

SessionTimeoutSpecifies the maximum time that a connection between the Business Central Web Server and the Business Central Server can remain idle before the session is stopped.

In the Business Central Web Server, this setting determines how long an open Business Central page or report can remain inactive before it closes. For example, suppose the SessionTimeout is set to 20 minutes. If a user doesn't take any action on a page within 20 minutes, then the page closes and it's replaced with the following message: The page has expired and the content cannot be displayed.

The time span has the format [dd.]hh:mm:ss[.ff]:

- dd is the number of days
- hh is the number of hours
- mm is the number of minutes
- ss is the number of seconds
- ff is fractions of a second

Default value: 00:20:00

ShowPageSearchSpecifies whether to show the Configuring Business Central Web Server instance - Business Central (1) Tell me what you want to do icon in the Business Central header. This feature lets users find Business Central objects, such as pages, reports, and actions.

If you don't want to show the Tell me what you want to do icon, then set the parameter to false.

Default value: true

UnknownSpnHintSpecifies whether to use a server principal name when establishing the connection between the Business Central Web Server server and Business Central Server. This setting is used to authenticate the Business Central Server, and it prevents the Business Central Web Server server from restarting when it connects to Business Central Server for the first time. You set values that are based on the value of the ServicePrincipalNameRequired key.

Value: The value has the following format.

(net.tcp://BCServer:Port/ServerInstance/Service)=NoSpn|SPN

- BCServer is the name of the computer that is running the Business Central Server.
- Port is the port number on which the Business Central Server is running.
- ServerInstance is the name of the Business Central Server instance.
- NoSpn|SPN specifies whether to use an SPN. If the ServicePrincipalNameRequired key is set to false, then set this value to NoSpn. If the ServicePrincipalNameRequired key is set to true, then set this value to Spn.

Default value: (net.tcp://localhost:7046/BC190/Service)=NoSpn

If you set this key to the incorrect value, then during startup, the Business Central Web Server will automatically determine a correct value. An incorrect value will cause the Business Central Web Server to restart. Note: For most installations, you don't have to change this value. Unlike the Dynamics NAV Client connected to Business Central, this setting isn't updated automatically. If you want to change the default value, then you must change it manually.

APPLIES TO: Business Central 2022 release wave 1 (version 20) and earlier.

UseAdditionalSearchTermsSpecifies whether Tell me uses the other search terms that are defined on pages and reports.

The other search terms are specified by the AdditionalSearchTerms and AdditionalSearchTermsML properties.

If you set this key name to false, the other search terms are ignored.

Default value: true

SaveValueToDatabasePromptlyIf set to true, changes to values in fields are saved to the database as soon as the user moves focus from the field, for example, by pressing Tab. true is the default and recommended setting because it gives users more precise indication of the page's status in the UI.

If set to false, changes aren't saved until the user closes the page by using the back arrow or stops editing by choosing the edit (pencil) button. After making changes to a field and moving focus to the next field, a user will see the status in the upper-right corner of the page change to Saving and then to Saved. This behavior can be misleading because the changes aren't yet saved to the database at this time.

Configuring Business Central Web Server instance - Business Central (2024)

FAQs

How do I create a webserver instance in Business Central? ›

To create a new web server instance, you need access to the WebPublish folder that contains the content files for serving the Business Central Web client. This folder is available on the Business Central installation media (DVD) and has the path 'DVD\WebClient\Business Central\130\Web Client\WebPublish'.

How do I create a new instance of IIS? ›

Go to Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. In the Connections panel, expand your host tree, right-click on Sites, and choose Add Website. Enter the new website's name and choose the location. Enter the Host name.

Where is Business Central administration tool? ›

To install Business Central Server Administration tool, use the Business Central Setup and choose either Server Option or Administration Tool under the custom options page.

What database does Business Central use? ›

An SQL Server or Azure SQL Database database that contains application object definitions and business data.

Can Business Central be on premise? ›

There can be many reasons to prefer to deploy Business Central on-premises rather than using online deployments.

Where are IIS config files? ›

The configuration files for IIS 7 and later are located in your %WinDir%\System32\Inetsrv\Config folder, and the primary configuration files are: ApplicationHost. config - This configuration file stores the settings for all your Web sites and applications.

How do I host a website using IIS domain? ›

In the IIS manager, right click on Sites, click Add Web Site.. and enter the site name, physical path and hostname as www.mywebsite.com, as shown below. This will create a website on the local IIS server. Now, we want to use http://www.mywebsite.com instead of the localhost url.

How do I add a second website to IIS? ›

To add another web site on IIS follow the instructions below:
  1. To start Internet Information Services, select Administrative Tools, select Internet Information Services.
  2. Right click on 'Web Sites' and select 'New', then 'Web Site'.
  3. Key in a name for the web site.
  4. Decide which IP will be used and the port setting.

Top Articles
Latest Posts
Article information

Author: Allyn Kozey

Last Updated:

Views: 6604

Rating: 4.2 / 5 (63 voted)

Reviews: 86% of readers found this page helpful

Author information

Name: Allyn Kozey

Birthday: 1993-12-21

Address: Suite 454 40343 Larson Union, Port Melia, TX 16164

Phone: +2456904400762

Job: Investor Administrator

Hobby: Sketching, Puzzles, Pet, Mountaineering, Skydiving, Dowsing, Sports

Introduction: My name is Allyn Kozey, I am a outstanding, colorful, adventurous, encouraging, zealous, tender, helpful person who loves writing and wants to share my knowledge and understanding with you.