Instruções para Desenvolvedores

Download

Assinador Digital

Instruções para os desenvolvedores

Como se comunicar com o aplicativo Assinador Digital

O arquivo websocket.js é um script de exemplo com métodos de como conectar ao websocket, enviar e receber mensagens.
A transmissão de dados entre a Web e o aplicativo Assinador Digital utiliza objeto JSON.
O objeto enviado ao aplicativo contém os seguintes atributos:

{
/* atributos obrigatórios */
"identificador" : "nome do arquivo pdf, com a extensao .pdf no final",
"byteBase64" : "string base64 do arquivo pdf",
"reason" : "razão da assinatura",
"location" : "local da assinatura",
/* atributos opcionais */
"cpfCnpj" : "Restringe assinatura do documento a um certificado com CPF/CNPJ específico",
"posX" : 15, /* posição x em milímetros do local da assinatura, valor padrao = 15f */
"posY" : 15, /* posição y em milímetros do local da assinatura, valor padrao = 15f */
"angulo" : 0, /* angulo em graus ° da assinatura em relacao a pagina, valor padrao = 0f */
"larguraPagina" : 210, /* largura da página, valor padrao = 210f (folha A4)*/
"alturaPagina" : 297 /* largura da página, valor padrao = 297f (folha A4)*/
}

O objeto recebido pelo aplicativo contém os seguintes atributos

{
"identificador" : "nome do arquivo pdf, com a extensao .pdf no final",
"byteBase64" : "string base64 do arquivo pdf assinado",
"sucesso" : true/false, /* true se documento foi assinado com sucesso */
"certificadoSelecionado" : true/false, /* true se documento foi assinado com sucesso */
"cpfCnpjValido" : true/false, /* true se CPF/CNPJ requerido confere com o do selecionado para assinatura */
"sucesso" : true/false, /* true se documento foi assinado com sucesso */
"erro" : "descrição de algum erro, se houve, ou null, casos contrário"
}

Versões Assinador Digital

Assinador Digital Versão 1
Assinador Digital de PDF versão 1 realiza conexão através do protocolo ws WebSocket. Possibilita a comuninação por meio de páginas http.
URL de conexão websocket usada pelo aplicativo Assinador Digital
ws://localhost:8025/websocket/assdigital

Assinador Digital Versão 2
Assinador Digital de PDF versão 2 realiza conexão através do protocolo ws WebSocket vinculado a um certificado digital assinado pela rede interna. Possibilita a comuninação por meio de páginas http e https.
URL de conexão websocket segura usada pelo aplicativo Assinador Digital
wss://www.assinadordigital.ms.gov.br:8025/assdigital
• Versão 2.0.1 - Ajustes para configurar hosts do Windows 10 e futuras versões de acordo com diretório padrão.
• Versão 2.0.2 - Ajustes para restringir cpf/cnpj na assinatura do pdf.
• Versão 2.1.0 - Ajustes para certificado de produção.
• Versão 2.2.0 - Versão assinada com o novo certificado.
• Versão 2.2.1 - Corrigido bug que impedia certificados com e-cnpj assinarem.
• Versão 2.2.3 - Alterado o leiaute; Corrigido bug que encerrava abruptamente o aplicativo caso não conseguisse configurar o arquivo "hosts".
• Versão 2.2.4 - Aumentado espaço reservado no documento para a assinatura.

Utilizamos cookies para permitir uma melhor experiência em nosso website e para nos ajudar a compreender quais informações são mais úteis e relevantes para você. Por isso é importante que você concorde com a política de uso de cookies deste site.