Host mapping - Changing the URL of your Domain

If you’d like to use a different URL, you can create one by setting up a custom domain. You can do so by:

• Step 1: Setting up your custom domain with SSL Certificate
• Step 2: White list your new URL

IMPORTANT: Your migration may need some configuration changes from our side:

1. Reports: Please notify us of the change as we will need to whitelist your URL so you can access the reports.
2. Custom Storage: If you use custom storage (AWS/Azure), you will need to update the CORS settings
3. Mobile App Deeplinking: We will also need to work with you on the mobile app deep-linking if you use the Blitzz fall back app so when your end users click on the SMS link, it launches ShowMe app.

Step 1: Setting up your custom domain with SSL Certificate

Go to Settings  () > Branding

By default, the address of your domain is a Blitzz subdomain, such as "mycompany" in mycompany.blitzz.co. However, you can map a subdomain of your own domain (such as support.mycompany.com) to your default Blitzz address. This feature is called host mapping.

A host-mapped address looks as follows:

support.mycompany.com/j

For example, suppose your company is called Mondo Cameras and the address of your main website is mondocam.com. After the company signs up to Blitzz Support, the initial address of your Domain might be something like mondocam.blitzz.co/j. You can change the Domain's address to a subdomain of your company's domain, such as support.mondocam.com/j. You can't modify your support address to direct to a specific page within your subdomain, such as mondocam.com/community/j.

Keep in mind that the host mapping URL for the agent will be support.mondocam.com.

The workflow for changing the address consists of the following steps:

1. Getting a domain name and subdomain (if you don't already have one)
2. Making the subdomain an alias of your default address
3. Specifying the new address
4. Setting up hosted SSL

Tip: Because of potentially long lead times, consider your SSL options early in the process of setting up your Blitzz Support.

After setting up a host-mapped, SSL-enabled domain, you can perform any of the following management tasks:

• Reviewing the SSL status of a certificate
• Replacing a certificate
• Extending HTTP Strict Transport Security (HSTS) to one year

Getting a domain name and subdomain

If not already done, register a domain name and add a support-related subdomain to it.

Note: Working with domain names and subdomains can be confusing because it's something most of us rarely do. Consult your system administrator, if you have one, before proceeding.

1. Purchase and register a domain name with a domain registrar.
   You can purchase and register a domain name from any domain registrar, including GoDaddy, Yahoo! Domains, Namecheap, 1&1, Netregistry, or Register.com. For instructions, see the Help on the registrar's website. For more information, see How to Register Your Own Domain Name by Christopher Heng on thesitewizard.com.
   For example, if your company is called Mondo Cameras, you might register a domain name called mondocam.com.
2. After registering the domain name, use the registrar's tools to add a support-related subdomain such as "support" or "help" or something along those lines. Example: support.mondocam.com. You'll make the subdomain an alias of your default Blitzz address in the next section.
   

   See the Help on the registrar's website for instructions on adding a subdomain.

Making the subdomain an alias of your default address

The next step is to make your subdomain an alias of your default Blitzz address. An alias is simply an alternate address for a website. For example, you can make the addresses "support.mondocam.com" and "mondocam.blitzz.co" interchangeable as far as web browsers are concerned.

Note: You need to create a CNAME record on your domain registrar's website to create the alias. If you have any concerns, consult your system administrator, if you have one, before proceeding.

To make your subdomain an alias of your default Blitzz address:

1. Sign in to your domain registrar's control panel.
   Use the login name and password that you created when you registered the domain name. If you don't have a domain name and a subdomain yet, see Getting a domain name and a subdomain.
2. Look for the option to change DNS records.
   

   The option might be called something like DNS Management, Name Server Management, or Advanced Settings.

3. Locate the CNAME records for your domain.
   

   A CNAME record, or Canonical Name record, is a type of alias used by the Domain Name System (DNS). Among other things, a CNAME record can be used to make a subdomain an alias of an external website. For more information, see CNAME records on Wikipedia.

4. Do one of the following:

   • If you don't have a CNAME record for your subdomain yet, look for an option to add a new record.
   • If you already have a CNAME record for your subdomain, look for an option to edit the record.
5. Point the CNAME record from your subdomain (shown in the Host Record field in the example below) to your Blitzz subdomain (shown in the Points To field).

The UI and terminology may vary depending on your registrar, but the concepts are the same.

Note: It may take time for changes to the DNS system to be implemented. Typically, it can take anywhere from a few hours to a day, depending on your Time To Live (TTL) settings in the registrar's control panel. In the example above, the TTL is 14,400 seconds, or 4 hours.

Specifying the new address

After making your subdomain an alias of your default Blitzz address, you need to specify the new address in your instance of Blitzz Support. If you omit this step, your new address will point to a Blitzz error page.

1. Click the Settings icon () in the sidebar.
2. Select the Branding tab at the bottom of the page.
3. Click Host Mapping section and enter your subdomain url.
   
   
4. Click Save.

The next step is to set up hosted SSL. See the following section for instructions.

Setting up hosted SSL

SSL (Secure Socket Layer) is an encryption protocol that ensures secure communications with your website.

Important: If you don’t upload a certificate when you use a host-mapped domain, 
all help center traffic will be redirected to your default Blitzz subdomain.

Providing your own SSL certificate

You will need to get and upload your own SNI-based SSL certificate as described in this section.

Getting your own SSL certificate

Note: Blitzz server only supports PFX type file of certificate. 
To convert any type of certificate to PFX format see this link for more details.