Pular para o conteúdo
nexus-dialogs
GitHub npm

Segurança

Esta página está disponível apenas em espanhol.

Qué hace la librería con el contenido que le pasas y qué le toca a quien la usa. Lo de esta página está cubierto por pruebas (test/unit/seguridad.test.ts).

#La regla corta

#Modo estricto (por omisión desde la 0.5.0)

Cualquier html en cadena que no pase por un sanitize configurado se muestra como texto en vez de interpretarse. Si alguien olvida configurar el filtro, el resultado es un texto feo y no un XSS.

// Con tu propio contenido (constantes de tu código): desactívalo a propósito.
configure({ strictHtml: false })

// Con contenido que no es tuyo: dale un filtro y el HTML se interpreta ya limpio.
configure({ sanitize: (html) => DOMPurify.sanitize(html) })

Antes de la 0.5.0 el HTML se insertaba tal cual por omisión. Si actualizas y ves etiquetas como <b> en pantalla, es esto.

#Cuándo usar cada cosa

Quiero mostrar…Usa
Un mensaje con datos del usuario (nombre, comentario, error del servidor)text (o title). Nunca html.
Contenido propio con negritas, listas o enlaces fijoshtml en cadena escrito por ti (constante en tu código) con strictHtml: false, o un sanitize.
Contenido que viene de fuera y debe verse con formatohtml + el filtro sanitize (abajo), o construye un Node con textContent/createElement.

#El filtro sanitize

Un solo punto de entrada para todo el HTML en cadena. Se configura una vez:

import DOMPurify from 'dompurify'
import { configure } from 'nexus-dialogs'

configure({ sanitize: (html) => DOMPurify.sanitize(html) })

sanitize puede devolver una cadena o un objeto con toString() (por ejemplo, un TrustedHTML). Con sanitize: null se quita. A partir de ahí, dialog.alert({ html }) y, con nexus-dialogs/swal, html, iconHtml, closeButtonHtml y loaderHtml pasan por tu función antes de llegar al DOM. La librería no trae su propio sanitizador a propósito: limpiar HTML a mano es una fuente clásica de fallos y es mejor usar uno mantenido (DOMPurify, o la API nativa Sanitizer cuando tu navegador objetivo la tenga).

Lo que el filtro no toca: los textos (ya son texto) y los Node, que son tu responsabilidad (ver arriba).

#Otras puertas que conviene conocer

#Qué está probado y qué no

CosaCómo
Textos como texto, sanitize, strictHtmlPruebas unitarias
Inyección de fórmulas (=1+1, @SUM(A1:A2), +cmd, -1+2, HYPERLINK, cmd|…)Pruebas unitarias; además, LibreOffice abre el CSV y el xlsx exportados sin crear fórmulas (se comprueba convirtiéndolos con soffice)
Apertura en Microsoft ExcelNo probada por nosotros. El archivo cumple la recomendación de OWASP, pero no lo hemos abierto en Excel
CSP y Trusted TypesPruebas en Chromium real
Fugas de memoria300 diálogos, formularios y toasts abiertos y cerrados no dejan nodos del DOM (Chromium)
DependenciasLa librería no tiene dependencias en producción; npm audit de producción corre en cada cambio

#Cómo reportar una vulnerabilidad

Ver SECURITY.md: canal privado, tiempos de respuesta y cómo se publican las versiones.