Como Obter uma Chave de Licença do IronPDF?

Uma chave de licença é emitida quando você compra uma licença comercial ou se inscreve para um teste gratuito. Ambos os caminhos passam pela mesma página de licenciamento IronPDF, onde opções estão disponíveis para desenvolvedor único, equipe e níveis de redistribuição isenta de royalties.

Para avaliar o IronPDF antes de se comprometer com uma compra, inscreva-se para uma licença de teste gratuita de 30 dias. A chave de teste ativa todos os recursos de produção — incluindo a renderização de HTML para PDF, fusão de PDFs, inserção de marcas e criptografia — para que você possa testar a API completa conforme suas necessidades reais.

Se sua organização precisar de preços para grandes volumes ou um acordo empresarial, entre em contato com a equipe de vendas IronPDF para uma cotação personalizada.

Como Aplicar uma Chave de Licença no Node.js?

Defina a propriedade licenseKey no objeto de configuração global antes de chamar qualquer função do IronPDF . Coloque essa inicialização no ponto de entrada do seu aplicativo — normalmente nas primeiras linhas do seu arquivo index.js ou app.js — para que a chave esteja ativa em todas as operações subsequentes com PDFs.

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

A atribuição tem efeito imediato — não é necessário reiniciar ou reimportar. Qualquer operação de PDF que ocorrer após esta linha utilizará o mecanismo licenciado.

Como Seguir as Melhores Práticas de Chave de Licença?

Codificar a chave de licença diretamente no código-fonte cria um risco de segurança, especialmente em repositórios públicos. A abordagem recomendada é armazenar a chave em uma variável de ambiente e lê-la em tempo de execução.

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

Ao usar esse padrão, adicione IRONPDF_LICENSE_KEY=your-key a um arquivo .env para desenvolvimento local e configure a variável no sistema de gerenciamento de segredos da sua plataforma de hospedagem para produção. Adicione .env a .gitignore para evitar commits acidentais.

Duas práticas adicionais reduzem o risco operacional:

• Aplicar a chave uma vez na inicialização. Atribuí-la repetidamente em cada solicitação é inofensivo, mas desperdiça ciclos. Inicialize-a no módulo de entrada do seu aplicativo.
• Mantenha a chave fora dos pacotes de cliente. A inicialização da chave de licença deve ocorrer no servidor. O IronPDF for Node.js é executado em um contexto do lado do servidor, então este é o local natural — mas verifique novamente se seu pipeline de compilação não inclui IronPdfGlobalConfig no código voltado para o navegador.

Como Verificar se Sua Chave de Licença Está Funcionando?

Após aplicar a chave, confirme que ela foi aceita antes de executar seus fluxos de trabalho de produção. Use a flag isLicensed no objeto de configuração global.

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

Um resultado true confirma que a chave é válida e que o mecanismo está funcionando no modo licenciado. Um resultado false significa que a chave não foi reconhecida — verifique se há espaços em branco extras, truncamento ou se a chave de avaliação expirou. Se o problema persistir, entre em contato com o suporte IronPDF com sua chave e versão do Node.js.

Quais são os próximos passos?

Com uma chave de licença válida em vigor, o motor IronPDF está pronto para cargas de trabalho de produção. Comece com as tarefas mais comuns:

• Gerar PDFs a partir de HTML — converta strings HTML, arquivos ou URLs em documentos PDF precisos em pixels.
• Mesclar, dividir e manipular PDFs existentes — combine vários arquivos ou extraia intervalos de páginas específicos.
• Adicione cabeçalhos, rodapés e marcas d'água — personalize sua saída com elementos de página consistentes.
• Explore a documentação completa do IronPDF for Node.js para referência de API, tutoriais e exemplos de código.

Para atualizar seu nível de licença ou adicionar lugares para desenvolvedores, visite a página de licenciamento IronPDF ou inicie um teste gratuito para avaliar um nível mais alto antes de comprar.