Static Resource Synchronization

Starting in release 9.0.004.xx, Genesys Co-browse can be used with websites that are fully authenticated, without the need for deploying and configuring intermediate proxy equipment, or without the need for domain whitelisting (that is, no need to configure the allowedExternalDomains option). Synchronizing resources that are placed behind authentication, provides Co-browse with an opportunity to render a web page the same way for both the customer and the agent, enabling them to have a full co-browsing experience.

The synced resources can be images, CSS stylesheets, fonts, and resources from style tags.

Static resources behind authentication that are not synced can result in different page views between the customer and agent during a co-browsing session. For example, a 401 unauthorized error can occur if Co-browse is attempting to load files directly instead of getting them from cache.

If caching fails for a resource, Co-browse will try other ways to sync the resource to the agent-side. These attempts depend on options that are turned on. Which options? configuration options or JS options?

The customer can turn on server-side sync (link to doc - where?), but this will force him to configure proxy,

The customer can turn on browser sync (link to doc- where?) or he can leave only static resource feature - in this case the agent-side will try to get the resource directly. so customer can configure some backup sync mechanism for not cached files or he can leave as is, still there is a backup - to read resource directly.

Configuring static resource synchronization

• The enableStaticResourceService option of the JavaScript Configuration API manages the static resource synchronization. This option is set to false by default. Setting this option to true turns on the feature, and resources will be cached.

• The [redis] cache.ttl configuration option specifies the retention policy for 2-level cache and is used to determine how much time the resource will be stored. This option is set to 1d by default. Note that the retention policy for 1-level cache (local cache) is 30 minutes, and is not configurable.

Important

• The resource is cached even if its location is not included in the allowedExternalDomains configuration option.
• If the resource is not successfully cached, there is an attempt to load it directly from its original location on the agent side. This occurs even if the location is not included in the allowedExternalDomains configuration option.

Limitations

• pseudoHover for cached files is not supported. Hover effects can work improperly for elements whose styles are described in cached CSS files or style tags.

• If a resource for caching is received from a third-party domain, the CORS headers must be correctly set, since the Genesys Co-browse script on the master-side needs to access its content.

• Resources added or updated after a co-browse session has started are not cached and are taken by the slave-side via direct link to the resource or proxied through the Co-browse server.

• Images from <source> tags of the <picture> tag are not cached.

• Resources from style attributes of DOM nodes are not cached and are taken by the slave-side via direct link to the resources.