如何在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 之间添加 .env 以防止意外提交。

两个附加的做法可减少操作风险：

• 在启动时应用密钥一次。在每个请求上重复分配是无害的，但浪费周期。 在您的应用程序的入口模块中初始化它。
• 保持密钥不在客户端包中。许可证密钥初始化必须在服务器上进行。 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许可证页面或开始免费试用以在购买前评估更高的级别。