{"id":22880636,"url":"https://github.com/elliotsecops/network-auditor","last_synced_at":"2025-05-07T02:22:04.659Z","repository":{"id":257338981,"uuid":"857909489","full_name":"elliotsecops/Network-Auditor","owner":"elliotsecops","description":"Script en Python diseñado para auditar e informar de las configuraciones de red del sistema en sistemas Linux. // Python script designed to audit and report system network configurations on Linux systems.","archived":false,"fork":false,"pushed_at":"2024-11-01T16:23:15.000Z","size":36,"stargazers_count":8,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T05:23:15.022Z","etag":null,"topics":["cybersecurity","network-analysis","network-security","python-automation","security-analysis","security-audit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elliotsecops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-15T23:14:24.000Z","updated_at":"2025-03-09T22:15:21.000Z","dependencies_parsed_at":"2024-11-01T16:25:43.650Z","dependency_job_id":"5cee0b3c-d9f3-4025-9d3a-cc4a6c4cf111","html_url":"https://github.com/elliotsecops/Network-Auditor","commit_stats":null,"previous_names":["elliotsecops/network-auditor"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FNetwork-Auditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FNetwork-Auditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FNetwork-Auditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FNetwork-Auditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elliotsecops","download_url":"https://codeload.github.com/elliotsecops/Network-Auditor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252799205,"owners_count":21805954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","network-analysis","network-security","python-automation","security-analysis","security-audit"],"created_at":"2024-12-13T17:20:26.756Z","updated_at":"2025-05-07T02:22:04.638Z","avatar_url":"https://github.com/elliotsecops.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Network-Auditor\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Python script designed to simplify network troubleshooting and auditing for system administrators, security professionals, and network engineers on Linux systems. Network-Auditor streamlines the process by providing a single, unified view of key network configurations in an easy-to-read, color-coded format.\n\n## Features\n\n* **List Network Interfaces:** Displays all network interfaces and their statuses (up/down).\n* **Show IP Addresses:** Shows IP addresses assigned to each interface.\n* **Show Routing Table:** Displays the current routing table.\n* **Show Firewall Rules:** Shows the current UFW (Uncomplicated Firewall) rules. Requires `sudo` access.\n* **List Open Connections:** Lists open network connections.\n* **List Docker Networks:** Lists Docker networks and their connected containers with IP addresses (requires Docker).\n* **Run All Checks:** Performs all of the above checks in sequence.\n* **Interactive Menu:** Provides a user-friendly menu for easy navigation.\n* **Color-Coded Output:** Enhances readability and highlights important information.\n* **Logging:** Records all actions and errors in `audit_network.log` for auditing and debugging.\n* **Command-line option:** Run all checks non-interactively with `--all`.\n\n## Prerequisites\n\n* **Python 3.x:** Ensure Python 3.x is installed.\n* **Tabulate Library:** Install using: `pip install tabulate`\n* **Required System Commands:** `ip`, `ss`, `ufw` (for firewall rules), `docker` (for Docker network listing).\n\n## Installation\n\n1. **Clone the Repository:**\n   ```bash\n   git clone https://github.com/elliotsecops/Network-Auditor.git\n   cd Network-Auditor\n   ```\n\n2. **Install Required Packages:**\n   ```bash\n   pip install tabulate\n   ```\n\n## Usage\n\n1. **Interactive Mode:**\n   ```bash\n   python3 network_audit.py \n   ```\n   Follow the on-screen menu to select the desired checks.\n\n2. **Run All Checks (Non-Interactive):**\n   ```bash\n   sudo python3 network_audit.py --all  # Recommended to run with sudo for full functionality\n   ```\n   or\n   ```bash\n   python3 network_audit.py --all # Some features won't work\n   ```\n\n## Security Considerations\n\nNetwork-Auditor requires superuser privileges (`sudo`) for certain checks, like viewing firewall rules. It is recommended to run the entire script using `sudo` for complete functionality. If you choose to run without `sudo`, some features will not work correctly. If you run it interactively, the script will prompt you for your password when elevated privileges are required. Use `sudo` judiciously and be aware of the potential security implications of running scripts with elevated privileges.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to open issues or submit pull requests for bug reports, feature requests, or other improvements. For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Acknowledgments\n\n* The `tabulate` library for creating formatted tables.\n\n## Contact\nelliotsecops@proton.me\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felliotsecops%2Fnetwork-auditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felliotsecops%2Fnetwork-auditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felliotsecops%2Fnetwork-auditor/lists"}