Skip to main content

Cisco Config Auditor

Code style: black Imports: isort LICENSE Commit Activity Say Thanks!

Based on Use Cisco IOS XE Hardening Guide and some opinionated best practices.

This script gives an overview of the hardening techniques that can be used to secure a Cisco network device. 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

$ pip install ciscoconfaudit

Clone repo, create a virtual environment, and install requirements.

macOS or Linux

$ git clone https://github.com/Tes3awy/cisco-config-auditor.git
$ cd auditor
$ python3 -m venv .venv --upgrade-deps
$ source .venv/bin/activate .
(.venv) $ python3 -m pip install -r requirements.txt

Windows

Note On Microsoft Windows, it may be required to enable the Activate.ps1 script by setting the execution policy for the user.
You can do this by issuing the following PowerShell command:
PS C:> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
See About Execution Policies for more information.

In PowerShell

> git clone https://github.com/Tes3awy/cisco-config-auditor.git
> cd auditor
> python -m venv .venv --upgrade-deps
> .venv\Scripts\Activate.ps1  # Check
(.venv) > pip install -r requirements.txt

Usage

You can try out two examples in the repo.

(.venv) $ python3 online.py   # parses config from a device (Uses netmiko)
(.venv) $ python3 offline.py  # parses config from text file

Credits

This package was inspired by jonarm from cisco-ios-audit.

Author

Osama Abbas

Contibutions

You are welcome to contribute to this Cisco swiss-army knife.

Metadata

Release files for ciscoconfaudit 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ciscoconfaudit 0.1.0
File Size Uploaded
ciscoconfaudit-0.1.0.tar.gz 46.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ciscoconfaudit 0.1.0
File Interpreter ABI Platform
ciscoconfaudit-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 79.5 kB

Release files / ciscoconfaudit-0.1.0.tar.gz

Download URL ciscoconfaudit-0.1.0.tar.gz
Size 46.7 kB
Tags Source
SHA-256 checksum
How to use checksums
bea666f0bdbf8a6446289c09527d4010fbb0a7e4aea77dacb99eba345b21693f
BLAKE2b-256 checksum
How to use checksums
c73e3b4965388193d0cecbe8d7e4e4f070426bb2417d2baf8d573ef758e98664
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.11.8

Release files / ciscoconfaudit-0.1.0-py3-none-any.whl

Download URL ciscoconfaudit-0.1.0-py3-none-any.whl
Size 32.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dce90f11062c5c8071fd98689e32a4bc2682e714f3f9691e5d930db7bc3ff052
BLAKE2b-256 checksum
How to use checksums
d7a3dd7f3b0d80929723081051c35544e3e4d0ca352d75daa1dc17db2f82ee11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.11.8

Release history Release notifications | RSS feed

0.2.1

1 release file

0.2.0

1 release file

0.1.2

2 release files

0.1.1

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page