Ghostscript GPL vs IronPDF: Techniczne porównanie przewodnika

Problem biznesowy

Aplikacja finansowa, zdrowotna lub ubezpieczeniowa tworzy dokumenty klienckie z szablonów internetowych. Te szablony pobierają zasoby zewnętrzne, ale serwer znajduje się za zaporą ogniową i proxy. Bez konfiguracji proxy, silnik nie może sięgnąć zasobów, więc wynik wygląda na uszkodzony. Wiele z tych środowisk działa również z uwierzytelnionymi serwerami proxy, co dodaje do wymagań kredencje.

Rozwiązanie

Proxy to parametr w metodzie RenderHtmlAsPdf, a nie właściwość opcji renderowania. Przekazanie ciągu proxy kieruje wszystkie żądania zasobów z silnika przez to proxy.

using IronPdf;

var renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(
    htmlContent,
    baseUrlOrPath: @"C:\templates\assets\",
    proxy: "http://proxy.co/rp.local:8080"
);
pdf.SaveAs("report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(
    htmlContent,
    baseUrlOrPath: @"C:\templates\assets\",
    proxy: "http://proxy.co/rp.local:8080"
);
pdf.SaveAs("report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(
    htmlContent,
    baseUrlOrPath: "C:\templates\assets\",
    proxy: "http://proxy.co/rp.local:8080"
)
pdf.SaveAs("report.pdf")

Dla uwierzytelnionego proxy, dane uwierzytelniające znajdują się w URL proxy. Specjalne znaki w haśle muszą być zakodowane procentowo.

string encoded = Uri.EscapeDataString("P@ssw0rd!");
string proxy = $"http://svc-account:{encoded}@proxy.co/rp.local:8080";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath: null, proxy: proxy);

string encoded = Uri.EscapeDataString("P@ssw0rd!");
string proxy = $"http://svc-account:{encoded}@proxy.co/rp.local:8080";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath: null, proxy: proxy);

Imports System

Dim encoded As String = Uri.EscapeDataString("P@ssw0rd!")
Dim proxy As String = $"http://svc-account:{encoded}@proxy.co/rp.local:8080"

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath:=Nothing, proxy:=proxy)

Renderowanie wewnętrznych adresów URL za proxy

Metoda renderowania URL nie akceptuje parametru proxy. Praktycznym wzorcem jest pobranie HTML przy użyciu HttpClient skonfigurowanego dla proxy, a następnie renderowanie tego HTML, aby zasoby referencyjne również były kierowane przez proxy.

using System.Net;
using System.Net.Http;

var webProxy = new WebProxy("http://proxy.co/rp.local:8080")
{
    Credentials = new NetworkCredential("svc-account", "P@ssw0rd!")
};
var handler = new HttpClientHandler { Proxy = webProxy, UseProxy = true };
using var httpClient = new HttpClient(handler);

string html = await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report");
PdfDocument pdf = renderer.RenderHtmlAsPdf(html, baseUrlOrPath: null, proxy: "http://proxy.co/rp.local:8080");

using System.Net;
using System.Net.Http;

var webProxy = new WebProxy("http://proxy.co/rp.local:8080")
{
    Credentials = new NetworkCredential("svc-account", "P@ssw0rd!")
};
var handler = new HttpClientHandler { Proxy = webProxy, UseProxy = true };
using var httpClient = new HttpClient(handler);

string html = await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report");
PdfDocument pdf = renderer.RenderHtmlAsPdf(html, baseUrlOrPath: null, proxy: "http://proxy.co/rp.local:8080");

Imports System.Net
Imports System.Net.Http

Dim webProxy As New WebProxy("http://proxy.co/rp.local:8080") With {
    .Credentials = New NetworkCredential("svc-account", "P@ssw0rd!")
}
Dim handler As New HttpClientHandler With {
    .Proxy = webProxy,
    .UseProxy = True
}
Using httpClient As New HttpClient(handler)
    Dim html As String = Await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report")
    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html, baseUrlOrPath:=Nothing, proxy:="http://proxy.co/rp.local:8080")
End Using

Punkty do zaplanowania

• Autoryzacja proxy to nie autoryzacja strony: Dane uwierzytelniające w URL proxy uwierzytelniają się w proxy, co różni się od danych logowania do strony internetowej.
• Schemat odnosi się do przeskoku przez proxy: Proxy http:// nadal może pobrać zasoby https://, więc wybór schematu dotyczy tego, czy połączenie aplikacja-proxy wymaga TLS.
• Kontenery i potoki: Wdrożenia Dockera i agenci budowania CI zazwyczaj nie mają wyjścia, więc taka sama konfiguracja proxy obowiązuje w tym przypadku.

Wynik

Za pomocą jednego parametru zespoły mogą uzyskać w pełni stylizowane, markowe pliki PDF z aplikacji działających za firmowym proxy, wliczając uwierzytelnione środowiska i kontenery. Pełne szczegóły konfiguracji znajdują się w przewodniku proxy.