{"id":27525617,"url":"https://github.com/downstize/security-events-suite","last_synced_at":"2026-05-16T08:39:23.729Z","repository":{"id":287958577,"uuid":"966359692","full_name":"Downstize/security-events-suite","owner":"Downstize","description":"Система генерации и обработки событий с формированием инцидентов по заданным шаблонам. Построена на ASP.NET Core и включает два микросервиса: генератор событий и процессор инцидентов.","archived":false,"fork":false,"pushed_at":"2025-04-14T20:10:55.000Z","size":3493,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-24T22:48:49.941Z","etag":null,"topics":["aspnet-core","docker","dotnet6","entity-framework-core","microservices","rest-api"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Downstize.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SecurityEventsSuite.sln","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-14T19:58:14.000Z","updated_at":"2025-04-14T20:14:52.000Z","dependencies_parsed_at":"2025-04-14T21:35:51.060Z","dependency_job_id":null,"html_url":"https://github.com/Downstize/security-events-suite","commit_stats":null,"previous_names":["downstize/security-events-suite"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Downstize/security-events-suite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Downstize%2Fsecurity-events-suite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Downstize%2Fsecurity-events-suite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Downstize%2Fsecurity-events-suite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Downstize%2Fsecurity-events-suite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Downstize","download_url":"https://codeload.github.com/Downstize/security-events-suite/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Downstize%2Fsecurity-events-suite/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267320259,"owners_count":24068527,"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","status":"online","status_checked_at":"2025-07-27T02:00:11.917Z","response_time":82,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["aspnet-core","docker","dotnet6","entity-framework-core","microservices","rest-api"],"created_at":"2025-04-18T14:27:07.987Z","updated_at":"2026-05-16T08:39:23.698Z","avatar_url":"https://github.com/Downstize.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Security Events Suite\n\n## 📌 Описание проекта\n\nSecurity Events Suite — это система для генерации и обработки событий, которая используется для создания и хранения инцидентов на основе поступающих данных (например, событий системы безопасности от камер или датчиков).\n\nВ системе реализованы два сервиса:\n\n- **Generator Service**  \n  Генерирует события автоматически в случайные интервалы (примерно в диапазоне [время предыдущего события; время предыдущего события + 2 секунды]). Также имеет REST API (Swagger) для ручного создания событий. Каждый раз при генерации события сервис отправляет его через HTTP в Processor Service.\n\n- **Processor Service**  \n  Принимает события через REST API (Swagger), проверяет их согласно заранее заданным шаблонам и создает на их основе инциденты. Инциденты сохраняются в базе данных. Логика обработки реализована с использованием двух шаблонов:\n  \n  - **Шаблон №1 (простой):** Если получено событие с `Event.Type = 1`, то сразу создаётся инцидент типа 1.\n  - **Шаблон №2 (составной):** Если получено событие с `Event.Type = 2` и затем в течение 20 секунд (не позже) поступает событие с `Event.Type = 1`, то создаётся инцидент типа 2; если подтверждение не поступает — создаётся инцидент типа 1 на основе события типа 2.\n  - **Шаблон №3 (составной):** Если получено событие с `Event.Type = 3` и затем в течение 60 секунд (не позже) появляется подтверждение (через создание инцидента типа 2 или поступление события типа 1), то создаётся инцидент типа 3; если подтверждения нет — на основе события типа 3 создаётся инцидент типа 1.\n\n## Технологии\n\n- **Backend:** ASP.NET Core (.NET 6), Entity Framework Core  \n- **База данных:** PostgreSQL  \n- **Сервисы:** Generator и Processor (реализованы как отдельные ASP.NET Core API приложения с BackgroundService)  \n- **Контейнеризация:** Docker, Docker Compose  \n\n## Доступ к сервисам\n\n| Сервис            | URL Swagger                                  |\n|-------------------|----------------------------------------------|\n| **Processor**     | [http://localhost:5129/swagger/index.html](http://localhost:5129/swagger/index.html) |\n| **Generator**     | [http://localhost:7018/swagger/index.html](http://localhost:7018/swagger/index.html) |\n\n---\n\n## 🛠️ Запуск проекта\n\n### 1️⃣ **Клонирование репозитория**\n```sh\ngit clone https://github.com/Downstize/security-events-suite.git\ncd SecurityEventsSuite\n```\n\n### 2️⃣ **Запуск через Docker**\n```sh\ndocker-compose up --build\n```\n---\n\nDocker Compose поднимет контейнеры для PostgreSQL, Generator Service и Processor Service. \n\n### 3. Тестирование\n\n- Для ручного создания события откройте Swagger UI по адресу [http://localhost:7018/swagger/index.html](http://localhost:7018/swagger/index.html) (Generator Service) и отправьте запрос на создание события (например, с типом 2 или 3).\n\n- Для просмотра полученных инцидентов зайдите в Processor Service через Swagger [http://localhost:5129/swagger/index.html](http://localhost:5129/swagger/index.html).\n\n## Архитектура и рабочий процесс\n\n1. **Генерация событий (Generator Service):**\n   - Сервис запускает фоновую задачу, которая генерирует события автоматически с случайными интервалами (до 2 секунд).\n   - Через REST API (Swagger) можно вручную создать событие с нужным типом.\n   - При генерации событие отсылается HTTP-запросом в Processor Service.\n\n2. **Обработка событий (Processor Service):**\n   - При получении события сервис анализирует его тип.\n   - При событии типа 1 сразу создаётся инцидент типа 1.\n   - При событии типа 2 запускается ожидание подтверждения в течение 20 секунд. Если в течение этого времени поступает событие типа 1, то создаётся инцидент типа 2, иначе — по таймауту создаётся инцидент типа 1.\n   - При событии типа 3 запускается ожидание подтверждения в течение 60 секунд. Если подтверждение поступает (через появление события типа 1 или создание инцидента типа 2) в течение 60 секунд, то создаётся инцидент типа 3, иначе — инцидент типа 1.\n   - Инциденты сохраняются в базе данных вместе со списком событий, на основе которых они были созданы.\n\n## 📂 Структура проекта\n\n```\nSecurityEventsSuite/\n├── Processor/                  # Processor Service (ASP.NET Core API)\n│   ├── Controllers/            # API контроллеры Processor\n│   ├── Data/                   # EF Core контекст базы и миграции\n│   ├── Models/                 # Модели (Event, Incident, Enums)\n│   ├── Services/               # Логика обработки событий и создания инцидентов\n│   ├── Program.cs              # Входная точка Processor\n│   └── appsettings.json        # Конфигурация Processor\n│\n├── Generator/                  # Generator Service (ASP.NET Core API)\n│   ├── Controllers/            # API контроллеры Generator\n│   ├── Models/                 # Модель Event и перечисления\n│   ├── Services/               # Генерация событий (фоновые задачи, REST API)\n│   ├── Program.cs              # Входная точка Generator\n│   └── appsettings.json        # Конфигурация Generator\n│\n├── docker-compose.yml          # Конфигурация Docker Compose\n└── README.md                   # Документация проекта\n```\n\n## 🛠 Разработчик\n- **Вячеслав** - Backend/Архитектура\n\n---\n\n## 📝 Лицензия\nЭтот проект распространяется под лицензией MIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdownstize%2Fsecurity-events-suite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdownstize%2Fsecurity-events-suite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdownstize%2Fsecurity-events-suite/lists"}