Whitelabel URL Setup

To set up a whitelabel URL, you'll need the following:

  • The domain (that you own/control)
  • An SSL certificate
  • The Key for the SSL Certificate
  • The Root Certificate keychain

The following instructions require some level of IT knowledge as well as access to the domain control panel.

Creating a CSR

To create a CSR, you will need to create both the key and the CSR. On a Unix machine or in Mac OSX's Terminal, you can use the following commands:

  1. Create a key
    openssl genrsa -out <domain_name>.key 2048
  2. Create a csr
    openssl req -new -sha256 -key <domain_name>.key -out <domain_name>.csr

Country Name: The two-letter ISO abbreviation for your country.
State or Province Name: The state or province where your organization is located. Can not be abbreviated.
Locality Name: The city where your organization is located.
Organization Name: The exact legal name of your organization. Do not abbreviate.
Organizational Unit: Optional for additional organizational information.
Common Name (Server Host Name): This is the MOST important. Its the fully qualified domain name you want. You will get a certificate name check warning if this is not an exact match.
Email address: Your email address

Do NOT set a challenge password or "An Optional Company Name"

To get an SSL certificate:

There are lots of providers of certs (RapidSSL, GeoCert, etc.) and they provide tutorials how to do it (for example here is GoDaddy's instructions Recently we have been using They have relatively inexpensive PositiveSSL certificate provided by Comodo for $9/year. See When buying a certificate, the provider will need to verify that you are who you say you are. This is usually done by sending an email to the email address setup in DNS (so you will need to have the domain set up in advance). 

We need three files total. Please name them accordingly:

  • Key - Name Example:
  • Certificate - Name Example: or .pem
  • Root Certificate Keychain - Example: Varies per setup - do not change

 Update DNS:

There are two ways that you can set up the DNS records so that they direct to the site. If you are mapping the root (, please use an A record. If you are using a subdomain (, please use a CNAME. This set up should be done through your DNS provider -- generally the same as where you registered the domain, but could be separate. Here is the information for both types of setups:

To set the root (

Value: (you need a second instance for this ip)
TTL: 3600

If the customer is not mapping the root, for example, then a CNAME is better, like this:

To set a subdomain (

Value: (the Zerista URL for your conference)
TTL: 3600

This should be done using the management console provided by the customer's DNS provider. Often times it will also be the same company as their registrar, but does not have to be.

Please note: It can take up to 48 hours for DNS changes to go live. 


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Powered by Zendesk