Jak uzyskać klucz licencyjny IronPDF?

Klucz licencyjny jest wydawany, gdy kupujesz licencję komercyjną lub rejestrujesz się na bezpłatny okres próbny. Obie ścieżki przechodzą przez tę samą stronę licencjonowania IronPDF, gdzie dostępne są opcje dla jednego dewelopera, zespołu i redystrybucji bez opłat licencyjnych.

Aby ocenić IronPDF przed decyzją o zakupie, zarejestruj się na bezpłatną 30-dniową licencję próbną. Klucz próbny aktywuje wszystkie funkcje produkcyjne — w tym renderowanie HTML-to-PDF, łączenie PDF, stemplowanie i szyfrowanie — dzięki czemu możesz przetestować całe API względem prawdziwych wymagań.

Jeśli Twoja organizacja potrzebuje cen hurtowych lub umowy dla enterprise, skontaktuj się z zespołem sprzedaży IronPDF w celu uzyskania indywidualnej oferty.

Jak zastosować klucz licencyjny w Node.js?

Ustaw właściwość licenseKey w globalnym obiekcie konfiguracyjnym przed wywołaniem jakiejkolwiek funkcji IronPDF. Umieść tę inicjalizację w punkcie wejścia aplikacji — zazwyczaj są to pierwsze linijki pliku index.js lub app.js — tak, aby klucz był aktywny dla każdej kolejnej operacji na pliku 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";

Przypisanie działa natychmiast — nie jest wymagany restart ani ponowne importowanie. Każda operacja PDF, która działa po tej linii, użyje licencjonowanego silnika.

Jak przestrzegać najlepszych praktyk dotyczących klucza licencyjnego?

Twarde kodowanie klucza licencyjnego bezpośrednio w kodzie źródłowym stwarza ryzyko bezpieczeństwa, szczególnie w publicznych repozytoriach. Zalecanym podejściem jest przechowywanie klucza w zmiennej środowiskowej i odczytywanie go w czasie wykonywania.

//: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;

Korzystając z tego wzorca, dodaj IRONPDF_LICENSE_KEY=your-key do pliku .env na potrzeby lokalnego rozwoju i skonfiguruj zmienną w systemie zarządzania sekretami swojej platformy hostingowej na potrzeby produkcji. Dodaj .env do .gitignore, aby zapobiec przypadkowym zatwierdzeniom.

Dwa dodatkowe praktyki zmniejszają ryzyko operacyjne:

• Zastosuj klucz raz przy starcie. Przypisanie go wielokrotnie do każdego żądania jest nieszkodliwe, ale marnuje cykle. Zainicjuj go w module wejściowym Twojej aplikacji.
• Trzymaj klucz z dala od pakietów po stronie klienta. Inicjalizacja klucza licencyjnego musi mieć miejsce na serwerze. IronPDF for Node.js działa w środowisku po stronie serwera, więc jest to naturalne miejsce — ale upewnij się, że Twój proces kompilacji nie dołącza IronPdfGlobalConfig do kodu przeznaczonego dla przeglądarki.

Jak sprawdzić, czy klucz licencyjny działa?

Po zastosowaniu klucza, potwierdź jego zaakceptowanie, zanim uruchomisz swoje procesy produkcyjne. Użyj flagi isLicensed w globalnym obiekcie konfiguracyjnym.

//: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.");
}

Wynik true potwierdza, że klucz jest ważny, a silnik działa w trybie licencjonowanym. Wynik false oznacza, że klucz nie został rozpoznany — sprawdź dokładnie, czy nie ma dodatkowych spacji, skróceń lub czy klucz próbny nie wygasł. Jeśli problem się utrzymuje, skontaktuj się z pomocą techniczną IronPDF z Twoim kluczem i wersją Node.js.

Jakie są kolejne kroki?

Z ważnym kluczem licencyjnym na miejscu, silnik IronPDF jest gotowy do produkcyjnych obciążeń roboczych. Zacznij od najczęstszych zadań:

• Generuj PDF-y z HTML — konwertuj ciągi HTML, pliki lub URL-e na dokumenty PDF o dokładności pikselowej.
• Łącz, dziel i manipuluj istniejącymi PDF-ami — łącz wiele plików lub wydziel konkretne zakresy stron.
• Dodaj nagłówki, stopki i znaki wodne — markuj swój wyjście spójnymi elementami strony.
• Odkryj pełną dokumentację IronPDF dla Node.js dla odniesienia API, samouczków i przykładów kodu.

Aby uaktualnić swój poziom licencji lub dodać miejsca dla deweloperów, odwiedź stronę licencjonowania IronPDF lub rozpocznij bezpłatny okres próbny, aby ocenić wyższy poziom przed zakupem.