Submit a ticketCall us

Announcing NCM 7.7
With NCM 7.7, you can examine the rules that make up an access control list for a Cisco ASA device. Then you can apply filters to display only rules that meet the specified criteria, order the rules by line number or by the hit count, and much more.
See new features and improvements.

Home > Success Center > Web Help Desk (WHD) > Web Help Desk Administrator Guide > Configure and manage authentication > Enable HTTPS

Enable HTTPS

Created by Steve.Hawkins, last modified by Steve.Hawkins on May 19, 2017

Views: 189 Votes: 0 Revisions: 5

When a browser submits an HTTPS request to Web Help Desk, the SSL protocol requires Web Help Desk to respond with a certificate to prove the authenticity of the server. Begin your security configuration by enabling HTTPS.

Beginning in Web Help Desk 12.5.1, you can enable HTTPS in Server Options located at Setup > General.

To activate HTTPS in Web Help Desk:

  1. Configure the HTTPS listening port to monitor HTTPS requests.
  2. Configure a URL port to monitor URLs generated by Web Help Desk that point back to the application.
  3. Enable Web Help Desk to listen for HTTPS requests.
  4. Enter the SSL connection port (if needed).
  5. Restart Web Help Desk.

Because this procedure requires changes to the whd.conf file, review the following procedures before you enable HTTPS.

Configure the HTTPS listening port

Configure the listening port to listen for HTTPS requests. When you are finished, configure the port number used to monitor the requests.

  1. Open an Explore window.
  2. Navigate to:

    WebHelpDesk/conf/whd.conf

  3. In the whd.conf file locate the Ports section.
  4. Enter the port number Web Help Desk monitors for HTTPS requests, which appears after the following entry:

    HTTPS_PORTS=

  5. Save your changes.
  6. Close the whd.conf file.

Configure a URL port

Your deployment may require Web Help Desk to use a different port in URLs it generates to itself than the port the app server itself is actually running on. For example, you can configure a Web server to route requests for the default port (80) to go to the default Web Help Desk port (8081). In this example, you can have Web Help Desk URLs use port 80 instead of port 8081.

To configure a URL port:

  1. In the whd.conf file, locate the URL Ports (optional) section.
  2. At the bottom of this section, enter the desired URL port number after the following entry:

    URL_HTTPS_PORT=

  3. Save and close the file.

Enable listening for HTTPS requests

  1. In the whd.conf file, locate the HTTPS_PORT entry.
  2. Uncomment the entry.
  3. Save and close the file.

Enter the SSL connection port

By default, Web browsers use port 443 for SSL connections. If you use a different port, include the port number in URLs that refer to Web Help Desk.

For example, if your whd.conf file contains HTTPS_PORT=8443, connect to Web Help Desk using the following URL:

https://localhost:8443

Restart Web Help Desk

After you configure the HTTPS_PORT setting, restart Web Help Desk. The application creates a new Java keystore at the following location:

WebHelpDesk/conf/keystore.jks

The new keystore contains a self-signed certificate.

 
Last modified
07:45, 19 May 2017

Tags

Classifications

Public