ADORSYS-GIS / ADORSYS-GIS/wazuh-agent

Windows GUI Installer

オープン
#111 コメント 16 件 リアクション 0 件 担当者 2 名 @t-desmond が担当を希望しています GitHub で見る
enhancement SIEM
主要言語
Shell
スター
10
フォーク
6
平均マージ
2時間 51分
マージ済み PR(30日)
10

説明

### 📝 Description
This ticket introduces a **Windows Wazuh GUI Installer** that provides a user-friendly interface for installing and configuring the Wazuh agent on Windows systems.
Currently, the installation process relies on PowerShell scripts that must be executed manually from the command line, which can be confusing for non-technical users and increases the risk of misconfiguration.

The proposed solution is to build a graphical installer (EXE) that:
- Guides the user through the installation process with clear steps and visual feedback.
- Allows input of required configuration fields (e.g., Wazuh manager address, agent name, registration key).
- Displays installation logs and success/error messages in real time.
- Supports running with elevated privileges when required.
- Optionally integrates a background PowerShell process for performing the actual installation logic.

This installer aims to simplify deployment, reduce user error, and improve adoption for Windows users.

---

### ✅ Definition of Ready
*(All must be checked before work begins)*
- [x] Clear understanding of the problem or feature request.
- [x] Access to required development and testing environments (Windows 10, 11).
- [x] Requirements, goals, and scope defined (GUI-based Wazuh agent installer).
- [x] Stakeholders aligned (Wazuh team, Windows platform owners).
- [x] Success metric: smooth, error-free installation experience validated through user testing.

---

### 🎯 Acceptance Criteria
*(Conditions that must be met for this issue to be accepted as complete)*
- [x] The GUI installer launches successfully on Windows 10 and 11.
- [x] User can input and confirm all required Wazuh agent configuration parameters.
- [x] Installation completes successfully with clear visual confirmation.
- [x] Logs are displayed or saved for troubleshooting.
- [ ] The installer properly handles permission elevation (UAC prompt).
- [x] Errors or missing configurations are clearly indicated to the user.
- [ ] Documentation (README or wiki) is updated with usage and troubleshooting steps.

---

### 🧪 Tests
*(List the tests or scenarios that should be covered)*
- [x] Verify installer launches without PowerShell console visibility (silent background).
- [x] Validate that the agent installs successfully and connects to the Wazuh manager.
- [ ] Confirm GUI responsiveness and progress bar accuracy during installation.
- [ ] Test failure handling (invalid manager IP, network error, permission denied).
- [x] Check uninstall/reinstall flow works correctly.
- [x] Verify compatibility with Windows 10 and 11 (x64).
- [x] Ensure log files are correctly created and accessible.
- [ ] Validate digital signing (optional, to avoid SmartScreen warnings).

---

### ✅ Definition of Done
*(Must all be true for the ticket to be closed)*
- [ ] Code reviewed and merged into the main branch.
- [ ] All tests (manual and automated) pass successfully.
- [ ] Documentation and release notes are updated.
- [ ] Installer binary is built and signed (if applicable).
- [ ] Stakeholders validate usability and functionality.
- [ ] Installer ready for internal or public release.

コントリビューションガイド

コントリビューションガイドを開く

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。