How to set the cookie domain in such a way that an existing unblu session can remain active after navigating to a sub-domain
I would like to configure a cookie domain for the unblu application in such a way that an existing unblu session can remain active when a visitor navigates to a sub-domain.
Unblu supports sub-domain switching. This means a session can remain active if there is a navigation to another sub-domain. This requires a definition of a cookie domain in the unblu server configuration file (unblu.properties).
The following property should be used to define a cookie domain:
A cookie domain can be set in one of the following ways; depending on the requirement/use-case (valid for unblu 3.5.x and all new versions):
- If no sub-domain-switch is required: then no cookie domain needs to be defined. In this way unblu uses the current context origin as the cookie domain. For example, consider the visitor is on https://www.example.com. In this case unblu uses www.example.com as the cookie domain when creating cookies.
- If a sub-domain-switch (only for one domain) is desired: it requires a cookie domain to be set as follows:
- In this case unblu will use .example.com as a cookie domain when creating cookies. As a result, a sub-domain switch is possible. This means if the visitor navigates to a sub-domain (let us say to subdomain1.example.com) and the unblu snippet is present on that page, the unblu session will remain active.
- If a sub-domain-switch is required (for more than one domain): a cookie domain should be set as follows:
- In this case unblu will set the cookie domain to the second level domain of the current context origin. For example, consider the visitor is on https://www.example.com. In this case unblu uses .example.com as the cookie domain. As a result, a sub-domain-switch is possible for multiple domains (but only for the current context origin domain).
The property com.unblu.identifier.cookieDomain is considered only for the visitor context origin. This means your agent does not have to access the "Unblu Agent Desk" through the same origin defined via com.unblu.identifier.cookieDomain.