CVE-2022-35583 安全危机

wkhtmltopdf 中的服务器端请求伪造 (SSRF) 漏洞允许攻击者

• 访问内部服务：访问防火墙后的内部 API、数据库和服务
• 窃取凭证：访问云元数据端点（AWS、GCP、Azure）以窃取 IAM 凭据
• 端口扫描：从基础设施内部扫描内部网络
• 数据渗透：通过精心制作的 HTML/CSS 提取敏感数据

攻击载体简单明了--向 PDF 生成器提交恶意 HTML：

<!-- 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"/>

当wkhtmltopdf渲染 HTML 时，它会绕过防火墙和安全控制，从服务器的网络上下文中获取这些 URL。 该漏洞永远不会被修补，因为该项目已被正式放弃。

受影响的封装库

wkhtmltopdf 的所有 .NET 封装程序都继承了相同的漏洞：

如果您的应用程序使用了这些库中的任何一个，那么它就存在 CVE-2022-35583 漏洞。

wkhtmltopdf配置模式

wkhtmltopdf 封装程序要求创建具有嵌套设置配置的文档对象：

// 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.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.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

这种模式要求使用 PdfTools 创建<代码>同步转换器</代码，使用 GlobalSettings 和 Objects 集合构建<代码>HtmlToPdfDocument</代码并手动将字节数组写入文件。

IronPDF简化模式

IronPDF 使用<代码>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

ChromePdfRenderer类消除了嵌套的配置对象，返回一个具有内置保存方法的PdfDocument。 有关全面的 HTML 转换指导，请参阅 HTML 转 PDF 教程。

wkhtmltopdf的实现

wkhtmltopdf 使用 ObjectSettings 中的 Page 属性指定 URL：

// 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.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.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

IronPdf 的实现

IronPDF 提供了专门的 RenderUrlAsPdf 方法：

// 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

RenderUrlAsPdf 方法利用 Chromium 引擎来呈现具有完整JavaScript执行功能和现代 CSS 支持功能的页面--这些功能受到wkhtmltopdf的 2015 WebKit 引擎的限制。

wkhtmltopdf自定义设置

wkhtmltopdf 需要嵌套 GlobalSettings 与 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.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.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

IronPDF自定义设置

IronPDF 使用<代码>渲染选项</代码属性进行直接配置：

// 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

CLI 到 C# API 映射

C# Wrapper API 映射

占位符语法映射

安全合规要求

有安全合规要求（SOC 2、PCI DSS、HIPAA）的组织不能接受存在已知关键漏洞的应用程序。 CVE-2022-35583 的严重性等级为 9.8，在大多数安全框架中都会触发立即修复的要求。

现代 CSS 框架的采用

采用 Bootstrap 5、Tailwind CSS 或自定义 CSS 网格布局的团队会发现wkhtmltopdf无法正确呈现这些布局。 2015 WebKit 引擎完全不支持 CSS 网格，并且破坏了 Flexbox 的实现。

JavaScript应用程序要求

使用现代JavaScript功能（ES6+ 语法，包括箭头函数、async/await、类和模板字面）的应用程序会在wkhtmltopdf中遇到故障。IronPDF的 Chromium 引擎提供完整的JavaScript支持。

云和容器部署

使用 Docker、Kubernetes 或云平台的现代部署策略受益于 IronPdf 的容器友好架构。 容器中wkhtmltopdf二进制文件的安全扫描将标记 CVE 漏洞。

长期维护问题

由于wkhtmltopdf今后预计不会更新，因此随着网络标准的发展，团队将面临越来越多的技术债务。IronPDF的积极开发确保了与未来 .NET 版本的持续兼容性，包括预计在 2026 年推出的 .NET 10。

同步支持

IronPdf 为网络应用程序性能提供异步/等待支持：

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

wkhtmltopdf 的同步封装器可以防止高负载网络应用程序中的线程阻塞--这是wkhtmltopdf仅同步封装器不具备的功能。