Skip to content

SiteQ8/CIS-Audit-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

14 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

CIS Controls Audit Tool

CIS Controls v8.1 License: MIT GitHub Pages

A web-based reference tool and audit checklist for implementing CIS Critical Security Controls v8.1

๐ŸŽฏ Overview

The CIS Controls Audit Tool is an interactive web tool designed to help security professionals, auditors, and IT teams implement and audit against the CIS Critical Security Controls v8.1. This tool serves as both a reference guide and an audit management platform for anyone wanting to apply CIS Controls in their organization.

Key Features

  • โœ… Complete CIS Controls v8.1 Coverage - All 18 Controls and 153 Safeguards
  • โœ… Interactive Audit Checklist - Track implementation progress with status indicators
  • โœ… Implementation Group Guidance - Detailed information for IG1, IG2, and IG3
  • โœ… Advanced Filtering - Filter by IG level, asset type, and security function
  • โœ… Search Functionality - Quick search across all controls and safeguards
  • โœ… Progress Tracking - Visual progress indicators and completion statistics
  • โœ… Export Capabilities - Download audit reports for documentation
  • โœ… CIS Benchmarks Reference - Information about 100+ technology benchmarks
  • โœ… Framework Mapping - Alignment with NIST, ISO 27001, PCI-DSS
  • โœ… Dark Mode - Eye-friendly interface for extended use
  • โœ… Responsive Design - Works seamlessly on desktop, tablet, and mobile
  • โœ… Offline Capable - Uses localStorage for data persistence

๐Ÿš€ Live Demo

View Live Demo

๐Ÿ—๏ธ Project Structure

CIS-Audit-Tool/
โ”œโ”€โ”€ docs/                          # GitHub Pages site (web GUI)
โ”‚   โ”œโ”€โ”€ index.html                 # Main dashboard page
โ”‚   โ”œโ”€โ”€ controls.html              # Controls explorer page
โ”‚   โ”œโ”€โ”€ audit.html                 # Audit checklist page
โ”‚   โ”œโ”€โ”€ implementation-groups.html # IG details page
โ”‚   โ”œโ”€โ”€ benchmarks.html            # CIS Benchmarks reference
โ”‚   โ”œโ”€โ”€ resources.html             # Resources and guides
โ”‚   โ”œโ”€โ”€ css/
โ”‚   โ”‚   โ”œโ”€โ”€ style.css             # Main stylesheet
โ”‚   โ”‚   โ””โ”€โ”€ themes.css            # Dark/light theme styles
โ”‚   โ”œโ”€โ”€ js/
โ”‚   โ”‚   โ”œโ”€โ”€ app.js                # Main application logic
โ”‚   โ”‚   โ”œโ”€โ”€ data.js               # CIS Controls data
โ”‚   โ”‚   โ”œโ”€โ”€ audit.js              # Audit functionality
โ”‚   โ”‚   โ””โ”€โ”€ utils.js              # Utility functions
โ”‚   โ”œโ”€โ”€ assets/
โ”‚   โ”‚   โ”œโ”€โ”€ images/               # Images and icons
โ”‚   โ”‚   โ””โ”€โ”€ fonts/                # Custom fonts
โ”‚   โ””โ”€โ”€ data/
โ”‚       โ””โ”€โ”€ cis-controls-v8.1.json # CIS Controls data
โ”œโ”€โ”€ scripts/                       # Automation scripts
โ”‚   โ”œโ”€โ”€ audit-templates/          # Audit templates
โ”‚   โ”‚   โ”œโ”€โ”€ audit-template.xlsx   # Excel audit template
โ”‚   โ”‚   โ””โ”€โ”€ audit-template.csv    # CSV audit template
โ”‚   โ””โ”€โ”€ generators/               # Report generators
โ”‚       โ””โ”€โ”€ generate-report.py    # Python report generator
โ”œโ”€โ”€ docs-content/                  # Documentation
โ”‚   โ”œโ”€โ”€ GETTING-STARTED.md        # Getting started guide
โ”‚   โ”œโ”€โ”€ IMPLEMENTATION-GUIDE.md   # Implementation guidance
โ”‚   โ”œโ”€โ”€ API-REFERENCE.md          # API documentation
โ”‚   โ””โ”€โ”€ CONTRIBUTING.md           # Contribution guidelines
โ”œโ”€โ”€ LICENSE                        # MIT License
โ””โ”€โ”€ README.md                      # This file

๐ŸŽ“ What are CIS Controls?

The CIS Critical Security Controls are a prioritized set of actions that collectively form a defense-in-depth set of best practices to mitigate the most common cyber attacks against systems and networks.

CIS Controls v8.1 Structure

  • 18 Controls organized into logical security domains
  • 153 Safeguards providing specific implementation guidance
  • 3 Implementation Groups (IG1, IG2, IG3) for prioritization based on organizational resources and risk

Implementation Groups

Group Safeguards Target Audience
IG1 56 Small/medium enterprises with limited cybersecurity expertise
IG2 +74 (130 total) Organizations with multiple departments and increased complexity
IG3 +23 (153 total) Enterprises with sensitive data and dedicated security teams

๐Ÿ“‹ The 18 CIS Controls

  1. Inventory and Control of Enterprise Assets
  2. Inventory and Control of Software Assets
  3. Data Protection
  4. Secure Configuration of Enterprise Assets and Software
  5. Account Management
  6. Access Control Management
  7. Continuous Vulnerability Management
  8. Audit Log Management
  9. Email and Web Browser Protections
  10. Malware Defenses
  11. Data Recovery
  12. Network Infrastructure Management
  13. Network Monitoring and Defense
  14. Security Awareness and Skills Training
  15. Service Provider Management
  16. Application Software Security
  17. Incident Response Management
  18. Penetration Testing

๐Ÿ› ๏ธ Getting Started

Prerequisites

No prerequisites needed! This is a static web application that runs entirely in the browser.

Installation

Option 1: Use the Live Demo

Simply visit the live demo to start using the tool immediately.

Option 2: Clone and Run Locally

# Clone the repository
git clone https://github.com/SiteQ8/CIS-Audit-Tool.git

# Navigate to the project directory
cd CIS-Audit-Tool

# Open the docs folder (this is your web GUI)
cd docs

# Open index.html in your browser
# On macOS:
open index.html

# On Linux:
xdg-open index.html

# On Windows:
start index.html

# Or use a local server (recommended):
python -m http.server 8000
# Then visit: http://localhost:8000

Option 3: Deploy to Your Own GitHub Pages

  1. Fork this repository
  2. Go to Settings > Pages
  3. Select "main" branch and "/docs" folder as source
  4. Your site will be published at https://[your-username].github.io/CIS-Audit-Tool/

๐Ÿ’ก Usage

Conducting an Audit

  1. Navigate to Audit Checklist: Click on "Audit Checklist" in the sidebar
  2. Filter Safeguards: Use filters to focus on specific Implementation Groups
  3. Mark Progress: Click checkboxes and update status for each safeguard
  4. Track Progress: View real-time progress indicators
  5. Add Notes: Document findings and implementation details
  6. Export Results: Download your audit report in multiple formats

Exploring Controls

  1. Browse Controls: Navigate to "Controls Explorer"
  2. View Details: Click on any control to see detailed information
  3. Filter & Search: Use filters to find specific controls
  4. Reference Safeguards: See all associated safeguards for each control

Implementation Guidance

  1. Select Your IG Level: Navigate to "Implementation Groups"
  2. Review Requirements: Understand which safeguards apply to you
  3. Access Resources: Visit "Resources" for implementation guides
  4. Check Benchmarks: Reference relevant CIS Benchmarks for your technologies

๐Ÿ”ง Advanced Features

Data Persistence

All audit progress is automatically saved to your browser's localStorage. Your work persists across sessions without requiring a database or server.

Export Formats

  • JSON: Machine-readable format for integration
  • CSV: Import into Excel or other tools
  • HTML: Printable audit report
  • PDF: Professional documentation (coming soon)

Search and Filter

Advanced filtering options:

  • Implementation Group: IG1, IG2, IG3
  • Asset Type: Devices, Software, Data, Users, Network, Documentation
  • Security Function: Identify, Protect, Detect, Respond, Recover, Governance
  • Status: Not Started, In Progress, Completed, Not Applicable

๐Ÿค Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

  • ๐Ÿ› Report Bugs: Found a bug? Open an issue
  • ๐Ÿ’ก Suggest Features: Have an idea? Start a discussion
  • ๐Ÿ“ Improve Documentation: Help make the docs better
  • ๐Ÿ”ง Submit Pull Requests: Fix bugs or add features

Development Setup

# Fork and clone the repository
git clone https://github.com/[your-username]/CIS-Audit-Tool.git

# Create a new branch
git checkout -b feature/your-feature-name

# Make your changes

# Test thoroughly

# Commit your changes
git commit -m "Add: your feature description"

# Push to your fork
git push origin feature/your-feature-name

# Open a Pull Request

๐Ÿ“š Documentation

  • Getting Started Guide - Quick start guide
  • Implementation Guide - Detailed implementation guidance
  • API Reference - Technical documentation
  • FAQ - Frequently asked questions

๐Ÿ”— Related Resources

Official CIS Resources

Framework Mappings

Community Resources

๐Ÿ™ Acknowledgments

  • Center for Internet Security (CIS) - For developing and maintaining the CIS Controls
  • CIS Community - For collaborative development of security best practices
  • Contributors - Thank you to all who have contributed to this project

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

Third-Party Resources

  • CIS Controlsยฎ is a registered trademark of the Center for Internet Security
  • This tool is not officially endorsed by the Center for Internet Security
  • All CIS Controls content is used in accordance with CIS licensing terms

โš ๏ธ Disclaimer

This tool is provided for reference and educational purposes. While it aims to accurately represent the CIS Controls v8.1, users should:

  • Refer to official CIS documentation for authoritative guidance
  • Validate all implementations against your organization's requirements
  • Consult with security professionals for critical implementations
  • Keep the tool updated with the latest CIS Controls versions

๐Ÿ“ง Contact

Project Maintainer: @SiteQ8

๐Ÿ“ˆ Roadmap

Version 1.0 (Current)

  • โœ… Complete CIS Controls v8.1 coverage
  • โœ… Interactive audit checklist
  • โœ… Implementation Group guidance
  • โœ… Dark mode support
  • โœ… Export functionality

Version 1.1 (Planned)

  • โณ PDF export for audit reports
  • โณ Multi-user collaboration features
  • โณ Integration with CIS-CAT Pro
  • โณ Automated compliance scoring
  • โณ Evidence attachment support

Version 2.0 (Future)

  • ๐Ÿ”ฎ Backend API for team collaboration
  • ๐Ÿ”ฎ Role-based access control
  • ๐Ÿ”ฎ Custom control frameworks
  • ๐Ÿ”ฎ Integration with SIEM tools
  • ๐Ÿ”ฎ Automated remediation suggestions

Built with โค๏ธ by cybersecurity professionals, for cybersecurity professionals

"Security is not a product, but a process." - Bruce Schneier

About

A web-based reference tool and audit checklist for implementing CIS Critical Security Controls v8.1

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages