Pré-requisitos#
Antes de começar, você precisará de um certificado digital válido registrado no repositório de certificados do Windows (o registro é feito automaticamente quando você utiliza um certificado digital no Windows). Para verificar se você tem um certificado digital registrado no Windows, siga os passos abaixo:1.
Iniciar > Executar... > certmgr.msc
2.
Deve haver pelo menos um certificado na pasta Pessoal. Dê um duplo-clique no certificado.
3.
Aparecerá uma janela com informações sobre o certificado. Deve haver a mensagem "Tem uma chave particular correspondente a este certificado."
Pronto, você já pode começar.Codificando as primeiras linhas#
Não é necessário incluir nenhum arquivo CSS pois o componente não interfere na interface da página.
Em seguida, instancie a classe SignerWebPKI
:Chame então o método init()
passando um callback que será chamado quando o componente estiver pronto para ser usado:Uma vez que o seu callback tenha sido chamado, você pode chamar as funções para operar com certificados digitais. Para obter os certificados disponíveis, utilize o método listCertificates()
:Para ler o encoding de um certificado, chame o método readCertificate()
:Para assinar bytes utilize o método signData(), que recebe 3 entradas:O thumbprint do certificado
Os bytes a serem assinados (em Base64)
O algoritmo de digest a ser utilizado durante a operação de assinatura
Caso o seu SDK rodando no servidor lhe informe o hash dos bytes a serem assinados, ao invés dos bytes em si, chame o método signHash()
:Próximos passos#
Agora que vimos as funções básicas do Web PKI ...Modified at 2024-12-03 14:40:29