IronPDF ile C#'da Çerezler Nasıl Kullanılır

RequestContext Özelliği Nedir?

RequestContext ozelligini tanimlayicilari uygulamadan once RequestContexts.Global olarak ayarlayin. ChromeHttpLoginCredentials sinifini oluşturun ve ApplyCookies metoduna gecirin. Render motoru ardından çerezlerle HTML içeriğini PDF'ye dönüştürür.

RequestContext ozelligi HTTP istegi basliklari ve doğrulama ile calisir. Bu, birden çok PDF jenerasyonu boyunca oturum durumunu koruyan uygulamalar için kritik olan render oturumları arasında çerez paylaşımını belirler.

ApplyCookies Metodunu 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, ASPX sayfalarını PDF'ye dönüştürürken kimlik doğrulaması gerektirdiğinde veya ASP.NET MVC uygulamaları ile çalışır.

Hangi RequestContext'i Seçmeliyim?

RequestContexts Enum, tarayici istek baglamlarini tanimlayarak oluşturmalar arasinda iliskiler kurar. Çerezleri ve kullanıcı tercihlerinin yönetimini sağlar.

• Izole: Yeni, izole istek bağlamları oluşturur. Mevcut renderların önceki renderlardan etkilenmesini önler. Çok iş parçacıklı PDF oluşturma için idealdir.
• Küresel: Tüm renderlar arasında paylaşılan küresel istek bağlamını kullanır. Tarayıcı durumlarını renderlar arasında kalıcı hale getirir. PDF işlemleri boyunca oturum verilerini korumak için mükemmeldir.
• Auto: Varsıyılan olarak IronPdf.Rendering.RequestContexts.Isolated ayarlanir. IronPdf.Rendering.RequestContexts.Global olarak değiştirilir eger IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) cagrildiysa.

Blazor Sunucu uygulamalarında çerez uygularken, sunucu tarafı renderlar arasında doğru oturum durumunu korumak için uygun RequestContext'i seçin.

IronPDF İçinde Özel Çerezler Nelerdir?

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

Özel çerezler, herhangi bir anahtar-değer çiftinin tanımına izin vererek standart HTTP çerezlerinden farklıdır. Bu esneklik, JWT belirteçleri, oturum kimlikleri veya özel kimlik doğrulama mekanizmalarını kullanan modern web uygulamalarına uygundur.

Özel Çerezleri Nasıl Uygularım?

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 güvenen JavaScript ağırlıklı siteler veya özel günlüğe kaydetme çözümleri uygulamaları için uygundur.

Özel Çerezler ile Standart Çerezleri Ne Zaman Kullanmalıyım?

Özel çerezler, standart HTTP kimlik bilgileriyle yönetilmemiş belirli oturum verilerini veya kimlik doğrulama belirteçlerini ele alır. Bunları özel kimlik doğrulama sistemleri ile birlikte veya PDF oluşturma sırasında kullanıcı tercihlerini korumak için kullanın.

Standart çerezler (ApplyCookies metodu ile) aşağıdaki durumlar için uygundur:

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

Özel çerezler şu durumlarda mükemmel performans gösterir:

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

Çerez Uygulamasındaki Yaygın Sorunlar Nelerdir?

Yaygin sorunlar arasinda Isolated baglamini kullanirken oluşturmalar arasinda tanimlayicilarin kalmamasi, yanlis tanimlayici degerlerinden kaynaklanan doğrulama hatalari ve PDF oluşturulmadan once tanimlayicilarin suresi dolmasi zamanlama sorunlari bulunur. Tanimlayicilarin gecerliligini dogrulayin ve kalici oturumlar icin Global baglamini dusunun.

Sorun giderme ipuçları:

1. Çerez Süresi Dolması: Çerezlerin süresinin dolmadığını doğrulayın. Kısa ömürlü belirteçler için yenileme mantığı uygulayın.
2. Etki Alanı Kısıtlamaları: Çerez etki alanlarının render URL'siyle eşleştiğinden emin olun.
3. Güvenli Çerezler: HTTPS URL'lerini renderlerken güvenli çerezleri düzgün bir şekilde yapılandırın.
4. SameSite Politikaları: Çapraz kaynaklı istekleri etkileyen tarayıcı SameSite çerez politikalarını düşünün.

Renderleme seçenekleri belgeleri tüm mevcut PDF oluşturma özelleştirme ayarlarını kapsayan gelişmiş kimlik doğrulama ve çerez senaryoları için bakın.