Node.jsでライセンスキーを適用する方法

IronPDFの関数を呼び出す前に、グローバル構成オブジェクトのlicenseKeyプロパティを設定してください。 この初期化処理をアプリケーションのエントリポイント（通常は index.js または app.js ファイルの最初の数行）に配置してください。これにより、その後のすべての PDF 操作においてキーが有効になります。

//:path=apply-license-key.js
// Import IronPdfGlobalConfig from the IronPDF package
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Apply your license key at application startup
// Replace the placeholder with the key you received from Iron Software
IronPdfGlobalConfig.getConfig().licenseKey = "YOUR-LICENSE-KEY-HERE";

//:path=apply-license-key.js
// Import IronPdfGlobalConfig from the IronPDF package
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Apply your license key at application startup
// Replace the placeholder with the key you received from Iron Software
IronPdfGlobalConfig.getConfig().licenseKey = "YOUR-LICENSE-KEY-HERE";

割り当ては即座に効果を発揮します—再起動や再インポートは必要ありません。 この行の後に実行される任意のPDF操作は、ライセンス済みエンジンを使用します。

ライセンスキーのベストプラクティスをどのように追求しますか？

ライセンスキーをソースコードに直接ハードコードすることは、特に公開リポジトリ内でのセキュリティリスクを生じます。 推奨されるアプローチは、キーを環境変数に保存し、実行時に読み取ることです。

//:path=apply-license-key-env.js
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Read the license key from an environment variable
// Set IRONPDF_LICENSE_KEY in your .env file or deployment environment
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

//:path=apply-license-key-env.js
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Read the license key from an environment variable
// Set IRONPDF_LICENSE_KEY in your .env file or deployment environment
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

このパターンを使用する際は、ローカル開発用に IRONPDF_LICENSE_KEY=your-key を .env ファイルに追加し、本番環境ではホスティングプラットフォームのシークレット管理システムで変数を設定してください。 誤ってコミットしてしまうのを防ぐため、.env から .gitignore を追加してください。

運用リスクを軽減するための追加の2つのプラクティス:

• スタートアップ時に一度キーを適用します。各リクエストで繰り返し割り当てるのは無害ですが、サイクルが無駄になります。 アプリのエントリーモジュールで初期化します。
• キーをクライアントサイドのバンドルから外しておきます。 ライセンスキーの初期化はサーバーで行う必要があります。 IronPDF for Node.jsはサーバーサイド環境で動作するため、ここが自然な配置場所となりますが、ビルドパイプラインがIronPdfGlobalConfigをブラウザ向けコードにバンドルしていないか、必ず再確認してください。

ライセンスキーが機能していることをどのように確認しますか？

キーを適用した後、本番ワークフローを実行する前に受け入れられたことを確認します。 グローバル設定オブジェクトで isLicensed フラグを使用してください。

//:path=verify-license-key.js
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Apply the license key
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

// Verify the key was accepted
const config = IronPdfGlobalConfig.getConfig();
if (config.isLicensed) {
    console.log("IronPDF: license key accepted — production mode active.");
} else {
    console.warn("IronPDF: running in trial mode — PDFs will contain a watermark.");
}

//:path=verify-license-key.js
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

// Apply the license key
IronPdfGlobalConfig.getConfig().licenseKey = process.env.IRONPDF_LICENSE_KEY;

// Verify the key was accepted
const config = IronPdfGlobalConfig.getConfig();
if (config.isLicensed) {
    console.log("IronPDF: license key accepted — production mode active.");
} else {
    console.warn("IronPDF: running in trial mode — PDFs will contain a watermark.");
}

trueという結果が表示された場合、キーが有効であり、エンジンがライセンスモードで実行されていることが確認されます。 false という結果は、キーが認識されなかったことを意味します。余分な空白、文字の切り捨て、または試用キーの有効期限切れがないか、再度確認してください。 問題が続く場合は、IronPDFサポートにキーとNode.jsバージョンを知らせてください。

次のステップは何ですか?

有効なライセンスキーがある場合、IronPDFエンジンは実稼働ワークロードの準備が整っています。 最も一般的なタスクから始めましょう:

• HTMLからPDFを生成する — HTML文字列、ファイル、またはURLをピクセル精度のPDFドキュメントに変換します。
• 既存のPDFをマージ、分割、および操作する — 複数のファイルを組み合わせたり、特定のページ範囲を抽出したりします。
• ヘッダー、フッター、およびウォーターマークを追加する — 一貫したページ要素で出力にブランドを付けます。
• フルIronPDF for Node.jsのドキュメントを参照し、APIリファレンス、チュートリアル、コード例を探ってください。

ライセンスティアをアップグレードしたり、開発者シートを追加したりするには、IronPDFライセンスページを訪問するか、無料トライアルを開始して、購入前に上位ティアを評価してください。