How do I download and deploy pre-provisioned cookies?
For background on using pre-provisioned cookies, see About Pre-Provisioned Cookies.
A. Download the Pre-Provisioned Cookies
Only super admins can use the API to download cookies.
- Open a browser and enter the query address, which consists of the base URL address for downloading cookies and the query string.
The base URL address for downloading cookies is:
For example, if you are on the zscaler.net cloud, the URL is: https://admin.zscaler.net/download/cookies
Appending the query string to the end utilizes the API. Some examples are:
Returns the offline cookie of ‘firstname.lastname@example.org,’ if the user is present.
Returns the offline cookies for all users added since 29th May 2010, 0000 hours Indian Standard Time.
Returns the offline cookies for all users belonging to “Sales” department.
Returns the offline cookies for all users belonging to “Sales” created after Nov. 5, 2010.
- When the authentication window appears, enter the username and password.
- When the service displays the compressed (zip) file of all the cookie files, save it.
The file is zipped and downloaded as: cookiejar-<orgid>-<date>.zip. Each cookie contained within the zip file will be of the form: <email-address>.sol
For example, the user’s flash cookie from the example above was stored in the following location:
The following table shows common operating system locations for flash cookies (LSOs).
As shown in the table, the #SharedObjects directory is the container directory, containing a randomly named directory. This randomly named directory consists of the domain directories, which holds the flash cookies.
B. Deploying Cookies
To deploy downloaded cookies:
- Verify that Flash is already installed.
- Check to see that the directories outlined above (%APPDATA\Macromedia\Flash Player\#SharedObjects) exist.
- If the directory does not exist, either install Flash or manually create all the directories up to #SharedObjects, then create an additional random directory (letters in caps with or without numbers, eight alpha-numeric digits long). Within the newly created random directory, create the gateway.zscaler.net directory. Within that, create the zscaler.swf directory.
- Once the directory is validated, rename the cookie as zscaler_auth.sol, and place it in the zscaler.swf directory.
This entire process can be automated via scripting based on administration requirements.