--- title: "Rest PKI Core" description: "Rest PKI Core: API REST para assinaturas digitais, validação, carimbos de tempo e verificação biométrica, em core.pki.rest ou em instância própria." canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core" locale: "pt-BR" product: "Rest PKI Core" last_updated: "2026-10-12" --- # 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](https://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 1. Adicione a biblioteca cliente da sua linguagem ([.NET](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/get-started#dotnet), [PHP](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/get-started#php) ou [Java](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/get-started#java)) ou [chame a API REST diretamente](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/get-started#rest) 1. Crie a sua primeira [sessão de assinatura](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions) O artigo [Primeiros passos para integração](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/get-started) explica cada uma delas. Em seguida, veja no [Guia de Integração](https://docs.lacunasoftware.com/articles/rest-pki/core/integration) 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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/webhooks). Veja [Sessões de assinatura](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions). * **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](https://docs.lacunasoftware.com/articles/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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/certificate-requirements). * **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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/pdf-a-conversion)), associe [metadados](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/document-metadata) próprios aos documentos e [valide os arquivos](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/file-validation) 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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/background-processing). * **Assinatura no desktop**: o [utilitário cliente do Rest PKI](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/client-tool) 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](https://docs.lacunasoftware.com/articles/rest-pki/core/requesting-timestamps) e [Configuração de Timestamping](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/configure-timestamp). ### 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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/bio-sessions). * **Prova de vida**: verifica se há uma pessoa real diante da câmera. Veja [Prova de vida](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/bio-sessions/liveness). * **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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/bio-sessions/enrollment), [Autenticação facial](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/bio-sessions/authentication) e [Identificação facial](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/bio-sessions/identification). * **Captura de documento**: lê documentos de identidade e compara o rosto do documento com o rosto do usuário. Veja [Captura de documento](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/bio-sessions/id-capture). * **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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/cert-auth). ### Compatibilidade com o Rest PKI O Rest PKI Core também atende à maior parte das APIs do [Rest PKI](https://docs.lacunasoftware.com/articles/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](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/migrating-from-rest-pki). ## Integrações * **API REST e bibliotecas cliente**: todas as funcionalidades estão disponíveis por uma API REST, descrita na [referência da API](https://core.pki.rest/swagger), com bibliotecas cliente para .NET, PHP, Java e Node.js. Veja [Primeiros passos para integração](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/get-started). * **Webhooks**: o Rest PKI Core avisa a sua aplicação quando um documento é assinado. Veja [Webhooks](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/webhooks). * **Login**: os usuários do dashboard entram pelo [GrantID](https://docs.lacunasoftware.com/articles/grant-id), o provedor de identidade OpenID Connect da Lacuna. Veja [Configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/configure-oidc). * **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](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/configure-blob-storage). ## Implantação Escolha onde o Rest PKI Core roda: * **Nuvem (SaaS)**: use a instância da Lacuna em [core.pki.rest](https://core.pki.rest/), sem nada para instalar ou manter. * **On-premises**: mantenha uma instância própria em [Windows Server](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/windows-server), [Linux](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/linux) (Ubuntu ou Rocky Linux), [Docker](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/docker) ou [Azure App Service](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/azure), com banco de dados SQL Server ou PostgreSQL. Uma única instância pode atender a várias [organizações](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/create-sub), cada uma com os próprios usuários, aplicações e configurações. Comece por [Rest PKI Core on-premises](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises). ## Veja também * [Guia de Integração](https://docs.lacunasoftware.com/articles/rest-pki/core/integration) * [Rest PKI Core on-premises](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises) * [Guia de Operação](https://docs.lacunasoftware.com/articles/rest-pki/core/operation) * [Histórico de versões](https://docs.lacunasoftware.com/articles/rest-pki/core/changelog)