Jak korzystać z cookies z IronPDF w C

Czym jest właściwość RequestContext?

Przed zastosowaniem plików cookie należy ustawić właściwość RequestContext na RequestContexts.Global. 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 działa z nagłówkami żądań 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 powinienem wybrać?

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

• Isolated: 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 renderowań. Zachowuje stan przeglądarki między renderowaniami. Idealne do zachowania danych sesji podczas operacji na plikach PDF.
• Auto: Domyślnie 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 wybierz odpowiedni RequestContext, aby zachować prawidłowy stan sesji między renderowaniem po stronie serwera.

Czym są niestandardowe pliki cookie w IronPDF?

CustomCookies wymaga 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 (metodą ApplyCookies) są odpowiednie:

• Podstawowe uwierzytelnianie HTTP
• Środowiska 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 obejmują brak zachowania plików cookie między renderowaniami przy użyciu kontekstu Isolated, błędy uwierzytelniania spowodowane nieprawidłowymi wartościami plików cookie oraz problemy z czasem, w których pliki cookie wygasają przed wygenerowaniem pliku PDF. Sprawdź ważność plików cookie i weź pod uwagę kontekst Global w przypadku sesji trwałych.

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.