Adding Cisco ASA Firewall Devices

Overview

TOS Aurora monitors ASA firewall devices for policy revision changes. For TOS Aurora to show full accountability details (who made the policy changes and when the changes were made), you must also configure the device to send syslogs. To help you organize the information for your devices, you can use the device information worksheet. To see which TOS features are supported for your device, review the feature support table.

Prerequisites

TOS Aurora and the monitored devices must be synchronized with the correct date and time, either manually or automatically. We recommend that you also configure the devices to resolve DNS queries.

Before you start, make sure that the device user account that you use for TOS Aurora monitoring has permission to run these commands:

  • Retrieve revision:

    show running-config
    show access-list
    show ipv6 access-list
    show clock
    show version
    terminal pager 512
    show cluster info

  • Retrieve dynamic topology:

    show version
    show name
    show route
    show route management-only
    show interface

  • Virtual context:

    changeto context <context_name>

  • Provisioning:

    changeto system
    show context
    exit
    configure terminal
    end
    write memory

Adding a Cisco ASA Firewall Device

  1. In TOS Aurora, go to Monitoring > Manage Devices.

  2. Select the appropriate device type:

    Add Cisco

  3. Configure the device settings:

    • Name for Display

    • Domain: Available only if you have configured your system for managing multi-domains and All Domains is currently selected. Select the domain to which to add the device. The Domain can only be entered when adding a device; to change the Domain, you must migrate the device.

    • Get revisions from: One of the following:

      • IP Address: Revisions are retrieved automatically
      • Offline File: (If available) Revisions are manually uploaded to TOS Aurora for Offline Analysis

    • ST server: In a distributed deployment, select which TOS Aurora cluster monitors this device (not shown in image)

    • To enable adding and monitoring Virtual Contexts, select This device has Virtual Contexts configured.
    • Collect counters for rule usage analysis is necessary for Rule Usage reports.

    • Collect counters for object usage analysis enables Rule Usage reports to include per-object usage information.

      Object usage analysis requires plenty of free disk space (depending on the number of gateways and the amount of traffic logs generated). If disk space is limited, you can configure TOS Aurora to limit the number of days that data is kept.

      We recommend that you enable TOS Aurora administrative alerts, which notify you if there is low disk space on the server. When disk utilization exceeds 90% in the partition that has the database, TOS Aurora sends an alert.

    • Enable Topology: Collects routing information for building the network Interactive Map.
      Topology options for Advanced management mode are configured when you import managed devices.
    • If the device uses dynamic addressing (such as DHCP) or dynamic routing protocols (such as OSPF), also select Collect dynamic topology information. To collect dynamic topology information from Cisco routers using SNMP v2 or v3, select SNMP in the next stage and specify the protocol details for your device.

    Click Next.

  4. Configure the TOS Aurora connection to the Cisco ASA Firewall device, according to the parameters required by the device. To use a vault server that contains access credentials, select Use Vault and select the server. For more information, see Configuring a Vault Server.

    • Enter the authentication details needed to connect to the Cisco ASA Firewall device.

      • Username and password: Enter the device username and password
      • Enable password: Enter the password to give TOS Aurora elevated privileges on the device
      • Login: If your device requires the Login password, select this option and enter the username and password that is required for the login command

    • Select whether to use SSH (preferred) or Telnet.

      You can configure the connection to use either SSH version 1 or 2 with the Override SSH version option.

    • To use default settings (recommended in most cases), leave the Port number and both Override options clear.

    • If TOS Aurora is configured to automatically replace the SSH host key when a new SSH host key is detected for a device, you can Override SSH host key settings to prevent the host key from being replaced for this device.

      You can then set TOS Aurora to Replace SSH host key automatically for this specific device.

      Warning: Automatic replacement of the SSH host key can expose your server to security risks and is not recommended.

    • Override SSH Version: Select this option to force the device to use SSH-1 or SSH-2
    • Override Cipher: Select this option to force the device to use DES or 3DES encryption

    Click Next.

  5. In Monitoring Settings, do one of the following:

    • To use real-time monitoring and timing settings from the Timing page, select Default.

    Otherwise, select Custom and configure the monitoring mode and settings.

    Real-Time Monitoring: Applies only if syslogs (Configuring Devices to Send Logs) are configured. Select Custom settings and configure:

    • 'Install policy' interval: When two or more Install Policy events for the same policy occur within this time interval, TOS Aurora combines the events into a single Install Policy revision (Default: 60 seconds)
    • Automatic fetch frequency: Frequency (in minutes) for automatic fetch 
    • Periodic Polling, select Custom settings and configure the Polling frequency: How often TOS Aurora fetches the configuration from each device.

      If you select 1 day, you can then select the exact time (hour and minute) for the daily polling.

    Click Next. 

  6. Save the configuration.

    The Cisco ASA Firewall device now appears in the Monitored Devices tree.

  7. To manually add Virtual Contexts to your device, wait for a revision to be received from the device (you can see the revision in Compare view). This may take several minutes. Then, add the Virtual Contexts:

    1. In the Monitored Devices tree, select the device.
    2. Click Import Virtual Contexts (only enabled for Manual Import):

      Import Cisco Virtual Contexts

    3. Select all the Virtual Contexts to be added.

      If the option to collect rule and object usage statistics for virtual contexts is available, it is enabled.

      If you do not want to collect these statistics, clear the options before you import the virtual contexts.

    4. Click Save.

For TOS Aurora to show full accountability details (who made the policy changes and when the changes were made), you must also configure the device to send syslogs.

How Do I Get Here?

In TOS Aurora, go to Monitoring > Manage Devices.