應用IronPDF for Python授權金鑰

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

部署生成或操作PDF的Python應用程式需要有效的IronPDF授權金鑰。 若沒有授權,每個輸出文件都會帶有IronPDF浮水印,並且程式庫以試用模式運行。 應用您的金鑰需要少於五行程式碼,並且必須在任何PDF操作執行之前進行。

快速入門:在Python中應用IronPDF授權金鑰

三步驟應用IronPDF授權金鑰:

  1. 通過pip安裝IronPDF:

    pip install ironpdf
  2. 在您腳本頂部設置LicenseKey屬性,在任何PDF操作之前:

    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    PYTHON
  3. 驗證授權金鑰是否被接受:

    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

在開發期間無需重新啟動或重新發布。 對於生產部署,在新增金鑰後必須清理和重新發布。

如何安裝IronPDF for Python?

在應用授權金鑰之前,IronPDF必須存在於Python環境中。 使用pip安裝它:

pip install ironpdf

請注意IronPDF for Python是基於IronPDF .NET程式庫構建的,需要在主機上安裝.NET 6.0 SDK。在運行pip install之前從Microsoft下載它。

一旦ironpdf套件可以在活動環境中的任何腳本中匯入。 除了.NET運行時的依賴性之外,無需額外的配置。

如何在Python中應用IronPDF授權金鑰?

在腳本的最開始,將License類上——在調用任何IronPDF API之前。 將金鑰分配放在PDF操作之後對這些調用沒有影響。

: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

提示每個腳本入口點的第一個IronPDF操作之前,必須分配授權金鑰。 如果您的專案具有多個入口點,例如網路處理程式和背景工作程式,對每個入口點新增分配。

如果您想在購買之前評估完整的功能集,可以獲取免費為期30天的試用金鑰。 試用金鑰遵循相同的分配語法。 要獲取完整授權,請存取IronPDF Python授權頁面

如何驗證和確認IronPDF授權金鑰?

IsValidLicense()檢查特定金鑰字串結構是否有效並被IronPDF的授權伺服器識別。

檢查運行時是否已授權

True。 當在試用模式下運行時返回False(沒有金鑰,金鑰過期,或應用金鑰在PDF操作已經運行後)。

: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

在應用啟動邏輯或健康檢查中使用IsLicensed以確認運行時狀態。

驗證特定金鑰字串

False。 這在從配置文件或環境變數接受授權金鑰時非常有用。

: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

重要關鍵差異:IsLicensed反映當前運行時狀態,不論使用了哪個金鑰。 而IsValidLicense()評估特定金鑰字串。 在應用金鑰之前,用IsValidLicense()驗證來自外部來源的輸入。

在部署的應用中應用授權後會發生什麼?

對於開發和本地測試,授權金鑰立即在正在運行的過程中生效。 無需重建或重新發布。 對於生產部署和在線應用,推薦的做法是在更新授權金鑰之後清理和重新發布應用,以防止過時的環境狀態引起意外行為。

將授權金鑰儲存在環境變數或秘密管理器中,而不是在源程式碼中硬編碼。 在應用啟動時讀取金鑰並在第一次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

這種模式將敏感憑證排除在版本控制之外,並在開發、測試和生產環境中運行,而無需更改程式碼。

請注意IronPDF在運行試用模式時,會在每個PDF頁面上生成浮水印。 要從所有輸出中移除浮水印,必須在任何渲染或操作操作之前應用有效的授權金鑰。

下一步是什麼?

應用有效的授權金鑰後,IronPDF for Python已準備好全面進行生產使用。 考慮使用下列資源繼續下一步:

常見問題

我應該在Python腳本的哪裡放置IronPDF授權金鑰指派?

在腳本的最頂端使用License.LicenseKey = 'YOUR-KEY'指派金鑰,在任何其他IronPDF调用之間。授權金鑰指派在PDF操作已運行後不會去除該操作的水印。

IronPDF for Python中的IsLicensed和IsValidLicense()有什麼區別?

License.IsLicensed是一個布林屬性,反映當前運行時會話中是否激活有效的金鑰。License.IsValidLicense(key)是方法,用於檢查特定金鑰字串是否有效和已被識別—-有助於驗證從環境變數或配置文件中讀取的金鑰然後再應用。

我如何獲得IronPDF for Python的免費試用授權金鑰?

存取IronPDF試用授權頁面並註冊免費30天試用金鑰。像完整授權金鑰一樣應用它,使用License.LicenseKey = 'YOUR-TRIAL-KEY'

IronPDF for Python需要安裝.NET SDK嗎?

是的。IronPDF for Python是基於IronPDF .NET程式庫構建的,需要在主機上安裝.NET 6.0 SDK。在運行pip install ironpdf之前,從Microsoft .NET下載頁面下載它。

如果我在沒有授權金鑰的情況下使用IronPDF會發生什麼?

沒有有效的授權金鑰,IronPDF以試用模式運行,並在每個生成或處理的PDF文件的每一頁都加上水印。要消除水印,請在第一次PDF操作之前應用有效的完整或試用授權金鑰。

我應該如何在生產應用中安全地儲存IronPDF授權金鑰?

將授權金鑰儲存在環境變數中,例如IRONPDF_LICENSE_KEY,並在應用啟動時使用os.environ.get讀取它。在任何PDF操作運行之前將其指派給License.LicenseKey。這樣可以避免將金鑰放在源程式碼控制中。

在應用新授權金鑰後,我需要重新啟動或重新發布應用程式嗎?

在開發期間,金鑰立即生效於當前運行進程。對於生產部署,更新授權金鑰後請清理並重新發布應用程式,以防止過時的環境狀態。

我可以應用一次IronPDF授權金鑰並跨多個腳本重用它嗎?

License.LicenseKey指派僅對當前進程有效。每個腳本或進程入口點必須在調用IronPDF API之前指派金鑰。如果您專案有多個入口點,請將指派加到每個入口點。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

準備開始了嗎?
版本: 2026.6 剛剛發布
Still Scrolling Icon

還在滾動嗎?

希望快速證明嗎?
運行範例 看您的HTML轉化成PDF。