Cómo usar Cookies con IronPDF en C

¿Qué es la propiedad RequestContext?

Establece la propiedad RequestContext a RequestContexts.Global antes de aplicar cookies. Crea la clase ChromeHttpLoginCredentials y pásala al método ApplyCookies. A continuación, el renderizador pasa el contenido HTML a PDF con cookies.

La propiedad RequestContext funciona con encabezados de solicitud HTTP y autenticación. Determina el uso compartido de cookies entre sesiones de renderizado, algo fundamental para que las aplicaciones mantengan el estado de la sesión en varias generaciones de PDF.

¿Cómo utilizo el método ApplyCookies?

Solicite cookies mediante 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)

Este enfoque funciona al convertir páginas ASPX a PDF que requieren autenticación o con aplicaciones ASP.NET MVC.

¿Cuál RequestContext debería elegir?

El Enum RequestContexts define contextos de solicitud del navegador que establecen relaciones entre renderizaciones. Gestiona las cookies y las preferencias del usuario.

• Isolated: Crea nuevos contextos de solicitud aislados. Evita que los renders actuales se vean afectados por renders anteriores. Ideal para generación de PDF multihilo.
• Global: Usa el contexto de solicitud global compartido entre todas las renderizaciones. Persiste los estados del navegador entre renders. Perfecto para mantener los datos de sesión a través de operaciones PDF.
• Auto: Por defecto, se establece en IronPdf.Rendering.RequestContexts.Isolated. Cambia a IronPdf.Rendering.RequestContexts.Global si se invocó IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials).

Al implementar cookies en aplicaciones de Blazor Server, elige el RequestContext adecuado para mantener el estado de sesión correcta entre renderizaciones del lado del servidor.

¿Qué son las cookies personalizadas en IronPDF?

CustomCookies requieren establecer la propiedad CustomCookies. Esta propiedad acepta diccionarios de pares clave-valor de cadena. Las cookies personalizadas gestionan sistemas de autenticación complejos o pasan datos a nivel de aplicación durante la renderización.

Las cookies personalizadas se diferencian de las cookies HTTP estándar en que permiten cualquier definición de par clave-valor. Esta flexibilidad se adapta a las aplicaciones web modernas que utilizan tokens JWT, identificadores de sesión o mecanismos de autenticación personalizados.

¿Cómo implementar cookies personalizadas?

Aplique cookies personalizadas mediante 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)

Este enfoque es adecuado para sitios con mucho JavaScript que dependen de las cookies para la gestión del estado o que implementan soluciones de registro personalizadas.

¿Cuándo debo usar cookies personalizadas frente a cookies estándar?

Las cookies personalizadas gestionan datos de sesión específicos o tokens de autenticación no gestionados por las credenciales HTTP estándar. Utilícelas con sistemas de autenticación personalizados o para mantener las preferencias del usuario durante la generación de PDF.

Las cookies estándar (a través del método ApplyCookies) son adecuadas para:

• Autenticación HTTP básica
• Entornos de autenticación de Windows
• Gestión sencilla de sesiones

Las cookies personalizadas sobresalen por:

• Autenticación basada en token JWT
• Gestión de sesiones complejas con múltiples parámetros
• Proveedores de autenticación de terceros (OAuth, SAML)
• Mantenimiento de preferencias y ajustes del usuario
• Requisitos de análisis y seguimiento

¿Cuáles son los problemas comunes con la implementación de cookies?

Problemas comunes incluyen cookies que no persisten entre renderizaciones usando el contexto Isolated, fallos de autenticación por valores de cookies incorrectos y problemas de tiempo donde las cookies expiran antes de la generación del PDF. Verifica la validez de las cookies y considera el contexto Global para sesiones persistentes.

Consejos para la resolución de problemas:

1. Caducidad de cookies: Verifica que las cookies no hayan caducado. Implementar la lógica de actualización para tokens de corta duración.
2. Restricciones de dominio: asegúrese de que los dominios de las cookies coincidan con la URL traducida.
3. Cookies seguras: Configurar correctamente las cookies seguras al renderizar URLs HTTPS.
4. Políticas SameSite: Tenga en cuenta las políticas de cookies SameSite del navegador que afectan a las solicitudes de origen cruzado.

Para la autenticación avanzada y los escenarios de cookies, consulte la documentación de opciones de renderización que cubre todos los ajustes de personalización de generación de PDF disponibles.