Comment utiliser les cookies avec IronPDF en C#

Qu'est-ce que la propriété RequestContext?

Définissez la propriété RequestContext sur RequestContexts.Global avant d'appliquer les cookies. Créez la classe ChromeHttpLoginCredentials et passez-la à la méthode ApplyCookies. Le moteur de rendu rend ensuite le contenu HTML au format PDF à l'aide de cookies.

La propriété RequestContext fonctionne avec les en-têtes de requête HTTP et l'authentification. Elle détermine le partage des cookies entre les sessions de rendu, ce qui est essentiel pour les applications qui conservent l'état de la session sur plusieurs générations de PDF.

Comment utiliser la méthode ApplyCookies?

<TODO : Ajouter une image ici -->

Appliquer les cookies en utilisant 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);

Cette approche fonctionne lors de la conversion de pages ASPX en PDF nécessitant une authentification ou avec des applications .NET MVC.

Quel RequestContext dois-je choisir?

RequestContexts Enum définit les contextes de demande du navigateur établissant des relations entre les rendus. Il gère les cookies et les préférences des utilisateurs.

• Isolé : Crée de nouveaux contextes de demande isolés. Empêche les rendus actuels d'être affectés par les rendus précédents. Idéal pour la génération de PDF multithread.
• Global : Utilise un contexte de requête global partagé entre tous les rendus. Persiste les états du navigateur entre les rendus. Parfait pour conserver les données de session dans les opérations PDF.
• Auto : La valeur par défaut est IronPdf.Rendering.RequestContexts.Isolated. Bascule vers IronPdf.Rendering.RequestContexts.Global si IronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials) a été invoqué.

Lors de la mise en œuvre de cookies dans les applications Serveur IronPDF, choisissez le RequestContext approprié pour maintenir un état de session correct entre les rendus côté serveur.

Qu'est-ce que les cookies personnalisés dans IronPDF?

Les cookies personnalisés nécessitent la définition de la propriété CustomCookies. Cette propriété accepte les dictionnaires de paires clé-valeur de chaînes. Les cookies personnalisés gèrent des systèmes d'authentification complexes ou transmettent des données au niveau de l'application pendant le rendu.

Les cookies personnalisés diffèrent des cookies HTTP standard car ils permettent de définir n'importe quelle paire clé-valeur. Cette flexibilité convient aux applications web modernes utilisant des jetons JWT, des identifiants de session ou des mécanismes d'authentification personnalisés.

Comment implémenter des cookies personnalisés?

Appliquez des cookies personnalisés à l'aide d'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);

Cette approche convient aux sites à forte composante JavaScript s'appuyant sur des cookies pour la gestion des états ou mettant en œuvre des solutions de journalisation personnalisées.

Quand dois-je utiliser des cookies personnalisés ou des cookies standard ?

Les cookies personnalisés gèrent des données de session spécifiques ou des jetons d'authentification qui ne sont pas gérés par les informations d'identification HTTP standard. Utilisez-les avec des systèmes d'authentification personnalisés ou pour conserver les préférences de l'utilisateur lors de la génération de PDF.

Les cookies standard (via la méthode ApplyCookies) conviennent :

• Authentification HTTP de base
• Environnements d'authentification Windows
• Gestion simple des sessions

Cookies personnalisés excel pour :

• Authentification par jeton JWT
• Gestion de session complexe avec plusieurs paramètres
• Fournisseurs d'authentification tiers (OAuth, SAML)
• Gestion des préférences et des paramètres de l'utilisateur
• Exigences en matière d'analyse et de suivi

Quels sont les problèmes courants liés à la mise en œuvre des cookies ?

Les problèmes les plus courants sont les suivants : les cookies ne persistent pas entre les rendus utilisant le contexte Isolated, les échecs d'authentification dus à des valeurs de cookies incorrectes et les problèmes de synchronisation où les cookies expirent avant la génération du PDF. Vérifier la validité des cookies et prendre en compte le contexte Global pour les sessions persistantes.

Conseils de dépannage :

1. <Expiration des cookies : Vérifiez que les cookies n'ont pas expiré. Implémenter une logique de rafraîchissement pour les tokens à courte durée de vie.
2. Restrictions de domaine : Veillez à ce que les domaines des cookies correspondent à l'URL rendue.
3. Cookies sécurisés : Configurer correctement les cookies sécurisés lors du rendu des URL HTTPS.
4. Politiques SameSite : Tenez compte des politiques de cookies SameSite des navigateurs qui affectent les requêtes cross-origin.

Pour les scénarios d'authentification avancée et de cookies, voir la documentation sur les options de rendu couvrant tous les paramètres de personnalisation de la génération de PDF disponibles.