La migration de Rotativavers IronPDF permet de remédier aux failles de sécurité critiques tout en modernisant votre flux de production de PDF. Ce guide fournit un chemin de migration complet, étape par étape, qui élimine la dépendance wkhtmltopdf abandonnée, permet la prise en charge de CSS et JavaScript modernes et offre une compatibilité multiplateforme au-delà d'ASP.NET MVC.
Rotativa est depuis longtemps un choix populaire parmi les développeurs pour générer des PDF en C#. Il utilise l'outil wkhtmltopdf pour convertir le contenu HTML en format PDF. Rotativaest une bibliothèque open-source spécialement conçue pour les applications ASP.NET MVC. Cependant, bien qu'elle ait attiré un public important, la dépendance de Rotativaà l'égard d'une pile technologique dépassée présente des défis qui ne sont pas forcément évidents pour tous les développeurs.
En son cœur, Rotativafournit un moyen simple d'intégrer la génération de PDF dans les projets ASP.NET MVC, en tirant parti de wkhtmltopdf pour ses fonctionnalités backend.
Rotativa intègre wkhtmltopdf, qui présente des VULNÉRABILITÉS DE SÉCURITÉ CRITIQUES NON PRÉVUES.
| Attribut | Valeur |
|---|---|
| CVE ID | CVE-2022-35583 |
| Sévérité | CRITIQUE (9,8/10) |
| Vecteur d'attaque | Réseau |
| Statut | Pas de version fixe (binaire wkhtmltopdf archivé) |
| Affectés | Toutes les versions de Rotativaregroupant wkhtmltopdf 0.12.6 |
Le dépôt GitHub wkhtmltopdf a été archivé (lecture seule) le 2 janvier 2023. La page de statut du mainteneur note que le projet dépend de Qt 4 (non pris en charge depuis 2015) et d'une branche WebKit de 2012, et met explicitement en garde contre son utilisation avec du HTML non fiable. CVE-2022-35583n'a pas de version corrigée, donc toute application utilisant Rotativaest exposée sauf si les entrées HTML sont entièrement assainies en amont.
<!-- Attacker submits this content via your MVC model -->
<iframe src="http://169.254.169.254/latest/meta-data/iam/security-credentials/"></iframe>
<img src="http://internal-database:5432/admin" />Impact :
Rotativa intègre wkhtmltopdf, qui utilise :
| Fonction | Rotativa | IronPDF |
|---|---|---|
| Compatibilité des projets | ASP.NET MVC uniquement | Tout type de projet .NET (MVC, Razor Pages, Blazor, etc.) |
| Maintenance | Abandonné | Maintenu activement |
| Sécurité | Vulnérabilité due aux dépendances wkhtmltopdf (CVE-2022-35583) | Mises à jour régulières et correctifs de sécurité |
| Rendu HTML | WebKit dépassé | Chrome moderne |
| CSS3 | Partiel | Prise en charge |
| Flexbox/Grid | Non pris en charge | Prise en charge |
| JavaScript | Peu fiable | ES6+ complet |
| Pages Razor | Non pris en charge | Prise en charge |
| Blazor | Non pris en charge | Prise en charge |
| Manipulation de PDF | Non disponible | Complet |
| Signatures numériques | Non disponible | Complet |
| Conformité PDF/A | Non disponible | Complet |
| Async/Await | Synchrone uniquement | Complet async |
| Open Source | Oui, licence MIT | Non, licence commerciale |
Pour les équipes ciblant les versions actuelles de .NET,IronPDF offre un rendu moderne par Chromium et une prise en charge multiplateforme que Rotativane peut offrir.
Le package original Rotativa cible le classique ASP.NET MVC 5 (dernière version v1.7.3, 29/09/2017). Le fork communautaire Rotativa.AspNetCore (webgio) a atteint v1.4.0 le 06/11/2024 et prend en charge .NET Core 3.1 jusqu'à .NET 8 — mais les deux packages livrent toujours le binaire wkhtmltopdf 0.12.6 (dernière version en amont juin 2020).
# Remove Rotativa
dotnet remove package Rotativa
dotnet remove package Rotativa.AspNetCore
# Install IronPDF
dotnet add package IronPdfSupprimez ces fichiers de votre projet :
wkhtmltopdf.exewkhtmltox.dllRotativa/Ces outils sont à l'origine de la CVE-2022-35583.IronPDF ne nécessite pas de binaires natifs.
// Add in Program.cs or Startup.cs
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";' Add in Program.vb or Startup.vb
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"// Before: Rotativa
using Rotativa;
using Rotativa.Options;
using Rotativa.AspNetCore;
// After: IronPDF
using IronPdf;
using IronPdf.Rendering;' Before: Rotativa
Imports Rotativa
Imports Rotativa.Options
Imports Rotativa.AspNetCore
' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering| Classe Rotativa | Équivalent d'IronPDF |
|---|---|
ViewAsPdf | ChromePdfRenderer |
ActionAsPdf | ChromePdfRenderer.RenderUrlAsPdf() |
UrlAsPdf | ChromePdfRenderer.RenderUrlAsPdf() |
Orientation enum | PdfPaperOrientation enum |
Size enum | PdfPaperSize enum |
| Placeholder Rotativa | IronPDF Placeholder |
|---|---|
[page] | {page} |
[topage] | {total-pages} |
[date] | {date} |
[time] | {time} |
[title] | {html-title} |
[sitepage] | {url} |
Avant (Rotativa):
// NuGet: Install-Package Rotativa.AspNetCore
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using System.Threading.Tasks;
namespace RotativaExample
{
public class PdfController : Controller
{
public async Task<IActionResult> GeneratePdf()
{
var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
// Rotativarequires returning a ViewAsPdf result from MVC controller
return new ViewAsPdf()
{
ViewName = "PdfView",
PageSize = Rotativa.AspNetCore.Options.Size.A4
};
}
}
}Après (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
namespace IronPdfExample
{
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF generated successfully!");
}
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module IronPdfExample
Sub Main()
Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = "<h1>Hello World</h1><p>This is a PDF document.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF generated successfully!")
End Sub
End ModuleCet exemple illustre la différence architecturale fondamentale. Rotativanécessite de retourner un résultat ViewAsPdf depuis une action du contrôleur MVC, vous liant au framework ASP.NET MVC. Le modèle ne fonctionne que dans le pipeline de requêtes MVC et nécessite une vue Razor pour le rendu.
IronPDF fonctionne partout : applications de console, API web, Blazor, Razor Pages, ou tout type de projet .NET. Vous appelez RenderHtmlAsPdf() avec une chaîne HTML et sauvegardez le résultat. Aucun contrôleur MVC n'est requis, aucune dépendance à l'égard de la vue. Consultez la documentation HTML vers PDF pour des exemples complets.
Avant (Rotativa):
// NuGet: Install-Package Rotativa.AspNetCore
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using System.Threading.Tasks;
namespace RotativaExample
{
public class UrlPdfController : Controller
{
public async Task<IActionResult> ConvertUrlToPdf()
{
// Rotativaworks within MVC framework and returns ActionResult
return new UrlAsPdf("https://www.example.com")
{
FileName = "webpage.pdf",
PageSize = Rotativa.AspNetCore.Options.Size.A4,
PageOrientation = Rotativa.AspNetCore.Options.Orientation.Portrait
};
}
}
}Après (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
namespace IronPdfExample
{
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
pdf.SaveAs("webpage.pdf");
Console.WriteLine("URL converted to PDF successfully!");
}
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module IronPdfExample
Sub Main()
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
pdf.SaveAs("webpage.pdf")
Console.WriteLine("URL converted to PDF successfully!")
End Sub
End ModuleLa classe UrlAsPdf de Rotativanécessite de retourner un ActionResult depuis un contrôleur MVC. La méthode RenderUrlAsPdf() d'IronPDF peut être appelée depuis n'importe quel contexte et retourne directement un objet PdfDocument. Le rendu de l'URL utilise le moteur moderne Chromium au lieu du moteur WebKit vulnérable et obsolète de wkhtmltopdf. Pour en savoir plus, consultez nos tutoriels.
Avant (Rotativa):
// NuGet: Install-Package Rotativa.AspNetCore
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using Rotativa.AspNetCore.Options;
using System.Threading.Tasks;
namespace RotativaExample
{
public class HeaderFooterController : Controller
{
public async Task<IActionResult> GeneratePdfWithHeaderFooter()
{
return new ViewAsPdf("Report")
{
PageSize = Size.A4,
// Margins(top, right, bottom, left)
PageMargins = new Margins(20, 10, 20, 10),
CustomSwitches = "--header-center \"Page Header\" --footer-center \"Page [page] of [topage]\""
};
}
}
}Imports Microsoft.AspNetCore.Mvc
Imports Rotativa.AspNetCore
Imports Rotativa.AspNetCore.Options
Imports System.Threading.Tasks
Namespace RotativaExample
Public Class HeaderFooterController
Inherits Controller
Public Async Function GeneratePdfWithHeaderFooter() As Task(Of IActionResult)
Return New ViewAsPdf("Report") With {
.PageSize = Size.A4,
' Margins(top, right, bottom, left)
.PageMargins = New Margins(20, 10, 20, 10),
.CustomSwitches = "--header-center ""Page Header"" --footer-center ""Page [page] of [topage]"""
}
End Function
End Class
End NamespaceAprès (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;
namespace IronPdfExample
{
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
CenterText = "Page Header",
DrawDividerLine = true
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
{
CenterText = "Page {page} of {total-pages}",
DrawDividerLine = true
};
var htmlContent = "<h1>Report Title</h1><p>Report content goes here.</p>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("report.pdf");
Console.WriteLine("PDF with headers and footers created successfully!");
}
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering
Imports System
Module IronPdfExample
Sub Main(args As String())
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter() With {
.CenterText = "Page Header",
.DrawDividerLine = True
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter() With {
.CenterText = "Page {page} of {total-pages}",
.DrawDividerLine = True
}
Dim htmlContent As String = "<h1>Report Title</h1><p>Report content goes here.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("report.pdf")
Console.WriteLine("PDF with headers and footers created successfully!")
End Sub
End ModuleRotativa utilise CustomSwitches pour passer des arguments en ligne de commande à wkhtmltopdf, y compris la configuration d'en-tête et de pied de page avec des espaces réservés comme [page] et [topage]. Cette approche basée sur les chaînes de caractères est sujette aux erreurs et difficile à valider au moment de la compilation.
IronPDF utilise des objets TextHeaderFooter fortement typés avec des propriétés comme CenterText et DrawDividerLine. La syntaxe des espaces réservés change de [page] à {page} et de [topage] à {total-pages}. Les propriétés typées offrent un système IntelliSense, une vérification au moment de la compilation et aucun risque de fautes de frappe.
Rotativa a été conçu pour ASP.NET MVC 5 et les versions antérieures :
// ❌ Rotativa- Only works with classic MVC pattern
public class InvoiceController : Controller
{
public ActionResult InvoicePdf(int id)
{
var model = GetInvoice(id);
return new ViewAsPdf("Invoice", model); // Tied to MVC Views
}
}
// Problems:
// - No Razor Pages support
// - No Blazor support
// - No minimal APIs support
// - No ASP.NET Core native integrationImports System.Web.Mvc
Public Class InvoiceController
Inherits Controller
Public Function InvoicePdf(id As Integer) As ActionResult
Dim model = GetInvoice(id)
Return New ViewAsPdf("Invoice", model) ' Tied to MVC Views
End Function
End Class
' Problems:
' - No Razor Pages support
' - No Blazor support
' - No minimal APIs support
' - No ASP.NET Core native integrationIronPDF sépare le rendu des vues de la génération de PDF, qui est en fait plus flexible - vous pouvez rendre n'importe quel HTML, pas seulement les vues MVC.
Rotativa bloque le fil ;IronPDF prend en charge l'intégralité des fonctions async/await :
// ❌ Rotativa- Blocks the thread
public ActionResult GeneratePdf()
{
return new ViewAsPdf("Report");
// This blocks the request thread until PDF is complete
// Poor scalability under load
}
// ✅IronPDF- Complet asyncsupport
public async Task<IActionResult> GeneratePdf()
{
var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync(html);
return File(pdf.BinaryData, "application/pdf");
// Non-blocking, better scalability
}Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc
' ❌ Rotativa- Blocks the thread
Public Function GeneratePdf() As ActionResult
Return New ViewAsPdf("Report")
' This blocks the request thread until PDF is complete
' Poor scalability under load
End Function
' ✅IronPDF- Complete async support
Public Async Function GeneratePdf() As Task(Of IActionResult)
Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)
Return File(pdf.BinaryData, "application/pdf")
' Non-blocking, better scalability
End FunctionAprès avoir migré vers IronPDF, vous bénéficiez de fonctionnalités que Rotativane peut pas vous offrir :
var merged = PdfDocument.Merge(pdf1, pdf2, pdf3);
merged.SaveAs("complete.pdf");Dim merged = PdfDocument.Merge(pdf1, pdf2, pdf3)
merged.SaveAs("complete.pdf")var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);Dim signature = New PdfSignature("certificate.pfx", "password")
pdf.Sign(signature)pdf.SecuritySettings.UserPassword = "secret";pdf.SecuritySettings.UserPassword = "secret"pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");IRON VB CONVERTER ERROR developers@ironsoftware.compdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b);pdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b)// This now works (broke in Rotativa)
var html = @"
<div style='display: flex; justify-content: space-between;'>
<div>Left</div>
<div>Right</div>
</div>
<div style='display: grid; grid-template-columns: 1fr 1fr 1fr;'>
<div>Col 1</div><div>Col 2</div><div>Col 3</div>
</div>";
var pdf = renderer.RenderHtmlAsPdf(html); // Works!' This now works (broke in Rotativa)
Dim html As String = "
<div style='display: flex; justify-content: space-between;'>
<div>Left</div>
<div>Right</div>
</div>
<div style='display: grid; grid-template-columns: 1fr 1fr 1fr;'>
<div>Col 1</div><div>Col 2</div><div>Col 3</div>
</div>"
Dim pdf = renderer.RenderHtmlAsPdf(html) ' Works![page] → {page})Rotativa et Rotativa.AspNetCorewkhtmltopdf.exe, wkhtmltox.dll)IronPdfusing Rotativa; → using IronPdf;)ViewAsPdf par ChromePdfRenderer + RenderHtmlAsPdf()UrlAsPdf par RenderUrlAsPdf()CustomSwitches en propriétés RenderingOptions[page] → {page}, [topage] → {total-pages})PageMargins par des MarginRight individuels
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
