Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
ecommerce_-_setting_up_a_custom_storefront_url [2020/02/13 15:35]
tblount
ecommerce_-_setting_up_a_custom_storefront_url [2020/02/25 10:18]
tblount
Line 1: Line 1:
 ====== Creating Custom URLs ====== ====== 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 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.+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 using a Wildcard SSL or a Standard SLL. If you have multiple storefronts, you can mix and match, meaning, one storefront can be configured with a WildcardSSL, and another can be configured with a Standard SLL.
  
-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:+It is important to be aware that there are different SSL requirements for using a Wildcard structure vs a Standard structure when selecting a custom URL for your storefront:
  
-  * **Subdomain**  – You must have wildcard SSL certificate for each distinct top-level domain that is being utilized for the subdomains+  * **Wildcard Certification**  allows you to secure your url and an unlimited number of subdomains under the same branding. For example, Wildcard SSL for *.yourdomain.com can secure: [[http://www.yourdomain.com|www.yourdomain.com]], email.yourdomain.com, store.yourdomain.com, etc. A key advantage of this type of setup is it is easier to manage your settings per site, and you would have one certificate expiration date for all sites connected to the certificate
-  * **Top-Level Only**  – You can use standard SSL +  * **Standard Certification**  allows you to secure a single url. For example, Standard SSL for yourstorefront.com will not allow for subdomains under the certification. 
-Cyrious Software doesn't not sell SSL certificates. You will need to purchase them through your domain/web hosting provider.+Cyrious Software doesn't not sell SSL certificates. You will need to purchase them through your domain/web hosting provider. Cyrious Software applications run on Microsoft IIS based servers. Please make sure you provider supports this configuration before continuing. Apache based SSL certificates cannot be supported.
  
-===== Custom Storefront URL - Subdomain =====+===== New Wildcard SSL Certificate Setup =====
  
-If you're setting up 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.+If you're planning on using Wildcard SSL for an Ecommerce storefront for the first time, 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** **Contact Cyrious Ecommerce Team**
  
-Notify Cyrious Ecommerce Team at [[ecommerce@cyrious.com|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.+Notify Cyrious Ecommerce Team at [[ecommerce@cyrious.com|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:+Please use our example below for the information to include with your request. This is just an example. All information should be updated to your information before being sent to the Cyrious Ecommerce Team.
  
-  * Storefront Id this will be applied to +  * Storefront ID = 1 
-  * Domain Name (including subdomain portion) +  * Certificate Domain Name = *.yourdomain.com 
-  * Organization Name (as it will be listed on the SSL) +  * CNAME Domain Name = store.yourdomain.com 
-  * Organization City (as it will be listed on the SSL) +  * Organization Name = ABC Signs, LLC 
-  * Organization State (as it will be listed on the SSL)+  * Organization City = Baton Rouge 
 +  * Organization State = Louisiana 
 +  * Organization Country = US 
 +  * Type of Certificate: Wildcard 
 + 
 +For the Storefront ID, you will get this ID from your admin panel. Navigate to Storefronts and pull the ID for the correct storefront. For the organization name, city, state and country, please make sure you provide the information you will use to fill it out on the SSL certificate if you haven't already purchase it.
  
 **Create CNAME Record** **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.+For your custom URL to work, you’ll also need to create a CNAME 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.+Common domain hosting providers are GoDaddy.com, HostGator.com, BlueHost.com, and InMotionHosting.com. We recommend you review the documentation specific to your provider as some terminology may be different than what is listed below.
  
   - Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.   - Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.
   - Following your hosting provider's documentation, to configure a new CNAME record with the following information:   - Following your hosting provider's documentation, to configure a new CNAME record with the following information:
-      - Name: Enter in the subdomain you want (most providers will auto-apend your domain, if not, type it manuallyThe full name should look something like this: **storefront.yourdomain.com.**  where **yourdomain.com.**  is your actual top-level domain.+      - Name: Enter in the subdomain you want to use for this CNAME record. Most providers will auto-apend your domain. If not, type it manuallyThe full name should look something like this: **storefront.yourdomain.com**  where **yourdomain.com**  is your actual domain.
       - TTL: 14400       - TTL: 14400
       - Type: CNAME       - Type: CNAME
Line 41: Line 46:
 **Purchase Wildcard SSL ** **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 by the Cyrious Ecommerce TeamIf your SSL provider requires the server type, select the IIS option. Once your certificate has been authenticated, reply to the Cyrious Ecommerce Team and attach the new digital certificate (CRT). When sending the CRT, please make sure the file is sent as a zip file as some email providers block the sending/receiving of these types of files. After Cyrious Ecommerce Team receives the new certificate, we will then activate the certificate for the appropriate 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.
  
-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.+===== Using an Existing Wildcard Certification =====
  
-===== Custom Storefront URL - Additional Subdomain ===== +If you're setting up additional Ecommerce storefronts with subdomains using an Wildcard SSL already configured with Cyrious, you'll need to complete the following steps. If you are using an existing Wildcard SSL not configured with Cyrious, please provide a completed PFX file with a password to our Ecommerce Team.
- +
-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** **Create CNAME Record**
Line 53: Line 56:
 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. 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.+Common domain hosting providers are GoDaddy.com, HostGator.com, BlueHost.com, and InMotionHosting.com. We recommend you review the documentation specific to your provider as some terminology may be different than what is listed below..
  
   - Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.   - Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.
   - Following your hosting provider's documentation, to configure a new CNAME record with the following information:   - Following your hosting provider's documentation, to configure a new CNAME record with the following information:
-      - Name: Enter in the subdomain you want (most providers will auto-apend your domain, if not, type it manuallyThe full name should look something like this: **storefront.yourdomain.com.**  where **yourdomain.com.**  is your actual top-level domain.+      - Name: Enter in the subdomain you want to use for this CNAME record. Most providers will auto-apend your domain. If not, type it manuallyThe full name should look something like this: **myburgershop.yourdomain.com**  where **yourdomain.com**  is your actual domain.
       - TTL: 14400       - TTL: 14400
       - Type: CNAME       - Type: CNAME
Line 65: Line 68:
 **Contact Cyrious Ecommerce Team** **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.+Notify Cyrious Ecommerce Team that you wish to setup another storefront on Wildcard SSL that 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: Include the following information with your request:
  
-  * Storefront Id this will be applied to +  * Storefront ID = 2 
-  * Domain Name (including subdomain portion)+  * Certificate Domain Name = *.yourdomain.com 
 +  * CNAME Domain Name = myburgershop.yourdomain.com
  
-===== Custom Storefront URL - Top-Level Domain Only =====+===== New Standard Certification Setup =====
  
-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.+To use a Standard SSL 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.//+//**NOTE:**  This is only for pointing a single domain to an individual storefront and will NOT work with subdomains.//
  
 **Contact Cyrious Ecommerce Team** **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.+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:+Please use our example below for the information to include with your request. This is just an example. All information should be updated to your information before being sent to the Cyrious Ecommerce Team.
  
-  * Storefront Id this will be applied to +  * Storefront ID = 1 
-  * Domain Name +  * Certificate Domain Name = yourstorefront.com 
-  * Organization Name (as it will be listed on the SSL) +  * Organization Name = ABC Signs, LLC 
-  * Organization City (as it will be listed on the SSL) +  * Organization City = Baton Rouge 
-  * Organization State (as it will be listed on the SSL)+  * Organization State = Louisiana 
 +  * Organization Country = US 
 +  * Type of Certificate: Standard
  
 **Create A & TXT Records** **Create A & TXT Records**
Line 94: Line 100:
 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. 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.+Common domain hosting providers are GoDaddy.com, HostGator.com, BlueHost.com, and InMotionHosting.com. We recommend you review the documentation specific to your provider as some terminology may be different than what is listed below.
  
   - Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.   - Log into your hosting provider and navigate to the section where you can manage your domain's DNS settings.
   - Following your hosting provider's documentation, to configure a new A record with the following information:   - Following your hosting provider's documentation, to configure a new A record with the following information:
-      - Name: Enter in the domain you are setting up. The full name should look something like this: **yourstorefront.com.**+      - Name: Enter in the domain you are setting up. The full name should look something like this: **yourstorefront.com**
       - TTL: 14400       - TTL: 14400
       - Type: A       - Type: A
Line 104: Line 110:
   - Save the entry.   - Save the entry.
   - Following your hosting provider's documentation, to configure a new TXT record with the following information:   - Following your hosting provider's documentation, to configure a new TXT record with the following information:
-      - Name: Enter in the domain you are setting up. The full name should look something like this: **yourstorefront.com.**+      - Name: Enter in the domain you are setting up. The full name should look something like this: **yourstorefront.com**
       - TTL: 14400       - TTL: 14400
       - Type: TXT       - Type: TXT
Line 112: Line 118:
 **Purchase Standard SSL** **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.+Once you've created the A & TXT records, purchase a Standard SSL using the CSR provided provided by the Cyrious Ecommerce Team. If your SSL provider requires the server type, select the IIS option. Once your certificate has been authenticated, reply to the Cyrious Ecommerce Team and attach the new digital certificate (CRT). When sending the CRT, please make sure the file is sent as a zip file as some email providers block the sending/receiving of these types of files. After Cyrious Ecommerce Team receives the new certificate, we will then activate the certificate for the appropriate storefront. 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.
  
 ===== Renewing Your SSL ===== ===== Renewing Your SSL =====
  
-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.+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 to allow enough time for generate and apply any new settings. If your certificate lapses, you will need to use the original Cyrious provide storefront link until your certificate is updated.
  
 **Contact Cyrious Ecommerce Team** **Contact Cyrious Ecommerce Team**
  
-To renew your SSL, notify Cyrious Ecommerce Team at [[ecommerce@cyrious.com|ecommercecyrious.com]] that you need a CSR to renew your SSL (standard or wildcard).+To renew your SSL, notify Cyrious Ecommerce Team at [[ecommerce@cyrious.com|ecommercecyrious.com]] that you need a CSR to renew your SSL.
  
-  * Storefront Id this will be applied to +Wildcard Example
-  * 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**+  Storefront ID = 1 
 +  Certificate Domain Name = *.yourdomain.com 
 +  CNAME Domain Name = store.yourdomain.com 
 +  * Organization Name = ABC Signs, LLC 
 +  * Organization City = Baton Rouge 
 +  * Organization State = Louisiana 
 +  * Organization Country = US 
 +  * Type of Certificate: Wildcard
  
-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.+Standard Example
  
-//**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.//+  Storefront ID = 1 
 +  Certificate Domain Name = yourstorefront.com 
 +  Organization Name = ABC Signs, LLC 
 +  Organization City = Baton Rouge 
 +  * Organization State = Louisiana 
 +  * Organization Country = US 
 +  * Type of Certificate: Standard
  
-Once the updated certificate is correctly configured, your storefront is all set for the duration of the SSL certificate.+**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. Once your certification renewal is complete, please reply to the Cyrious Ecommerce Team and attach the new digital certificate (CRT). When sending the CRT, please make sure the file is sent as a zip file as some email providers block the sending/receiving of these types of files. After the Cyrious Ecommerce Team receives the new certificate, we will then activate the certificate for the appropriate storefront. This process may take up to 5 business days. Once the updated certificate is correctly configured, your storefront is all set for the duration of the SSL certificate. 
 + 
 +//**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.//