Blitzz Help Center

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:



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:



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



If you don't have an SSL certificate, you will need to get one. Make sure any SSL certificate you use supports Server Name Indication (SNI) technology.


Note: IP-based SSL certificates are not supported.


Generate CSR


If your certificate provider asks for a CSR file then you can directly generate with any of the following links. You just need to fill up some basic details of your Company like Country, State, City, etc. 


https://ssltools.digicert.com/checker/views/csrGenerate.jsp
https://csrgenerator.com/


Uploading the certificate


After purchasing the SSL certificate, the certificate authority will send you an email or direct you to a page where you can download the certificate. The instructions are often unclear about what files you really need or if you should prepare them before uploading them.


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.

After obtaining or preparing the SSL certificate as a PFX file, upload it to our servers as follows.


  1. In Blitzz, click the Setting icon () in the sidebar, select Settings > Branding, then click the Host Mapping tab at the top of the Security page.
  2. Navigate to Bind your SSL Certificate section to Upload certificate.


  3. Navigate to the PFX file and select it.
  4. Enter your password if any. 
  5. Click Save.

The certificate will be installed on our servers. 








Reviewing the SSL status of a certificate



You can review the SSL status (CNAME check) of your host-mapped, SSL-enabled brands in the Blitzz Support interface.


  1. In Blitzz Support, click the Settings icon (), select Settings > Branding, then click the Host mapping tab. This page displays information about your certificates:


    Note: This view of the SSL page is only displayed if you have a host-mapped, SSL-enabled domain.
  2. Refresh the page to run the SSL status check again.

Replacing a certificate



You can replace a certificate installed on Blitzz Support.


  1. In Blitzz Support, click the Settings icon (), select Settings > Branding, then click the Host mapping tab at the top of the Security page.
  2. Click Remove certificate and follow the steps in Uploading the certificate above.
    Note: This view of the SSL page is only displayed if you have a host-mapped, SSL-enabled domain.

Step 2: White list your new URL 


2.1. Update your custom data storage


This is only applicable if you are using custom storage feature to store your data. After you set up your host mapping, you will need to add the new URL in the CORS policy of your AWS or Azure custom storage. Refer to instructions on custom storage. If Blitzz is hosting all your data, then you don't need to worry about it and we will take care of it automatically.


2.2 Enable deep-linking


Enabling this allows your users to auto-populate the code when they click on the link in SMS invite. This process may take 3-7 business days, however, you will still be able to use all the Blitzz Services during this time.


After you have set up your custom storage, you will need to validate the ownership of your domain. To do so:


  1. Create a support ticket and provide your new URL (blitzz.co/ticket)
  2. Our support team will get back to you with 2 JSON files that will need to be uploaded to your domain's home directory.
  3. Once you have uploaded these files, the last step is for us to re-submit our Apple and Android Apps for approval with your new URL whitelisted. This may take 3-7 business days.

We will let you know as soon as the whitelisting is successfully complete and ready for your testing.









Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.