This is an old revision of the document!


Creating Custom URLs

The Cyrious Ecommerce platform allows customers to request custom URL's for each storefront in addition to using the default URLs that are provided when your system is provisioned. You can configure these as subdomains such as storefront.yourdomain.com or as a top-level domain such as yourstorefrontdomain.com. If you have multiple storefronts, you can mix and match, meaning, one storefront can be configured with a subdomain, and another can be configured with a top-level domain.

It is important to be aware that there are different SSL requirements for using a subdomain structure vs a top-level domain structure when selecting a custom URL for your storefront:

  • Subdomain – You must have a wildcard SSL certificate for each distinct top-level domain that is being utilized for the subdomains.
  • Top-Level Only – You can use a standard SSL

Cyrious Software doesn't not sell SSL certificates. You will need to purchase them through your domain/web hosting provider.

If you're setting up a custom subdomain for an Ecommerce storefront for the first time or for a new subdomain on a different top-level domain, you'll need to complete the following steps. If you are familiar with web hosting, you can provide a completed PFX file with a password to our Ecommerce Team.

Contact Cyrious Ecommerce Team

Notify Cyrious Ecommerce Team at ecommercecyrious.com that you wish to receive a certificate request (CSR) for a wildcard SSL. This may take up to two business days to process.

Include the following information with your request:

  • Storefront Id this will be applied to
  • Domain Name (including subdomain portion)
  • Organization Name (as it will be listed on the SSL)
  • Organization City (as it will be listed on the SSL)
  • Organization State (as it will be listed on the SSL)

Create CNAME Record

For your custom URL to work, you’ll also need to create a CNAME record for the custom subdomain URL you're planning to use. To do this, you’ll need to log into your domain/web hosting provider’s account management site that controls your domain’s DNS records.

Common domain hosting providers are GoDaddy.com, HostGator.com, BlueHost.com, and InMotionHosting.com. We recommend you review the documentation specific to your provider.

  1. Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.
  2. Following your hosting provider's documentation, to configure a new CNAME record with the following information:
    1. Name: Enter in the subdomain you want (most providers will auto-apend your domain, if not, type it manually) The full name should look something like this: storefront.yourdomain.com. where yourdomain.com. is your actual top-level domain.
    2. TTL: 14400
    3. Type: CNAME
    4. Record: znodeenginestorefront.azurewebsites.net
  3. Save the entry.

Purchase Wildcard SSL

IMPORTANT NOTE: YOU MUST PURCHASE A WILDCARD SSL. A STANDARD SSL WILL NOT WORK.

Once you've created the CNAME record, purchase a wildcard SSL using the CSR provided. If your SSL provider requires the server type, select the IIS option. Once you’ve purchased the wildcard SSL, reply to the Cyrious Ecommerce Team and attach the newly purchased certificate (CRT). When sending the CRT, please make sure the file is sent as a zip file. After Cyrious Support receives the new certificate, we will then activate the certificate on your storefront. This process may take up to 5 business days. Once the certificate is correctly configured, you'll be able to use your new subdomain to access the storefront.

If you're setting up an additional Ecommerce storefront with a custom subdomain using a wildcard SSL already configuerd with Cyrious, you'll need to complete the following steps.

Create CNAME Record

For your custom URL to work, you’ll also need to create a CNAME record for the custom subdomain URL you're planning to use. To do this, you’ll need to log into your domain/web hosting provider’s account management site that controls your domain’s DNS records.

Common domain hosting providers are GoDaddy.com, HostGator.com, BlueHost.com, and InMotionHosting.com. We recommend you review the documentation specific to your provider.

  1. Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.
  2. Following your hosting provider's documentation, to configure a new CNAME record with the following information:
    1. Name: Enter in the subdomain you want (most providers will auto-apend your domain, if not, type it manually) The full name should look something like this: storefront.yourdomain.com. where yourdomain.com. is your actual top-level domain.
    2. TTL: 14400
    3. Type: CNAME
    4. Record: znodeenginestorefront.azurewebsites.net
  3. Save the entry.

Contact Cyrious Ecommerce Team

Notify Cyrious Ecommerce Team that you wish to setup a subdomain for a storefront and that the wildcard SSL is already in place from an earlier Ecommerce setup. Also, inform them that the CNAME record has already been setup. This may take up to two business days to process.

Include the following information with your request:

  • Storefront Id this will be applied to
  • Domain Name (including subdomain portion)

To use a custom top-level domain for an Ecommerce storefront, you'll need to complete the following steps. If you are familiar with web hosting, you can provide a completed PFX file with a password to our Ecommerce Team.

NOTE: This is only for pointing a top-level domain to an individual storefront and will NOT work with subdomains.

Contact Cyrious Ecommerce Team

Notify Cyrious Ecommerce Team that you wish to receive a certificate request (CSR) for a standard SSL. This may take up to two business days to process.

Include the following information with your request:

  • Storefront Id this will be applied to
  • Domain Name
  • Organization Name (as it will be listed on the SSL)
  • Organization City (as it will be listed on the SSL)
  • Organization State (as it will be listed on the SSL)

Create A & TXT Records

For your custom URL to work, you’ll also need to create an A record and TXT record for the custom URL you're planning to use. To do this, you’ll need to log into your domain/web hosting provider’s account management site that controls your domain’s DNS records.

Common domain hosting providers are GoDaddy.com, HostGator.com, BlueHost.com, and InMotionHosting.com. We recommend you review the documentation specific to your provider.

  1. Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.
  2. Following your hosting provider's documentation, to configure a new A record with the following information:
    1. Name: Enter in the domain you are setting up. The full name should look something like this: yourstorefront.com.
    2. TTL: 14400
    3. Type: A
    4. Record: 40.86.91.212
  3. Save the entry.
  4. Following your hosting provider's documentation, to configure a new TXT record with the following information:
    1. Name: Enter in the domain you are setting up. The full name should look something like this: yourstorefront.com.
    2. TTL: 14400
    3. Type: TXT
    4. Record: znodeenginestorefront.azurewebsites.net
  5. Save the entry.

Purchase Standard SSL

Once you've created the A & TXT records, purchase a standard SSL using the CSR provided. If your SSL provider requires the server type, select the IIS option. Once you’ve purchased the standard SSL, reply to the Cyrious Ecommerce Team and attach the newly purchased certificate (CRT). After Cyrious Ecommerce Team receives the new certificate, we will then activate the certificate on your account. This process may take up to 5 business days. Once the certificate is correctly configured, you'll be able to use your new domain to access the storefront.

You should monitor the expiration date of your SSL to avoid interruption to your website availability. We STRONGLY recommend you renew your SSL at least 4 weeks prior to its expiration date and preferably earlier.

Contact Cyrious Ecommerce Team

To renew your SSL, notify Cyrious Ecommerce Team at ecommercecyrious.com that you need a CSR to renew your SSL (standard or wildcard).

  • Storefront Id this will be applied to
  • Domain Name (including subdomain portion, if it's a standard SSL)
  • Organization Name (as it will be listed on the SSL)
  • Organization City (as it will be listed on the SSL)
  • Organization State (as it will be listed on the SSL)

Purchase Renewal SSL

Purchase the renewal SSL (standard or wildcard) using the CSR provided to you by the Cyrious Ecommerce Team. If your SSL provider requires the server type, select the IIS option. Reply to the Cyrious Ecommerce Team and attach the newly purchased certificate (CRT). After the Cyrious Ecommerce Team receives the new certificate, we will then activate the certificate on your account. This process may take up to 5 business days.

NOTE: If you want to switch from a Standard to Wildcard SSL or vice versa, you MUST notify Cyrious Ecommerce Team as part of your request to avoid broken storefronts.

Once the updated certificate is correctly configured, your storefront is all set for the duration of the SSL certificate.

You could leave a comment if you were logged in.