Configure Authentication for Explicit Web Proxy
Focus
Focus
Next-Generation Firewall

Configure Authentication for Explicit Web Proxy

Table of Contents

Configure Authentication for Explicit Web Proxy

When you configure an explicit web proxy, configure one of the following user authentication methods:
If you want to exempt traffic from specific devices, such as printers, from authentication, you can Configure Exemptions for Explicit Proxy Authentication.
If you don't need to configure authentication for your web proxy traffic, you can Exclude All Explicit Proxy Traffic From Authentication.

Configure Kerberos Authentication

  1. Create a service account for the directory (if it is not already configured) and enable support for AES128 and AES256 encryption in the service account properties.
  2. Register the service principal name (SPN) for the proxy FQDN and create a keytab file for the Kerberos single sign-on (SSO).
    The Kerberos keytab principal name must match the hostname that resolves to the proxy interface IP address.
  3. On the firewall, create a server profile for the Kerberos server.
  4. Configure an authentication profile to use Kerberos and import the keytab to the authentication profile.
  5. (Optional but recommended) If you use Panorama to manage your firewalls, configure a log forwarding profile to forward logs to Strata Logging Service, Panorama, or both.
    By default, the firewall does not forward logs to Strata Logging Service or Panorama. Forwarding the logs ensures that the complete authentication log information is available to assist in troubleshooting any potential authentication issues.
    As a best practice, if you are using Panorama to manage the web proxy firewall, configure any objects the proxy uses in a shared Panorama location and configure the web proxy firewall in a separate device group that contains no other firewalls or virtual systems. If the firewall is already a member of a device group, create a child device group as a sub-group and move the firewall to the child device group.
    If you experience issues with the browser challenge when using the Chrome browser, we recommend using an alternate browser.
  6. In the Explicit Proxy Configuration (NetworkProxyExplicit Proxy Configuration), select Kerberos Single Sign On as the Authentication service type.
  7. Select the Authentication Profile you created in Step 4.
  8. Complete the remaining steps to Configure a Web Proxy.

Configure SAML Authentication

SAML authentication for explicit web proxy requires Panorama and the Cloud Services plugin version 3.2.1 (and later versions).
To simplify configuration for SAML-based authentication for the explicit web proxy, the firewall or Panorama automatically generates the following rules to allow the necessary traffic. If you are using Panorama, you must select an individual firewall to view the rules.
  • SWG-allow-vpc-dns-rule — Allows traffic from the zone where the web proxy upstream interface is located to the primary and secondary DNS server addresses for the web proxy.
    The firewall also generates an anti-spyware profile, SWG-DNS-Security-Profile, to allow the required traffic.
    The autogenerated rule SWG-allow-vpc-dns-rule applies this profile to the applicable traffic.
  • SWG-block-unsolicited-dns-rule —Blocks unauthorized traffic to the primary and secondary DNS server addresses for the web proxy.
  • SWG-allow-outbound-auth-domain-rule — (Explicit proxy with SAML authentication only) Allows traffic from the zone where the web proxy upstream interface is located to the Cloud Services plugin.
    The autogenerated rule SWG-allow-outbound-auth-domain-rule applies the hybrid-swg-authdomain-bypass URL category to the applicable traffic.
    The URL category,hybrid-swg-authdomain-bypass contains the necessary predefined entries for the required domains.
  1. If you have not already done so, configure Explicit Proxy for mobile users.
    This is a typical authentication method for on-premises web proxy authentication and Prisma Access Explicit Proxy, which requires a license. Prisma Access Explicit Proxy settings for cookie and timeout values apply to an explicit web proxy configuration as well. You must commit the changes and push them to the relevant firewalls before continuing.
  2. If you have not already done so, configure a SAML Authentication profile.
  3. (Required for XAU only) If the downstream proxy sends the XAU header, configure a trusted source address for the downstream proxy.
    1. Select DeviceUser IdentificationTrusted Source Address.
    2. Edit the settings for the trusted source address to change the status to Enabled.
    3. Add any address objects you want to allow X-Authenticated User (XAU).
      Explicit web proxy requires an IP address object for the trusted source address.
    4. Click OK.
  4. In the Explicit Proxy Configuration (NetworkProxyExplicit Proxy Configuration), select SAML/CAS as the Authentication service type.
  5. (Optional but recommended) If you are using a decryption policy for the traffic, select Strip ALPN to remove the value in the Application-Layer Protocol Negotiation (ALPN).
    This option requires HTTPS.
  6. Complete the remaining steps to configure the Configure a Web Proxy.

Configure Cloud Identity Engine Authentication

To simplify configuration for SAML-based authentication for the explicit web proxy, the firewall or Panorama automatically generates the following rules to allow the necessary traffic. If you are using Panorama, you must select an individual firewall to view the rules.
  • SWG-allow-vpc-dns-rule — Allows traffic from the zone where the web proxy upstream interface is located to the primary and secondary DNS server addresses for the web proxy.
    The firewall also generates an anti-spyware profile, SWG-DNS-Security-Profile, to allow the required traffic.
    The autogenerated rule SWG-allow-vpc-dns-rule applies this profile to the applicable traffic.
  • SWG-block-unsolicited-dns-rule —Blocks unauthorized traffic to the primary and secondary DNS server addresses for the web proxy.
  • SWG-allow-outbound-auth-domain-rule — (Explicit proxy with SAML authentication only) Allows traffic from the zone where the web proxy upstream interface is located to the Cloud Services plugin.
    The autogenerated rule SWG-allow-outbound-auth-domain-rule applies the hybrid-swg-authdomain-bypass URL category to the applicable traffic.
    The URL category,hybrid-swg-authdomain-bypass contains the necessary predefined entries for the required domains.
  1. If you have not already done so, configure Explicit Proxy for mobile users.
    You must commit the changes and push them to the relevant firewalls before continuing.
  2. If you have not already done so, configure authentication using the Cloud Identity Engine and configure a Cloud Identity Engine authentication profile.
  3. (Required for XAU only) If the downstream proxy sends the XAU header, configure a trusted source address for the downstream proxy.
    1. Select DeviceUser IdentificationTrusted Source Address.
    2. Edit the settings for the trusted source address to change the status to Enabled.
    3. Add any address objects you want to allow X-Authenticated User (XAU).
      Explicit web proxy requires an IP address object for the trusted source address.
    4. Click OK.
  4. In the Explicit Proxy Configuration (NetworkProxyExplicit Proxy Configuration), select SAML/CAS as the Authentication service type.
  5. (Optional but recommended) Select Strip ALPN to remove the value in the Application-Layer Protocol Negotiation (ALPN).
    This option requires HTTPS.
  6. Complete the remaining steps to configure the Configure a Web Proxy.

Configure Basic Authentication

Basic authentication uses an HTTP 407 challenge to prompt users for a username and password. The proxy validates credentials against the configured backend and optionally caches the authenticated IP address so that subsequent requests from the same IP are not challenged again until the IP Surrogate minutes time limit is reached.
If you change the Authentication service type (for example, switching between Kerberos Single Sign On and a basic authentication type), users must clear their browser cache and history for the change to take effect.
  1. Create an authentication profile for the authentication type you want to use: Local Database, LDAP, RADIUS, TACACS+, Kerberos Pre-Authentication, or Authentication Sequence.
    Unlike Kerberos Single Sign On, which authenticates users transparently using Kerberos service tickets without prompting for credentials, Kerberos Pre-Authentication presents users with an HTTP 407 challenge and uses Kerberos only to validate the submitted credentials against Active Directory. Authentication Sequence tries each configured backend in order until one successfully validates the credentials.
  2. (Optional but recommended) Configure a log forwarding profile to forward authentication logs to Strata Logging Service, Panorama, or both.
  3. In the Explicit Proxy Configuration (NetworkProxyExplicit Proxy Configuration), for Authentication service type, choose the authentication backend: Local Database, LDAP, RADIUS, TACACS+, Kerberos Pre-Authentication, or Authentication Sequence.
  4. For Authentication Profile, choose the profile you created.
  5. (Optional) For Basic Authentication Realm, enter a name to identify the protection scope presented to clients in the 407 challenge.
    The default is Explicit Proxy. The realm name supports alphanumeric characters, spaces, hyphens, underscores, and periods, up to 127 characters.
  6. (Optional) For IP Surrogate Minutes parameter, enter a duration of 1 to 600 minutes to cache the authenticated user's IP address.
    The default is 0, which disables IP surrogate. If you enter a value greater than 0, a confirmation dialog appears — click Proceed Anyway to confirm.
    Don't use IP surrogate in NAT environments or VDI deployments where multiple users share a single IP address.
    The IP surrogate cache is stored in memory and does not persist when Envoy proxy or the device restarts. After a restart, users must authenticate again.
  7. Verify that the authentication is working by viewing the traffic and authentication logs. Logs are generated only in case of authentication failure.
    • (Decrypted traffic only) Go to MonitorLogsTraffic and check that the authentication is working.
    • (Undecrypted traffic only) Go to MonitorLogsAuthentication and check that the authentication is working.
      Each authentication log entry includes the following fields:
      • Proxy Auth Method— Reflects the protocol used.
      • Object— Identifies the authentication profile used to validate credentials.
      • Type— Explicit Proxy, indicating the log originated from an explicit web proxy authentication event.
      • Event— Indicates the authentication outcome: Authentication Success, Authentication Failure, or HTTP407 (when the proxy issued a 407 challenge to the client).
  8. Complete the remaining steps to configure the Configure a Web Proxy.