Palo Alto Networks Panorama
| SamurAI [Local] Collector | SamurAI [Cloud] Collector |
|---|---|
To complete this integration, you will need to:
- Ensure connectivity requirements are in place:
- Configure your Palo Alto Networks Panorama environment:
- Configure syslog to your SamurAI Local Collector
- Enable API Access
- Configure WildFire authentication (optional)
- Complete the integration in the SamurAI Portal:
Connectivity Requirements
You must ensure the following connectivity requirements are available:
| Source | Destination | Ports | Description |
|---|---|---|---|
| Panorama or the Log Collector forwarding logs, depending on your deployment | SamurAI Local Collector | UDP/514 (syslog) | Log transmission |
| SamurAI Local Collector | Panorama | TCP/443 (HTTPS) | Extended data collection, including packet captures where supported and enabled |
| SamurAI Local Collector | *.wildfire.paloaltonetworks.com | TCP/443 (HTTPS) | WildFire public cloud report retrieval, if configured |
| SamurAI Local Collector | auth.apps.paloaltonetworks.com | TCP/443 (HTTPS) | OAuth 2.0 access-token generation for WildFire public cloud collection |
Follow the Palo Alto Networks log-forwarding instructions appropriate to your Panorama deployment mode. Ensure that the device or Log Collector performing external log forwarding can reach the SamurAI Local Collector.
The OAuth authentication service is separate from the WildFire public cloud API endpoint. If WildFire public cloud collection is enabled, allow access to both destinations.
See:
- Configure Log Forwarding from Panorama to External Destinations
- Generate an Access Token for WildFire API Requests
Configure syslog to your SamurAI Local Collector
Follow the steps in the Palo Alto Networks documentation to configure external log forwarding from your Panorama environment to your SamurAI Local Collector:
Select the documentation version matching your Panorama deployment. The link above points to version 11.1.
Follow the instructions appropriate to your deployment mode, including any requirements for Dedicated Log Collectors or Collector Groups.
Use the following parameters when configuring the syslog server profile:
| Field Name | Parameter |
|---|---|
| Server Profile Name | A name of your choice. We suggest NTT_Syslog_Profile. |
| Syslog Server | IP address of your SamurAI Local Collector |
| Transport | UDP |
| Port | 514 |
| Format | BSD |
| Facility | Keep the default |
| Custom Log Format | Keep the default for every log type |
If you will not use the management interface for syslog forwarding, follow the applicable Palo Alto Networks instructions to configure an alternative interface.
Your Palo Alto Networks Next-Generation Firewalls must be configured to forward the required logs to Panorama or the applicable Log Collectors.
If this has not already been configured, follow:
Enable API Access
The Panorama API-Key is used for extended data collection from Panorama. It is separate from the WildFire authentication credentials configured later in this guide.
Follow the steps in the Palo Alto Networks documentation:
Create a dedicated administrator account and Admin Role Profile for the SamurAI integration.
Under XML API, disable all permissions except:
- Log
- Operational Requests
- Export
Assign the Admin Role Profile to the dedicated administrator account.
Next, generate the API key by following:
Use the username and password of the dedicated Panorama administrator account.
Securely record the value returned in the <key> element. Enter this value in the API-Key field when you Complete the Palo Alto Networks Panorama Integration.
Configure WildFire authentication
WildFire collection is optional. Complete this section if you want SamurAI to retrieve WildFire analysis reports.
The authentication method depends on the WildFire deployment:
| WildFire Deployment | SamurAI Portal Fields |
|---|---|
| WildFire public cloud | WildFire Client ID, WildFire Client Secret, WildFire TSG-ID, and the WildFire authentication service endpoint |
| On-premises WildFire appliance | WildFire API-Key (legacy) |
These credentials are separate from the Panorama API-Key obtained in Enable API Access.
The WildFire public cloud authentication procedure applies to customers using Panorama-managed firewalls.
These credentials authenticate the integration to the WildFire public cloud API. They do not replace the Panorama API-Key and do not require changing the firewall management platform.
WildFire public cloud: obtain OAuth 2.0 credentials
For WildFire public cloud collection, obtain:
- Client ID — the identifier issued for the service account.
- Client Secret — the secret issued for that service account.
- TSG-ID — the Tenant Service Group ID associated with the WildFire tenant.
The integration uses these values to request OAuth 2.0 access tokens. You do not need to enter a manually generated access token in the SamurAI Portal.
1. Select the correct tenant
Sign in to Strata Cloud Manager and select the customer tenant associated with the WildFire entitlement.
The tenant must have the appropriate license. Palo Alto Networks documents that:
- An Advanced WildFire license permits creation of an Advanced WildFire API key.
- A Prisma Access license permits creation of a Prisma Access API key.
Follow the prerequisites and instructions for the applicable license in:
2. Create a dedicated service account and configure its role
In Strata Cloud Manager, navigate to System Settings → Identity & Access Management.
Create a dedicated service account for this integration. Use a descriptive name, such as ntt_wildfire_user, subject to Palo Alto Networks naming requirements.
Configure the service account according to the WildFire documentation:
| Setting | Required Configuration |
|---|---|
| Apps & Services | All Apps & Services |
| Role | A custom role containing the iam.service_account and iam.custom_role permissions |
Do not leave the service account without an assigned role. Follow Palo Alto Networks’ WildFire-specific instructions for the required scope and restricted custom role.
See:
- Service Accounts
- Add a Custom Role Through Common Services
- Get Your Advanced WildFire Cloud API Key for Token-Based Authentication
3. Record the Client ID and Client Secret
Securely record the Client ID and Client Secret issued for the service account.
Use the issued Client ID, not merely the display name chosen for the account.
The Client Secret cannot be retrieved again after the service account has been created.
Store the secret securely. Do not include it in email, screenshots, support-ticket text, or documentation.
For details, see:
4. Bind the service account to the WildFire API key
Navigate to Configuration → WildFire Settings in Strata Cloud Manager.
If creating a new WildFire API key:
- Select Create New Key.
- Select the service account created for this integration.
- Select Create API Key.
- Wait until the key status changes from Pending to Valid.
Each WildFire API key must be bound to a unique service account.
If the tenant already has an NGFW or Prisma Access WildFire API key, follow the migration procedure instead. Existing unmigrated keys must be migrated or revoked before a new key can be created.
See:
- Get Your Advanced WildFire Cloud API Key for Token-Based Authentication
- Advanced WildFire Cloud API Migration
For OAuth-based WildFire collection, enter the bound service account’s Client ID and Client Secret in the SamurAI Portal.
Do not enter the WildFire backend API key in the WildFire API-Key (legacy) field.
5. Obtain the TSG-ID
In Strata Multitenant Cloud Manager:
- Select Tenants and Services → Tenant Management.
- Select the customer tenant and the relevant licensed product.
- Record the Tenant Service Group ID (
tsg_id) shown for that tenant.
Use the tenant associated with the WildFire API key and service account.
See:
The SamurAI integration can derive the TSG-ID when the Client ID matches:
<account-name>@<tsg-id>.iam.panserviceaccount.com
However, do not assume that every Client ID uses this format. Record the TSG-ID independently and enter the verified value in the WildFire TSG-ID field to avoid relying on automatic extraction.
6. Confirm the authentication endpoint
Palo Alto Networks documents the following OAuth 2.0 token endpoint:
https://auth.apps.paloaltonetworks.com/am/oauth2/access_token
Enter this value in the WildFire authentication service endpoint field when completing the integration.
This is the authentication endpoint, not the WildFire report endpoint or Panorama address.
See:
On-premises WildFire appliance: obtain an API key
WildFire appliances use API keys generated directly on the appliance rather than the public cloud OAuth authentication workflow.
Follow the Palo Alto Networks instructions:
If confirmed:
- Generate an API key on the WildFire appliance using the Palo Alto Networks instructions.
- Securely record the appliance-generated key.
- Enter it in WildFire API-Key (legacy) in the SamurAI Portal.
- Leave the WildFire OAuth fields blank for this authentication path.
Complete the Palo Alto Networks Panorama Integration
- Log in to the SamurAI Portal.
- Select Telemetry → Integrations from the main menu.
- Click Create.
- Find and select Palo Alto Networks Panorama.
- Select the relevant Local Collector and click Next.
- The Local Collector IP address is displayed on the left of the screen.
- To configure extended collection, enable the toggle.
- Enter the following information.
General extended collection settings
| Field | Value |
|---|---|
| Name for the Integration | A descriptive name to identify the integration in the SamurAI Portal. |
| Description (Optional) | Additional information to help identify the integration. |
| Manager name | The name used as the source for alerts from this integration. |
| API-Key | The Panorama API key obtained in Enable API Access. This is separate from the WildFire credentials below. |
| Hostname / IP | The hostname or IP address of Panorama used for extended data collection. |
WildFire settings
Complete the fields for the applicable WildFire authentication method.
If WildFire collection is not required, leave the WildFire credential fields blank.
| Field | Value |
|---|---|
| WildFire API-Key (legacy) (Optional) | For a supported on-premises WildFire appliance integration only: enter the appliance-generated key obtained in Configure WildFire authentication. Leave blank when using WildFire public cloud OAuth authentication. |
| WildFire Client ID (Optional) | For WildFire public cloud collection: enter the Client ID issued for the service account bound to the WildFire API key. Client ID and Client Secret must both be provided. |
| WildFire Client Secret (Optional) | For WildFire public cloud collection: enter the secret issued for the same service account. This is not the legacy WildFire API key. |
| WildFire TSG-ID (Optional) | Enter the verified Tenant Service Group ID obtained in Configure WildFire authentication. If omitted, the integration can derive it only when the Client ID matches <account-name>@<tsg-id>.iam.panserviceaccount.com. Otherwise, this field must be completed. |
| WildFire authentication service endpoint | If not set the default will be used https://auth.apps.paloaltonetworks.com/am/oauth2/access_token for Oauth2 token generation |
Although the WildFire credential fields are marked Optional in the portal, Client ID and Client Secret are both required to enable WildFire public cloud OAuth collection.
The correct TSG-ID must also be available, either through the WildFire TSG-ID field or the supported Client ID extraction format.
Configure only one WildFire authentication method.
For public cloud OAuth authentication, leave WildFire API-Key (legacy) blank.
For a supported WildFire appliance integration, provide the appliance API key and leave the WildFire OAuth fields blank.
- Click Finish.
Our Integration guide was accurate at the time of writing but vendors change things frequently! If you find errors or anything is outdated, let us know by raising a request in the SamurAI MDR Portal and we shall get it updated.