Pular para o conteúdo principal

Rest PKI Core

O Rest PKI Core leva assinaturas digitais, validação de assinaturas, carimbos de tempo e verificação biométrica de identidade às suas aplicações por meio de uma API REST. Quando uma etapa depende do usuário, como escolher um certificado e assinar ou tirar uma selfie, a página fica no próprio Rest PKI Core: a sua aplicação cria uma sessão, envia o usuário para ela e recebe os resultados de volta, sem precisar de código próprio de assinatura ou de câmera.

Use-o como serviço em core.pki.rest ou mantenha uma instância própria em Windows, Linux, Docker ou Azure.

Primeiros passos para integração​

A integração tem três etapas:

  1. Obtenha o endpoint da instância e crie uma chave de API no dashboard dela
  2. Adicione a biblioteca cliente da sua linguagem (.NET, PHP ou Java) ou chame a API REST diretamente
  3. Crie a sua primeira sessão de assinatura

O artigo Primeiros passos para integração explica cada uma delas. Em seguida, veja no Guia de Integração a funcionalidade de que você precisa.

Funcionalidades​

Assinaturas digitais​

  • Sessões de assinatura: a sua aplicação cria uma sessão com os documentos a assinar, ou deixa que o usuário faça upload deles, e redireciona o usuário para uma página de assinatura hospedada pelo Rest PKI Core. Ao final, a sua aplicação obtém os documentos assinados pela API e também pode ser avisada por webhook. Veja Sessões de assinatura.
  • Certificados locais e em nuvem: os usuários assinam com os certificados instalados no computador, em token criptográfico ou em smart card, por meio do Web PKI, ou com certificados em nuvem. Uma sessão também pode aceitar apenas certificados em nuvem, sem passar pelas telas do Web PKI.
  • Requisitos de certificados: restrinja os certificados que podem assinar numa sessão, por exemplo apenas certificados em dispositivo criptográfico ou apenas o certificado de um determinado CPF. Veja Requisitos de certificados.
  • Formatos e políticas de assinatura: PAdES para arquivos PDF, CAdES para qualquer arquivo e XAdES para arquivos XML, incluindo as políticas de assinatura da ICP-Brasil (AD-RB, AD-RT, AD-RC e AD-RA).
  • Preparação dos documentos: converta arquivos PDF para PDF/A antes da assinatura (Conversão para PDF/A), associe metadados próprios aos documentos e valide os arquivos que os usuários enviam antes que sejam assinados.
  • Processamento em background: devolva o usuário à sua aplicação assim que ele assinar, enquanto os documentos ainda estão sendo processados. Veja Processamento em background.
  • Assinatura no desktop: o utilitário cliente do Rest PKI assina documentos pela linha de comando, para aplicações desktop e scripts.

Validação e preservação​

  • Inspeção de assinaturas: abra assinaturas PAdES, CAdES e XAdES para ver quem assinou e quando, e valide-as.
  • Códigos de verificação: os documentos assinados podem trazer um código que qualquer pessoa pode informar na página de validação da instância para conferir o documento e as assinaturas dele.
  • Carimbos de tempo de arquivamento: estenda assinaturas existentes com carimbos de tempo de arquivamento (AD-RA), para que continuem validáveis muito depois de os certificados que as geraram expirarem.

Carimbo de tempo​

Os seus sistemas podem solicitar carimbos de tempo RFC 3161 ao Rest PKI Core, pelo protocolo TSP ou por uma API REST. Uma instância on-premises encaminha as requisições aos provedores de carimbo de tempo que você configurar, em ordem de prioridade, e distribui a carga entre provedores de mesma prioridade. Veja Solicitando carimbos de tempo e Configuração de Timestamping.

Biometria e identidade​

  • Sessões de biometria: páginas hospedadas pelo Rest PKI Core que capturam o rosto e os documentos de identidade do usuário, abertas por redirecionamento ou incorporadas à sua página com um widget. Veja Sessões de biometria.
  • Prova de vida: verifica se há uma pessoa real diante da câmera. Veja Prova de vida.
  • Cadastro, autenticação e identificação: cadastre o rosto de uma pessoa, confirme depois que é a mesma pessoa (1:1) ou descubra a quem pertence um rosto entre as pessoas cadastradas (1:N). Veja Cadastro biométrico, Autenticação facial e Identificação facial.
  • Captura de documento: lê documentos de identidade e compara o rosto do documento com o rosto do usuário. Veja Captura de documento.
  • Identificação por vídeo: grava o usuário e o documento de identidade dele, com um relatório em PDF dos resultados.
  • Autenticação com certificado: os usuários entram na sua aplicação com o próprio certificado digital. Veja Autenticação com certificado.

Compatibilidade com o Rest PKI​

O Rest PKI Core também atende à maior parte das APIs do Rest PKI clássico, como as de assinaturas PAdES, CAdES e XML, de autenticação com certificado e de marcas em PDF, o que facilita a migração de aplicações feitas para o Rest PKI. Veja Migração do Rest PKI para o Rest PKI Core.

Integrações​

  • API REST e bibliotecas cliente: todas as funcionalidades estão disponíveis por uma API REST, descrita na referência da API, com bibliotecas cliente para .NET, PHP, Java e Node.js. Veja Primeiros passos para integração.
  • Webhooks: o Rest PKI Core avisa a sua aplicação quando um documento é assinado. Veja Webhooks.
  • Login: os usuários do dashboard entram pelo GrantID, o provedor de identidade OpenID Connect da Lacuna. Veja Configuração de OpenID Connect.
  • Armazenamento de arquivos: os documentos ficam no sistema de arquivos local, no Azure Blob Storage, no Amazon S3 (ou em um serviço compatível com S3) ou no Google Cloud Storage. Veja Configuração de Blob Storage.

Implantação​

Escolha onde o Rest PKI Core roda:

Veja também​

Ver em Markdown