IronPDF ile kimliği doğrulanmış bir sayfayı PDF olarak nasıl oluşturabilirim?

RequestContext i Global olarak ayarlayın ve RenderUrlAsPdf çağrısından önce kullanıcının oturum çerezini CustomCookies 'e yerleştirin. IronPDF'nin Chrome motoru bu çerezlerle kimlik doğrulaması yapacak ve korumalı sayfayı oluşturacaktır.

ApplyCookies ve CustomCookies arasındaki fark nedir?

ApplyCookies , HTTP kimlik bilgilerini (temel kimlik doğrulama veya Windows kimlik doğrulaması) kullanarak oturum açar ve sonuçtaki oturum çerezlerini genel bağlama kaydeder. CustomCookies , çerez anahtar-değer çiftlerini doğrudan sağlamanıza izin verir — JWT tokenleri, OAuth çerezleri ve çok parametreli oturumlar için yararlıdır.

RequestContext nedir ve Global ile Isolated ne zaman kullanılmalı?

Global 'i, birden fazla oluşturmanın aynı doğrulanmış oturumu paylaştığı durumlarda kullanın (örneğin, tek bir kullanıcı için toplu fatura üretimi). Farklı kullanıcılar için eşzamanlı oluşturma yaparken, her oluşturmanın temiz bir çerez durumu alması için Isolated 'ı kullanın ve oturumların kullanıcılar arasında sızmasından kaçının.

IronPDF, PDF oluşturma için JWT ve OAuth kimlik doğrulamasını işleyebilir mi?

Evet. Token değerlerini CustomCookies içinde anahtar-değer çiftleri olarak iletin (örneğin, auth_token ve refresh_token ). IronPDF, bu değerleri Chrome motorunun yaptığı her isteğe iletir.

Neden PDF'im boş bir sayfa veya giriş ekranı olarak oluşturuluyor?

En yaygın nedenler, süresi dolmuş oturum çerezleri, uyumsuz çerez alan adları, HTTPS URL'lerindeki güvenli çerez kısıtlamaları ve çapraz kaynak isteklerindeki SameSite politika bloklarıdır. Çerezlerin geçerli ve hedef alan adı ile eşleştiğinden emin olun ve ardından oluşturmaya başlayın.

C# PDF Kütüphanesi

Explore IronPDF Ücretsiz Denemeye Başlayın

HTML'den PDF'e

Online Demo Tüm Kod Örneklerini Görün

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >

Install-Package IronPdf

ÜRÜN KARŞILAŞTIRMALARI

PDFsharp'a PDF'den Görsel İçe Aktarma En İyi Alternatiflerini Keşfet

Curtis Chau

Updated: 5 Temmuz 2026

Çoğu HTML'den PDF'e iş en aynı sebepten dolayı bozulur: sayfa ancak bir kullanıcı oturum açtıktan sonra doğru görünür. IronPDF, Chrome motorunu çalıştırır, bu nedenle, doğru çerezleri verene kadar, kimliği doğrulanmamış bir tarayıcının göreceği bir giriş ekranını ya da boş bir kabuğu görür. Bunu, RequestContext özelliği, ApplyCookies metodu ve CustomCookies sözlüğü olmak üzere API'nin üç parçası çözer. Her birinin nasıl uyduğunu ve eşleşen bir kod parçasını görmek için buraya bakın.

Giriş yaptıktan sonra faturaları ve ekstreleri oluşturma

Bir müşterinin faturası oturum korumalı bir yolda bulunur ve uygulamanız zaten oturumlarını tutar. O oturum kimliğini doğrudan CustomCookies üzerinden iletin:

using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042")
        .SaveAs("invoice-1042.pdf");

using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042")
        .SaveAs("invoice-1042.pdf");

Imports IronPdf
Imports System.Collections.Generic

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042").SaveAs("invoice-1042.pdf")

Imports IronPdf
Imports System.Collections.Generic

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042").SaveAs("invoice-1042.pdf")

Temel veya Windows kimlik doğrulaması için bunun yerine ApplyCookies kullanın. URL'ye belirtilen kimlik bilgileri ile giriş yapar ve elde edilen çerezleri global bağlama kaydeder, ardından sonraki işlem onları yeniden kullanır:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

var credentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "svc_reports",
    NetworkPassword = "your_password"
};

string uri = "https://app.example.com/account/invoices/1042";
renderer.ApplyCookies(uri, credentials);

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

var credentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "svc_reports",
    NetworkPassword = "your_password"
};

string uri = "https://app.example.com/account/invoices/1042";
renderer.ApplyCookies(uri, credentials);

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global

Dim credentials As New ChromeHttpLoginCredentials With {
    .NetworkUsername = "svc_reports",
    .NetworkPassword = "your_password"
}

Dim uri As String = "https://app.example.com/account/invoices/1042"
renderer.ApplyCookies(uri, credentials)

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf")

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global

Dim credentials As New ChromeHttpLoginCredentials With {
    .NetworkUsername = "svc_reports",
    .NetworkPassword = "your_password"
}

Dim uri As String = "https://app.example.com/account/invoices/1042"
renderer.ApplyCookies(uri, credentials)

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf")

Token tabanlı ve üçüncü taraf kimlik doğrulaması

Modern uygulamalar basit HTTP kimlik bilgilerine nadiren dayanır. Kimlik doğrulamalarını JWT'ler, OAuth veya SAML ile yaparlar, genellikle sonucu bir çerezde saklarlar. CustomCookies herhangi bir anahtar-değer çiftini aldığı için, bir taşıyıcı jeton veya kimlik sağlayıcı çerezi doğrudan yerleştirilir:

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "auth_token", jwt },
    { "refresh_token", refreshToken }
};

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "auth_token", jwt },
    { "refresh_token", refreshToken }
};

Imports System.Collections.Generic

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"auth_token", jwt},
    {"refresh_token", refreshToken}
}

Imports System.Collections.Generic

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"auth_token", jwt},
    {"refresh_token", refreshToken}
}

Kişiselleştirilmiş ve yerelleştirilmiş belgeler

Çerezler genellikle yer, para birimi veya özellik bayrağı durumunu taşır. Onları iletin, PDF bu belirli kullanıcının gördüğü doğru dil ve para birimiyle eşleşir:

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "locale", "en-AU" },
    { "currency", "AUD" },
    { "feature_newLayout", "on" }
};

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "locale", "en-AU" },
    { "currency", "AUD" },
    { "feature_newLayout", "on" }
};

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"locale", "en-AU"},
    {"currency", "AUD"},
    {"feature_newLayout", "on"}
}

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"locale", "en-AU"},
    {"currency", "AUD"},
    {"feature_newLayout", "on"}
}

Bir oturumu paylaşan toplu oluşturma

Aynı kimliği doğrulanmış kullanıcı için sırayla birçok PDF üretmek için, RequestContext'yi Global olarak ayarlayın. Tarayıcı durumu, çerezler dahil, işlemler arasında kalır, yani her belge için değil, yalnızca bir kez kimlik doğrulaması yaparsınız:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

foreach (var id in invoiceIds)
{
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}")
            .SaveAs($"invoice-{id}.pdf");
}

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

foreach (var id in invoiceIds)
{
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}")
            .SaveAs($"invoice-{id}.pdf");
}

Imports IronPdf.Rendering

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

For Each id In invoiceIds
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}").SaveAs($"invoice-{id}.pdf")
Next

Imports IronPdf.Rendering

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

For Each id In invoiceIds
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}").SaveAs($"invoice-{id}.pdf")
Next

Çerez sızıntısı olmadan eşzamanlı oluşturma

Ters senaryo da aynı ağırlığı taşır. Birçok farklı kullanıcı için aynı anda hizmet sunumu yapan bir servis, her rendere temiz bir durum veren ve bir kullanıcının oturumunun başka bir kullanıcının belgesine sızmasını önleyen Isolated bağlamına ihtiyaç duyar. Her iş parçacığına kendi oluşturucusunu verin:

using System.Threading.Tasks;

Parallel.ForEach(jobs, job =>
{
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Isolated;
    renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
    {
        { "ASP.NET_SessionId", job.SessionId }
    };

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath);
});

using System.Threading.Tasks;

Parallel.ForEach(jobs, job =>
{
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Isolated;
    renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
    {
        { "ASP.NET_SessionId", job.SessionId }
    };

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath);
});

Imports System.Threading.Tasks
Imports IronPdf.Rendering

Parallel.ForEach(jobs, Sub(job)
    Dim renderer = New ChromePdfRenderer()
    renderer.RenderingOptions.RequestContext = RequestContexts.Isolated
    renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
        {"ASP.NET_SessionId", job.SessionId}
    }

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath)
End Sub)

Imports System.Threading.Tasks
Imports IronPdf.Rendering

Parallel.ForEach(jobs, Sub(job)
    Dim renderer = New ChromePdfRenderer()
    renderer.RenderingOptions.RequestContext = RequestContexts.Isolated
    renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
        {"ASP.NET_SessionId", job.SessionId}
    }

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath)
End Sub)

Yöntemi işe eşlemek

Temel HTTP kimlik doğrulaması, Windows kimlik doğrulaması ve basit oturumlar için standart çerezleri (ApplyCookies) kullanın. Jetonlar, çok parametreli oturumlar, üçüncü taraf sağlayıcılar ve saklanan tercihler ile CustomCookies kullanın. Durumu renderlar arasında paylaşmak için Global ve onları ayrı tutmak için Isolated seçin; Auto varsayılan olarak izole edilmiş olarak başlar ve ApplyCookies çağrıldığında global hale geçer.

Çoğu hata, süresi dolmuş tokenler, eşleşmeyen çerez alanları, HTTPS URL'lerinde güvenli çerez işlemleri ve kökenler arası isteklerde SameSite politikaları etrafında kümelenir. Çerez geçerliliğini doğrulayın ve oturumların kalıcı olması gerektiğinde Global'e dayanın.

Çerezlerin tüm işi olduğu zamanlar

Çerezler PDF oluşturma işleminde bir uç durum değildir. Onları doğru şekilde alırsanız, kullanılabilir bir belge gönderirsiniz; Yanlış yaparsanız, bir oturum açma formunun ekran görüntüsünü gönderirsiniz.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...

Daha Fazla Oku