This is a NAPALM community driver for the Cisco ASA platform.
This driver makes use of the Cisco ASA REST API. The REST API is only available from software version 9.3.2 and up, and on the 5500-X series, ASAv, ASA on Firepower and ISA 3000 platforms.
For latest information on the ASA REST API Compatibility check the compatibility matrix(PDF)
pip install napalm-asafrom napalm import get_network_driver
driver = get_network_driver("asa")
device = driver(hostname='192.168.1.1', username='cisco', password="cisco", optional_args = {'port': 8443})
device.open()
facts = device.get_facts()
device.close()Check the full NAPALM Docs for more detailed instructions.
| Getter | Support |
|---|---|
| get_arp_table | ✅ |
| get_bgp_config | ❌ |
| get_bgp_neighbors | ❌ |
| get_bgp_neighbors_detail | ❌ |
| get_config | ✅ |
| get_environment | ❌ |
| get_facts | ✅ |
| get_firewall_policies | ❌ |
| get_interfaces | ✅ |
| get_interfaces_counters | ❌ |
| get_interfaces_ip | ✅ |
| get_ipv6_neighbors_table | ❌ |
| get_lldp_neighbors | ❌ |
| get_lldp_neighbors_detail | ❌ |
| get_mac_address_table | ❌ |
| get_network_instances | ❌ |
| get_ntp_peers | ❌ |
| get_ntp_servers | ❌ |
| get_ntp_stats | ❌ |
| get_optics | ❌ |
| get_probes_config | ❌ |
| get_probes_results | ❌ |
| get_route_to | ❌ |
| get_snmp_information | ❌ |
| get_users | ❌ |
| is_alive | ✅ |
| ping | ❌ |
| traceroute | ❌ |
Mock tests are usefull for quickly iterating when writing a new getter of fixing a bug, but you do want to test on a 'real' device to make sure everything works as expected. One of the most convenient ways is to use an ASAv running on Virtualbox + Vagrant. @bobthebutcher has a nice write up on how to setup an ASAv with Vagrant.