Driver Support Document

Cisco firewalls, ASA Series, Context within Multiple Mode (OBSOLETE, PLEASE REDISCOVER)

Show Tested Devices Grid

SYSOID Mapping
SYSOID MODEL OS VERSION
 1.3.6.1.4.1.9.1.669 ciscoASA5520 8.0, 8.1, 8.2
 1.3.6.1.4.1.9.1.670 ciscoASA5520 7.x, 8.0, 8.1, 8.2
 1.3.6.1.4.1.9.1.672 ciscoASA5540 7.x, 8.0, 8.1, 8.2
 1.3.6.1.4.1.9.1.673 ciscoASA5540sc 7.x, 8.0, 8.1, 8.2
 1.3.6.1.4.1.9.1.745 ciscoASA5505 7.x, 8.0, 8.1, 8.2
 1.3.6.1.4.1.9.1.914 ciscoASA5580 7.x, 8.0, 8.1, 8.2

Driver Features Support Grid

Driver FeaturesAccess Methods
(X signifies feature support)CLISNMPTFTPCLI+TFTPSNMP+TFTPFTPCLI+FTPSNMP+FTPCLI+SFTPSCPCLI+SCPSNMP+SCPHTTP/HTTPS
  Driver Discovery                            
X General Access release notes
(CLI protocols: telnet, ssh1, ssh2, console)
X     X                  
Configuration
X Retrieve Running Configuration release notes X     X                  
X Retrieve Startup Configuration   X     X                  
  Retrieve Binary Configuration                            
X Device information parsing  
X Enhanced Layer2 Basic IP information parsing  
  Configuration Deployment to Running release notes                          
  Configuration Deployment to Startup                            
  Binary Configuration Deployment                            
Diagnostics
X Routing Table   X                        
X OSPF Neighbors   X                        
X Interfaces   X                        
  Modules and Inventory                            
  Flash Storage Space                            
  File System                            
X Uptime     X                      
X ICMP Test   X                        
X Topology Parsing   X                        
X Duplex Parsing   X                        
  Enhanced VLAN Parsing  
Features
  Software Center                            
  Software Image Synchronization                            
X Password Management release notes
(Can modify: limited username, limited password, full password)
X                        
X Syslog Configuration and Change Detection release notes Syslog patterns X                        
X Custom Scripts and Diagnostics  
Bulk deploy available
X                        
X ACL Parsing  
  ACL Provisioning                            
  VLAN Provisioning                            
X Configlet Parsing  
X QoS Parsing  
  VRF Parsing  
  Context Management                            

Password Management

Release Notes

SNMP Updater not available in client contexts

Because of community string masking that is specific to the Cisco ASA, support for updating SNMP community strings has been removed from this driver.

return to top

General Access

Release Notes

Context Connections

Connections to Cisco ASA child devices can go through the parent device. However, if the Telnet and SSH connection methods on the Cisco ASA child device do not match the parent device's connection methods, some communications could fail because the child device's connection method settings do not override the parent device's connection method settings.

Disabling context management

The context management feature adds independent device entries for contexts on the device automatically by using the inventory diagnostic. This feature can be disabled by adding the access variable "disable_context" and setting it to true. Disabling the feature will remove any previously created context devices permanently and will result in the inability to directly manage contexts with NA. Changes will take effect the next time the inventory diagnostic task is run.

return to top

Password Management

Release Notes (inherited)

SNMP Updater cannot modify SNMP hosts

The SNMP community string updater can update, modify, or remove SNMP community strings. It cannot add, modify, or remove SNMP host entries that might be needed for desired SNMP functionality.

Changing limited password

The Limited Access Password field in the Deploy Passwords task only changes the telnet console access password, using the passwd command on the device.

return to top

Syslog Configuration and Change Detection

Release Notes

Syslog interface must be defined

Cisco Firewalls require the specification of the interface to be used for relaying of syslog messages. The custom access variable "SyslogInterface" should be set to the correct interface to ensure correct operation of Syslog tasks.

return to top

Retrieve Running Configuration

Release Notes

Device masking of running and startup configurations

The "show running-config" & "show startup-config" commands mask important information in the output. However, snapshots via CLI is made available to address snapshot support for Client Contexts that don't have an outside path for TFTP use.

When supported, the "more system:running-config" or TFTP snapshots allows for capture of non-masked information. As of consequence the behavior of ASA drivers in regard to snapshots provide for the following:

Single-mode devices:
CLI snapshot option is available only for capturing the running-configuration.
Capturing Startup-config via CLI is disabled as it runs the risk of capturing masked information.
TFTP via CLI is enabled for capturing both running-config & startup-config.

Admin-context in multiple mode:
CLI is disabled because the "more system:running-config" is unsupported
TFTP via CLI is enabled for capturing both running-config & startup-config.

System Context in multiple mode:
CLI snapshot is enabled for capturing both running-config & startup-config.
TFTP via CLI is enabled for capturing both running-config & startup-config.

Client Context in multiple mode:
CLI snapshots use "show running-config" & "show startup-config" commands and can contain masked information.
TFTP via CLI is enabled for capturing both running-config & startup-config if an outside path for TFTP use is available.

'Memory Troubleshooting for Cisco PIX configuration' diagnostic in client contexts

The 'Memory Troubleshooting for Cisco PIX configuration' diagnostic requires the "show proc" command. This command can be issued on the device itself, but it is unavailable on the device's security contexts. When the diagnostic is run within a context, the task fails.

return to top

Configuration Deployment to Running

Release Notes

Configuration deployment in client contexts

Configuration Deployment is disabled for Client-Context as it can result in overwriting valid information with masked content.

Double-check deployed configurations

The PIX occasionally has difficulty merging new configuration commands with the existing configuration. Because of this, we recommend that you double-check PIX configurations after you deploy them from the system.

First, take a snapshot of the configuration. Then check whether your changes were actually deployed to the running configuration as expected. Sometimes the system reports the deployment as failed, but still applies changes to the running configuration.

return to top

Retrieve Running Configuration

Release Notes (inherited)

May need to change the TFTP interface access setting

To retrieve (or deploy) a PIX device configuration using TFTP, you may need to specify the TFTP interface to use on the device. If the device self-selects the wrong interface for the TFTP settings, you can override the TFTP interface access setting in the device's password rules in the system. Note that you must either set up a device-specific password rule or define a password rule that applies specifically to PIX devices that are exhibiting this problem.

To change a device password rule:

  1. Edit the device and select "Use device-specific password information" or create or edit a device password rule applying to the appropriate device(s).
  2. Click "Show Device Access Settings"
  3. Choose "PIX TFTP interface" from one of the drop-down menus for "Name"
  4. Enter the desired interface (e.g. "outside") for the "Value" of this setting.
  5. Ensure all other authentication information is correct, and then save the device or password rule.

return to top

Configuration Deployment to Running

Release Notes (inherited)

Double-check deployed configurations

The PIX occasionally has difficulty merging new configuration commands with the existing configuration. Because of this, we recommend that you double-check PIX configurations after you deploy them from the system.

First, take a snapshot of the configuration. Then check whether your changes were actually deployed to the running configuration as expected. Sometimes the system reports the deployment as failed, but still applies changes to the running configuration.

return to top

Syslog Configuration and Change Detection

Release Notes (inherited)

No support for real-time change detection via AAA

The PIX does not support accounting sessions. Therefore, the system cannot provide real-time change detection through AAA.

Syslog interface must be defined

Cisco Firewalls require the specification of the interface to be used for relaying of syslog messages. The custom access variable "SyslogInterface" should be set to the correct interface to ensure correct operation of Syslog tasks.

return to top

Password Management

Release Notes (inherited)

SNMP Updater cannot modify SNMP hosts

The SNMP community string updater can update, modify, or remove SNMP community strings. It cannot add, modify, or remove SNMP host entries that might be needed for desired SNMP functionality.

Changing limited password

The Limited Access Password field in the Deploy Passwords task only changes the telnet console access password, using the passwd command on the device.

return to top

Syslog Triggering

return to top