PONTIFÍCIA UNIVERSIDADE CATÓLICA DO PARANÁ
ESCOLA POLITÉCNICA - PROGRAMA DE PÓS-GRADUAÇÃO EM ARQUITETURA DE SOFTWARE, CIÊNCIA DE DADOS E CYBERSEGURANÇA
Proposta De Arquitetura Para Uma Plataforma Corporativa De Assinatura Eletrônica De Documentos
CURITIBA
2026
Para executar o software:
- clone este repositório
- substitua os arquivos Cadeia_Oficial.p7b, cert.p12, cert.pem certificadodigital.pfx e key.pem pelos arquivos do seu certificado digital de produção
- execute o comando node server.js (assume-se que o node.js versão LTS esteja instalado em seu sistema)
- navegue para https://localhost:3000
O presente trabalho apresenta o desenvolvimento de uma aplicação web destinada à personalização visual de documentos PDF assinados eletronicamente. O sistema permite ao usuário carregar um documento PDF, navegar por suas páginas e inserir elementos gráficos como assinaturas, selos de certificação, QR Codes, timestamps, textos e demais componentes visuais de forma intuitiva, possibilitando a geração de um documento final alinhado à identidade visual da organização.
A solução foi concebida para simplificar o processo de preparação de documentos corporativos, eliminando a necessidade de edição manual em softwares gráficos ou no PDF. A interface permite posicionar e organizar os elementos diretamente sobre o documento, oferecendo uma experiência visual semelhante à edição de um documento convencional, porém voltada especificamente ao contexto de assinaturas eletrônicas.
Além da facilidade de utilização, o sistema foi projetado com arquitetura modular, permitindo a incorporação de novos componentes gráficos, novos modelos de assinatura e futuras integrações com provedores de assinatura digital, mantendo elevada capacidade de evolução e manutenção.
A transformação digital impulsionou a adoção de assinaturas eletrônicas em processos administrativos, jurídicos e comerciais. No Brasil, uma das principais alternativas disponíveis é a plataforma gov.br, que disponibiliza gratuitamente um serviço de assinatura eletrônica amplamente reconhecido e de fácil utilização.
Embora essa solução atenda adequadamente a diversos cenários, sua utilização apresenta limitações para organizações que desejam oferecer uma experiência personalizada aos seus clientes ou preservar sua identidade institucional durante o processo de assinatura documental.
Os documentos assinados por meio do gov.br exibem automaticamente elementos gráficos pertencentes à identidade visual do Governo Federal, como logotipos, cores e modelos padronizados de assinatura. Conforme ilustrado na Figura 1, documentos corporativos acabam apresentando uma identidade visual que não corresponde à marca da empresa responsável pelo processo de assinatura.
Exemplo de documento assinado com o assinador Gov.br. Fonte: Gov.br (2026). Disponível em: https://validar.iti.gov.br
Outro aspecto relevante é que o serviço disponibiliza assinatura eletrônica na modalidade avançada, cuja utilização é suficiente para grande parte das aplicações previstas na legislação brasileira. Entretanto, determinadas organizações optam pela utilização de assinaturas eletrônicas qualificadas, certificados ICP-Brasil ou modelos próprios de validação documental, exigindo maior flexibilidade na composição visual do documento final.
A Figura 2 apresenta um exemplo do selo utilizado para identificar assinaturas eletrônicas qualificadas, modalidade que oferece o mais elevado nível de confiabilidade entre os modelos previstos pela legislação brasileira.
A assinatura eletrônica qualificada tem o maior nível de aceitação dentre os modelos disponíveis. Fonte: Instituto Nacional de Tecnologia da Informação – ITI (2026).
Dessa forma, observa-se a necessidade de uma ferramenta que permita desacoplar a apresentação visual do documento do mecanismo responsável pela autenticação da assinatura, possibilitando que empresas mantenham sua identidade visual independentemente da tecnologia empregada para validar eletronicamente o documento.
A identidade visual representa um importante ativo das organizações, estando presente em contratos, propostas comerciais, certificados, procurações e diversos outros documentos institucionais. A utilização de assinaturas eletrônicas padronizadas por provedores externos pode reduzir a percepção de personalização dos documentos e limitar sua adequação aos padrões internos da organização.
Nesse contexto, torna-se relevante o desenvolvimento de uma ferramenta capaz de personalizar completamente os elementos visuais presentes em documentos assinados eletronicamente, permitindo que cada organização mantenha sua própria identidade gráfica sem abrir mão da segurança proporcionada pelos mecanismos de assinatura digital existentes.
Além do aspecto visual, uma ferramenta centralizada reduz atividades repetitivas relacionadas à inserção manual de assinaturas, selos e informações complementares, promovendo maior produtividade e padronização dos documentos produzidos. O objetivo geral deste trabalho consiste em desenvolver uma aplicação web para edição de documentos PDF que possibilite a inserção e o posicionamento de assinaturas, QR Codes, timestamps, selos de certificação e demais elementos gráficos reutilizáveis, permitindo a geração de documentos personalizados, organizados e aderentes aos padrões institucionais da organização.
Como objetivos específicos, destacam-se:
- Desenvolver uma interface gráfica intuitiva para manipulação de documentos PDF;
- Permitir a reutilização de componentes gráficos frequentemente utilizados;
- Facilitar o posicionamento preciso dos elementos sobre o documento;
- Possibilitar futuras integrações com diferentes provedores de assinatura eletrônica;
- Projetar uma arquitetura modular que favoreça a manutenção e evolução do sistema.
O desenvolvimento da solução fundamenta-se em conceitos relacionados à assinatura eletrônica, manipulação de documentos PDF, arquitetura de aplicações web modernas e princípios de engenharia de software. A Medida Provisória nº 2.200-2/2001 (BRASIL, 2001) estabeleceu a Infraestrutura de Chaves Públicas Brasileira (ICP-Brasil), criando mecanismos para garantir autenticidade, integridade e validade jurídica de documentos eletrônicos. Posteriormente, a Lei nº 14.063/2020 (BRASIL, 2020) consolidou as modalidades de assinatura eletrônica utilizadas pela Administração Pública, classificando-as em simples, avançada e qualificada. Sob a perspectiva arquitetural, o sistema foi concebido como uma aplicação web baseada em componentes, permitindo elevada reutilização de código e facilidade de manutenção. A manipulação visual dos documentos ocorre diretamente no navegador, utilizando renderização das páginas do PDF e sobreposição dinâmica de componentes gráficos.
A solução também incorpora princípios de usabilidade, privilegiando interação visual direta (drag-and-drop), reutilização de recursos e separação entre interface de usuário, lógica de negócio e processamento documental, favorecendo futuras evoluções do sistema.
O desenvolvimento da solução foi conduzido utilizando uma abordagem incremental, baseada na evolução de um projeto de código aberto previamente existente. Como ponto de partida, foi adotado o projeto PDF Stamp (BFRITSCHER, 2024), que já disponibilizava uma interface gráfica funcional para carregamento de documentos PDF, navegação entre páginas e inserção de imagens no documento.
A escolha por utilizar um projeto de código aberto como base teve como objetivo acelerar o desenvolvimento da solução, concentrando os esforços na implementação das funcionalidades que agregariam maior valor ao negócio. Dessa forma, foi possível reutilizar uma interface gráfica consolidada e direcionar o trabalho para os aspectos relacionados à assinatura eletrônica, à segurança da informação e à arquitetura do sistema.
Durante a análise da aplicação original, observou-se que sua funcionalidade limitava-se à sobreposição visual de imagens sobre documentos PDF. Embora esse comportamento produzisse um documento aparentemente assinado, não havia qualquer mecanismo criptográfico responsável por garantir autenticidade, integridade ou não repúdio. Em outras palavras, tratava-se apenas de uma assinatura visual, sem validade como assinatura eletrônica baseada em certificados digitais.
A partir dessa base, foi realizada uma evolução arquitetural da aplicação, incorporando suporte à assinatura eletrônica efetiva dos documentos PDF. Para isso, foram integradas bibliotecas de código aberto pertencentes ao ecossistema node-signpdf (VBUCH, 2025), especializado na assinatura digital de documentos PDF para aplicações desenvolvidas em Node.js.
As principais bibliotecas incorporadas ao sistema foram:
- @signpdf/placeholder-plain, responsável pela inserção do placeholder (espaço reservado) destinado à assinatura digital dentro da estrutura do documento PDF;
- @signpdf/signer-p12, responsável pela leitura e utilização de certificados digitais no formato PKCS#12 (.P12/.PFX), realizando as operações criptográficas utilizando a chave privada do certificado;
- @signpdf/signpdf, biblioteca principal responsável pela geração da assinatura digital e sua incorporação definitiva ao documento PDF previamente preparado.
Com essa evolução, a aplicação deixou de atuar apenas como um editor visual de documentos e passou a produzir documentos efetivamente assinados eletronicamente utilizando certificados digitais, preservando simultaneamente os requisitos de autenticidade, integridade e não repúdio exigidos pelos mecanismos modernos de assinatura digital.
Além da funcionalidade de assinatura, foram desenvolvidos recursos para inserção de QR Codes, timestamps, textos personalizados, selos institucionais e demais componentes gráficos reutilizáveis, permitindo que o documento final seja adaptado à identidade visual da organização. Todo o posicionamento dos elementos ocorre por meio de uma interface gráfica interativa, proporcionando uma experiência intuitiva ao usuário e reduzindo o tempo necessário para preparação dos documentos. Ao término do desenvolvimento, obteve-se um protótipo plenamente funcional, capaz de carregar documentos PDF, realizar sua edição visual, aplicar assinaturas eletrônicas utilizando certificados digitais e exportar o documento final já assinado.
Embora o sistema esteja operacional, sua arquitetura foi concebida para permitir evolução contínua e integração com o ecossistema tecnológico corporativo. Entre as principais evoluções previstas destaca-se a integração com o Google Cloud Secret Manager, que será responsável pelo armazenamento seguro dos certificados digitais utilizados pela organização. Essa abordagem elimina a necessidade de armazenamento local dos certificados, reduzindo riscos de exposição de chaves privadas e aumentando o nível de segurança da solução. Outra evolução planejada consiste na integração com um serviço de gerenciamento de identidade corporativa, como o Google Cloud Identity, utilizando o protocolo OpenID Connect (OIDC). Essa integração permitirá que os colaboradores utilizem suas credenciais institucionais para acessar o sistema, centralizando o gerenciamento de identidade e simplificando os processos de autenticação e autorização.
Com o objetivo de ampliar a reutilização da solução dentro da organização, pretende-se disponibilizar uma camada de abstração baseada em uma API RESTful, permitindo que outros sistemas corporativos consumam o serviço de assinatura eletrônica sem depender da interface web desenvolvida neste projeto. Dessa forma, diferentes departamentos poderão desenvolver aplicações próprias, promovendo reutilização, padronização e redução de duplicidade de implementações.
Para armazenamento dos documentos assinados, prevê-se a utilização do Google Cloud Storage, oferecendo alta disponibilidade, elevada durabilidade dos dados, versionamento dos documentos e gerenciamento automático do ciclo de vida dos arquivos. Sob a perspectiva da infraestrutura, recomenda-se a implantação da aplicação em ambiente containerizado utilizando um serviço gerenciado da Google Cloud, como o Cloud Run ou o Google Kubernetes Engine (GKE). Essa abordagem permite escalabilidade automática, alta disponibilidade e reduz significativamente o esforço operacional relacionado ao gerenciamento da infraestrutura.
Na camada de borda da arquitetura, propõe-se a utilização da Cloudflare para gerenciamento de DNS, emissão de certificados TLS, proteção contra ataques distribuídos (DDoS), aplicação de regras de Web Application Firewall (WAF) e aceleração da entrega do conteúdo, contribuindo para o aumento da disponibilidade e da segurança da aplicação.
Por fim, para suportar o processo de desenvolvimento e entrega contínua do software, recomenda-se a utilização do GitHub como plataforma de hospedagem do código-fonte e controle de versões, enquanto o GitHub Actions será empregado para implementação das pipelines de Integração Contínua e Entrega Contínua (CI/CD). Essas pipelines serão responsáveis pela execução automatizada de testes, análise estática de código, construção das imagens Docker, publicação dos artefatos e implantação da aplicação nos ambientes de homologação e produção, promovendo maior confiabilidade, rastreabilidade e padronização no ciclo de desenvolvimento do sistema.
Durante a definição da arquitetura também foram considerados os principais riscos inerentes à solução. Entre eles destacam-se a proteção dos certificados digitais corporativos, a correta gestão de permissões de assinatura, a disponibilidade dos serviços em nuvem, a integridade dos documentos armazenados e a escalabilidade da aplicação diante do aumento do número de usuários. As tecnologias e serviços propostos foram selecionados justamente para mitigar esses riscos, fornecendo mecanismos consolidados de segurança, autenticação, controle de acesso, armazenamento seguro e alta disponibilidade. A arquitetura proposta para a solução é apresentada na Figura 3, evidenciando os principais componentes da aplicação, os serviços em nuvem e as integrações previstas para evolução da plataforma.
Diagrama de arquitetura proposto. Fonte: Elaborado pelo autor (2026).
Espera-se que a solução desenvolvida permita às organizações produzir documentos eletrônicos visualmente alinhados à sua identidade institucional, independentemente do mecanismo utilizado para autenticação da assinatura.
A ferramenta deverá reduzir o tempo necessário para preparação de documentos, eliminar atividades repetitivas relacionadas à inserção manual de elementos gráficos e proporcionar maior padronização dos documentos corporativos.
Adicionalmente, a arquitetura proposta cria uma base tecnológica para futuras integrações , permitindo que o sistema evolua conforme novas demandas surgirem.
BFRITSCHER, Benoît. PDF Stamp. GitHub, 2024. Disponível em: https://github.com/bfritscher/pdf-stamp. Acesso em: 29 jun. 2026.
BRASIL. Lei nº 14.063, de 23 de setembro de 2020. Dispõe sobre o uso de assinaturas eletrônicas em interações com entes públicos, em atos de pessoas jurídicas e em questões de saúde e sobre as licenças de softwares desenvolvidos por entes públicos. Diário Oficial da União: Brasília, DF, 24 set. 2020. Disponível em: https://www.planalto.gov.br/ccivil_03/_ato2019-2022/2020/lei/L14063.htm. Acesso em: 29 jun. 2026.
BRASIL. Medida Provisória nº 2.200-2, de 24 de agosto de 2001. Institui a Infraestrutura de Chaves Públicas Brasileira - ICP-Brasil. Diário Oficial da União: Brasília, DF, 27 ago. 2001. Disponível em: https://www.planalto.gov.br/ccivil_03/mpv/antigas_2001/2200-2.htm. Acesso em: 29 jun. 2026. VBUCH. node-signpdf. GitHub, 2025. Disponível em: https://github.com/vbuch/node-signpdf. Acesso em: 29 jun. 2026.
VBUCH. @signpdf/signer-p12. npm. Disponível em: https://www.npmjs.com/package/@signpdf/signer-p12. Acesso em: 29 jun. 2026.
BRASIL. Instituto Nacional de Tecnologia da Informação. Gov.br. Disponível em: https://validar.iti.gov.br. Acesso em: 29 jun. 2026.
BRASIL. Instituto Nacional de Tecnologia da Informação. Assinatura eletrônica qualificada. Disponível em: https://www.gov.br/iti. Acesso em: 29 jun. 2026.