Jak korzystać z cookies z IronPDF w C

Czym jest właściwość RequestContext?

Ustaw właściwość RequestContext na RequestContexts.Global przed zastosowaniem cookies. Utwórz klasę ChromeHttpLoginCredentials i przekaż ją do metody ApplyCookies. Następnie renderer renderuje zawartość HTML do formatu PDF z wykorzystaniem plików cookie.

Właściwość RequestContext współpracuje z nagłówkami żądania HTTP i uwierzytelnianiem. Decyduje to o udostępnianiu plików cookie między sesjami renderowania, co ma kluczowe znaczenie dla aplikacji utrzymujących stan sesji podczas generowania wielu plików PDF.

Jak korzystać z metody ApplyCookies?

Zastosuj pliki cookie przy użyciu IronPDF:

: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)

To podejście sprawdza się podczas konwersji stron ASPX do formatu PDF wymagających uwierzytelnienia lub w przypadku aplikacji ASP.NET MVC.

Który RequestContext wybrać?

RequestContexts Enum definiuje konteksty żądań przeglądarki, ustanawiając relacje pomiędzy renderami. Zarządza plikami cookie i preferencjami użytkownika.

• Izolowane: Tworzy nowe, izolowane konteksty żądań. Zapobiega wpływowi poprzednich renderowań na bieżące renderowania. Idealny do wielowątkowego generowania plików PDF.
• Global: Wykorzystuje wspólny globalny kontekst żądania dla wszystkich renderów. Zachowuje stan przeglądarki między renderowaniami. Idealne do zachowania danych sesji podczas operacji na plikach PDF.
• Auto: Domyślnie ustawiony na IronPdf.Rendering.RequestContexts.Isolated. Przełącza się na IronPdf.Rendering.RequestContexts.Global, jeśli wywołano IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials).

Podczas wdrażania plików cookie w aplikacjach Blazor Server należy wybrać odpowiedni RequestContext, aby zachować prawidłowy stan sesji między renderowaniem po stronie serwera.

Czym są niestandardowe pliki cookie w IronPDF?

Pliki cookie niestandardowe wymagają ustawienia właściwości CustomCookies. Ta właściwość akceptuje słowniki par klucz-wartość typu string. Niestandardowe pliki cookie obsługują złożone systemy uwierzytelniania lub przekazują dane na poziomie aplikacji podczas renderowania.

Pliki cookie niestandardowe różnią się od standardowych plików cookie HTTP tym, że umożliwiają definiowanie dowolnych par klucz-wartość. Ta elastyczność pasuje do nowoczesnych aplikacji internetowych wykorzystujących tokeny JWT, identyfikatory sesji lub niestandardowe mechanizmy uwierzytelniania.

Jak wdrożyć niestandardowe pliki cookie?

Stosowanie niestandardowych plików cookie za pomocą IronPDF:

: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)

Takie podejście sprawdza się w przypadku stron intensywnie wykorzystujących JavaScript, które opierają się na plikach cookie do zarządzania stanem lub wdrażają niestandardowe rozwiązania do logowania.

Kiedy należy używać niestandardowych plików cookie, a kiedy standardowych?

Niestandardowe pliki cookie obsługują określone dane sesji lub tokeny uwierzytelniające, które nie są zarządzane przez standardowe poświadczenia HTTP. Można ich używać z niestandardowymi systemami uwierzytelniania lub w celu zachowania preferencji użytkownika podczas generowania plików PDF.

Standardowe pliki cookie (za pomocą metody ApplyCookies) są odpowiednie:

• Podstawowe uwierzytelnianie HTTP
• Srodowiska uwierzytelniania systemu Windows
• Proste zarządzanie sesjami

Pliki cookie niestandardowe sprawdzają się w następujących sytuacjach:

• Uwierzytelnianie oparte na tokenach JWT
• Złożone zarządzanie sesjami z wieloma parametrami
• Zewnętrzni dostawcy uwierzytelniania (OAuth, SAML)
• Zarządzanie preferencjami i ustawieniami użytkownika
• Wymagania dotyczące analityki i śledzenia

Jakie są typowe problemy związane z wdrażaniem plików cookie?

Typowe problemy to cookies nie utrzymujące się pomiędzy renderami przy użyciu kontekstu Isolated, niepowodzenia uwierzytelnienia z powodu niepoprawnych wartości cookies oraz problemy z czasem, gdy cookies wygasają przed generowaniem PDF. Zweryfikuj ważność cookies i rozważ kontekst Global dla trwałych sesji.

Wskazówki dotyczące rozwiązywania problemów:

1. Wygasanie plików cookie: Sprawdź, czy pliki cookie nie wygasły. Zaimplementuj logikę odświeżania dla tokenów o krótkim okresie ważności.
2. Ograniczenia domen: Upewnij się, że domeny plików cookie są zgodne z wyświetlanym adresem URL.
3. Bezpieczne pliki cookie: Prawidłowo skonfiguruj bezpieczne pliki cookie podczas renderowania adresów URL HTTPS.
4. Zasady SameSite: Weź pod uwagę zasady dotyczące plików cookie SameSite w przeglądarkach, które mają wpływ na żądania międzydomenowe.

W przypadku zaawansowanych scenariuszy uwierzytelniania i plików cookie zapoznaj się z dokumentacją opcji renderowania, która obejmuje wszystkie dostępne ustawienia dostosowywania generowania plików PDF.