Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

🛡️ How-To-Secure-A-Linux-Server

Una guía interactiva, práctica y contenedorizada para el bastionado (hardening) y aseguramiento de servidores Linux en entornos de producción. Este repositorio no solo recopila las mejores prácticas de seguridad a nivel de kernel y de servidor web, sino que también proporciona herramientas automatizadas de auditoría y sirve una interfaz web (Wiki) totalmente optimizada para su consulta.


📝 Descripción General

El proyecto How-To-Secure-A-Linux-Server es una plataforma de conocimiento y un conjunto de herramientas de automatización diseñadas para administradores de sistemas e ingenieros de seguridad. El repositorio está estructurado para cumplir una doble función:

  1. Base de Conocimiento Activa (Wiki): Una aplicación web estática (OpenWiki) construida sobre tecnologías modernas de frontend, que recopila guías detalladas sobre la configuración segura del Kernel de Linux, optimizaciones de red y securización de servidores web.
  2. Scripts de Auditoría y Control: Herramientas en bash para realizar auditorías de seguridad locales y verificar el estado de cumplimiento del servidor antes de su puesta en producción.

🛠️ Tecnologías y Librerías Utilizadas

El proyecto utiliza un stack tecnológico moderno orientado al rendimiento, la seguridad y la consistencia en el desarrollo:

  • Entorno de Ejecución y Servidor:
    • Docker: Despliegue en contenedor mediante construcción multi-etapa (multi-stage build).
    • Nginx: Servidor web de alto rendimiento configurado bajo estrictos parámetros de seguridad (cabeceras HTTP de seguridad, TLS robusto y mitigación de DDoS).
  • Frontend (OpenWiki):
    • React / Vite: Motor de la aplicación web SPA para la visualización fluida de la documentación.
  • Auditoría y Automatización:
    • Bumblebee (por Perplexity AI): Motor de auditoría de seguridad integrado para análisis locales.
    • Bash Scripting: Automatización de chequeos de conformidad de seguridad del sistema.
  • Calidad de Código y Estilo:
    • Biome: Formateador y linter ultrarrápido para mantener la cohesión en la configuración y código del proyecto.
    • Lefthook: Gestor de Git Hooks eficiente para validaciones locales pre-commit.

📁 Estructura del Repositorio

La arquitectura de archivos del proyecto está organizada de la siguiente manera:

.
├── .env                            # Variables de entorno locales
├── .gitignore                      # Exclusiones de Git
├── .no-mistakes.yaml               # Configuración del proxy de calidad para commits
├── AGENTS.md                       # Documentación de agentes de IA y automatizaciones
├── CONTRIBUTING.md                 # Directrices para contribuir al proyecto
├── Dockerfile                      # Construcción multi-stage de la aplicación Wiki
├── LICENSE                         # Licencia del proyecto
├── LICENSE.txt                     # Términos de licencia alternativos o de dependencias
├── SECURITY.md                     # Política de divulgación de vulnerabilidades
├── biome.json                      # Reglas de formato y calidad de Biome
├── lefthook.yml                    # Configuración de Git Hooks (pre-commit / pre-push)
├── linux-kernel-sysctl-hardening.md # Guía y configuración para el endurecimiento de sysctl en Linux
├── mem0.yaml                       # Configuración de persistencia/memoria para integraciones
├── nginx.conf                      # Configuración de producción de Nginx con foco en seguridad
├── nginx.md                        # Documentación específica de bastionado de Nginx
├── openwiki.stderr.log             # Registro de errores del servicio OpenWiki
├── openwiki.stdout.log             # Registro de salida estándar del servicio OpenWiki
├── scripts/
│   ├── security_audit.sh           # Script de auditoría de seguridad local con Bumblebee
│   └── status.sh                   # Cuadro de mando (dashboard) de conformidad local
└── package.json (inferido)         # Gestión de dependencias y scripts de construcción de la Wiki

🚀 Instalación y Ejecución Local

Requisitos Previos

  • Docker y Docker Compose instalados en el sistema.
  • Para ejecutar las auditorías locales, se recomienda tener instalado Bash y la herramienta Bumblebee (opcional, el script la detectará automáticamente).

Opción A: Despliegue de la Wiki con Docker (Producción y Consulta)

Para compilar la aplicación OpenWiki y servirla localmente a través del servidor Nginx seguro:

  1. Construye la imagen de Docker localmente:

    docker build -t how-to-secure-linux-wiki .
  2. Ejecuta el contenedor exponiendo el puerto seguro:

    docker run -d -p 8080:80 --name secure-linux-wiki how-to-secure-linux-wiki
  3. Accede a la interfaz web en tu navegador: http://localhost:8080

Opción B: Ejecución de Scripts de Seguridad y Cumplimiento

Puedes analizar la seguridad de tu entorno local utilizando los scripts incorporados.

  1. Auditoría de Seguridad (Bumblebee): Este script analiza las dependencias, configuraciones de red y posibles fugas de información.

    chmod +x scripts/security_audit.sh
    ./scripts/security_audit.sh
  2. Dashboard de Estado de Conformidad: Verifica el estado del repositorio frente a los estándares de calidad antes de realizar contribuciones:

    chmod +x scripts/status.sh
    ./scripts/status.sh

⚙️ Gobernanza del Proyecto

Este repositorio cuenta con un estricto flujo de calidad e integración continua automatizado localmente para garantizar que ninguna configuración insegura o código defectuoso llegue a las ramas principales:

  • Validación de Formato: El archivo biome.json define reglas estrictas para el código y la documentación. Estas validaciones son ejecutadas automáticamente por Lefthook antes de cada commit.
  • Git Proxy (no-mistakes): El archivo .no-mistakes.yaml actúa como puerta de enlace local, interceptando los comandos de Git para evitar errores comunes de despliegue o la inclusión de secretos en el historial.
  • Auditorías continuas: Se promueve el uso del script ./scripts/security_audit.sh como paso previo a cualquier solicitud de cambio (Pull Request).

Megacore - Automatizando y estandarizando la calidad del software en Megasoft.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages