Versões da API

O Web PKI oferece a possiblilidade de o desenvolvedor definir qual a versão da API deseja exigir, baseando-se no conjunto de funcionalidades que deseja utilizar. Para isso, utilize o parâmetro requiredApiVersion no método init():

pki.init({
    ready: onWebPkiReady,
    requiredApiVersion: pki.apiVersions.v1_2
});

No exemplo acima, definimos que iremos utilizar funcionalidades introduzidas na API 1.2. Desta forma, a atualização dos componentes do Web PKI só será exigida aos usuários com versões inferiores às definidas pela API 1.2. Nenhuma atualização desnecessária será exigida de usuários com versões suficientes, ainda que não sejam a mais recente.

Se o parâmetro não for passado, o padrão é exigir a API 1.3.

Histórico de versões da API

1.8.2 (2023-11-23)

Desde lib 2.16.3

• Melhoria no método importCertificate suportando múltiplas chamadas

1.8.1 (2022-12-17)

• Adiciona métodos encrypt e decrypt
• Adiciona Extended Key Usage info ao CertificateModel
• Adiciona o parâmetro nonExportableKey ao método generateSoftwareRsaKeyPair

1.7.2 (2022-07-03)

• Adiciona suporte a respostas sem limite de tamanho do App
• Adiciona campos de PKI internacionais no CertificateModel: PkiArgentinaModel, PkiEcuadorModel, PkiParaguayModel, PkiPeruModel
• Adiciona campos no CertificateModel: certificatePolicies, subjectDN, issuerDN

1.6.1 (2020-05-23)

• Adiciona comando downloadToFolder* com suporte forçado a TLS 1.2

1.6 (2019-10-13)

• Adiciona métodos keySignData e keySignHash para assinatura com Id de chave privada gerada.
• Adiciona o parâmetro privateKeyId ao resultado da geração de par de chaves GenerateKeyPairResponse.
• Corrige bug na resposta do método sendAuthenticatedRequest quando o payload retornado não possui a propriedade Content-Length no Header.

1.5.2 (2019-07-19)

• Adiciona opção de retorno do conteúdo do documento assinado nos comandos de assinatura local sem limite de 1MB: returnContent
• Adiciona nível de validação do certificado do assinante nos comandos de assinatura local: CertificateValidationLevels
• Adiciona controle de direção vertical e horizontal na representação visual da assinatura PAdES (PDF): PadesVisualAutoPositioning
• Adiciona controle do ciclo de vida da aplicação nativa no método init: useDomainNativePool

1.5 (2018-11-27)

• Adiciona comando mais eficiente de assinatura de lote: signHashBatch
• Adiciona licença v3
• Adiciona integração com mobile

1.4.1 (2018-06-15)

• Corrige bug de buffer vazio no comando sendAuthenticatedRequest*

1.4 (2018-02-23)

• Adiciona funcionalidades de assinatura local de XML:
  • signFullXml*
  • signXmlElement*
  • openXmlSignature*
• Adiciona funcionalidades de requisição Web autenticada:
  • sendAuthenticatedRequest*
• Adiciona mensagem de erro de usuário no objeto de exceção:
  • userMessage

1.3 (2017-11-10)

• Adiciona gerenciador de erro com objeto de exceção mais detalhado:
  • fail

1.2 (2017-06-19)

• Adiciona funcionalidades para emissão de certificado digital em repositório local e via PKCS#11:
  • generateSoftwareRsaKeyPair
  • importCertificate
  • listTokens
  • generateTokenRsaKeyPair
  • importTokenCertificate

1.1 (2016-08-19)

• Adiciona licença v2
• Adiciona funcionalidades para assinatura local:
  • showFileBrowser*
  • openFile*
• Adiciona funcionalidades de assinatura local PAdES:
  • signPdf*
  • openPades*
• Adiciona funcionalidades de assinatura local CAdES:
  • signCades*
  • openCades*

1.0 (2015-04-28)

• Adiciona funcionalidades básicas:
  • init
  • listCertificates
  • readCertificate
  • signHash
  • signData
  • redirectToInstallPage
• Adiciona funcionalidade para assinatura em lote:
  • preauthorizeSignatures
• Adiciona funcionalidade de download e seleção de diretório:
  • showFolderBrowser
  • downloadToFolder
  • openFolder
• Adiciona integração de assinatura com RestPKI:
  • signWithRestPki

* Métodos suportados apenas em Windows. Para mais informações veja o artigo Assinaturas web.