Application d'une clé de licence IronPDF for Python

This article was translated from English: Does it need improvement?
Translated
View the article in English

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 :

    pip install ironpdf
  2. Réglez l'attribut LicenseKey au début de votre script, avant toute opération PDF :

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

    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    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 en utilisant pip :

pip install ironpdf

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

Une fois que pip est terminé, le package ironpdf est disponible pour importation dans tout script dans 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=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-2.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 servent à des fins 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 licence d'IronPDF.

Vérification de si le runtime est licencié

License.IsLicensed est un attribut booléen qui retourne True lorsqu'une clé de licence valide a été appliquée dans la session d'exécution en cours. Il retourne False lorsqu'il fonctionne en mode d'essai (pas de clé, clé expirée, ou une clé appliquée après que les opérations PDF ont déjà été exécutées).

:path=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-3.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 d'application ou les contrôles 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 clé et retourne True si cette clé spécifique est valide et activée, ou False si elle est malformé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=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-4.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 clé : IsLicensed reflète l'état d'exécution actuel indépendamment de la clé appliquée. IsValidLicense() évalue une chaîne de clé spécifique. Utilisez IsValidLicense() pour valider l'entrée 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=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-5.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.6 vient de sortir
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.