CyberSec-Assistant-Lab - Defensive Linux security audit assistant with read

项目说明

CyberSec Assistant Lab

Учебный defensive-инструмент локального аудита Linux для портфолио Junior
Linux System Administrator / Junior Security Specialist. Проект демонстрирует
безопасный запуск системных команд, обработку ошибок, тестирование, отчётность,
CI и контейнеризацию.

Назначение

Программа выполняет безопасный локальный аудит Linux-системы:

Проект не эксплуатирует уязвимости, не подбирает пароли, не обходит
аутентификацию и не изменяет конфигурацию системы. Все проверки read-only.

Статусы

| Статус | Значение |
|---|---|
| PASS | Проверка выполнена, явных проблем не найдено |
| WARN | Найдена потенциальная проблема или нужен ручной анализ |
| FAIL | Проверка выявила нарушение политики безопасности |
| ERROR | Проверку невозможно выполнить в текущем окружении |

Быстрый запуск

JSON- и HTML-отчёты появятся в каталоге reports/.

Запуск тестов

Запуск в Docker

Соберите образ:

Запустите аудит и сохраните отчёты в локальном каталоге reports/:

PowerShell:

Контейнер запускается от непривилегированного пользователя и по умолчанию
проверяет только собственное окружение контейнера. Для полноценного аудита
Linux-хоста запускайте программу непосредственно на хосте. Не используйте
--pri и не монтируйте в контейнер секреты, /etc/shadow или SSH-ключи.

Демонстрация

Полный HTML-отчёт, созданный при безопасном запуске в Docker:

<a href="screenshots/html-report.png">
<img src="screenshots/html-report.png" alt="Полный HTML-отчёт CyberSec Assistant" width="420">
</a>

Красные статусы ERROR на демонстрационном снимке ожидаемы: минимальный
контейнер не содержит sudo, SSH-сервер, systemctl и journalctl. Инструмент
корректно сообщает об отсутствии компонентов и продолжает остальные проверки.

Структура

Дополнительные каталоги:

Модель безопасности

Ограничения

Разработка

Перед отправкой изменений:

GitHub Actions автоматически запускает тесты при push и pull_request.
Правила участия описаны в CONTRIBUTING.md, а безопасного
сообщения об уязвимостях — в SECURITY.md.

Roadmap

План дальнейшего развития находится в docs/ROADMAP.md.

项目信息

开发语言：Python

Star 数：1

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Defensive Linux security audit assistant with read-only system checks, SSH and journal analysis, security update detection, JSON/HTML reports, tests, CI, and Docker support.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。