C#でIronPDFとCookieを使ったPDF 変換・レンダリング方法

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

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)

このアプローチは、認証を必要とする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);

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)

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

カスタムクッキーと標準クッキーはいつ使い分けるべきですか？

カスタムクッキーは、標準的なHTTP認証情報では管理できない特定のセッションデータや認証トークンを扱います。 カスタム認証システムで使用したり、PDF生成時にユーザー設定を維持するために使用します。

標準的なクッキー(ApplyCookiesメソッド経由)が適しています：

• 基本的なHTTP認証
• Windows認証環境
• シンプルなセッション管理

カスタムクッキーエクセル

• JWTトークンベース認証
• 複数のパラメータを持つ複雑なセッション管理
• サードパーティ認証プロバイダ(OAuth、SAML)
• ユーザー設定とメンテナンス
• アナリティクスとトラッキングの要件

クッキーの実装に関する一般的な問題は何ですか?

一般的な問題としては、Isolated コンテキストを使用したレンダリング間で Cookie が保持されない、Cookie 値が正しくないために認証が失敗する、PDF 生成前に Cookie が期限切れになるタイミングの問題などがあります。 クッキーの有効性を確認し、永続セッションのコンテキストを考慮します。

トラブルシューティングのヒント

1.クッキーの有効期限：クッキーの有効期限が切れていないか確認してください。 短命トークンのリフレッシュ・ロジックを実装する。 2.ドメインの制限: クッキーのドメインがレンダリングされたURLと一致するようにしてください。 3.セキュア・クッキー：HTTPS URL をレンダリングするときに、セキュア Cookie を適切に設定してください。 4.SameSiteポリシー：クロスオリジンリクエストに影響するブラウザのSameSiteクッキーポリシーを考えてください。

高度な認証やCookieのシナリオについては、レンダリングオプションのドキュメントを参照して、利用可能なすべてのPDF生成カスタマイズ設定をカバーしています。