When Cloud Next Generation Firewall Enterprise detects unknown files or potential
real-time threats in your network,
it evaluates the traffic using on-box machine learning models and asynchronous
cloud sandboxing according to your Advanced malware sandbox (WildFire) security profiles.
Before you begin, review the concepts in the
[Advanced malware sandbox security profile](https://docs.cloud.google.com/firewall/docs/about-security-profiles.md.txt#wildfire-profile)
overview.

This page explains how to manage files submitted to the
Advanced malware sandbox service
for analysis, monitor malware sandboxing results, and track dynamic verdicts
using the Google Cloud console and gcloud.

Use the **Advanced malware sandbox submissions** tab on the
**NGFW Enterprise logs**
page to audit file submissions, download analysis reports or malware samples,
and change verdict overrides.
To view a summary of the Advanced malware sandbox submissions file analysis activity
and malware detected during a
specific timeframe in your network, go to the Cloud NGFW
[Dashboard](https://console.cloud.google.com/net-security/firewall-manager/dashboard/cards).

To learn more about how file submissions work, see
[Advanced malware sandbox overview](https://docs.cloud.google.com/firewall/docs/about-wildfire.md.txt).

To understand the JSON layout of the logging record, see
[Advanced malware sandbox logs](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt).

## Roles and permissions

To view the list of submissions and
access Advanced malware sandbox data, ask your administrator to grant you the
necessary Identity and Access Management (IAM) roles for your organization or project.

| Ability | Necessary role |
|---|---|
| View configuration and basic submission records | Both of the following roles: - [Compute Network Viewer](https://docs.cloud.google.com/compute/docs/access/iam.md.txt#compute.networkViewer) (`roles/compute.networkViewer`) on the organization or project - [Logs Viewer](https://docs.cloud.google.com/logging/docs/access-control.md.txt#logging.viewer) (`roles/logging.viewer`) on the project where submission logs are stored |
| To access dynamic analysis reports, download original malware samples, or submit verdict change requests | Any of the following roles on the organization or the project: - [Compute Network Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/compute.md.txt#compute.networkAdmin) (`roles/compute.networkAdmin`) - [Firewall Endpoint Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/networksecurity.md.txt#networksecurity.firewallEndpointAdmin) (`roles/networksecurity.firewallEndpointAdmin`) - The following specific permissions: - `networksecurity.firewallEndpoints.getWildfireReport` for downloading PDF analysis reports. - `networksecurity.firewallEndpoints.getWildfireSample` for downloading original malware sample binaries. - `networksecurity.firewallEndpoints.createVerdictChangeRequest` for filing manual verdict overrides for false positives or false negatives. - `networksecurity.firewallEndpoints.getVerdictChangeRequest` for getting verdict change request details. - `networksecurity.firewallEndpoints.listVerdictChangeRequests` for listing verdict change requests. |

For more information about granting roles, see
[Manage access to projects, folders, and organizations](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).

## Change the verdict of a submission

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles on your organization or project.

**Permissions**

- `networksecurity.firewallEndpoints.createVerdictChangeRequest`

**Roles**

- Compute Network Admin (`roles/compute.networkAdmin`)
- Firewall Endpoint Admin (`roles/networksecurity.firewallEndpointAdmin`)

To submit a verdict change request for a file submitted to Advanced malware sandbox
by an endpoint, do the following:

### Console

1. In the Google Cloud console, go to the **Advanced malware sandbox submissions** page.


   [Go to Advanced malware sandbox submissions](https://console.cloud.google.com/projectselector2/net-security/ngfw/enterprise-logs/wildfire-submissions/list?supportedpurview=project)

   <br />

2. In the project selector menu, select your project.

3. To change the verdict of the Advanced malware sandbox submission, click
   **More actions**
   for the file whose verdict you want to change.

4. Click **Change verdict**.

5. In the **Verdict** list, select the verdict. For example,
   Malware, Phishing.

6. In the **Comment** field, enter the justification for the verdict change.

7. Click **Create**.

### gcloud

To submit a verdict change request, use the
[`gcloud network-security firewall-endpoints wildfire-verdict-change-requests create` command](https://docs.cloud.google.com/sdk/gcloud/reference/network-security/firewall-endpoints/wildfire-verdict-change-requests/create.md.txt):

```
gcloud network-security firewall-endpoints wildfire-verdict-change-requests create \
    --endpoint=ENDPOINT_NAME \
    [--organization=ORGANIZATION_ID | --project=PROJECT_ID] \
    --zone=ZONE \
    --hash=HASH \
    --verdict=VERDICT \
    --comment=COMMENT
```

Replace the following:

- `ENDPOINT_NAME`: the ID of the firewall endpoint, or
  its fully qualified identifier. If you specify the fully qualified
  identifier, you can omit `--organization` or `--project`, and
  `--zone`.

- `ORGANIZATION_ID`: the organization ID in which the
  organization-level firewall endpoint is located.

- `PROJECT_ID`: the project ID in which the
  project-level firewall endpoint is located.

- `ZONE`: the zone in which the firewall endpoint is
  located.

- `HASH`: the hash of the file to submit a verdict change
  request for.

- `VERDICT`: the verdict requested for the file.

- `COMMENT`: the justification for the verdict change
  request. The maximum length is 2,048 characters.

## List verdict change requests

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles on your organization or project.

**Permissions**

- `networksecurity.firewallEndpoints.listVerdictChangeRequests`

**Roles**

- Compute Network Admin (`roles/compute.networkAdmin`)
- Firewall Endpoint Admin (`roles/networksecurity.firewallEndpointAdmin`)

### Console

> [!NOTE]
> **Note:** You can't view a list of all verdict change requests in the Google Cloud console. You can view individual verdict change request status on the details page of the associated Advanced malware sandbox submission.

To list individual verdict change requests, do the following:

1. In the Google Cloud console, go to the **Advanced malware sandbox submissions** page.


   [Go to Advanced malware sandbox submissions](https://console.cloud.google.com/projectselector2/net-security/ngfw/enterprise-logs/wildfire-submissions/list?supportedpurview=project)

   <br />

2. In the project selector menu, select your project.

3. Click the name of the Advanced malware sandbox submission. The
   **Verdict change requests** section on the submission details page
   lists the verdict change requests for that submission.

### gcloud

To list individual verdict change requests, use the
[`gcloud network-security firewall-endpoints wildfire-verdict-change-requests list` command](https://docs.cloud.google.com/sdk/gcloud/reference/network-security/firewall-endpoints/wildfire-verdict-change-requests/list.md.txt):

> [!NOTE]
> **Note:** When you list verdict change requests, the response includes requests for all firewall endpoints in your organization or project, even if you specify a specific endpoint in the command.

```
gcloud network-security firewall-endpoints wildfire-verdict-change-requests list \
    --endpoint=ENDPOINT_NAME \
    [--organization=ORGANIZATION_ID | --project=PROJECT_ID] \
    --zone=ZONE
```

Replace the following:

- `ENDPOINT_NAME`: the ID of the firewall endpoint, or
  its fully qualified identifier. If you specify the fully qualified
  identifier, you can omit `--organization` or `--project`, and
  `--zone`.

- `ORGANIZATION_ID`: the organization ID in which to list
  verdict change requests.

- `PROJECT_ID`: the project ID in which to list verdict
  change requests.

- `ZONE`: the zone in which to list verdict change
  requests.

## Get verdict change request details

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles on your organization or project.

**Permissions**

- `networksecurity.firewallEndpoints.getVerdictChangeRequest`

**Roles**

- Compute Network Admin (`roles/compute.networkAdmin`)
- Firewall Endpoint Admin (`roles/networksecurity.firewallEndpointAdmin`)

To get the details of the verdict change request, do the following:

### Console

1. In the Google Cloud console, go to the **Advanced malware sandbox submissions** page.


   [Go to Advanced malware sandbox submissions](https://console.cloud.google.com/projectselector2/net-security/ngfw/enterprise-logs/wildfire-submissions/list?supportedpurview=project)

   <br />

2. In the project selector menu, select your project.

3. Click the name of the Advanced malware sandbox submission. The submission
   details page displays the status and details of the verdict change
   request.

### gcloud

To get the details of the verdict change request, use the
[`gcloud network-security firewall-endpoints wildfire-verdict-change-requests get` command](https://docs.cloud.google.com/sdk/gcloud/reference/network-security/firewall-endpoints/wildfire-verdict-change-requests/get.md.txt):

```
gcloud network-security firewall-endpoints wildfire-verdict-change-requests get NAME \
    --endpoint=ENDPOINT_NAME \
    [--organization=ORGANIZATION_ID | --project=PROJECT_ID] \
    --zone=ZONE
```

Replace the following:

- `NAME`: the unique name of the verdict change request.

- `ENDPOINT_NAME`: the ID of the firewall endpoint, or
  its fully qualified identifier. If you specify the fully qualified
  identifier, you can omit `--organization` or `--project`, and
  `--zone`.

- `ORGANIZATION_ID`: the organization ID in which to
  get the verdict change request.

- `PROJECT_ID`: the project ID in which to get the
  verdict change request.

- `ZONE`: the zone in which to get the verdict change
  request.

## Download an analysis report

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles on your organization or project.

**Permissions**

- `networksecurity.firewallEndpoints.getWildfireReport`

**Roles**

- Compute Network Admin (`roles/compute.networkAdmin`)
- Firewall Endpoint Admin (`roles/networksecurity.firewallEndpointAdmin`)

To download the Advanced malware sandbox submission analysis report, do the following:

1. In the Google Cloud console, go to the **Advanced malware sandbox submissions** page.


   [Go to Advanced malware sandbox submissions](https://console.cloud.google.com/projectselector2/net-security/ngfw/enterprise-logs/wildfire-submissions/list?supportedpurview=project)

   <br />

2. In the project selector menu, select your project.

3. Click **More actions**
   for the file to download the Advanced malware sandbox analysis report.

4. Click **Download Advanced malware sandbox report**.

## Download a malware sample

#### Permissions required for this task

To perform this task, you must have been granted the following permissions
*or* one of the following IAM roles on your organization or project.

**Permissions**

- `networksecurity.firewallEndpoints.getWildfireSample`

**Roles**

- Compute Network Admin (`roles/compute.networkAdmin`)
- Firewall Endpoint Admin (`roles/networksecurity.firewallEndpointAdmin`)

To download the malware sample from an Advanced malware sandbox submission,
do the following:

1. In the Google Cloud console, go to the **Advanced malware sandbox submissions** page.


   [Go to Advanced malware sandbox submissions](https://console.cloud.google.com/projectselector2/net-security/ngfw/enterprise-logs/wildfire-submissions/list?supportedpurview=project)

   <br />

2. In the project selector menu, select your project.

3. Click **More actions**
   for the file to download the malware sample.

4. Click **Download malware sample**.

## What's next

- [Configure Advanced malware sandbox service](https://docs.cloud.google.com/firewall/docs/configure-wildfire.md.txt)
- [Create and manage Advanced malware sandbox security profiles](https://docs.cloud.google.com/firewall/docs/configure-wildfire-security-profiles.md.txt)
- [Create firewall endpoints and endpoint associations](https://docs.cloud.google.com/firewall/docs/configure-firewall-endpoints.md.txt)
- [Manage firewall endpoints and endpoint associations](https://docs.cloud.google.com/firewall/docs/manage-firewall-endpoints.md.txt)