Jak korzystać z cookies z IronPDF w C

Czym jest Właściwość RequestContext?

Ustaw właściwość RequestContext na RequestContexts.Global przed zastosowaniem ciasteczek. Stwó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 żądań HTTP oraz autentykacją. 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 używać 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ć?

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

• Isolated: Tworzy nowe, odizolowane konteksty żądań. Zapobiega wpływowi poprzednich renderowań na bieżące renderowania. Idealny do wielowątkowego generowania plików PDF.
• Global: Używa współdzielonego globalnego kontekstu żądania między wszystkimi renderami. 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 implementacji ciasteczek w aplikacjach Blazor Server, wybierz odpowiedni RequestContext, aby utrzymać prawidłowy stan sesji między serwerowymi renderami.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

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 ciasteczka (za pomocą metody ApplyCookies) są odpowiednie dla:

• 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?

Powszechne problemy obejmują ciasteczka nieprzetrwające między renderami, używając kontekstu Isolated, błędy uwierzytelniania z nieprawidłowych wartości ciasteczek oraz problemy z czasem, kiedy ciasteczka wygasają przed wygenerowaniem PDF. Zweryfikuj poprawność ciasteczek i rozważ kontekst Global dla utrzymujących 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.