This page will help to show you how to structure your CSV file for importing and updating address and service objects.

• Usage
• CSV Structure
• Example Files

This command allows you to import and export address and service objects. You
can also add objects to groups, as well as remove addreses objects from address groups.

Please run "panco example" for sample CSV file to use as a reference when importing.

See https://github.com/scottdware/panco/Wiki for more information

Usage:
  panco objects [flags]

Flags:
  -a, --action string        Action to perform; import or export
  -d, --device string        Device to connect to
  -g, --devicegroup string   Device Group name when exporting from Panorama (default "shared")
  -f, --file string          Name of the CSV file to import/export to
  -h, --help                 help for objects
  -p, --pass string          Password for the user account specified
  -u, --user string          User to connect to the device as
  -v, --vsys string          Vsys name when exporting from a firewall (default "vsys1")

The CSV file for object creation (import) should be organized with the following columns:

Name,Type,Value,Description,Tags,Device Group/Vsys

• The Description and Tags fields are optional, however you MUST still include them even if they are blank in your file!
• If any line begins with a hashtag #, it WILL be ignored!

NOTE: Here are a few things to keep in mind when creating objects:

• For the name of the object, it cannot be longer than 32 characters, and must only include letters, numbers, spaces, hyphens, and underscores.
• If you are tagging an object upon creation, please make sure that the tags exist prior to creating the objects.
• When creating service groups, you DO NOT need to specify a description, as they do not have that capability.
• When ran against a local firewall, the default value for Vsys is "vsys1" if you do not specify one. When ran against Panorama, the default value for Device Group is "shared."

WARNING: If an existing address or service object has the same name as one you are creating, it's value will be overwritten with what you specify.

For a static address group, Value must contain a comma, or semicolon separated list of members to add to the group, enclosed in quotes "", e.g.:

"ip-host1, ip-net1; fqdn-example.com"

For a dynamic address group, Value must contain the criteria (tags) to match on. This MUST be enclosed in quotes "", and each criteria (tag) must be surrounded by single-quotes ', e.g.:

"'Servers' or 'Web-Servers' and 'DMZ'"

Value must contain a single port number (443), range (1023-3000), or comma separated list of ports, enclosed in quotes, e.g.: "80, 443, 8080".

** Value must contain a comma or semicolon separated list of service objects to add to the group, enclosed in quotes "", e.g.: "tcp_8080, udp_666; tcp_range".

** Value is the color that you want the tag to represent. Below are the following colors available for use:

None, Red, Green, Blue, Yellow, Copper, Orange, Purple, Gray, Light Green, Cyan, Light Gray, Blue Gray, Lime, Black, Gold, Brown, Olive, Maroon, Red-Orange, Yellow-Orange, Forest Green, Turquoise Blue, Azure Blue, Cerulean Blue, Midnight Blue, Medium Blue, Cobalt Blue, Blue Violet, Medium Violet, Medium Rose, Lavender, Orchid, Thistle, Peach, Salmon, Magenta, Red Violet, Mahogany, Burnt Sienna, Chestnut

• objects.csv - Sample file that will create address and service objects.
• update.csv - Sample file that will remove an address object from a group, and add a service object to one.