La crisis de seguridad CVE-2022-35583

La vulnerabilidad Server-Side Request Forgery (SSRF) en wkhtmltopdf permite a los atacantes:

• Acceso a servicios internos: Llegar a API internas, bases de datos y servicios detrás de cortafuegos
• Steal Credentials: Accede a endpoints de metadatos en la nube (AWS, GCP, Azure) para robar credenciales IAM
• Exploración de puertos: Exploración de redes internas desde la infraestructura
• Exfiltración de datos: extracción de datos confidenciales mediante HTML/CSS manipulado

El vector de ataque es sencillo: HTML malicioso enviado a un generador de PDF:

<!-- Malicious HTML submitted to your PDF generator -->
<iframe src="http://169.254.169.254/latest/meta-data/iam/security-credentials/"></iframe>
<img src="http://internal-database:5432/admin"/>

<!-- Malicious HTML submitted to your PDF generator -->
<iframe src="http://169.254.169.254/latest/meta-data/iam/security-credentials/"></iframe>
<img src="http://internal-database:5432/admin"/>

Cuando wkhtmltopdf renderiza este HTML, obtiene estas URL del contexto de red del servidor, eludiendo cortafuegos y controles de seguridad. Esta vulnerabilidad nunca será parcheada porque el proyecto ha sido oficialmente abandonado.

Bibliotecas envolventes afectadas

Todas las envolturas .NET para wkhtmltopdf heredan las mismas vulnerabilidades:

Si su aplicación utiliza alguna de estas bibliotecas, es vulnerable a CVE-2022-35583.

patrón de configuración wkhtmltopdf

las envolturas wkhtmltopdf requieren la creación de objetos de documento con configuraciones de ajustes anidadas:

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientación= Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    HtmlContent = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientación= Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    HtmlContent = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Este patrón requiere crear un ConvertidorSincronizadocon PdfTools, construir un <código>HtmlToPdfDocument</códigocon colecciones GlobalSettings y Objects, y escribir manualmente matrices de bytes en archivos.

Patrón simplificado de IronPDF

IronPDF utiliza un enfoque simplificado con la clase ChromePdfRenderer:

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML.</p>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML.</p>");
        pdf.SaveAs("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

La clase ChromePdfRenderer elimina los objetos de configuración anidados, devolviendo un PdfDocument con métodos de guardado incorporados. Para obtener información detallada sobre la conversión de HTML, consulte el tutorial HTML a PDF.

implementación de wkhtmltopdf

wkhtmltopdf utiliza la propiedad Page dentro de ObjectSettings para especificar URLs:

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientación= Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "https://www.example.com"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientación= Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "https://www.example.com"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Implementación de IronPDF

IronPDF proporciona un método RenderUrlAsPdf dedicado:

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

El método RenderUrlAsPdf aprovecha el motor Chromium para renderizar páginas con ejecución completa de JavaScripty soporte moderno de CSS, capacidades limitadas por el motor WebKit 2015 de wkhtmltopdf.

configuración personalizada de wkhtmltopdf

wkhtmltopdf requiere objetos GlobalSettings anidados con MarginSettings:

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientación= Orientation.Landscape,
                PaperSize = PaperKind.A4,
                Margins = new MarginSettings() { Top = 10, Bottom = 10, Left = 10, Right = 10 }
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "input.html",
                    WebSettings = { DefaultEncoding = "utf-8" }
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("custom-output.pdf", pdf);
    }
}

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientación= Orientation.Landscape,
                PaperSize = PaperKind.A4,
                Margins = new MarginSettings() { Top = 10, Bottom = 10, Left = 10, Right = 10 }
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "input.html",
                    WebSettings = { DefaultEncoding = "utf-8" }
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("custom-output.pdf", pdf);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Configuración personalizada de IronPDF

IronPDF utiliza propiedades <código>RenderingOptions</códigopara la configuración directa:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("custom-output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("custom-output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Mapeo de API deCLI a C

C# Wrapper API Mapping

Mapeo sintáctico de marcadores

Requisitos de cumplimiento de seguridad

Las organizaciones con requisitos de cumplimiento de seguridad (SOC 2, PCI DSS, HIPAA) no pueden aceptar aplicaciones con vulnerabilidades críticas conocidas. El índice de gravedad 9,8 de CVE-2022-35583 exige una corrección inmediata en la mayoría de los marcos de seguridad.

Adopción del marco CSS moderno

Los equipos que adoptan Bootstrap 5, Tailwind CSS o diseños CSS Grid personalizados descubren que wkhtmltopdf no puede renderizarlos correctamente. El motor WebKit de 2015 carece por completo de compatibilidad con CSS Grid y ha roto la implementación de Flexbox.

Requisitos de la aplicación JavaScript

Las aplicaciones que utilizan características modernas de JavaScript-sintaxis ES6+, incluidas funciones de flecha, async/await, clases y literales de plantilla- experimentan fallos en wkhtmltopdf. El motor Chromium deIronPDFes totalmente compatible con JavaScript.

Despliegues en la nube y en contenedores

Las estrategias de despliegue modernas que utilizan Docker, Kubernetes o plataformas en la nube se benefician de la arquitectura deIronPDFadaptada a los contenedores. Los análisis de seguridad de los binarios wkhtmltopdf en contenedores detectarán la vulnerabilidad CVE.

Preocupaciones de mantenimiento a largo plazo

Dado que no se esperan futuras actualizaciones de wkhtmltopdf, los equipos se enfrentan a una deuda técnica cada vez mayor a medida que evolucionan los estándares web. El desarrollo activo deIronPDFgarantiza una compatibilidad continua con las futuras versiones de .NET, incluida .NET 10, prevista para 2026.

Soporte Async

IronPDF es compatible con async/await para mejorar el rendimiento de las aplicaciones web:

public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Esto evita el bloqueo de hilos en aplicaciones web de alta carga, una capacidad que no está disponible con las envolturas de wkhtmltopdf de sólo sincronización.