Skip to main content

WildFire Antivirus Profile

WildFire antivirus profiles configure file forwarding to WildFire for cloud-based malware analysis and prevention. The scm CLI provides commands to create, update, delete, and load WildFire antivirus profiles.

Overview

The wildfire-antivirus-profile commands allow you to:

  • Create WildFire antivirus profiles with file forwarding rules
  • Update existing profile configurations including packet capture settings
  • Delete profiles that are no longer needed
  • Bulk import profiles from YAML files
  • Export profiles for backup or migration

Set WildFire Antivirus Profile

Create or update a WildFire antivirus profile.

Syntax

scm set security wildfire-antivirus-profile NAME [OPTIONS]

Arguments

ArgumentDescriptionRequired
NAMEProfile nameYes

Options

OptionDescriptionRequired
--folder TEXTFolder locationNo*
--snippet TEXTSnippet locationNo*
--device TEXTDevice locationNo*
--description TEXTProfile descriptionNo
--rules TEXTRules configuration as JSONNo
--packet-capture / --no-packet-captureEnable packet captureNo

* One of --folder, --snippet, or --device is required.

Examples

Create Basic Profile

$ scm set security wildfire-antivirus-profile wf-basic \
--folder Texas \
--description "Basic WildFire profile"
---> 100%
Created WildFire antivirus profile: wf-basic in folder Texas

Create Profile with Custom Rules

$ scm set security wildfire-antivirus-profile wf-custom \
--folder Texas \
--rules '[{"name":"Forward All","direction":"both","analysis":"public-cloud","application":["any"],"file_type":["any"]}]'
---> 100%
Created WildFire antivirus profile: wf-custom in folder Texas

Create Profile with Packet Capture

$ scm set security wildfire-antivirus-profile wf-capture \
--folder Texas \
--packet-capture
---> 100%
Created WildFire antivirus profile: wf-capture in folder Texas

Delete WildFire Antivirus Profile

Delete a WildFire antivirus profile from SCM.

Syntax

scm delete security wildfire-antivirus-profile NAME [OPTIONS]

Arguments

ArgumentDescriptionRequired
NAMEProfile name to deleteYes

Options

OptionDescriptionRequired
--folder TEXTFolder locationNo*
--snippet TEXTSnippet locationNo*
--device TEXTDevice locationNo*
--forceSkip confirmation promptNo

* One of --folder, --snippet, or --device is required.

Example

$ scm delete security wildfire-antivirus-profile wf-basic \
--folder Texas \
--force
---> 100%
Deleted WildFire antivirus profile: wf-basic from folder Texas

Load WildFire Antivirus Profile

Load multiple WildFire antivirus profiles from a YAML file.

Syntax

scm load security wildfire-antivirus-profile [OPTIONS]

Options

OptionDescriptionRequired
--file TEXTPath to YAML file containing profile definitionsYes
--folder TEXTOverride folder location for all profilesNo
--snippet TEXTOverride snippet location for all profilesNo
--device TEXTOverride device location for all profilesNo
--dry-runPreview changes without applying themNo

YAML File Format

---
wildfire_antivirus_profiles:
- name: wf-basic
folder: Texas
description: "Basic WildFire profile"

- name: wf-custom
folder: Texas
description: "Custom WildFire rules"
rules:
- name: Forward All
direction: both
analysis: public-cloud
application:
- any
file_type:
- any

Examples

Load with Original Locations

$ scm load security wildfire-antivirus-profile \
--file wildfire.yaml
---> 100%
✓ Loaded WildFire antivirus profile: wf-basic
✓ Loaded WildFire antivirus profile: wf-custom

Successfully loaded 2 out of 2 WildFire antivirus profiles from 'wildfire.yaml'

Load with Folder Override

$ scm load security wildfire-antivirus-profile \
--file wildfire.yaml \
--folder Austin
---> 100%
✓ Loaded WildFire antivirus profile: wf-basic
✓ Loaded WildFire antivirus profile: wf-custom

Successfully loaded 2 out of 2 WildFire antivirus profiles from 'wildfire.yaml'
note

When using container override options (--folder, --snippet, --device), all profiles will be loaded into the specified container, ignoring the container specified in the YAML file.

Show WildFire Antivirus Profile

Display WildFire antivirus profile objects.

Syntax

scm show security wildfire-antivirus-profile [NAME] [OPTIONS]

Arguments

ArgumentDescriptionRequired
NAMEProfile name to display; omit to list allNo

Options

OptionDescriptionRequired
--folder TEXTFolder locationNo*
--snippet TEXTSnippet locationNo*
--device TEXTDevice locationNo*
--output, -o [table|json|yaml]Output format (default: table)No
--max-results INTEGERMaximum number of results to displayNo

* One of --folder, --snippet, or --device is required.

note

When no NAME is specified, all items are listed by default.

Examples

Show Specific Profile

$ scm show security wildfire-antivirus-profile wf-basic \
--folder Texas
---> 100%
WildFire Antivirus Profile: wf-basic
Location: Folder 'Texas'
Description: Basic WildFire profile

List All Profiles (Default Behavior)

$ scm show security wildfire-antivirus-profile --folder Texas
---> 100%
WildFire Antivirus Profiles in folder 'Texas':
------------------------------------------------------------
Name: wf-basic
Description: Basic WildFire profile
------------------------------------------------------------
Name: wf-custom
Description: Custom WildFire rules
------------------------------------------------------------

Backup WildFire Antivirus Profiles

Backup all WildFire antivirus profile objects from a specified location to a YAML file.

Syntax

scm backup security wildfire-antivirus-profile [OPTIONS]

Options

OptionDescriptionRequired
--folder TEXTFolder to backup profiles fromNo*
--snippet TEXTSnippet to backup profiles fromNo*
--device TEXTDevice to backup profiles fromNo*
--file TEXTOutput filename (defaults to auto-generated)No

* One of --folder, --snippet, or --device is required.

Examples

Backup from Folder

$ scm backup security wildfire-antivirus-profile --folder Texas
---> 100%
Successfully backed up 3 WildFire antivirus profiles to wildfire_antivirus_profile_folder_texas_20240115_120530.yaml

Backup with Custom Filename

$ scm backup security wildfire-antivirus-profile \
--folder Texas \
--file texas-wildfire.yaml
---> 100%
Successfully backed up 3 WildFire antivirus profiles to texas-wildfire.yaml

Best Practices

  1. Forward All File Types: Use rules with file_type: ["any"] and application: ["any"] to ensure comprehensive malware analysis coverage.
  2. Enable Packet Capture: Use --packet-capture for forensic analysis when investigating potential malware incidents.
  3. Use Public Cloud Analysis: Set analysis to public-cloud for the broadest threat intelligence coverage from WildFire.
  4. Backup Before Changes: Always backup existing profiles before making bulk modifications via load commands.
  5. Combine with Anti-Spyware: Layer WildFire profiles with anti-spyware and vulnerability protection for defense in depth.