C#でIronPDFとクッキーを使う方法

RequestContextプロパティとは何ですか

クッキーを適用する前に、RequestContextプロパティをRequestContexts.Globalに設定してください。 ChromeHttpLoginCredentialsクラスを作成し、ApplyCookiesメソッドに渡します。 レンダラーは、HTMLコンテンツをCookieを使ってPDFにレンダリングします。

RequestContextプロパティは、HTTPリクエストヘッダと認証で動作します。 複数のPDF世代にわたってセッションの状態を維持するアプリケーションにとって重要な、レンダリングセッション間のCookie共有を決定します。

ApplyCookiesメソッドはどのように使用しますか?

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

このアプローチは、認証を必要とするASPXページからPDFへの変換や、ASP.NETのMVCアプリケーションで機能します。

どのRequestContextを選ぶべきですか?

RequestContexts列挙型は、レンダリング間の関係を確立するブラウザのリクエストコンテキストを定義します。 クッキーとユーザー設定を管理します。

• 分離：分離された新しいリクエストコンテキストを作成します。 現在のレンダリングが以前のレンダリングの影響を受けないようにします。 マルチスレッドPDF生成に最適です。
• グローバル：すべてのレンダー間で共有されたグローバル リクエスト コンテキストを使用します。 レンダリング間でブラウザの状態を保持します。 PDF操作全体でセッションデータを維持するのに最適です。
• 自動：デフォルトはIronPdf.Rendering.RequestContexts.Isolatedです。 IronPdf.ChromePdfRenderer.ApplyCookies(System.String、IronPdf.ChromeHttpLoginCredentials)が呼び出された場合、IronPdf.Rendering.RequestContexts.Globalに切り替えます。

BlazorサーバーアプリケーションにCookieを実装する場合、適切なRequestContextを選択し、サーバー側のレンダリング間で適切なセッション状態を維持してください。

IronPDFのカスタムクッキーとは何ですか?

カスタムクッキーは、CustomCookiesプロパティを設定する必要があります。 このプロパティは、文字列のキーと値のペアの辞書を受け入れます。 カスタムクッキーは、複雑な認証システムを処理したり、レンダリング中にアプリケーションレベルのデータを渡したりします。

カスタムクッキーは、標準的なHTTPクッキーとは異なり、任意のキーと値のペアを定義することができます。 この柔軟性は、JWTトークン、セッションID、またはカスタム認証メカニズムを使用する最新のWebアプリケーションに適しています。

カスタムクッキーを実装するにはどうすればよいですか?

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

このアプローチは、JavaScriptを多用するサイトが状態管理のためにCookieに依存していたり、カスタムロギングソリューションを実装していたりする場合に適しています。

カスタムクッキーと標準クッキーはいつ使い分けるべきですか？ カスタムクッキーは、標準的なHTTP認証情報では管理できない特定のセッションデータや認証トークンを扱います。 カスタム認証システムで使用したり、PDF生成時にユーザー設定を維持するために使用します。 標準的なクッキー（ApplyCookiesメソッド経由）が適しています： - 基本的なHTTP認証 - Windows認証環境 - シンプルなセッション管理 カスタムクッキーエクセル - JWTトークンベース認証 - 複数のパラメータを持つ複雑なセッション管理 - サードパーティ認証プロバイダ（OAuth、SAML） - ユーザー設定とメンテナンス - アナリティクスとトラッキングの要件 ### クッキーの実装に関する一般的な問題は何ですか? よくある問題には、`Isolated`コンテキストを使用したレンダリング間でクッキーが永続化されないこと、不正なクッキー値による認証の失敗、PDF生成前にクッキーの有効期限が切れるタイミングの問題などがあります。 クッキーの有効性を確認し、永続的なセッションのために`Global`コンテキストを考慮してください。 トラブルシューティングのヒント 1.**クッキーの有効期限**：クッキーの有効期限が切れていないか確認してください。 短命トークンのリフレッシュ・ロジックを実装する。 2.**ドメインの制限**: クッキーのドメインがレンダリングされたURLと一致するようにしてください。 3.**セキュア・クッキー**：HTTPS URL をレンダリングするときに、セキュア Cookie を適切に設定してください。 4.**SameSiteポリシー**：クロスオリジンリクエストに影響するブラウザのSameSiteクッキーポリシーを考えてください。 高度な認証やCookieのシナリオについては、[レンダリングオプションのドキュメント](https://ironpdf.com/how-to/rendering-options/)を参照して、利用可能なすべてのPDF生成カスタマイズ設定をカバーしています。