IdeiaSigner
  1. Web PKI
IdeiaSigner
  • Bem-vindo
  • Política de Privacidade
  • Certificação Digital
    • O que é?
    • Assinaturas Digitais
    • Assinaturas de servidor
    • Login com certificado digital
    • Certificados confiados pela Adobe
    • Assinaturas web
      • O que são?
      • Assinaturas web remotas
      • Assinaturas web locais
  • Web PKI
    • O que é?
    • Primeiros passos
    • Propriedades dos certificados
    • Personalizando a listagem de certificados
    • Pré-validação de certificados
    • Browsers suportados
    • Instalação e distribuição de componentes do WEB PKI via GPO
    • Licenciamento
    • Chamadas assíncronas
    • Callback de erro padrão
    • Customizando o comportamento quando o componente não estiver instalado
    • Utilizando uma página de instalação personalizada
    • Callbacks e AngularJS
    • Filtros de certificados
    • Especificando a URL do Rest PKI
    • Atualizações - Web PKI
    • Requisição Autenticada
    • Logs - Web PKI
    • Atributos de Segurança - Web PKI
    • Substituição do ICPBravoAccess
    • FAQ
      • Qual é a diferença entre as funções signData e signHash?
      • Qual é o formato da assinatura retornada pelas funções signData e signHash?
      • O Web PKI suporta conexões SSL usando o certificado do usuário?
  • Rest PKI
    • O que é?
    • Rest PKI - Disponibilidade de exemplos por projeto
    • Códigos de Retorno do REST PKI
    • Tags da representação visual de assinaturas PAdES
    • Configuração de Data e Hora
    • Solicitando carimbos de tempo
  • Signer
    • Guia de Integração
    • Integração com Assinatura embutida
    • Guia do usuário
      • Geração de documentos
    • Administração do sistema
      • Adicionando usuário à administração
      • Visualizando os documentos
      • Excluindo documentos
    • Sobre o Signer
      • Histórico de versões do Signer
      • Código de erro inesperado ao submeter ou assinar um PDF
  • GrantID
    • GrantID - Inicio
  • API Auxiliar
    • Manual de Integração APIs
    • Endpoints
      • CadastrarOrganizacao
      • AtualizarDadosFaturamento
      • CadastrarUsuario
  1. Web PKI

Primeiros passos

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#

Primeiro, inclua na sua página o arquivo signer-web-pki.js mais recente:
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():
Se você não estiver familharizado com chamadas assíncronas, veja a seção Chamadas assícronas.
Para saber as propriedades disponíveis para cada certificado, veja o artigo Propriedades dos certificados
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 ...
Veja os browser suportados
Veja como funciona o licenciamento
Veja como customizar o comportamento quando o componente não estiver instalado
Se a sua aplicação utiliza AngularJS ou Angular2+, leia a seção Callbacks e Angular
Página anterior
O que é?
Próxima página
Propriedades dos certificados
Built with