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 na globalnym obiekcie konfiguracyjnym przed wywołaniem dowolnej funkcji IronPDF. Umieść tę inicjalizację w punkcie wejścia Twojej aplikacji — zazwyczaj pierwsze linie w pliku index.js lub app.js — aby klucz był aktywny dla każdej kolejnej operacji PDF.

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-1.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=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-2.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;

Podczas korzystania z tego wzoru, dodaj IRONPDF_LICENSE_KEY=your-key do pliku .env dla lokalnego rozwoju i skonfiguruj zmienną w systemie zarządzania tajemnicami platformy hostingowej do produkcji. Dodaj .env do .gitignore, aby zapobiec przypadkowemu popełnieniu zmian.

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 dla Node.js działa w kontekście serwera, więc jest to naturalne umiejscowienie - ale upewnij się, że Twój pipeline budowy nie pakuje IronPdfGlobalConfig w kod widoczny 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 na globalnym obiekcie konfiguracyjnym.

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/license-keys-3.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 i silnik działa w trybie licencjonowanym. Wynik false oznacza, że klucz nie został rozpoznany — sprawdź, czy nie ma dodatkowych odstępów, skrócenia lub nieaktualnego klucza próbnego. 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.