By default, CAREWare 6 uses its own lightweight CAREWare HTTP Server to handle communication between the Client and Business Tiers. This configuration works for most use cases, however in some cases an organization already has standardized TLS certificate management on IIS or other reasons and wishes to use IIS.
Follow these instructions to set up IIS to forward traffic to the CAREWare HTTP Server
- Install the latest versions of the CAREWare HTTP Server and Business Tier using the installers available from the links here.
- Verify the connection to CAREWare locally on the server works connecting to http://localhost:8080/careware/rs/index.htm in a browser window.
Note: If the connection to CAREWare works from that page, then proceed with setting up CAREWare to work with IIS. Ensure that firewall rules block any incoming connections on port 8080 and that it is only possible to connect to this port via local host on the server itself.
- .Install IIS using the method appropriate for your operating system. In Windows Server, the Server Manager can be used to install IIS.
- Install the URL Rewrite module for IIS, available here.
- Open IIS Manager.
- Right click Sites.
- Click Add Website.
- Enter the Site name
- Under Binding select HTTPS for the type.
- Enter the Host name.
- Click OK.
- Click the site.
- Double click Output Caching.
- Click Edit Feature Settings.
- Uncheck Enable cache.
- Check Enable kernel cache.
- Click OK.
- Right click the website added.
- Click Add Application.
- Enter 'careware' as the Alias.
- Click the ellipsis to browse to the CwProxy folder to select the Physical path.
Note: If the folder cw_proxy doesn’t exist add it and then select that path.
Note: It is important that the Alias is set to careware; otherwise the proxy only works for CAREWare with that alias.
- Click OK.
- Click the application.
- Double click URL Rewrite.
- Click Add Rule(s) from the right-side menu.
- Click Reverse Proxy.
- Click OK.
- Under Inbound Rules, enter localhost:8080/careware.
- Check Enable SSL Offloading.
- Uncheck Rewrite the domain names of the links in HTTP responses is not selected.
- Click OK.
At this point, the connection to CAREWare has been established using the new site created in IIS. From a machine other than server CAREWare is installed on, navigate to the internet facing address that is handled by the IIS server and confirm the connection to CAREWare works. The address should be something like https://www.yoursite.com/careware/rs/index.htm. If the connection works, then IIS has been successfully set up as a reverse proxy for CAREWare.