Editar no GitHub

Licenciamento

Para habilitar o uso do Lacuna PKI SDK é necessário carregar a licença na inicialização da aplicação. A licença pode ser utilizada nos formatos

  • Arquivo LacunaPKILicense.config
  • String Base64

Se você ainda não possui uma licença, entre em contato através do site pki.lacunasoftware.com para obter uma licença de trial gratuitamente.

Existem 3 maneiras de se carregar a licença. A maneira mais recomendada depende se sua aplicação é uma aplicação web ou desktop:

Arquivo LacunaPKILicense.config no diretório da DLL

O SDK busca automaticamente o arquivo .config da licença junto à sua DLL (Lacuna.Pki.dll). Portanto, basta que o arquivo LacunaPKILicense.config seja copiado durante a compilação para o mesmo local da DLL.

Config file and DLL side by side

Uma forma prática de fazer isso é incluir o arquivo LacunaPKILicense.config no projeto do seu site ou aplicação e especificar o Build Action do arquivo como Content e setar opção Copy to Output Directory para Copy Always.

Set build action to Copy always

Essa forma é a mais recomendada para aplicações web.

Arquivo .config

Outra opção é incluir no arquivo Web.config ou App.config do seu site ou aplicação uma tag com o caminho para o arquivo .config da licença ou ainda uma tag com a licença em Base64, conforme exemplificado abaixo:

<appSettings>
  <!-- LacunaPKILicense.config file path -->
  <add key="LacunaPKI.LicensePath" value="[LacunaPKILicense.config file path]"/>

  <!-- or -->

  <!-- Base64 License -->
  <add key="LacunaPKI.BinaryLicense" value="[Base64 license]"/>
</appSettings>

Programaticamente

A licença pode ser carregada programaticamente fazendo uma chamada ao método LoadLicense(Byte[]) passando o valor decodificado da licença em Base64, preferencialmente no código de inicialização do seu site ou aplicação:

// Licença em Base64
byte[] binLicense = Convert.FromBase64String("[given Base64 License]");

// Carregando Licença
PkiConfig.LoadLicense(binLicense);

// Uso habilitado

Esta forma é a mais recomendada para aplicações desktop, pois a licença fica embutida no código fonte da aplicação, dificultando seu vazamento para terceiros.

Também é possível utilizar o método LoadLicense(String) para passar o caminho para o arquivo .config da licença. Entretanto, esse método não é recomendado para aplicações desktop pois não tem a vantagem de "esconder" a licença.

// Caminho para o arquivo LacunaPKILicense.config
string licensePath = "...";

// Carregando licença
PkiConfig.LoadLicense(licensePath);

// Uso habilitado

Próximos passos

Tendo adicionado o pacote Lacuna PKI SDK ao seu projeto e configurado a licença de uso do mesmo, veja como utilizar o SDK acessando os próximos tópicos como Certificados e Assinaturas.

Veja também