Une clé de licence IronPDF débloque le déploiement en production pour votre application Node.js. Sans clé valide, IronPDF fonctionne en mode essai et tamponne chaque PDF généré avec un filigrane. L'application d'une clé de licence supprime ce filigrane et lèvera toutes les restrictions de sortie, vous offrant des documents entièrement conformes prêts pour les utilisateurs finaux. Les étapes ci-dessous décrivent comment obtenir une clé, la configurer correctement et confirmer qu'elle est active.
Démarrage rapide : Appliquer une clé de licence IronPDF dans Node.js
Comment obtenir une clé de licence IronPDF ?
Une clé de licence est délivrée lorsque vous achetez une licence commerciale ou que vous vous inscrivez pour un essai gratuit. Les deux chemins passent par la même page de licences IronPDF, où des options sont disponibles pour les développeurs individuels, les équipes et les niveaux de redistribution libre de droits.
Pour évaluer IronPDF avant de vous engager à un achat, inscrivez-vous pour un essai gratuit de 30 jours. La clé d'essai active toutes les fonctionnalités de production — y compris le rendu HTML-vers-PDF, la fusion PDF, le tamponnage et le cryptage — afin que vous puissiez tester l'intégralité de l'API en fonction de vos exigences réelles.
Si votre organisation a besoin d'une tarification de volume ou d'un accord d'entreprise, contactez l'équipe commerciale d'IronPDF pour un devis personnalisé.
Comment appliquer une clé de licence dans Node.js ?
Définissez la propriété licenseKey sur l'objet de configuration global avant d'appeler toute fonction IronPDF. Placez cette initialisation au point d'entrée de votre application — généralement les premières lignes de votre fichier index.js ou app.js — afin que la clé soit active pour chaque opération PDF ultérieure.
//: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";
L'affectation prend effet immédiatement — aucun redémarrage ou réimportation requis. Toute opération PDF qui s'exécute après cette ligne utilisera le moteur sous licence.
Comment suivre les meilleures pratiques pour les clés de licence ?
Coder une clé de licence directement dans le code source crée un risque de sécurité, surtout dans les dépôts publics. L'approche recommandée est de stocker la clé dans une variable d'environnement et de la lire au moment de l'exécution.
//: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;
Lorsque vous utilisez ce modèle, ajoutez IRONPDF_LICENSE_KEY=your-key à un fichier .env pour le développement local et configurez la variable dans le système de gestion des secrets de votre plateforme d'hébergement pour la production. Ajoutez .env à .gitignore pour éviter les commits accidentels.
Deux pratiques supplémentaires réduisent les risques opérationnels :
- Appliquez la clé une seule fois au démarrage. L'assigner à plusieurs reprises à chaque requête est inoffensif mais gaspille des cycles. Initialisez-le dans le module d'entrée de votre application.
- Gardez la clé hors des bundles côté client. L'initialisation des clés de licence doit se faire côté serveur. IronPDF for Node.js s'exécute dans un contexte côté serveur, c'est donc l'emplacement naturel — mais vérifiez bien que votre pipeline de compilation n'intègre pas
IronPdfGlobalConfigdans le code destiné au navigateur.
Comment vérifier que votre clé de licence fonctionne ?
Après avoir appliqué la clé, confirmez qu'elle a été acceptée avant d'exécuter vos flux de travail de production. Utilisez l'indicateur isLicensed sur l'objet de configuration global.
//: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.");
}
Un résultat true confirme que la clé est valide et que le moteur fonctionne en mode sous licence. Un résultat false signifie que la clé n'a pas été reconnue — vérifiez qu'il n'y a pas d'espaces supplémentaires, de troncature ou que la clé d'essai n'a pas expiré. Si le problème persiste, contactez l'assistance d'IronPDF avec votre clé et la version de Node.js.
Quelles sont les prochaines étapes?
Avec une clé de licence valide en place, le moteur IronPDF est prêt pour les charges de travail de production. Commencez par les tâches les plus courantes :
- Générez des PDF à partir de HTML — convertissez des chaînes HTML, des fichiers ou des URL en documents PDF précis au pixel près.
- Fusionnez, divisez et manipulez des PDF existants — combinez plusieurs fichiers ou extrayez des plages de pages spécifiques.
- Ajoutez des en-têtes, pieds de page et filigranes — brandissez votre sortie avec des éléments de page cohérents.
- Explorez la documentation complète IronPDF for Node.js pour la référence API, les tutoriels et les exemples de code.
Pour mettre à niveau votre niveau de licence ou ajouter des sièges de développeur, visitez la page de licence IronPDF ou démarrez un essai gratuit pour évaluer un niveau supérieur avant d'acheter.
Questions Fréquemment Posées
Comment obtenir une clé de licence IronPDF pour un projet Node.js ?
Achetez une licence ou inscrivez-vous pour un essai gratuit de 30 jours sur la page des licences IronPDF. Une clé est envoyée par e-mail lors de l'enregistrement ou de la confirmation d'achat.
Où dans une application Node.js la clé de licence doit-elle être appliquée ?
Appliquez la clé au point d'entrée de l'application — typiquement les premières lignes de index.js ou app.js — afin que la clé soit active avant que toute fonction IronPDF ne soit appelée.
Que se passe-t-il si vous exécutez IronPDF sans clé de licence ?
IronPDF fonctionne en mode d'essai et tamponne chaque PDF généré avec un filigrane. L'application d'une clé de licence valide supprime le filigrane et lève toutes les restrictions de sortie.
Comment appliquez-vous une clé de licence IronPDF dans Node.js ?
Importez IronPdfGlobalConfig du package @ironsoftware/ironpdf et assignez votre clé : IronPdfGlobalConfig.getConfig().licenseKey = 'VOTRE-CLÉ';
Comment éviter de coder en dur la clé de licence dans le code source ?
Stockez la clé dans une variable d'environnement telle que IRONPDF_LICENSE_KEY, puis lisez-la à l'exécution avec process.env.IRONPDF_LICENSE_KEY. Ajoutez la variable au gestionnaire de secrets de votre plateforme d'hébergement pour les déploiements en production.
Comment vérifier qu'une clé de licence IronPDF a été acceptée ?
Lisez IronPdfGlobalConfig.getConfig().isLicensed. Une valeur de retour de true confirme que la clé est valide et que le moteur fonctionne en mode sous licence.
Que devriez-vous vérifier si isLicensed renvoie false ?
Vérifiez que la clé a été copiée sans espace supplémentaire ou troncature, confirmez que l'essai n'a pas expiré, et assurez-vous que la clé est définie avant que toute opération IronPDF ne soit exécutée. Contactez le support d'IronPDF si le problème persiste.
La même clé de licence peut-elle être utilisée sur plusieurs serveurs Node.js ?
Les termes de licence dépendent de votre niveau d'achat. Les licences pour un seul développeur couvrent un développeur ; les licences pour équipe et libre de droits couvrent des scénarios de déploiement plus larges. Consultez la page des licences IronPDF pour le niveau correspondant à vos exigences de déploiement.

