ShieldSign PKIDocumentação

Assinatura digital de PDF com certificado ICP-Brasil, por API

Seus usuários assinam com o certificado que já têm (token A3, arquivo A1 ou certificado em nuvem). Você recebe o PDF assinado em PAdES, com carimbo de tempo, validado até a raiz ICP-Brasil. A chave privada nunca sai do computador do usuário.

Fazer a primeira assinaturaReferência da API

Como funciona#

  1. Seu servidor inicia enviando o PDF à API e recebendo um token de sessão.
  2. O usuário escolhe o certificado no navegador. A extensão ShieldSign lê o certificado do token, do Windows ou da nuvem; a API confere a cadeia, a validade e o uso da chave antes de o usuário digitar o PIN.
  3. A assinatura acontece no computador do usuário, na janela da extensão. O PIN só é digitado ali.
  4. Seu servidor conclui e baixa o PDF assinado, com o carimbo de tempo já embutido.

Por onde começar#

Primeira assinaturaTrês chamadas de API, do PDF ao documento assinado. Integrar no seu sistemaO fluxo completo entre navegador, servidor e API, com exemplos em PHP e JavaScript. Referência da APIEndpoints, parâmetros, exemplos e respostas. Extensão e agenteO que o usuário instala e como o seu site detecta e orienta. Verificar assinaturasConfira qualquer PDF e mostre erros e avisos em português. Login com certificadoAutentique pela posse da chave do e-CPF ou e-CNPJ.

O que a plataforma oferece#

  • PAdES com perfis ICP-Brasil (AD-RB, AD-RT, AD-RC e AD-RA) e perfil básico, com a política declarada lida da lista oficial do ITI.
  • Carimbo de tempo de uma autoridade credenciada em toda assinatura, para provar quando o documento foi assinado.
  • Lote: vários PDFs numa só aprovação e um só PIN.
  • Assinatura visível com texto, imagem e posição definidos por você; vários signatários em sequência no mesmo PDF.
  • Verificação de assinaturas, com os problemas explicados em português e códigos estáveis.
  • Login por certificado (e-CPF/e-CNPJ) com desafio de uso único e proteção contra repasse a outro site.
  • PKI privada: aceite certificados de uma AC corporativa, isolada das raízes globais.
  • Privacidade: o PIN e a chave privada não passam pela API, e os PDFs ficam no servidor só durante a sessão.

Precisa de ajuda?#

Veja Suporte ou escreva para contato@shieldcertificadora.com.br. Ao pedir ajuda, informe o cabeçalho X-Request-Id da resposta.

ShieldSign PKI · Shield Certificadora · contato@shieldcertificadora.com.br · Privacidade