Skip to content

Repository files navigation

🛡️ AuditSentry — Linux System Audit & Security Assessment Tool

AuditSentry is a Bash-based Linux system auditing utility that collects critical system, security, and configuration information to help administrators assess the health and security posture of Linux servers.

Developed as a practical Linux administration project, AuditSentry automates routine auditing tasks by gathering hardware information, resource utilisation, user activity, process status, security configuration, and system logs into a comprehensive audit report.


✨ Features

  • 🖥️ Collects system and hardware information
  • 📊 Reports CPU, memory, and disk utilization
  • 👥 Lists active users and running processes
  • 🌐 Identifies listening ports and network services
  • 🔐 Reviews SSH configuration
  • 🚨 Detects SUID and SGID files
  • 📜 Summarizes recent system logs
  • ⚡ Lightweight and compatible with most Linux distributions

📂 Project Structure

AuditSentry/
├── audit-report.sh
├── reports/
└── README.md

🚀 Installation

Clone the repository:

git clone https://github.com/Kachinonye/AuditSentry.git

Navigate to the project directory:

cd AuditSentry

Make the script executable:

chmod +x audit-report.sh

▶️ Usage

Run the audit tool:

./audit-report.sh

AuditSentry automatically gathers key system information and produces a structured audit report for review.


📋 Audit Categories

AuditSentry currently examines:

  • Operating system information
  • Hardware details
  • CPU utilization
  • Memory utilization
  • Disk usage
  • Active user sessions
  • Running processes
  • Open ports
  • SSH configuration
  • SUID/SGID files
  • Recent system logs

💼 Skills Demonstrated

This project showcases practical experience with:

  • Linux System Administration
  • Bash Shell Scripting
  • Security Auditing
  • System Diagnostics
  • Resource Monitoring
  • Process Management
  • Network Inspection
  • Log Analysis
  • Security Assessment
  • Technical Documentation

🎯 Use Cases

AuditSentry is useful for:

  • Linux System Administrators
  • Junior DevOps Engineers
  • Security Analysts
  • Home Lab Audits
  • Server Health Reviews
  • Security Baseline Assessments
  • Linux Administration Training

🔮 Planned Enhancements

Future releases may include:

  • HTML audit reports
  • JSON report export
  • Compliance checks
  • CIS benchmark integration
  • Scheduled audits with cron
  • Email report delivery
  • Severity scoring
  • Configuration file support

👨‍💻 Author

Kachinonye Nmezi

Junior Linux Administrator | Bash Scripting & Automation Specialist

GitHub: https://github.com/Kachinonye

LinkedIn: https://www.linkedin.com/in/kachinonye-nmezi-74170723b/


📜 License

Licensed under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages