Déployer une application Python qui génère ou manipule des PDFs nécessite une clé de licence valide d'IronPDF. Sans celle-ci, chaque document de sortie comporte un filigrane IronPDF et la bibliothèque fonctionne en mode d'essai. Appliquer votre clé prend moins de cinq lignes de code et doit être fait avant que toute opération PDF ne s'exécute.

Démarrage rapide : Application d'une clé de licence IronPDF en Python

Appliquez une clé de licence IronPDF en trois étapes :

  1. Installez IronPDF via pip :

    //:path=install.sh
    :ProductInstall
    //:path=install.sh
    :ProductInstall
    SHELL
  2. Définissez l'attribut LicenseKey en haut de votre script, avant toute opération sur le PDF :

    //:path=apply_license.py
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    //:path=apply_license.py
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    PYTHON
  3. Vérifiez que la clé a été acceptée :

    //:path=verify_license.py
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    //:path=verify_license.py
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    PYTHON

Aucun redémarrage ou republiage n'est requis lors du développement. Pour les déploiements en production, nettoyez et republiez après avoir ajouté la clé.

Comment installer IronPDF en Python ?

Avant d'appliquer une clé de licence, IronPDF doit être présent dans l'environnement Python. Installez-le à l'aide de pip :

//:path=install.sh
:ProductInstall
//:path=install.sh
:ProductInstall
SHELL

Veuillez noterIronPDF for Python s'appuie sur la bibliothèque IronPDF .NET et nécessite l'installation du SDK .NET 6.0 sur la machine hôte. Téléchargez-le depuis le site de Microsoft avant d'exécuter pip install.

Une fois pip terminé, le package ironpdf est disponible pour être importé dans n'importe quel script au sein de l'environnement actif. Aucune configuration supplémentaire n'est nécessaire au-delà de la dépendance runtime .NET.

Comment appliquez-vous une clé de licence IronPDF en Python ?

Définissez l'attribut LicenseKey sur la classe License au tout début de votre script — avant d'appeler toute API IronPDF. Placer l'attribution après les opérations PDF n'aura aucun effet sur ces appels.

//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
PYTHON

ConseilsLa clé de licence doit être attribuée avant la première opération IronPDF dans chaque point d'entrée du script. Si votre projet a plusieurs points d'entrée — telle qu'un gestionnaire web et un travailleur en arrière-plan — ajoutez l'attribution à chacun d'eux.

Une clé d'essai gratuite de 30 jours est disponible si vous souhaitez évaluer l'ensemble des fonctionnalités avant d'acheter. Les clés d'essai suivent la même syntaxe d'attribution. Pour acquérir une licence complète, visitez la page de licence IronPDF Python.

Comment vérifiez-vous et validez-vous une clé de licence IronPDF?

Deux membres de la classe License ont des fonctions de vérification différentes : IsLicensed vérifie si une clé valide est actuellement active dans l'environnement d'exécution, tandis que IsValidLicense() vérifie si une chaîne de clé spécifique est structurellement valide et reconnue par le serveur de licences d'IronPDF.

Vérification de si le runtime est licencié

License.IsLicensed est un attribut booléen qui renvoie True lorsqu'une clé de licence valide a été appliquée dans la session d'exécution en cours. Elle renvoie False lorsqu'elle fonctionne en mode d'essai (pas de clé, clé expirée ou clé appliquée après l'exécution d'opérations PDF).

//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")
//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")
PYTHON

Utilisez IsLicensed dans la logique de démarrage de l'application ou les vérifications de l'état de santé pour confirmer l'état d'exécution.

Validation d'une chaîne de clé spécifique

License.IsValidLicense(key) accepte une chaîne de caractères de clé et renvoie True si cette clé spécifique est valide et activée, ou False si elle est mal formée, expirée ou non reconnue. Ceci est utile lors de l'acceptation de clés de licence à partir de fichiers de configuration ou de variables d'environnement.

//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")
//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")
PYTHON

ImportantLa différence principale : IsLicensed reflète l'état d'exécution actuel, quelle que soit la clé appliquée. IsValidLicense() évalue une chaîne de caractères spécifique. Utilisez IsValidLicense() pour valider les données provenant de sources externes avant d'appliquer la clé.

Que se passe-t-il après avoir appliqué une licence dans une application déployée ?

Pour le développement et les tests locaux, la clé de licence prend effet immédiatement dans le processus en cours. Aucune reconstruction ou republiage n'est nécessaire. Pour les déploiements en production et les applications en direct, la pratique recommandée est de nettoyer et republier l'application après la mise à jour de la clé de licence pour éviter que l'état de l'environnement obsolète ne cause un comportement inattendu.

Stockez la clé de licence dans une variable d'environnement ou un gestionnaire de secrets plutôt que de la coder en dur dans le code source. Lisez la clé au démarrage de l'application et attribuez-la avant la première opération PDF :

//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")
//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")
PYTHON

Ce modèle garde les informations d'identification sensibles hors du contrôle de version et fonctionne sur les environnements de développement, de staging et de production sans modifications de code.

Veuillez noterIronPDF génère un filigrane sur chaque page PDF lorsqu'il fonctionne en mode d'essai. Pour supprimer le filigrane de toutes les sorties, une clé de licence valide doit être appliquée avant toute opération de rendu ou de manipulation.

Quelles sont les prochaines étapes?

Avec une clé de licence valide appliquée, IronPDF for Python est prêt pour une utilisation complète en production. Considérez ces ressources pour aller de l'avant :

Questions Fréquemment Posées

Où dois-je placer l'affectation de la clé de licence IronPDF dans un script Python ?

Attribuez la clé en utilisant License.LicenseKey = 'VOTRE-CLÉ' au tout début de votre script, avant tout autre appel IronPDF. Appliquer la clé après l'exécution d'une opération PDF ne supprimera pas le filigrane de cette opération.

Quelle est la différence entre IsLicensed et IsValidLicense() dans IronPDF for Python ?

License.IsLicensed est un attribut booléen qui indique si une clé valide est active dans la session d'exécution actuelle. License.IsValidLicense(key) est une méthode qui vérifie si une chaîne de clé spécifique est valide et reconnue — utile pour valider les clés lues à partir de variables d'environnement ou de fichiers de configuration avant qu'elles ne soient appliquées.

Comment puis-je obtenir une clé de licence d'essai gratuite pour IronPDF en Python ?

Visitez la page de la licence d'essai IronPDF et inscrivez-vous pour obtenir une clé d'essai gratuite de 30 jours. Appliquez-la de la même manière qu'une clé de licence complète en utilisant License.LicenseKey = 'VOTRE-CLÉ-D'ESSAI'.

IronPDF for Python nécessite-t-il l'installation du SDK .NET ?

Oui. IronPDF for Python est basé sur la bibliothèque IronPDF .NET et requiert l'installation du SDK .NET 6.0 sur la machine hôte. Téléchargez-le depuis la page de téléchargement .NET de Microsoft avant d'exécuter pip install ironpdf.

Que se passe-t-il si j'utilise IronPDF sans clé de licence ?

Sans une clé de licence valide, IronPDF fonctionne en mode essai et applique un filigrane sur chaque page de chaque document PDF généré ou traité. Pour supprimer le filigrane, appliquez une clé de licence complète ou d'essai valide avant la première opération PDF.

Comment dois-je stocker une clé de licence IronPDF de manière sécurisée dans une application de production ?

Stockez la clé de licence dans une variable d'environnement telle que IRONPDF_LICENSE_KEY et lisez-la au démarrage de l'application en utilisant os.environ.get. Assignez-la à License.LicenseKey avant toute opération PDF. Cela permet de garder la clé hors du contrôle de version.

Dois-je redémarrer ou republier l'application après l'application d'une nouvelle clé de licence ?

Pendant le développement, la clé prend effet immédiatement dans le processus en cours d'exécution. Pour les déploiements en production, nettoyez et republiez l'application après la mise à jour de la clé de licence pour éviter un état d'environnement obsolète.

Puis-je appliquer une clé de licence IronPDF une fois et la réutiliser dans plusieurs scripts ?

L'affectation License.LicenseKey s'applique uniquement au processus en cours. Chaque script ou point d'entrée de processus doit assigner la clé avant d'appeler les API IronPDF. Si votre projet a plusieurs points d'entrée, ajoutez l'affectation à chacun d'eux.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Version : 2026.5 just released
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ?
exécuter un échantillon Regardez votre code HTML se transformer en PDF.