Host Mapped Domain Enhancements

There are a few enhancements to the host mapped domain feature. A new Host Mapped Domain wizard replaces the Host Mapped Domain dialog, and the wizard includes Default Site functionality for a root domain redirect. Also, Microsoft Azure is the new SSL certificate binding service (replacing Let's Encrypt).

Permission Required?

For this activity, you must have the following permission setting:

For more information about permissions, see Setting User Permissions.

How to Add a Host Mapped Domain

  1. On the left side of the interface, click Sites.

  2. Select the URLs tab.

  3. In the toolbar click .

  4. In the wizard, type the host domain you want to use, and click Validate Domain.

  5. Note If the domain does not validate successfully, make sure the CNAME is set up correctly with the registrar.

  6. Choose an SSL certificate.

    • Use MadCap Generated SSL Certificate You might decide to select the MadCap secure certificate if your company’s IT resources are limited or you are not concerned about using your own certificate.
    • Use Custom SSL Certificate Select this option if your IT department prefers to use its own certificate, instead of MadCap’s. After obtaining the Personal Information Exchange (.pfx) file from your IT department, click Select Your File to find and select it. Then enter the SSL password, and click Next.

      Note Central supports only PFX certificates that require passwords.

    Note It is recommended that you generate only one certificate in a 24-hour time period.

    Note Central uses Microsoft Azure to generate SSL certificates.

  7. Select Bind Domain and SSL Certificate. (This process can take up to 10 minutes.)
  8. When the domain is validated and bound, you can use the wizard to change host mapped domain settings.

    If you click the Change Domain Settings button, that takes you back to the Domain page of the wizard to update and validate a new host mapped domain.

  9. Click the x in the upper-right corner to close the wizard.

How to Add a Default Site

You can select a site to redirect to when the root domain is visited.

  1. On the left side of the interface, click Sites.
  2. Select the URLs tab.
  3. Click next to the domain you want to edit and select Edit.
  4. From the Host Mapped Domain wizard, select Default Site.

  5. From the Default Site drop-down, select a site.

    Note Make sure the site you select is also associated with a custom domain. See Creating Sites.

  6. Click Save.
  7. (Optional) You can quickly see which sites are associated to the host mapped domain by clicking Sites. The wizard lists the sites. If a site is set as the current default site, it is indicated as such by a globe/star icon.

Note In previous releases, visiting a live URL root domain resulted in a "404, page not found" error.

This does not happen anymore. If you set a default site, and you type the root domain into the browser's URL, it redirects to the assigned default site.

URLs Page View

The URLs page view includes a couple of updates to the screen to help you manage your domains better. There are two new columns.

  • Status This column lets you know if the domain is bound or not.

  • Default Site This column indicates which site, if any, has been selected as a default site. (While viewing the URLs page, you might have to scroll to the right to see this column.)