Immutable. This exact content is served forever at /api/v1/blob/4d277969ec55b862.
---
name: pentest-report
description: >
Usar esta skill siempre que el usuario quiera generar un informe de pruebas de penetración,
informe técnico de vulnerabilidades, resumen ejecutivo de seguridad, o cualquier documento
de auditoría ofensiva. Activa cuando se mencionen: hallazgos de pentest, CVE, CVSS,
vulnerabilidades detectadas, POC realizados, informe de auditoría, recomendaciones de
remediación, parcheo o hardening. También cuando el usuario proporcione notas de hallazgos
y pida estructurarlos en informe profesional.
---
# Skill: Informe Profesional de Pentesting — hackingyseguridad.com
Genera el informe final de auditoría como documento Word (.docx) con el formato corporativo
oficial de **hackingyseguridad.com**, replicando exactamente la estructura, orden de secciones,
tablas, logotipos y estilo visual del documento de referencia.
---
## Formato corporativo obligatorio
### Logotipo
- **Logo principal**: texto estilizado "Hacking y seguridad.com" en tipografía bold gris oscuro
- "Hacking" en grande, negrita, gris (#555555)
- "y seguridad.com" debajo, misma fuente, gris más claro
- **Posición header**: esquina superior derecha en TODAS las páginas (header del documento)
- **Posición portada**: centrado/grande a 1/3 superior de página, con URL http://www.hackingyseguridad.com/
- **URL debajo del logo portada**: enlace azul http://www.hackingyseguridad.com/ centrado
- **Tipografía**: Arial o similar sans-serif
### Paleta de colores
- Texto body: negro (#000000)
- Títulos de sección: negro bold
- Numeración de hallazgos: azul (#2E75B6)
- Severidad CRÍTICA: texto rojo (#C00000)
- Severidad ALTA: fondo o texto naranja (#FF6600)
- Severidad MEDIA: fondo amarillo claro (#FFE699)
- Severidad BAJA: fondo verde claro (#70AD47)
- Severidad INFORMATIVA: fondo gris claro (#F2F2F2)
- Resaltado amarillo en texto: para destacar datos clave en párrafos
- Resaltado naranja: para cifrados o protocolos vulnerables concretos
- Comandos/output técnico: fondo negro (#1E1E1E), texto verde (#00FF00) — estilo terminal Kali
### Márgenes y página
- Tamaño: A4 (11906 × 16838 DXA)
- Márgenes: 1 pulgada en todos los lados (1440 DXA)
- Fuente base: Arial 11pt (22 half-points)
- Texto body: justificado
---
## Flujo de trabajo
### PASO 1 — Recopilar hallazgos
Si el usuario no ha proporcionado hallazgos estructurados, solicitar:
- Nombre/tipo de vulnerabilidad
- Activo/componente afectado (IP, FQDN, API, puerto)
- CVE asociado (si existe)
- Evidencia o POC realizado (output de herramienta)
- Impacto observado
Si los hallazgos ya están en la conversación, extraerlos directamente sin preguntar.
---
### PASO 2 — Tabla maestra de vulnerabilidades
Construir tabla ordenada de **mayor a menor criticidad** (CVSS base score):
| # | Vulnerabilidad | CVE | CVSS | Severidad | Componente | POC Realizado | Estado |
|---|---------------|-----|------|-----------|------------|---------------|--------|
| 1 | ... | CVE-XXXX | 9.8 | Crítica | ... | Sí | Abierta |
**Escala de severidad CVSS v3.1:**
| Rango | Severidad | Color en informe |
|-----------|-------------|-------------------------------|
| 9.0–10.0 | Crítica | Rojo (#C00000) |
| 7.0–8.9 | Alta | Naranja (#FF6600) |
| 4.0–6.9 | Media | Amarillo (#FFE699) fondo |
| 0.1–3.9 | Baja | Verde (#70AD47) |
| 0.0 | Informativa | Gris (#F2F2F2) |
---
### PASO 3 — Orden de secciones del documento Word
La estructura sigue EXACTAMENTE este orden (igual que el documento de referencia):
```
SECCIÓN 1: PORTADA
SECCIÓN 2: PÁGINA EN BLANCO (contraportada)
SECCIÓN 3: ÍNDICE
SECCIÓN 4: INTRODUCCIÓN
SECCIÓN 5: DESCRIPCIÓN DE LAS PRUEBAS, AUDITORIA "HACKING ÉTICO"
SECCIÓN 6: DESCRIPCIÓN PRUEBAS HACKING ÉTICO EN MODALIDAD CAJA NEGRA
SECCIÓN 7: LISTA DE REVISIONES
SECCIÓN 8: RESUMEN EJECUTIVO
SECCIÓN 9: EVIDENCIAS
SECCIÓN N: HALLAZGOS numerados 1..N (uno por vulnerabilidad)
SECCIÓN FIN: ANEXO
```
---
## Estructura detallada por sección
### PORTADA (página 1)
```
[Header: logo HyS esquina superior derecha]
[Logo grande centrado]:
"Hacking" ← negrita, 36pt, gris (#595959)
"y seguridad.com" ← negrita, 26pt, gris (#595959)
[URL centrada, azul]:
http://www.hackingyseguridad.com/
[Título centrado, negrita, grande, azul (#2E75B6)]:
"Auditoria de seguridad, «hacking ético»
en modalidad caja negra a [SISTEMA/SCOPE]"
[Imagen/logotipos de los sistemas auditados: centrados]
[Salto de página]
```
### PÁGINA EN BLANCO (página 2)
```
[Header: logo HyS esquina superior derecha]
[Contenido vacío — página de cortesía]
[Salto de página]
```
### ÍNDICE (página 3)
```
ÍNDICE
ÍNDICE .............................................................. 3
INTRODUCCIÓN ........................................................ 4
DESCRIPCION DE LAS PRUEBAS, AUDITORIA "HACKING ETICO": ............. 5
DESCRIPTCION PRUEBAS HACKING ETICO EN MODALIDAD CAJA NEGRA ......... 6
LISTA DE REVISIONES ................................................. 8
RESUMEN EJECUTIVO: .................................................. 9
EVIDENCIAS: ........................................................ 10
1. [NOMBRE HALLAZGO 1] | VULNERABILIDAD GRAVEDAD [NIVEL] ........... 11
2. [NOMBRE HALLAZGO 2] | VULNERABILIDAD GRAVEDAD [NIVEL] ........... 18
...
ANEXO: ............................................................. 32
[Salto de página]
```
Formato: texto en negrita, números de página alineados a la derecha con tab stop.
Construir manualmente (no usar TOC automático de Word para control total del formato).
### INTRODUCCIÓN
```
INTRODUCCIÓN
[Párrafo justificado: objetivo del análisis, modalidad caja negra, scope
(IPs/FQDNs), herramientas de referencia como shodan.io / censys.io]
[Diagrama de flujo]:
WEB PAGE → INTERNET → API → WEB SERVER → DATABASE
con flechas REQUEST/RESPONSE — tabla estilizada o imagen
• [FQDN/sistema 1]: [descripción]
• [FQDN/sistema 2]: [descripción]
• [FQDN/sistema N]: [descripción]
```
### DESCRIPCIÓN DE LAS PRUEBAS, AUDITORIA "HACKING ÉTICO"
```
DESCRIPCION DE LAS PRUEBAS, AUDITORIA "HACKING ETICO":
[Descripción de la metodología: técnicas evaluadas, vectores de ataque,
tipos de pruebas aplicadas]
[Tabla comparativa de sistemas/APIs auditados si procede — p.ej. Key API Tools
con columnas por proveedor: AWS / Azure / GCP]
```
### DESCRIPCIÓN PRUEBAS HACKING ÉTICO EN MODALIDAD CAJA NEGRA
```
DESCRIPTCION PRUEBAS HACKING ETICO EN MODALIDAD CAJA NEGRA
FASE 1
1º.- Reconocimiento pasivo y activo.
2º.- Identificación de activos.
3º.- Fingerprinting de servicios.
4º.- Enumeración.
5º.- Detección de vulnerabilidades:
[lista de vectores evaluados: Fuzzing, Análisis estático/dinámico,
Escaneo de vulnerabilidades, Autenticación, Autorización, Fuerza Bruta,
Validación de entrada, Manejo de errores, Encriptación, Gestión de sesiones,
XSS, CSRF, Inyección SQL, XXE, Control de acceso roto, RCE, DoS, etc.]
Herramientas: nmap, wapiti, acunetix, nessus, zap OWASP, openvas, nikto, scripts
FASE 2
6º.- Explotación de vulnerabilidades.
7º.- Pentesting. Pruebas de intrusión. Exploit: No aplica / Solo si requerido.
8º.- Pruebas de Estrés: No aplica / Solo si requerido.
9º.- Batería de ataques: No aplica / Solo si requerido.
FASE 3
10ª.- Informes finales con:
- I. Resumen de las vulnerabilidades detectadas, ordenadas por grado de
criticidad: (alta, media ó baja-informativa).
- II. Evidencias y detalle de las pruebas realizadas y datos sobre cada
una de las vulnerabilidades detectadas o explotadas.
- III. Cambios de mejora propuestos. Plan de contingencia.
```
### LISTA DE REVISIONES
```
LISTA DE REVISIONES
[Tabla con bordes simples, cabecera en negrita]:
| Número edición | Fecha edición | Apartados revisados | Cambios efectuados | Observaciones |
|----------------|---------------|--------------------|--------------------|---------------|
| 1ª | DD MMM. AAAA | [descripción] | | |
| | | | | |
[Salto de página]
```
### RESUMEN EJECUTIVO
```
RESUMEN EJECUTIVO:
[Párrafo ejecutivo con la valoración global. Destacar la severidad más
alta detectada con resaltado amarillo (highlight) en el texto.]
Tabla resumen:
| #Ref | Activo | Vulnerabilidad | Gravedad |
|------|--------|---------------------------------------------|-------------|
| 1 | API | [nombre vulnerabilidad completo] | Media | ← celda color amarillo
| 2 | API | [nombre vulnerabilidad completo] | Baja | ← celda color verde
| 3 | API | [nombre vulnerabilidad completo] | Informativa | ← celda gris
[Salto de página]
```
Celdas de Gravedad con color de fondo según severidad (ver paleta).
### EVIDENCIAS
```
EVIDENCIAS:
Puertos/servicios en los activos IP:
| #Ref | Activo | Puerto TCP/UDP | Servicio | Fingerprint | Vuln int | Descripción Vuln | Exploit |
|------|--------|----------------|---------|-------------|----------|-----------------|---------|
| 1 | | 80/TCP | http | | | | |
| 2 | | 443 TCP/UDP | httpd | | | | |
| 3 | | | | | | | |
| 4 | | | | | | | |
| 5 | | | | | | | |
Tecnologías/Fingerprint y versiones utilizadas:
[tabla o lista con banner grabbing / captura de banner obtenida]
```
### HALLAZGOS (secciones numeradas 1..N)
Cada hallazgo ocupa su propia sección con el siguiente formato:
```
[Salto de página]
[N]. [NOMBRE VULNERABILIDAD EN MAYÚSCULAS] | VULNERABILIDAD GRAVEDAD [NIVEL EN MAYÚSCULAS]
← título centrado, negrita, azul, Heading 2
[Subtítulo con highlight AMARILLO]:
[Descripción en una línea del contexto específico auditado]
[Párrafo inicial JUSTIFICADO con highlight amarillo describiendo el protocolo/
tecnología vulnerable y resaltando en naranja los valores/protocolos concretos
afectados, p.ej. "TLS 1.0 y TLS 1.1 y combinaciones de cifrado «débiles»"]
[Por cada activo/FQDN afectado]:
[FQDN - https://fqdn.ejemplo.com] ← fondo azul oscuro (#1F4E79), texto blanco, bold
[Output técnico de la herramienta]
← bloque en Courier New 8-9pt, fondo negro (#1E1E1E), texto verde (#00FF00)
con resaltado en las líneas relevantes (cifrados débiles: naranja/amarillo,
warnings: amarillo, versiones vulnerables: naranja)
Descripción de la vulnerabilidad:
[Párrafo técnico explicando la causa raíz, CWE si aplica]
Impacto:
[Consecuencias: Confidencialidad / Integridad / Disponibilidad, ataques posibles,
referencias OWASP/NIST/CVSSv3]
Recomendación / Remediación (Bastionado):
[Acciones concretas con comandos/parámetros exactos]
CVSS v3.1 Score: X.X | Vector: AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H
CVE: CVE-XXXX-YYYY (o "Sin CVE asignado")
CWE: CWE-XXX (si aplica)
Herramientas utilizadas: [lista]
Referencias: [URLs]
```
**Para hallazgos con múltiples activos** (p.ej. GCP + Azure + AWS):
repetir el bloque [FQDN → output terminal] dentro de la misma sección numerada.
### ANEXO
```
ANEXO:
[Evidencias adicionales, capturas de pantalla de herramientas,
outputs completos, referencias normativas, URLs de referencia,
datos de configuración complementaria]
Referencias:
[Lista de URLs / advisories / papers relacionados]
```
---
## PASO 4 — Código JavaScript para generar el .docx
Instalar dependencia: `npm install -g docx`
```javascript
const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell,
Header, AlignmentType, HeadingLevel, BorderStyle, WidthType,
ShadingType, LevelFormat, PageBreak, VerticalAlign } = require('docx');
const fs = require('fs');
// ── PALETA CORPORATIVA ────────────────────────────────────────────────────
const C = {
negro: "000000",
azulHyS: "2E75B6",
azulOscuro: "1F4E79",
grisLogo: "595959",
rojoCritico: "C00000",
naranja: "FF6600",
amarillo: "FFE699",
verde: "70AD47",
grisInfo: "F2F2F2",
blanco: "FFFFFF",
terminalBg: "1E1E1E",
terminalFg: "00FF00",
};
// ── HEADER CORPORATIVO (logo esquina superior derecha) ────────────────────
function makeHeader() {
return new Header({
children: [
new Paragraph({
alignment: AlignmentType.RIGHT,
children: [
new TextRun({ text: "Hacking", bold: true, size: 22, color: C.grisLogo, font: "Arial" }),
new TextRun({ break: 1 }),
new TextRun({ text: "y seguridad.com", size: 16, color: C.grisLogo, font: "Arial" }),
],
}),
],
});
}
// ── PORTADA ───────────────────────────────────────────────────────────────
function makePortada(tituloInforme) {
return [
new Paragraph({ spacing: { before: 2880, after: 240 }, alignment: AlignmentType.CENTER,
children: [
new TextRun({ text: "Hacking", bold: true, size: 72, color: C.grisLogo, font: "Arial" }),
new TextRun({ break: 1 }),
new TextRun({ text: "y seguridad.com", bold: true, size: 52, color: C.grisLogo, font: "Arial" }),
],
}),
new Paragraph({ alignment: AlignmentType.CENTER, spacing: { before: 240, after: 720 },
children: [new TextRun({ text: "http://www.hackingyseguridad.com/", color: C.azulHyS, size: 20, font: "Arial" })],
}),
new Paragraph({ alignment: AlignmentType.CENTER, spacing: { before: 480, after: 480 },
children: [new TextRun({ text: tituloInforme, bold: true, size: 48, color: C.azulHyS, font: "Arial" })],
}),
new Paragraph({ children: [new PageBreak()] }),
];
}
// ── PÁGINA EN BLANCO ──────────────────────────────────────────────────────
const paginaBlanco = [
new Paragraph({ children: [] }),
new Paragraph({ children: [new PageBreak()] }),
];
// ── ENTRADA DE ÍNDICE ─────────────────────────────────────────────────────
function lineaIndice(texto, pagina) {
return new Paragraph({
tabStops: [{ type: "right", position: 9000 }],
children: [
new TextRun({ text: texto, bold: true, font: "Arial", size: 20 }),
new TextRun({ text: `\t${pagina}`, bold: true, font: "Arial", size: 20 }),
],
spacing: { before: 60, after: 60 },
});
}
// ── CELDA CON COLOR DE SEVERIDAD ─────────────────────────────────────────
function celdaSeveridad(texto, nivel) {
const fills = { "Crítica": C.rojoCritico, "Alta": C.naranja,
"Media": C.amarillo, "Baja": C.verde, "Informativa": C.grisInfo };
const textColors = { "Crítica": C.blanco, "Alta": C.blanco };
const border = { style: BorderStyle.SINGLE, size: 1, color: "CCCCCC" };
return new TableCell({
borders: { top: border, bottom: border, left: border, right: border },
shading: { fill: fills[nivel] || C.grisInfo, type: ShadingType.CLEAR },
width: { size: 1500, type: WidthType.DXA },
children: [new Paragraph({
alignment: AlignmentType.CENTER,
children: [new TextRun({ text: texto, bold: true, font: "Arial", size: 20,
color: textColors[nivel] || C.negro })],
})],
});
}
// ── TABLA RESUMEN EJECUTIVO ───────────────────────────────────────────────
function tablaResumenEjecutivo(hallazgos) {
const b = { style: BorderStyle.SINGLE, size: 1, color: "CCCCCC" };
const borders = { top: b, bottom: b, left: b, right: b };
const cel = (t, w, bold=false) => new TableCell({ borders, width: { size: w, type: WidthType.DXA },
children: [new Paragraph({ children: [new TextRun({ text: t, bold, font: "Arial", size: 20 })] })] });
return new Table({
width: { size: 8800, type: WidthType.DXA },
columnWidths: [800, 1500, 5000, 1500],
rows: [
new TableRow({ children: [cel("#Ref",true,800), cel("Activo",true,1500),
cel("Vulnerabilidad",true,5000), cel("Gravedad",true,1500)] }),
...hallazgos.map(h => new TableRow({ children: [
cel(String(h.ref), 800), cel(h.activo, 1500),
cel(h.vulnerabilidad, 5000), celdaSeveridad(h.gravedad, h.gravedad),
]})),
],
});
}
// ── TABLA LISTA DE REVISIONES ─────────────────────────────────────────────
function tablaRevisiones(revisiones) {
const b = { style: BorderStyle.SINGLE, size: 1, color: "000000" };
const borders = { top: b, bottom: b, left: b, right: b };
const widths = [1200, 1400, 2400, 2400, 1400];
const cel = (t, w, bold=false) => new TableCell({ borders, width: { size: w, type: WidthType.DXA },
children: [new Paragraph({ children: [new TextRun({ text: t, bold, font: "Arial", size: 20 })] })] });
return new Table({
width: { size: 8800, type: WidthType.DXA },
columnWidths: widths,
rows: [
new TableRow({ children: [
cel("Número edición", widths[0], true), cel("Fecha edición", widths[1], true),
cel("Apartados revisados", widths[2], true), cel("Cambios efectuados", widths[3], true),
cel("Observaciones", widths[4], true),
]}),
...revisiones.map(r => new TableRow({ children: [
cel(r.numero, widths[0]), cel(r.fecha, widths[1]),
cel(r.apartados, widths[2]), cel(r.cambios, widths[3]),
cel(r.observaciones, widths[4]),
]})),
// fila vacía final
new TableRow({ children: widths.map(w => cel("", w)) }),
],
});
}
// ── TABLA EVIDENCIAS ──────────────────────────────────────────────────────
function tablaEvidencias(puertos) {
const b = { style: BorderStyle.SINGLE, size: 1, color: "CCCCCC" };
const borders = { top: b, bottom: b, left: b, right: b };
const widths = [600, 900, 1200, 900, 1500, 900, 1900, 900];
const cel = (t, w, bold=false) => new TableCell({ borders, width: { size: w, type: WidthType.DXA },
children: [new Paragraph({ children: [new TextRun({ text: t, bold, font: "Arial", size: 16 })] })] });
return new Table({
width: { size: 8800, type: WidthType.DXA },
columnWidths: widths,
rows: [
new TableRow({ children: [
cel("#Ref", widths[0], true), cel("Activo", widths[1], true),
cel("Puerto TCP/UDP", widths[2], true), cel("Servicio", widths[3], true),
cel("Fingerprint", widths[4], true), cel("Vuln int", widths[5], true),
cel("Descripción Vuln", widths[6], true), cel("Exploit", widths[7], true),
]}),
...puertos.map(p => new TableRow({ children: [
cel(String(p.ref), widths[0]), cel(p.activo, widths[1]),
cel(p.puerto, widths[2]), cel(p.servicio, widths[3]),
cel(p.fingerprint, widths[4]), cel(p.vulnInt, widths[5]),
cel(p.descVuln, widths[6]), cel(p.exploit, widths[7]),
]})),
],
});
}
// ── BLOQUE TERMINAL (output técnico) ──────────────────────────────────────
function bloqueTerminal(lineas) {
return lineas.map(linea => new Paragraph({
shading: { fill: C.terminalBg, type: ShadingType.CLEAR },
spacing: { before: 0, after: 0 },
children: [new TextRun({ text: linea, font: "Courier New", size: 16, color: C.terminalFg })],
}));
}
// ── CABECERA ACTIVO EN HALLAZGO (fondo azul oscuro) ──────────────────────
function tituloActivo(texto) {
return new Paragraph({
shading: { fill: C.azulOscuro, type: ShadingType.CLEAR },
spacing: { before: 120, after: 60 },
children: [new TextRun({ text: texto, bold: true, color: C.blanco, font: "Arial", size: 20 })],
});
}
// ── SECCIÓN HALLAZGO INDIVIDUAL ───────────────────────────────────────────
// hallazgo: { nombre, gravedad, subtitulo, descripcion, activos:[{fqdn, output:[]}],
// causaRaiz, impacto, remediacion, cvss, cvssVector, cve, cwe,
// herramientas:[], referencias:[] }
function seccionHallazgo(numero, h) {
const titulo = `${numero}. ${h.nombre} | VULNERABILIDAD GRAVEDAD ${h.gravedad.toUpperCase()}`;
return [
new Paragraph({ children: [new PageBreak()] }),
new Paragraph({
alignment: AlignmentType.CENTER,
heading: HeadingLevel.HEADING_2,
spacing: { before: 240, after: 120 },
children: [new TextRun({ text: titulo, bold: true, font: "Arial", size: 28, color: C.azulHyS })],
}),
new Paragraph({ spacing: { before: 120, after: 120 },
children: [new TextRun({ text: h.subtitulo, highlight: "yellow", font: "Arial", size: 20 })],
}),
new Paragraph({ alignment: AlignmentType.JUSTIFIED, spacing: { before: 120, after: 240 },
children: [new TextRun({ text: h.descripcion, font: "Arial", size: 20 })],
}),
...h.activos.flatMap(activo => [
tituloActivo(activo.fqdn),
...bloqueTerminal(activo.output),
]),
new Paragraph({ spacing: { before: 240, after: 60 },
children: [new TextRun({ text: "Descripción de la vulnerabilidad:", bold: true, font: "Arial", size: 20 })] }),
new Paragraph({ alignment: AlignmentType.JUSTIFIED, spacing: { before: 60, after: 120 },
children: [new TextRun({ text: h.causaRaiz, font: "Arial", size: 20 })] }),
new Paragraph({ spacing: { before: 120, after: 60 },
children: [new TextRun({ text: "Impacto:", bold: true, font: "Arial", size: 20 })] }),
new Paragraph({ alignment: AlignmentType.JUSTIFIED, spacing: { before: 60, after: 120 },
children: [new TextRun({ text: h.impacto, font: "Arial", size: 20 })] }),
new Paragraph({ spacing: { before: 120, after: 60 },
children: [new TextRun({ text: "Recomendación / Remediación (Bastionado):", bold: true, font: "Arial", size: 20 })] }),
new Paragraph({ alignment: AlignmentType.JUSTIFIED, spacing: { before: 60, after: 240 },
children: [new TextRun({ text: h.remediacion, font: "Arial", size: 20 })] }),
new Paragraph({ spacing: { before: 120, after: 60 }, children: [
new TextRun({ text: `CVSS v3.1 Score: ${h.cvss}`, bold: true, font: "Arial", size: 20 }),
new TextRun({ text: ` | Vector: ${h.cvssVector}`, font: "Arial", size: 20 }),
]}),
new Paragraph({ children: [new TextRun({ text: `CVE: ${h.cve}`, font: "Arial", size: 20 })] }),
new Paragraph({ children: [new TextRun({ text: `CWE: ${h.cwe}`, font: "Arial", size: 20 })] }),
new Paragraph({ children: [new TextRun({ text: `Herramientas: ${h.herramientas.join(", ")}`, font: "Arial", size: 20 })] }),
new Paragraph({ spacing: { before: 120, after: 60 },
children: [new TextRun({ text: "Referencias:", bold: true, font: "Arial", size: 20 })] }),
...h.referencias.map(r => new Paragraph({
children: [new TextRun({ text: r, color: C.azulHyS, font: "Arial", size: 20 })],
})),
];
}
// ── CONSTRUCCIÓN DEL DOCUMENTO ────────────────────────────────────────────
// Rellenar estas variables con los datos del engagement:
const TITULO_INFORME = "Auditoria de seguridad, «hacking ético» en modalidad caja negra a [SISTEMA]";
const REVISIONES = [{ numero: "1ª", fecha: "DD MMM. AAAA", apartados: "[descripción]", cambios: "", observaciones: "" }];
const RESUMEN_EJECUTIVO_TEXTO = "El sistema auditado y la infraestructura expuesta a internet presenta...";
const HALLAZGOS_RESUMEN = [
{ ref: 1, activo: "API", vulnerabilidad: "[nombre vulnerabilidad]", gravedad: "Media" },
];
const PUERTOS_EVIDENCIA = [
{ ref: 1, activo: "", puerto: "80/TCP", servicio: "http", fingerprint: "", vulnInt: "", descVuln: "", exploit: "" },
{ ref: 2, activo: "", puerto: "443 TCP/UDP", servicio: "httpd", fingerprint: "", vulnInt: "", descVuln: "", exploit: "" },
];
const HALLAZGOS = [
{
nombre: "PROTOCOLOS Y CIFRADOS OFRECIDOS «DEBILES»",
gravedad: "Media",
subtitulo: "Combinaciones de cifrados débiles ofrecidas para los sistemas auditados",
descripcion: "Se detectan protocolos TLS 1.0 y TLS 1.1 y combinaciones de cifrado débiles/vulnerables...",
activos: [
{ fqdn: "GCP - https://ejemplo.com", output: ["PORT STATE SERVICE", "443/tcp open https", "| TLSv1.0:", "| ciphers:", "| TLS_RSA_WITH_3DES_EDE_CBC_SHA - C"] },
],
causaRaiz: "El servidor acepta protocolos TLS obsoletos (1.0, 1.1) y suites de cifrado débiles...",
impacto: "Interceptación de tráfico (Man-in-the-Middle), inyección de datos, SWEET32, BEAST...",
remediacion: "Deshabilitar TLS 1.0 y TLS 1.1. Configurar únicamente TLS 1.2+ con suites seguras:\nnginx: ssl_protocols TLSv1.2 TLSv1.3;\nApache: SSLProtocol -all +TLSv1.2 +TLSv1.3",
cvss: "5.9",
cvssVector: "AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:N/A:N",
cve: "CVE-2011-3389 (BEAST), CVE-2016-2183 (SWEET32)",
cwe: "CWE-326",
herramientas: ["nmap", "testssl.sh", "sslscan"],
referencias: ["https://www.bsi.bund.de/EN/Topics/OwnOrganisation/StandardsAndCriteria/TechnicalGuidelines/tr02102/tr02102_node.html"],
},
];
const doc = new Document({
styles: {
default: { document: { run: { font: "Arial", size: 22, color: C.negro } } },
paragraphStyles: [
{ id: "Heading1", name: "Heading 1", basedOn: "Normal", next: "Normal",
run: { size: 32, bold: true, font: "Arial", color: C.negro },
paragraph: { spacing: { before: 360, after: 180 }, outlineLevel: 0 } },
{ id: "Heading2", name: "Heading 2", basedOn: "Normal", next: "Normal",
run: { size: 28, bold: true, font: "Arial", color: C.azulHyS },
paragraph: { spacing: { before: 240, after: 120 }, outlineLevel: 1 } },
],
},
numbering: {
config: [
{ reference: "bullets", levels: [{ level: 0, format: LevelFormat.BULLET, text: "•",
alignment: AlignmentType.LEFT, style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] },
],
},
sections: [{
properties: {
page: { size: { width: 11906, height: 16838 }, margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } },
},
headers: { default: makeHeader() },
children: [
// 1. PORTADA
...makePortada(TITULO_INFORME),
// 2. PÁGINA EN BLANCO
...paginaBlanco,
// 3. ÍNDICE
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "ÍNDICE", bold: true })] }),
lineaIndice("ÍNDICE", "3"),
lineaIndice("INTRODUCCIÓN", "4"),
lineaIndice('DESCRIPCION DE LAS PRUEBAS, AUDITORIA "HACKING ETICO":', "5"),
lineaIndice("DESCRIPTCION PRUEBAS HACKING ETICO EN MODALIDAD CAJA NEGRA", "6"),
lineaIndice("LISTA DE REVISIONES", "8"),
lineaIndice("RESUMEN EJECUTIVO:", "9"),
lineaIndice("EVIDENCIAS:", "10"),
// ...lineaIndice para cada hallazgo
lineaIndice("ANEXO:", "32"),
new Paragraph({ children: [new PageBreak()] }),
// 4. INTRODUCCIÓN
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "INTRODUCCIÓN", bold: true })] }),
new Paragraph({ alignment: AlignmentType.JUSTIFIED, spacing: { before: 120, after: 240 },
children: [new TextRun({ text: "El presente documento pretende servir de guía y ayuda, para la detección de vulnerabilidades, «hacking ético», en modalidad caja negra, desde internet, sin información previa...", font: "Arial", size: 22 })],
}),
new Paragraph({ children: [new PageBreak()] }),
// 5. DESCRIPCIÓN DE LAS PRUEBAS
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: 'DESCRIPCION DE LAS PRUEBAS, AUDITORIA "HACKING ETICO":', bold: true })] }),
new Paragraph({ children: [new PageBreak()] }),
// 6. DESCRIPCIÓN CAJA NEGRA
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "DESCRIPTCION PRUEBAS HACKING ETICO EN MODALIDAD CAJA NEGRA", bold: true })] }),
new Paragraph({ children: [new PageBreak()] }),
// 7. LISTA DE REVISIONES
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "LISTA DE REVISIONES", bold: true })] }),
new Paragraph({ spacing: { before: 240, after: 120 }, children: [] }),
tablaRevisiones(REVISIONES),
new Paragraph({ children: [new PageBreak()] }),
// 8. RESUMEN EJECUTIVO
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "RESUMEN EJECUTIVO:", bold: true })] }),
new Paragraph({ alignment: AlignmentType.JUSTIFIED, spacing: { before: 120, after: 240 },
children: [new TextRun({ text: RESUMEN_EJECUTIVO_TEXTO, font: "Arial", size: 22 })],
}),
new Paragraph({ spacing: { before: 120, after: 120 },
children: [new TextRun({ text: "Tabla resumen:", font: "Arial", size: 22 })] }),
tablaResumenEjecutivo(HALLAZGOS_RESUMEN),
new Paragraph({ children: [new PageBreak()] }),
// 9. EVIDENCIAS
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "EVIDENCIAS:", bold: true })] }),
new Paragraph({ spacing: { before: 120, after: 120 },
children: [new TextRun({ text: "Puertos/servicios en los activos IP:", font: "Arial", size: 22 })] }),
tablaEvidencias(PUERTOS_EVIDENCIA),
// 10..N. HALLAZGOS
...HALLAZGOS.flatMap((h, i) => seccionHallazgo(i + 1, h)),
// ANEXO
new Paragraph({ children: [new PageBreak()] }),
new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun({ text: "ANEXO:", bold: true })] }),
new Paragraph({ children: [new TextRun({ text: "[Evidencias adicionales, capturas, referencias]", font: "Arial", size: 22 })] }),
],
}],
});
Packer.toBuffer(doc).then(buf => {
fs.writeFileSync("/mnt/user-data/outputs/informe_pentest.docx", buf);
console.log("✓ informe_pentest.docx generado");
});
```
---
## PASO 5 — Validación del fichero generado
```bash
python /mnt/skills/public/docx/scripts/office/validate.py informe_pentest.docx
# Si falla → desempacar, corregir XML, reempacar
python /mnt/skills/public/docx/scripts/office/unpack.py informe_pentest.docx unpacked/
# [editar unpacked/word/document.xml]
python /mnt/skills/public/docx/scripts/office/pack.py unpacked/ informe_pentest_fixed.docx \
--original informe_pentest.docx
```
---
## Vectores CVSS v3.1 — Referencia rápida
```
AV: N=Red A=Adyacente L=Local P=Físico
AC: L=Baja H=Alta
PR: N=Ninguno L=Bajo H=Alto
UI: N=Ninguno R=Requerido
S: U=Sin cambio C=Con cambio
C/I/A: N=Ninguno L=Bajo H=Alto
```
Calculadora: https://www.first.org/cvss/calculator/3.1
---
## Plantillas de remediación (Bastionado) por tipo de vulnerabilidad
### Protocolos TLS/cifrados débiles
- **Bastionado**: Deshabilitar TLS 1.0 y TLS 1.1; forzar TLS 1.2+ con suites seguras
- **Config nginx**: `ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:...`
- **Config Apache**: `SSLProtocol -all +TLSv1.2 +TLSv1.3`
- **Referencia**: BSI TR-02102, NIST SP 800-52r2
### Ausencia de cabeceras de seguridad X-Header
- **Bastionado nginx**:
```
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Content-Security-Policy "default-src 'self'" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;
```
- **Referencia**: OWASP Secure Headers Project
### Certificado wildcard/comodín
- **Remediación**: Emitir certificado específico por FQDN; limitar scope del comodín
- **Config**: Certificate Transparency, HPKP si aplica
### DoS/DDoS
- **Bastionado**: Rate limiting, filtros Ingress/Egress, ACLs, CDN/WAF
- **Config nginx**: `limit_req_zone`, `limit_conn_zone`
- **Config iptables**: `hashlimit`, `connlimit`
- **Referencia**: NIST SP 800-61r2, RFC 5635
### Inyección SQL
- **Bastionado**: Prepared statements; ORM con parámetros; deshabilitar errores detallados en producción
- **Config**: WAF con OWASP Core Rule Set
### Command Injection / RCE
- **Bastionado**: Eliminar `system()`/`exec()`; aplicar mínimo privilegio; chroot/jail
### XSS (Reflected/Stored)
- **Bastionado**: Content Security Policy; encoding de salida contextual; sanitización de entrada
### Path Traversal
- **Bastionado**: `realpath()` con validación contra directorio base; whitelist de rutas
### Fuerza bruta / Credenciales débiles
- **Bastionado**: Lockout tras N intentos; MFA; rate limiting; bcrypt/Argon2
### CVE en servicios de red (SSH, OpenSSL, Apache…)
- **Bastionado**: Actualizar a versión corregida; deshabilitar servicio si no es necesario; ACL por IP
---
## Notas de uso
- Si el usuario no indica CVSS score, estimar basándose en tipo de vulnerabilidad y contexto
- Usar siempre CVE oficial si existe; si no, indicar "Sin CVE asignado"
- El resumen ejecutivo debe ser legible por perfiles no técnicos (dirección, legal, cumplimiento)
- El informe técnico debe ser reproducible por otro auditor
- Clasificar siempre el documento como **CONFIDENCIAL**
- Terminología preferida en castellano:
- *bastionado* (no "hardening")
- *fichero* (no "archivo")
- *captura de banner* (no "banner grabbing")
- *comodín* (no "wildcard")
- *auditoría* (no "assessment")
- Idioma del informe: castellano (español de España)
- El logo de hackingyseguridad.com SIEMPRE en el header de todas las páginas
- El output técnico de herramientas: bloques de fuente monoespaciada con fondo oscuro
(estilo terminal Kali Linux)
- El documento final se entrega en /mnt/user-data/outputs/informe_pentest_[cliente]_[fecha].docx
### Guardar el informe en disco
Guarda el informe en la carpeta: /mnt/user-data/outputs/
en ficheros en formatos:
- PDF v1.7
- DOC compatible con Microsoft Word 97-2003
- Rich Text Format v1, ANSI
- Microsoft Word 2007+