Purpose
This article explains how to serve the ENow Management System (EMS) web site over HTTPS (SSL/TLS). You create a separate IIS site, MailscapeSSL, that points at the same content as the existing Mailscape site and carries the HTTPS binding. Because the HTTPS configuration lives on its own site, upgrading the ENow web server does not overwrite it.
Prerequisites
- An SSL certificate for the name users and ENow Clients will use to reach the web server (for example
<WebServerFQDN>), installed in the web server's local computer certificate store and visible in IIS Manager under Server Certificates. - Local administrator rights on the ENow web server.
- TCP 443 open from ENow Clients, remote probes and admin workstations to the web server. See Network Requirements: Ports, Endpoints and Proxy Configuration.
Step 1: Create the MailscapeSSL site in IIS
- On the ENow web server, open Internet Information Services (IIS) Manager.
- In the left pane, expand the server name, right-click Sites, and select Add Website.
- In Site name, enter
MailscapeSSL. - Next to Application pool, click Select…, choose MailscapeAppPool, and click OK.
- Next to Physical path, click … and select the same folder the Mailscape site uses. On a default installation this is:
C:\inetpub\wwwroot\Mailscape
- Under Binding, change Type to https. The port changes to 443.
- Under SSL certificate, select your certificate from the drop-down, then click OK.
The Sites list now shows MailscapeSSL with an *:443 (https) binding and the same path as the Mailscape site.
Step 2: Convert MailscapeWeb to an application
- In the left pane, expand MailscapeSSL.
- Right-click the MailscapeWeb folder and select Convert to Application.
- In the Add Application window, confirm the application pool is MailscapeAppPool and click OK.
Step 3: Set authentication on MailscapeWeb
- With MailscapeSSL > MailscapeWeb selected in the left pane, double-click Authentication under the IIS section of the center pane.
- Select Windows Authentication and click Enable in the Actions pane.
- Leave Anonymous Authentication enabled. ENow Clients and remote probes need it to communicate with the web server.
- Close IIS Manager.
Step 4: Reset IIS and test locally
- Open PowerShell as administrator and run (this restarts IIS; the ENow web site is briefly unavailable):
iisreset
- On the web server, browse to the new site:
https://<WebServerFQDN>/MailscapeWeb
- If the page does not load locally, or you are repeatedly prompted for credentials, configure the host names Windows will accept for local NTLM authentication. Follow Method 1 in Microsoft's article Error message when you try to access a server locally by using its FQDN or its CNAME alias.
Step 5: Point the ENow Admin Console at the HTTPS site
- After the MailscapeSSL site loads locally, open the ENow Admin Console.
- In ENow Web Server URL, replace the default
http://localhost:20080/MailscapeWebwith your HTTPS URL, for examplehttps://<WebServerFQDN>/MailscapeWeb, and click Connect.
Important: Do not skip this step. It prevents other administrators from connecting the Admin Console to the wrong web site.
Step 6: Point existing ENow Clients at HTTPS
If ENow Clients are already deployed, redirect them to the HTTPS URL.
- On each server running the ENow Client, open the following file in a text editor run as administrator:
C:\Program Files (x86)\ENow\Mailscape Agent\MailscapeAgent.config
- Find line 91, or the line that starts with
http://and contains the web server URL, for example:http://<WebServerFQDN>:20080/MailscapeWeb
- Replace it with the HTTPS URL and save the file:
https://<WebServerFQDN>/MailscapeWeb
Change one client first and confirm it checks in on the dashboard before updating the rest. If many clients need changing, contact support@enowsoftware.com and we will provide a PowerShell script to update them.
Related articles
- Network Requirements: Ports, Endpoints and Proxy Configuration
- Newly installed ENow Client does not appear in the Authorize Servers screen
- Active/Passive ENow Web Servers: Failover Clustering, DFS Replication and Load Balancing
Applies to
ENow Management System 8.x.
Comments
0 comments
Please sign in to leave a comment.