https://github.com/tes3awy/cisco-config-auditor

Cisco IOS XE Configuration Auditor
https://github.com/tes3awy/cisco-config-auditor

audit automation cisco-iosxe configuration-parser devnet

Last synced: 3 months ago
JSON representation

Cisco IOS XE Configuration Auditor

• Host: GitHub
• URL: https://github.com/tes3awy/cisco-config-auditor
• Owner: Tes3awy
• License: gpl-3.0
• Created: 2024-02-13T20:43:50.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-07-12T13:30:16.000Z (about 1 year ago)
• Last Synced: 2024-10-14T07:54:11.921Z (9 months ago)
• Topics: audit, automation, cisco-iosxe, configuration-parser, devnet
• Language: Python
• Homepage: https://pypi.org/project/ciscoconfaudit/
• Size: 382 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ciscoconfaudit

[![published](https://static.production.devnetcloud.com/codeexchange/assets/images/devnet-published.svg)](https://developer.cisco.com/codeexchange/github/repo/Tes3awy/cisco-config-auditor)

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ciscoconfaudit)

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)

[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat-square&labelColor=ef8336)](https://pycqa.github.io/isort/)

![LICENSE](https://img.shields.io/github/license/Tes3awy/cisco-config-auditor?color=purple&style=flat-square&label=LICENSE)

![Commit Activity](https://img.shields.io/github/commit-activity/m/Tes3awy/cisco-config-auditor/main?logo=github&style=flat-square)

![PyPI - Version](https://img.shields.io/pypi/v/ciscoconfaudit)

![PyPI - Status](https://img.shields.io/pypi/status/ciscoconfaudit)

[![Downloads](https://static.pepy.tech/badge/ciscoconfaudit)](https://pepy.tech/project/ciscoconfaudit)

[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/Tes3awy)

> Based on [Use Cisco IOS XE Hardening Guide](https://www.cisco.com/c/en/us/support/docs/ios-nx-os-software/ios-xe-16/220270-use-cisco-ios-xe-hardening-guide.html) and some opinionated best practices.

This package gives an overview of the hardening techniques that can be used to secure a Cisco network device. Network security is not a one-layer thing, yet, it depends on multiple factors. If you harden your devices, then it is a good starting point that increases the overall security of the environment you manage.

## Installation

> Install from PyPi

```bash

$ pip install ciscoconfaudit

```

## Usage

You can try out _two examples_ in the repo in [examples](https://github.com/Tes3awy/cisco-config-auditor/tree/main/examples).

```bash

(.venv) $ python3 basic_online.py   # Parses config from a device (Uses netmiko)

(.venv) $ python3 basic_offline.py  # Parses config from text file

```

### Example Output

| Global Config Audit (Sample)                                                                                     | Interface-Level Audit                                                                                                |

| ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |

| ![Global Config Audit](https://github.com/Tes3awy/cisco-config-auditor/blob/main/assets/global-config-audit.jpg) | ![Interface Level Audit](https://github.com/Tes3awy/cisco-config-auditor/blob/main/assets/interface-level-audit.jpg) |

## Use Case

- Ever been tired of checking whether the Cisco hardneing technqiues (_[here](https://www.cisco.com/c/en/us/support/docs/ios-nx-os-software/ios-xe-16/220270-use-cisco-ios-xe-hardening-guide.html)_) are applied to your network devices one by one? This package is very handy in generating a tabular report for you.

## Author

[Osama Abbas](https://github.com/Tes3awy)

## Credits

This package was inspired by [jonarm](https://github.com/jonarm) from [cisco-ios-audit](https://github.com/jonarm/cisco-ios-audit).

## Contributions

You are welcome to contribute to this Cisco [Swiss army knife](https://en.wikipedia.org/wiki/Swiss_Army_knife).