EMPIEZA EN UN EQUIPO.
ESCALA CON CRITERIO.
Prepara el entorno local, configura el coordinador y conecta tus agentes. Una guía de inicio basada en los comandos del proyecto.
DESCARGA.
INSTALA. EXPLORA.
Obtén el código de Sentinel desde su repositorio y abre la aplicación en Windows.
01 Abre PowerShell donde quieras guardar el proyecto.
git clone https://github.com/huaynariveraelvis-rgb/sentinel.git
cd sentinel
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m sentinel01 Descarga el ZIP y extrae la carpeta sentinel-main.
02 Abre PowerShell dentro de esa carpeta y ejecuta:
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m sentinelANTES DE LA PRIMERA AUDITORÍA.
- Copia local del proyecto Sentinel y Python disponible.
- Equipo Windows que administras con autorización.
- Acceso para instalar las dependencias del proyecto.
- Para el laboratorio: conectividad entre agentes y coordinador.
Abre tu primera consola.
En PowerShell, desde la carpeta del proyecto Sentinel.
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m sentinelUsa privilegios de administrador para consultar todas las conexiones y aplicar los controles que apruebes.
Centraliza tu laboratorio.
En el equipo que administrará los reportes del parque.
python -m sentinel.coordinator --generar-token
python -m sentinel.coordinatorEl primer comando genera config/lab_token.key. El coordinador del README utiliza el puerto 8770. Configura el acceso según tu red.
Conecta un equipo autorizado.
Distribuye de forma segura el mismo token del laboratorio al agente.
python -m sentinel.agent --servidor http://IP_DEL_COORDINADOR:8770 --equipo PC-01Sustituye IP_DEL_COORDINADOR por la dirección de tu coordinador y PC-01 por la etiqueta del equipo. Este comando inicia el reporte; la remediación requiere configuración y aprobación adicionales.
PREGUNTAS FRECUENTES.
¿Sentinel reemplaza al antivirus?+
Su función principal es auditar configuraciones, vigilar cambios y ayudar a remediar hallazgos. Complementa las defensas del equipo y revisa controles como Microsoft Defender y el firewall.
¿Hace cambios sin mi aprobación?+
El flujo de remediación requiere aprobación del administrador. En el despliegue centralizado, el agente debe estar habilitado para aplicar los controles aprobados. Las acciones quedan registradas.
¿Qué funciona sin conexión?+
El análisis heurístico local funciona sin internet. El agente conserva reportes pendientes cuando el coordinador no está disponible. Las integraciones externas y la explicación ampliada con IA requieren sus servicios correspondientes.
¿Cómo protejo el token del laboratorio?+
Distribúyelo solo entre el coordinador y los agentes autorizados, mediante un canal seguro. No lo publiques en la web ni lo incluyas en informes o repositorios. Consulta el README para la configuración completa.
¿De dónde salen los datos de esta web?+
La vista local lee data/auditorias.db en modo de solo lectura y las marcas de Telegram conservadas por el agente. Muestra el historial con sus fechas, incluidos registros del laboratorio. No ejecuta auditorías ni se conecta a un chat de Telegram en vivo. Las claves y los datos privados quedan reservados.