C#'ta IronPDF ile Çerezleri Kullanma

RequestContext Özelliği Nedir?

Çerezleri uygulamadan önce RequestContext özelliğini RequestContexts.Global olarak ayarlayın. ChromeHttpLoginCredentials sınıfını oluşturun ve ApplyCookies yöntemine aktarın. Renderleyici daha sonra HTML içeriğini çerezlerle PDF'e dönüştürür.

RequestContext özelliği, HTTP istek başlıkları ve kimlik doğrulama ile çalışır. Bu, birden fazla PDF oluşturma işlemi arasında oturum durumunu koruyan uygulamalar için çerez paylaşımını belirler.

ApplyCookies Yöntemini Nasıl Kullanırım?

IronPDF kullanarak çerezleri uygulayın:

:path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-cookies.cs

using IronPdf;

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

renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

ChromeHttpLoginCredentials credentials = new ChromeHttpLoginCredentials() {
    NetworkUsername = "testUser",
    NetworkPassword = "testPassword"
};

string uri = "http://localhost:51169/Invoice";

// Apply cookies
renderer.ApplyCookies(uri, credentials);

Imports IronPdf

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global

Dim credentials As New ChromeHttpLoginCredentials() With {
	.NetworkUsername = "testUser",
	.NetworkPassword = "testPassword"
}

Dim uri As String = "http://localhost:51169/Invoice"

' Apply cookies
renderer.ApplyCookies(uri, credentials)

Bu yaklaşım, kimlik doğrulaması gerektiren ASPX sayfalarını PDF'ye dönüştürme veya ASP.NET MVC uygulamalarıyla çalışırken etkilidir.

Hangi RequestContext'yi seçmeliyim?

RequestContexts Enum, render'lar arasında ilişkiler kuran tarayıcı istek bağlamlarını tanımlar. Çerezleri ve kullanıcı tercihlerini yönetir.

• Isolated: Yeni, izole edilmiş istek bağlamları oluşturur. Mevcut renderların önceki renderlar tarafından etkilenmesini önler. Çok iş parçacıklı PDF oluşturma için idealdir.
• Global: Tüm renderlar arasında paylaşılan global istek bağlamını kullanır. Renderlar arasındaki tarayıcı durumlarını kalıcı hale getirir. PDF işlemleri arasında oturum verilerini korumak için mükemmeldir.
• Auto: Varsayılan olarak IronPdf.Rendering.RequestContexts.Isolated. IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) çağrıldıysa IronPdf.Rendering.RequestContexts.Global'ye geçer.

Blazor Server uygulamalarında çerezleri uygularken, sunucu tarafı görüntülemeleri arasında uygun oturum durumunu korumak için uygun RequestContext öğesini seçin.

IronPDF'deki Özel Çerezler Nelerdir?

CustomCookies, CustomCookies özelliğinin ayarlanmasını gerektirir. Bu özellik, string anahtar-değer çiftleri sözlükleri kabul eder. Özel çerezler, render sırasında karmaşık kimlik doğrulama sistemlerini yönetir veya uygulama düzeyinde veri iletir.

Özel çerezler, herhangi bir anahtar-değer çiftine izin vererek standart HTTP çerezlerinden farklıdır. Bu esneklik, JWT tokenları, oturum kimlikleri veya özel kimlik doğrulama mekanizmaları kullanan modern web uygulamalarına uygun hale gelir.

Özel Çerezler Nasıl Uygulanır?

IronPDF kullanarak özel çerezleri uygulayın:

:path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-custom-cookies.cs

using IronPdf;
using System;
using System.Collections.Generic;

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

Dictionary<string, string> customCookies = new Dictionary<string, string>();

// Apply custom cookies
renderer.RenderingOptions.CustomCookies = customCookies;

var uri = new Uri("https://localhost:44362/invoice");
PdfDocument pdf = renderer.RenderUrlAsPdf(uri);

Imports IronPdf
Imports System
Imports System.Collections.Generic

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private customCookies As New Dictionary(Of String, String)()

' Apply custom cookies
renderer.RenderingOptions.CustomCookies = customCookies

Dim uri As New Uri("https://localhost:44362/invoice")
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf(uri)

Bu yaklaşım, durum yönetimi için çerezlere dayanan JavaScript yoğun siteler veya özel günlüğe kaydetme çözümleri uygularken uygundur.

Özel Çerezleri Ne Zaman Kullanmalıyım?

Özel çerezler, standart HTTP kimlik bilgileri tarafından yönetilmeyen belirli oturum verileri veya kimlik doğrulama tokenlarını yönetir. Özel kimlik doğrulama sistemleriyle veya PDF oluşturma sırasında kullanıcı tercihlerini korumak için kullanın.

Standart çerezler (ApplyCookies yöntemi aracılığıyla) uygundur:

• Temel HTTP kimlik doğrulaması
• Windows kimlik doğrulama ortamları
• Basit oturum yönetimi

Özel çerezler ise şunlar için ustadır:

• JWT token tabanlı kimlik doğrulama
• Birden çok parametreye sahip karmaşık oturum yönetimi
• Üçüncü taraf kimlik doğrulama sağlayıcıları (OAuth, SAML)
• Kullanıcı tercihleri ve ayarlarının korunması
• Analitik ve izleme gereksinimleri

Çerez Uygulaması ile İlgili Yaygın Sorunlar Nelerdir?

Sık karşılaşılan sorunlar arasında, Isolated bağlamı kullanıldığında çerezlerin render işlemleri arasında kalıcı olmaması, yanlış çerez değerlerinden kaynaklanan kimlik doğrulama hataları ve PDF oluşturma işleminden önce çerezlerin süresinin dolmasıyla ilgili zamanlama sorunları yer almaktadır. Çerez geçerliliğini doğrulayın ve kalıcı oturumlar için Global bağlamını dikkate alın.

Sorun giderme ipuçları:

1. Çerez Süresi Doldu: Çerezlerin süresinin dolmadığını doğrulayın. Kısa ömürlü tokenlar için yenileme mantığı uygulayın.
2. Alan Sınırlamaları: Çerez alanlarının render edilen URL ile eşleştiğinden emin olun.
3. Güvenli Çerezler: HTTPS URL'leri render edilirken güvenli çerezleri doğru bir şekilde yapılandırın.
4. SameSite Politikaları: Tarayıcı SameSite çerez politikalarını çapraz kaynak isteklerini etkileyebilecek şekilde düşünün.

Gelişmiş kimlik doğrulama ve çerez senaryoları için, mevcut tüm PDF oluşturma özelleştirme ayarlarını kapsayan rendering options documentatione göz atın.