IronPDFでログイン保護されたページをPDFとしてレンダリングするにはどうすればいいですか？

RequestContext を Global に設定し、 CustomCookies にユーザーのセッションクッキーを入力してから RenderUrlAsPdf を呼び出します。IronPDFのChromeエンジンはこれらのクッキーで認証し、保護されたページをレンダリングします。

IronPDFにおけるApplyCookiesとCustomCookiesの違いは何ですか？

ApplyCookies はHTTPの認証情報（基本認証またはWindows認証）を使用してサインインし、得られたセッションクッキーをグローバルコンテキストにキャプチャします。 CustomCookies はクッキーのキーと値のペアを直接提供することができます。JWTトークン、OAuthクッキー、および複数パラメータのセッションに便利です。

RequestContextとは何で、GlobalとIsolatedはいつ使うべきですか？

複数のレンダリングが同じ認証セッションを共有するときは Global を使用します（例: 1人のユーザーのために請求書を一括生成する場合）。異なるユーザーのために同時にレンダリングするときは Isolated を使用して、各レンダリングがクリーンなクッキー状態を得るようにし、ユーザー間でセッションが混じり合わないようにします。

IronPDFはJWTとOAuthの認証をPDFレンダリングで処理できますか？

はい。 CustomCookies でトークンの値をキーと値のペア（例: auth_token と refresh_token ）として渡します。IronPDFはそのレンダリングのためにChromeエンジンが行うすべてのリクエストにこれらを添付します。

PDFが空白のページやログイン画面として表示される理由は何ですか？

最も一般的な原因は、有効期限切れのセッションクッキー、不一致のクッキードメイン、HTTPS URLでのセキュアクッキー制限、クロスオリジンリクエストでのSameSiteポリシーブロックがあります。レンダリング前にクッキーが有効で対象ドメインに一致することを確認してください。

C# PDFライブラリ

Explore IronPDF 無料トライアル

HTML から PDF へ

Online Demo すべてのコード例を見る

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >

Install-Package IronPdf

製品比較

PDFsharpに代わるPDFから画像への最良の代替案を探る

Curtis Chau

Updated: 2026年7月5日

ほとんどのHTMLからPDFへのジョブは、同じ理由で失敗します：ユーザーがサインインした後でのみページが正しく表示されます。 IronPDFはChromiumエンジンを駆動しており、未認証のブラウザが見るもの、つまりログイン画面や空のシェルが、正しいクッキーを渡すまでは表示されます。 3つのAPIの部分がこれを解決します。CustomCookies辞書です。ここにそれぞれのフィットする場所と適合するスニペットがあります。

ログインの背後で請求書と声明をレンダリングする

顧客の請求書はセッション保護されたルートにあり、アプリケーションが既にそのセッションを保持しています。そのセッションIDをCustomCookiesを通じて直接渡します:

using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042")
        .SaveAs("invoice-1042.pdf");

using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042")
        .SaveAs("invoice-1042.pdf");

Imports IronPdf
Imports System.Collections.Generic

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042").SaveAs("invoice-1042.pdf")

Imports IronPdf
Imports System.Collections.Generic

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

renderer.RenderUrlAsPdf("https://app.example.com/account/invoices/1042").SaveAs("invoice-1042.pdf")

基本認証またはWindows認証の場合は、代わりにApplyCookiesを利用してください。指定された資格情報でURLにサインインし、生成されたクッキーをグローバルコンテキストにキャプチャし、その後のレンダリングで再利用します。

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

var credentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "svc_reports",
    NetworkPassword = "your_password"
};

string uri = "https://app.example.com/account/invoices/1042";
renderer.ApplyCookies(uri, credentials);

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

var credentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "svc_reports",
    NetworkPassword = "your_password"
};

string uri = "https://app.example.com/account/invoices/1042";
renderer.ApplyCookies(uri, credentials);

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global

Dim credentials As New ChromeHttpLoginCredentials With {
    .NetworkUsername = "svc_reports",
    .NetworkPassword = "your_password"
}

Dim uri As String = "https://app.example.com/account/invoices/1042"
renderer.ApplyCookies(uri, credentials)

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf")

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global

Dim credentials As New ChromeHttpLoginCredentials With {
    .NetworkUsername = "svc_reports",
    .NetworkPassword = "your_password"
}

Dim uri As String = "https://app.example.com/account/invoices/1042"
renderer.ApplyCookies(uri, credentials)

renderer.RenderUrlAsPdf(uri).SaveAs("invoice-1042.pdf")

トークンベースおよびサードパーティ認証

現代のアプリは、単純なHTTP資格情報にほとんど寄りかかりません。 JWT、OAuth、またはSAMLで認証し、結果をクッキーに保存することがよくあります。 CustomCookiesは任意のキーと値のペアを受け入れるので、ベアラートークンやアイデンティティプロバイダのクッキーを直接投入できます:

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "auth_token", jwt },
    { "refresh_token", refreshToken }
};

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "auth_token", jwt },
    { "refresh_token", refreshToken }
};

Imports System.Collections.Generic

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"auth_token", jwt},
    {"refresh_token", refreshToken}
}

Imports System.Collections.Generic

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"auth_token", jwt},
    {"refresh_token", refreshToken}
}

パーソナライズおよびローカライズされたドキュメント

クッキーはしばしばロケール、通貨、または機能フラグの状態を運びます。それらを転送すると、その特定のユーザーが見るものと一致するPDFが正しい言語と通貨で表示されます。

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "locale", "en-AU" },
    { "currency", "AUD" },
    { "feature_newLayout", "on" }
};

renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "locale", "en-AU" },
    { "currency", "AUD" },
    { "feature_newLayout", "on" }
};

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"locale", "en-AU"},
    {"currency", "AUD"},
    {"feature_newLayout", "on"}
}

renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"locale", "en-AU"},
    {"currency", "AUD"},
    {"feature_newLayout", "on"}
}

同一セッションを共有するバッチ生成

同じ認証済みユーザーのために連続して多くのPDFを生成するには、Globalに設定してください。ブラウザの状態（クッキーを含む）はレンダリング間で保持されるので、1回だけ認証するだけで、各ドキュメントごとに認証する必要がありません。

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

foreach (var id in invoiceIds)
{
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}")
            .SaveAs($"invoice-{id}.pdf");
}

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;
renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
{
    { "ASP.NET_SessionId", sessionId }
};

foreach (var id in invoiceIds)
{
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}")
            .SaveAs($"invoice-{id}.pdf");
}

Imports IronPdf.Rendering

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

For Each id In invoiceIds
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}").SaveAs($"invoice-{id}.pdf")
Next

Imports IronPdf.Rendering

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.RequestContext = RequestContexts.Global
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
    {"ASP.NET_SessionId", sessionId}
}

For Each id In invoiceIds
    renderer.RenderUrlAsPdf($"https://app.example.com/invoices/{id}").SaveAs($"invoice-{id}.pdf")
Next

クッキー漏れなしの同時レンダリング

反対のシナリオも同様に重要です。多くの異なるユーザーのために一度にサービスをレンダリングするには、Isolatedコンテキストが必要です。これにより各レンダーにはクリーンな状態が与えられ、あるユーザーのセッションが他のユーザーのドキュメントに漏れるのを防ぎます。各スレッドに独自のレンダラーを与えます。

using System.Threading.Tasks;

Parallel.ForEach(jobs, job =>
{
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Isolated;
    renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
    {
        { "ASP.NET_SessionId", job.SessionId }
    };

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath);
});

using System.Threading.Tasks;

Parallel.ForEach(jobs, job =>
{
    var renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Isolated;
    renderer.RenderingOptions.CustomCookies = new Dictionary<string, string>
    {
        { "ASP.NET_SessionId", job.SessionId }
    };

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath);
});

Imports System.Threading.Tasks
Imports IronPdf.Rendering

Parallel.ForEach(jobs, Sub(job)
    Dim renderer = New ChromePdfRenderer()
    renderer.RenderingOptions.RequestContext = RequestContexts.Isolated
    renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
        {"ASP.NET_SessionId", job.SessionId}
    }

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath)
End Sub)

Imports System.Threading.Tasks
Imports IronPdf.Rendering

Parallel.ForEach(jobs, Sub(job)
    Dim renderer = New ChromePdfRenderer()
    renderer.RenderingOptions.RequestContext = RequestContexts.Isolated
    renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
        {"ASP.NET_SessionId", job.SessionId}
    }

    renderer.RenderUrlAsPdf(job.Url).SaveAs(job.OutputPath)
End Sub)

方法をジョブに一致させる

基本HTTP認証、Windows認証、および単純なセッションには標準クッキー (ApplyCookies) を使用してください。トークン、マルチパラメータセッション、サードパーティプロバイダ、および保存された設定にはCustomCookiesを利用してください。レンダー間で状態を共有するためにIsolatedを選んでください; ApplyCookiesが呼び出されるとグローバルに切り替わります。

ほとんどの失敗は、期限切れのトークン、不一致のクッキードメイン、HTTPS URLでのセキュアクッキーの取り扱い、およびクロスオリジンリクエストでのSameSiteポリシーの周りに集中しています。レンダリングの前にクッキーの有効性を確認し、セッションを持続させる必要がある場合にはGlobalを頼りにしてください。

クッキーが全作業の時

クッキーはPDF生成において例外ではありません。それらが正しければ、使用可能なドキュメントを届けることができ、誤っていたら、ログインフォームのスクリーンショットを届けることになってしまいます。

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...

詳しく読む