PAC file FAQ
What happens when a PAC file can't be downloaded?
If a PAC policy is mentioned but the PAC file can't be downloaded,
BlackBerry Access
doesn't allow the browser to navigate to any web sites, and users see the following message: "Invalid web proxy configuration". Users can try reloading the page to restart the PAC file download so that BlackBerry Access
can try to download the PAC file again.When is a PAC file downloaded and how long is it cached?
The PAC file is downloaded at the time the user tries to load a webpage, when the app is cold-started, when the
BlackBerry Access
policy is updated, or the app is unlocked. When the BlackBerry Access
policy comes to the app, the download sequence starts. When the device starts receiving the PAC file, the previous PAC file is replaced with the new one. When it's downloaded, the PAC data persists in the secure container, with an expiration time of 24 hours, and is not downloaded again until the policy is updated, or the app is restarted. The PAC file is downloaded again when a user accesses a webpage after restarting the device or when a new policy is pushed by UEM
. The cached PAC file is reused until the PAC file is refreshed by a policy change or when the app is restarted.Is there a cache timeout that controls whether the client will download PAC regularly?
There's no cache timeout for PAC files. The client doesn't download a new configuration unless it meets the criteria described in the previous question.
Why do users see an "Invalid Web Proxy Configuration" error message and how can users diagnose the problem?
This error message is displayed due to various conditions related to PAC files or the proxy server. Users can go to the console in
BlackBerry Access
to see more details. This error message can be displayed for the following reasons:
- The PAC script couldn't be executed because of aJavaScripterror. Unfortunately,BlackBerry Accesscan't detectJavaScripterrors. It's recommended that you first test the PAC file in a browser on a computer and then deploy it to devices. A PAC tester tool is available to test the PAC here: https://code.google.com/p/pactester/.
- The PAC file returns an empty value. In the case of computer browsers, they fall back to a connection without a web proxy. However, for security reasons,BlackBerry Accessdoesn't fall back and displays an error message instead.