On the Hosted PAC Files page, you can:

• Add a Custom PAC File

  To add a PAC file to the Zscaler service:

  1. In the Admin Portal, go to Infrastructure > Internet & SaaS > Traffic Forwarding > Hosted PAC Files.

  The page lists the default PAC files and any other custom files that were uploaded to the Zscaler service.

  2. Click Add PAC File.
  3. In the Add PAC File window:
     • PAC File Name: Enter a name for the PAC file. The name you enter here applies to all the additional versions of the PAC file. The name cannot exceed 255 characters and cannot include spaces.
     • Description: Enter a description for the PAC file. The description cannot exceed 255 characters.
     • Domain: This field displays the domain name that your organization provided when it first registered. If there are multiple domain names, select the domain to which the PAC file applies. This selection applies to all the additional versions of the PAC file.
     • Obfuscate URL: Enable this field to obfuscate the PAC file URL. This selection applies to all the additional versions of the PAC file.

  You cannot modify (enable or disable) the Obfuscate URL field for a saved PAC file as it changes the Hosted URL and causes a network shortage because the new Hosted URL must be redistributed to all your users. Users using the old Hosted URL are served by the default proxy PAC file instead of the intended custom PAC file. To prevent a shortage and ensure all users are using the new Hosted URL, follow these instructions.

  1. On the Hosted PAC Files page, click the View icon corresponding to the PAC file for which you want to enable or disable the obfuscated URL field.
  2. On the Preview Version Details page, select the required version of the PAC file and copy the content to the clipboard.
  3. Click Add PAC File on the Hosted PAC Files page.
  4. In the Add PAC File window, enter the necessary information, such as name, description, and domain for the PAC file.
  5. Ensure that you enable or disable Obfuscate URL.
  6. In the PAC File Contents section, paste the content copied from the old PAC file.
  7. Click Save and activate the change.
  8. Distribute the new PAC file URL to your users.

  Close

  • PAC File Contents: Type or copy and paste your JavaScript. To learn more, see Writing a Pac File and Best Practices for Writing PAC Files.

  You can also copy and expand the PAC file contents.

  4. Click Verify PAC File to check for errors in the syntax. An error message is displayed if the PAC file has errors.

  You can correct the PAC file and click Verify PAC File again to ensure that there are no errors or you can save the PAC file with errors.

  5. Click Save & Deploy and activate the change.
     • If the PAC file has no verification errors, enter a commit message in the window that appears and click Confirm. The message cannot exceed 255 characters.
     • If the PAC file has verification errors, complete the following sections in the window that appears:

  • Enter a commit message under the Save section. The message cannot exceed 255 characters.
  • Enter I accept the risk under the Deploy section.
  • Click Confirm.

  Close
• Create a Branch for the Custom PAC File

  You can create multiple branches or versions for your PAC file. Zscaler allows you to host up to 10 versions of the PAC file at a time.

  When you create more than 10 versions, you are prompted to delete an older version of the PAC file. The versions that are deployed, staged for deployment, or marked as last known good are not available for selection.

  To create a new branch for the custom PAC file:

  1. On the Hosted PAC Files page, click the View icon corresponding to the PAC file.
  2. On the Preview Version Details page, select the version in the Preview field of the custom PAC file for which you want to view details.
  3. Click Create Branch.
  4. On the Create Branch page:
     1. Select the version that you want to use as a template to create a new branch. You can also click the Menu icon (the ellipsis) to do the following actions:
        • Deploy
        • Mark as Last Known Good
        • Create Branch
        • Export
        • Stage Deployment
     2. View the following information for the selected PAC file version:
        • PAC File Name: The name of the PAC file.
        • Description: Additional notes or information about the PAC file.
        • Domain: The Zscaler domain in which the PAC file is hosted.
        • Obfuscate URL: Displays whether the PAC file URL is obfuscated or not.
        • Status: Displays the verification and deployment status of the PAC file.
        • Last Saved: The date the PAC file was last modified.
        • Last Modified By: The last admin username who modified the PAC file.
        • Commit Message: The message entered while saving this version of the PAC file.
     3. Edit the PAC file contents.
     4. Click Verify PAC File. You can save the PAC file with or without verification errors.
     5. Click Save and activate the changes.

  Enter a commit message in the window that appears, and click Confirm to save the new version of the PAC file. The message cannot exceed 255 characters.

  6. Click Save & Stage Deployment and activate the changes.

  Enter a commit message in the window that appears, and click Confirm to stage the new version for testing before deployment. The message cannot exceed 255 characters.

  You can stage only one PAC file version for deployment at a time, and the hosted URL for that PAC file is different from the deployed version. If you deploy the staged PAC file, then the hosted URL changes to the previously deployed version.

  7. Click Save & Deploy and activate the changes to deploy the PAC file with immediate effect.

  • If the PAC file has no verification errors, enter a commit message in the window that appears and click Confirm. The message cannot exceed 255 characters.
  • If the PAC file has verification errors, complete the following sections in the window that appears:
    • Enter a commit message under the Save section. The message cannot exceed 255 characters.
    • Enter I accept the risk under the Deploy section.
    • Click Confirm.

  Close
• Manage Different Versions of the Custom PAC File

  You can manage all branches of your PAC file in the Admin Portal. You can view the deployed version or any other version of the PAC file. You can also compare the contents of any two PAC file versions.

  To manage the custom PAC file versions:

  1. On the Hosted PAC Files page, click the Manage Versions icon corresponding to the PAC file.

  The Manage PAC File page appears.

  2. In the Manage Versions tab, you can do the following:

     1. Compare any two versions of the PAC file:
        1. Click Compare Two Versions.
        2. Select any two PAC file versions and then click Compare Two Versions again.

     The comparison table for the selected versions is displayed and the differences are highlighted.

     2. View the following information:
     • Version: The version number of the PAC file.
     • Date Saved: The date the PAC file was last modified.
     • Last Modified By: The last admin username who modified the PAC file.
     • Commit Message: The message entered while saving this version of the PAC file.
     • Hosted URL: The hosted URL of the PAC file.
     • Status: Indicates the verification status of the PAC file.
     • Action: Deploy, mark or remove the Last Known Good tag, create a branch, delete, or stage deployment for the PAC file version.
     3. Click the version number to view more details of the PAC file. You are redirected to the Preview Version Details page for the selected PAC file version.
  3. In the View Deployed Version tab, you can view the details of the currently deployed PAC file version.

  Close