Palo Alto Networks NGFW

Palo Alto Networks NGFW

WitnessAI Documentation
List
Start Here
Home
Discovery
Analytics
Conversations
Users
Alerts
Policy
Administration
Apps & Resources
Tutorials
Release Notes
Release Notes
November 3, 2026 WitnessAI Release
October 27, 2026 WitnessAI Release
October 20, 2026: WitnessAI Release
October 13, 2026: WitnessAI Release
September 29, 2026: WitnessAI Release
September 22, 2026: WitnessAI Release
September 15, 2026: WitnessAI Release
September 8, 2026: WitnessAI Release
September 1, 2026: WitnessAI Release
August 25, 2026: WitnessAI Release
August 18, 2026 WitnessAI Release
August 4, 2026 WitnessAI Release
July 21, 2026 WitnessAI Release
July 14, 2026 WitnessAI Release
July 9, 2026 WitnessAI Release
June 30, 2026 WitnessAI Hotfix
June 23, 2026 WitnessAI Release
June 16, 2026 WitnessAI Release
June 11, 2026 WitnessAI Release
June 4, 2026 WitnessAI Hotfix
June 2, 2026 WitnessAI Update
May 19, 2026 WitnessAI Update
April 30, 2026 WitnessAI Update
April 28, 2026 WitnessAI Update
April 23, 2026 WitnessAI Update
April 16, 2026 WitnessAI Update
April 14, 2026 WitnessAI Update
April 9, 2026 WitnessAI Update
April 2, 2026 WitnessAI Update
March 31, 2026 WitnessAI Update
March 24, 2026 WitnessAI Update
March 19, 2026 WitnessAI Update
March 17, 2026 WitnessAI Update
March 12, 2026 WitnessAI Update
March 5, 2026 WitnessAI Update
February 26, 2026 WitnessAI Update
February 24, 2026 WitnessAI Update
February 10, 2026 WitnessAI Update
January 27, 2026 WitnessAI Update
January 20, 2026 WitnessAI Update
January 13, 2026 WitnessAI Update
December 18, 2025 WitnessAI Update
December 9, 2025 WitnessAI Update
November 18, 2025 WitnessAI Update
November 25, 2025 WitnessAI Update
November 11, 2025 WitnessAI Update
October 28, 2025 WitnessAI Update
October 23, 2025 WitnessAI Update
October 9, 2025 WitnessAI Update
April 11, 2025: WitnessAI Release v2.0
Draft: November 10, 2026 WitnessAI Release
June 9, 2025: WitnessAI Update
June 23, 2025: WitnessAI Update
July 18, 2025: WitnessAI Update
September 30, 2025: WitnessAI Update
July 31, 2025: WitnessAI Update
August 12, 2025: WitnessAI Update
September 23, 2025: WitnessAI Update
October 2, 2025 WitnessAI Update
Integrations
API Reference
Administrator Guide

Palo Alto Networks NGFW Configuration

πŸ’‘
Network device integrations have been updated in WitnessAI v2.0. Devices configured for WitnessAI v1.5 will need a minor update to support v2.0. Some new features will not activate until your devices are updated.
Existing v1.5 network devices will continue to work without interruption in v2.0.
See the network integration guides in the Integrations menu for details.
Have questions? Our support team will be happy to assist.

Prerequisites

Backup Your Configuration

Always create a backup of the firewall configurations before implementing new changes. For instructions on how to backup the configs, please refer to:

Verify licenses

WitnessAI requires Palo Alto NGFW have licenses for Advanced URL Filtering (1), and Threat Prevention (2).
Verify licenses and check expiration dates in the configuration console.
notion image

Install WitnessAI Root Certificate

  1. Go to Device β†’ Certificate Management β†’ Certificates
  2. Click Import β†’ Import cert provided by Account Team
notion image
Β 
notion image
  1. Once the cert is imported, Click on it and Select Trusted Root CA and click OK
notion image
Β 

Setup EDL Certificate Profile

  1. Certificate will be provided by support.
  2. Go to Device β†’ Certificates and click on Import
  3. Give the certificate name as Witness-AI-CA and upload the CA certificate by clicking on Browse
  4. Go to Device β†’ Certificate Profile Β and click on Add
  5. Give the name as Witness-AI-CP and click on the Add button under CA Certificates
  6. Select the Witness-AI-CA certificate and click OK
  7. Use this certificate Profile for the EDL Configuration.

Create External Dynamic List

This section will focus on creating the WitnessForwardDomainList, which are LLM projects that traffic will be forwarded to WitnessAI.
  1. Go to Objects β†’ External Dynamic Lists β†’ Add
notion image
Β 
  1. Click Add and enter the following configurations:
  2. Name β†’ WitnessForwardDomainList
    Type β†’ Domain List
    Source β†’ https://api.[tenantID].[region].witness.ai/v1/edls/forwardlist.txt
    Check for Updates β†’ Every five minutes
    Click OK

Create Custom Application for Office

Create a Custom Application for traffic towards augloop.office.com as Palo Alto Firewall identifies this as a WebSocket connection and fails to insert HTTP headers.
  1. Go to Objects β†’ Applications
  2. Click Add and name the application augloop
  3. Select the basic properties as per the below values:
  4. a. Category β†’ general-internet
    b. Subcategory β†’ internet-utility
    c. Technology β†’ browser-based
    d. Parent App β†’ ms-office365-copilot
    e. Risk β†’ 1
  5. Go to the Advanced tab and select Port
  6. Add the port information as below:
  7. a. tcp/443
    b. tcp/80
  8. Go to the Signatures tab and click Add
  9. Configure the following settings:
  10. a. Name β†’ AugloopSig
    b. Scope β†’ Session
    c. Select Add Or Condition
    d. Operator β†’ Pattern Match
    e. Context β†’ http-req-headers
    f. Pattern β†’ (augloop.office.com)
    g. Click OK and Click OK again

Redirect AI Traffic to WitnessAI

Create an Anti-Spyware Profile to redirect any DNS request from the WitnessForwardDomainList to WitnessAI.
  1. Go to Objects β†’ Security Profiles β†’ Anti-Spyware β†’ Click Add
  2. Set the following settings:
  3. Name β†’ WitnessAI_Sinkhole
    DNS Policies β†’ Set the Policy Action as sinkhole for WitnessForwardDomainList EDL.
    Sinkhole IPv4 β†’ See instructions below:
    Note: To obtain the sinkhole IPv4 address, ping the following:
    connect.[tenantID].[region].witness.ai
    Click OK
notion image

URL Filtering Profile to add User Info

Create a URL Filtering Profile and configure HTTP Header Insertion to add the user email address in the X- Authenticated-User Header field.
  1. Go to Objects β†’ Security Profiles β†’ URL Filtering β†’ Add
  2. Configure the following settings:
    1. Name β†’ WitnessAI_URL-Filtering
    2. Under External Dynamic URL Lists, select WitnessURLs and change Site Access to alert.
      • Note: This will ensure that URL filtering logs are created for any traffic matching these URLs.
  3. Click on the HTTP Header Insertion tab and click Add
  4. Configure the following settings:
    1. *Name β†’ X-Auth-User*
    2. Type β†’ Dynamic Fields
    3. Domain β†’
    4. Header β†’ X-Authenticated-User
    5. Value β†’ ($user)@($domain)
    6. Check the Log box
notion image

Create Decryption Profile & Policy

  1. Go to Object β†’ Decryption β†’ Decryption Profile β†’ Add
  2. Set the following configurations:
    1. Name β†’ Witness-Decrypt
    2. Enable Strip ALPN
notion image
  1. Click SSL Protocol Settings and configure the following:
    1. Min Version β†’ TLSv1.0
    2. Max Version β†’ TLSv1.2
notion image
  1. Go to Policies β†’ Decryption
  2. Create a new decryption policy for decrypting all SSL traffic going towards the AI URLs maintained by Witness AI.
    1. Source Zone β†’ LAN/GP Zone
    2. Destination Zone β†’ WAN
    3. URL Category β†’Β  WitnessURLs
    4. Action β†’ Decrypt
    5. Type β†’ SSL Forward Proxy
    6. Decryption Profile β†’ Witness-Decrypt
    7. Note: Create a new Profile and make sure that the Strip ALPN checkbox on the Decryption Profile is enabled
notion image
notion image

Create Security Policy for DNS Sinkhole

Use the URL Filtering Profile and Anti-Spyware Profile in a security Policy created for allowing access to AI URLs maintained by Witness AI.
  1. Go to Policies β†’ Security
  2. Create a new security policy for allowing traffic towards AI URLs maintained by WitnessAI.
    1. Source Zone β†’ LAN/GP Zone
    2. Destination Zone β†’ WAN
    3. Action β†’ Allow
    4. Anti-Spyware Profile β†’ WitnessAI_Sinkhole
    notion image

Create Security Policy for URL Filtering

Use the URL Filtering Profile and Anti-Spyware Profile in a security Policy created for allowing access to AI URLs maintained by Witness AI.
  1. Go to Policies β†’ Security
  2. Create a new security policy for allowing traffic towards AI URLs maintained by WitnessAI.
    1. Source Zone β†’ LAN/GP Zone
    2. Destination Zone β†’ WAN
    3. URL Category β†’ WitnessURLs
    4. URL Filtering β†’ WitnessAI_URL-Filtering
    notion image

Implement Block for Quic Protocol

Quic is a Google developed protocol which uses UDP for web connections and limits the firewall visibility and ability to analyze and apply security actions.
  • Note: If the Quic protocol is not already blocked, please perform this step.
  1. Go to Policies β†’ Security
  2. Click Add to create a new security policy for blocking quic protocol.
  3. Name the rule Quic Block.
notion image
  1. Block any quic protocol traffic from LAN/GP Zone towards the internet.
    1. Source Zone β†’ *LAN/GP Zone*
    2. Destination Zone β†’ *WAN*
    3. Application β†’ quic
    4. Action β†’ *Deny*
  2. Click OK
  3. Move the Quic Block rule to the top.

Commit Change

The last step is to commit the change to the firewall. This will implement and enable the configuration changes made.
  1. Click Commit
  2. Review changes and implement the configuration changes.
Β