wkhtmltopdf vs IronPDF: Guía de comparación técnica

La crisis de seguridad CVE-2022-35583

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

• Acceder a servicios internos: acceder a API internas, bases de datos y servicios detrás de firewalls
• Robar credenciales: acceder a los puntos finales de metadatos de la nube (AWS, GCP, Azure) para robar credenciales de IAM
• Escaneo de puertos: escanee redes internas desde dentro de la infraestructura
• Exfiltración de datos: extraiga datos confidenciales mediante HTML/CSS elaborados

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,
                Orientation = 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,
                Orientation = 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);
    }
}

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");
    }
}

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,
                Orientation = 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,
                Orientation = Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "https://www.example.com"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

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");
    }
}

El método RenderUrlAsPdf aprovecha el motor Chromium para renderizar páginas con ejecución completa de JavaScript y 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,
                Orientation = 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,
                Orientation = 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);
    }
}

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");
    }
}

Mapeo de API deCLI a C

Mapeo de API de Wrapper de C

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;
}

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.