Skip to content

uzumal/cisco-secure-access-activity-plotter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Cisco Secure Access Activity Plotter

πŸš€ A blazing-fast visualization tool for large-scale CSV exports from Cisco Secure Access (Activity Search).

πŸ“Œ Overview

This project simplifies the visualization of large firewall activity logs exported from Cisco Secure Access.
The raw CSV data can contain hundreds of thousands of entries β€” making manual graphing in Excel or Google Sheets impractical.
This Python-based tool enables fast, scalable, and customizable plotting of key activity trends.


πŸ” Use Cases

  • Security operation center (SOC) analysts visualizing firewall trends
  • IT admins analyzing outbound traffic patterns
  • Quick visualization for incident response or compliance reports
  • CEO/CISO reporting dashboards for visibility into network activity

πŸ›  Features

  • βœ… Supports large CSV exports from Cisco Secure Access
  • πŸ“Š Generates time-based activity plots (daily/hourly, by destination port, etc.)
  • ⚑ Optimized for performance (pandas + matplotlib)
  • πŸ” Easy customization of filters (e.g., only allow ALLOW actions)
  • 🧩 Modular codebase with CSV parsing and plotting separated

πŸ“‚ Repository Structure

β”œβ”€β”€ firewall_csv_output.py # CSV preprocessing logic
β”œβ”€β”€ firewall_plot_output.py # Visualization (plotting) logic
β”œβ”€β”€ sample.csv # Example input (optional)
β”œβ”€β”€ output/ # Where PNG graphs are saved
└── README.md

πŸš€ Getting Started

1. Prerequisites

  • Python 3.8+
  • pandas
  • matplotlib

Install dependencies:

pip install -r requirements.txt
# or manually:
pip install pandas matplotlib

2. Usage

  1. Export CSV from Cisco Secure Access β†’ Activity Search

  2. Place the CSV in the root directory (e.g., activity_log.csv)

  3. Run:

python firewall_csv_output.py activity_log.csv
python firewall_plot_output.py
  1. Graphs will be saved in the output/ directory as PNG files

License

MIT License

Releases

No releases published

Packages

No packages published

Languages