Custom Domain - troubleshooting errors in cookie-restricted browsers

Custom Domain - troubleshooting errors in cookie-restricted browsers


While using the Custom Domain feature in Zoho Connect, you may encounter a few challenges  in user actions, such as accessing files and custom apps and uploading, downloading, or previewing attachments. Zoho Connect uses different domain addresses to perform the above-listed actions (for faster response) and since they differ from your organization's domain name, they'll be treated as a third-party apps by your browser.  

Since domains are different for custom domain enabled networks, the actions mentioned above will not work if third-party cookies are blocked. This is due to the limitations in the web browser.  

If you happen to face any difficulty while accessing files and custom apps , we suggest you follow the steps below to resolve them:

Step 1: Provide access to your custom domain using your Zoho Account  
  1. When the members log in to their Zoho Connect account for the first time via the newly configured custom URL, this page will appear.   
             
  1. Select the "Trust this website" checkbox, and click GRANT ACCESS to use your Zoho Connect account through the custom domain. By performing this step, you'll also be providing access to the other domains used by Zoho Connect to perform upload, download, and preview actions. This one-time action will help with a better and more consistent user experience. 
Step 2: Enable third-party cookies to your custom domain
  
Add your Zoho Connect's custom domain URL to the Always use Cookies section of your browser's settings. This prevents the blocking of other domains used within Zoho Connect as they are primarily considered third-party apps.  Here's how you can do this with a few popular browsers:
 
1. Google Chrome
  • Open a Google Chrome browser.
  • Click the three vertical dots in the top-right corner of your browser.
  • From the menu, select Settings.
  • From the left part of the Settings tab, select Privacy and Security, then Site Settings.
  • In the Site Settings page, scroll down to the Content section.
  • Select Cookies and site data.
      
  • On the Cookies and site data page, click the Add next to Sites that can always use cookies.
  • In the Add a site text box, enter your custom domain (for example connect.zylker.com'), select Including third-party cookies on this site option and click Add.
      
 
 
2. Mozilla Firefox Browser
  • Open a Mozilla Firefox browser.
  • Click the three vertical dots in the top-right corner of the browser, and select Preferences.
  • From the left part of the Settings tab, select Privacy and Security.
  • Choose the Custom option.
  • Deselect "Cookies" checkbox.
           
  • Click Reload All Tabs. 
3. Safari Browser
  1. Open a Safari browser.
  2. Click Safari from the top menu.
           
  1. From the dropdown, select Preferences.
  2. Switch to the Privacy tab.
  3. Deselect the Block all Cookies and Prevent cross-site tracking checkboxes.
      
4. Microsoft Edge Browser
  1. Open Microsoft Edge Browser.
  2. Click the ellipsis in the top-right corner of the browser.
  3. From the menu, select Settings.
           
  1. From the left section of the Settings page, select "Cookies and site permissions" and click Manage.
  2. Delete cookies and site data.
  3. On the Cookies and site data page, scroll down to the Allow section, select "Including third-party cookies on this site" checkbox, and click Add.
            

  1. Enter your custom domain and click Add.
 
FAQ
  
1. Why is it necessary to enable third-party cookies?

Let's take the example of a custom domain named connect.zylker.com. When you try to upload a file within this page, another API call is triggered with the domain upload.zoho.com . This domain is not same as the custom domain you currently use, so the browser treats upload.zoho.com as a third-party domain, and blocks it. Therefore, it is necessary to enable third-party cookies to prevent this type of limitation.  

2. What is the purpose of upload.zoho.com in Zoho Connect?
  
For a faster and enhanced upload experience, we are using different domains based on the requirement. For upload, we use upload.zoho.com.
 
3. How do custom domains work?
  
When you access the custom domain connect.zylker.com, we will add the necessary details in the cookies in both connect.zylker.com & *.zoho.com domain.
 
4. What is a browser third-party cookie policy?
  
All major browsers block third-party cookies by default in their latest versions. Once it is enabled, cookies will not be added when we access upload.zoho.com within connect.zylker.com. Our server will throw an unauthorized error, because user cookies were not added in the request.
 
5. Why does this only happen when a custom domain is configured?

Without a custom domain, Zoho Connect uses the domain connect.zoho.com, and upload requests are triggered in upload.zoho.com. Since both the domains belong to zoho.com, the browser does not block cookies.

 

If you need more help with managing custom domains, reach out to us at support@zohoconnect.com.