Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Configure IIS for Windows Server operatings systems or Windows desktop operating systems. Please refer to the Microsoft documentation for this task.

  • You may skip the section on configuring Windows Authentication

  • Please enable the WebSockets Protocol feature

Note

WebSockets Protocol can be absent if desired. It is not sufficient to block WebSockets Protocol on client-side/browser, e.g. per Group Policy. Please ensure in IIS-Manager, that the created IIS Site has the Native Module WebSocketModule not configured.
Tax Balance application will then fallback to Server-sent events (SSE) or Long Polling for some communication scenarios between Browser and Server.

Set or create the following entry in the registry:

Code Block
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\HTTP\Parameters]
"UrlSegmentMaxLength"=dword:00000400

For easy administration, here is also a Powershell script, which adds this registry key :

Code Block
languagepowershell
Set-Location -Path "HKLM:\"
$Path="HKLM:\SYSTEM\CurrentControlSet\services\HTTP\Parameters" 
New-ItemProperty -Path $Path -Name "UrlSegmentMaxLength" -Value 1024 -PropertyType DWord
Set-Location -Path "C:\"


You may want to use the following PowerShell script to perform the installation of the IIS feature.

...

Install-WindowsFeature Web-Server
Install-WindowsFeature Web-WebServer

Install-WindowsFeature Web-Common-Http
Install-WindowsFeature Web-Default-Doc
Install-WindowsFeature Web-Dir-Browsing
Install-WindowsFeature Web-Http-Errors
Install-WindowsFeature Web-Static-Content
Install-WindowsFeature Web-Http-Redirect
 
Install-WindowsFeature Web-Health
Install-WindowsFeature Web-Http-Logging 
  
Install-WindowsFeature Web-Performance
Install-WindowsFeature Web-Stat-Compression
  
Install-WindowsFeature Web-Security
Install-WindowsFeature Web-Filtering
  
Install-WindowsFeature Web-App-Dev
Install-WindowsFeature Web-WebSockets
  
Install-WindowsFeature Web-Mgmt-Tools
Install-WindowsFeature Web-Mgmt-Console

Get-Website | Remove-Website
Get-ChildItem 
Install-WindowsFeature NET-Framework-45-Features Install-WindowsFeature NET-WCF-Services45 Install-WindowsFeature NET-WCF-TCP-PortSharing45
-Path IIS:\AppPools\ | ForEach-Object { Remove-WebAppPool $_.Name } 
Code Block
languagepowershell
themeRDark

Firewall Clearing

Maybe the Windows defender Firewall needs an additional clearing for the port 8443 (our standard for TaxTransferDE) and TLS:

Code Block
languagepowershell
New-NetFirewallRule -DisplayName "GTC Suite-8443-443" -Direction Inbound -LocalPort 8443,443 -Protocol TCP -Action Allow

Install .NET Core Hosting Bundle

The corresponding runtime must be available on the host system. Download the current See Installation requirements to determine whether the installation of the .NET Core Hosting Bundle is required. Tax Balance Version 24.0.95 and later does not require installing the .NET Core Hosting Bundle. For older versions download the hosting bundle of ASP.NET Core Runtime 6.0 on this page.

...

Open the Advanced Settings and set Behavior > Limits > Maximum Url Segments to 32.

Note

Tax Balance works exclusively with HTTPS. Create a valid HTTPS binding with a matching valid certificate.

Learn more