---
title: "Assinaturas e o Lacuna Signer"
description: "Como o Digiploma coleta as assinaturas ICP-Brasil dos documentos do MEC pelo Lacuna Signer: quem assina o quê, etapas do fluxo e publicação do documento."
canonical: "https://docs.lacunasoftware.com/articles/digiploma/signatures"
locale: "pt-BR"
product: "Digiploma"
last_updated: "2026-10-11"
---

# Assinaturas e o Lacuna Signer

O Digiploma coleta as assinaturas ICP-Brasil dos documentos do MEC por meio do [Lacuna Signer](https://docs.lacunasoftware.com/articles/signer). Ele cria cada arquivo
XML como um documento no Signer, com os signatários do seu [fluxo de assinatura](https://docs.lacunasoftware.com/articles/digiploma/api/templates-and-flows#fluxos-de-assinatura); os
signatários assinam no Signer com os seus certificados; e o Signer avisa o Digiploma quando cada documento é concluído. O Digiploma então
publica o documento e mantém as assinaturas verificáveis ao longo do tempo (veja [Revalidação de diplomas](https://docs.lacunasoftware.com/articles/digiploma/revalidation)).

## Quem assina o quê

Um fluxo de assinatura tem uma lista de signatários para cada **etapa**. Para cada arquivo XML, o Digiploma transforma as etapas
necessárias nos passos de um documento do Signer: as regras de uma etapa com a mesma `order` assinam em paralelo, as demais em sequência,
e as etapas se sucedem. Uma regra de pessoa exige um certificado e-CPF, e uma regra da instituição, um certificado e-CNPJ. Os certificados
precisam ser do tipo A3, exceto nos históricos escolares parciais e nos documentos auxiliares.

O Signer escolhe a política de assinatura XAdES da ICP-Brasil pelo que é assinado: **AD-RC** quando o signatário assina um elemento do
XML, como `DadosDiploma`, e **AD-RA** quando assina o documento inteiro. A assinatura AD-RA traz o carimbo de tempo de arquivamento que o
Digiploma renova depois.

![Quem assina o quê no XML do diploma e no XML da documentação acadêmica](https://docs.lacunasoftware.com/images/digiploma/signer-who-signs-what-pt.svg)

| Documento | Signatários | O que assinam |
|---|---|---|
| XML do diploma | **Emissão**: representantes da emissora e a emissora | `DadosDiploma` (AD-RC) |
| | **Registro**: representantes da registradora | `DadosRegistro` (AD-RC) |
| | **Armazenamento**: a registradora | O documento inteiro (AD-RA) |
| XML da documentação acadêmica | Etapa Emissão | `DadosDiploma` (AD-RC) |
| | A emissora: a primeira regra e-CNPJ da etapa Emissão | O documento inteiro (AD-RA) |
| Histórico escolar | Representantes e, depois, a instituição | O documento inteiro. Representantes: AD-RC. A instituição: AD-RA (AD-RC no histórico parcial). |
| Currículo escolar | Coordenadores do curso e, depois, a instituição | O documento inteiro (AD-RA) |
| Lista de diplomas anulados, arquivo de fiscalização | A instituição, no Signer (modo manual) | O documento inteiro (AD-RA) |

Os documentos auxiliares (listas de diplomas anulados e arquivos de fiscalização) também podem ser assinados pelo próprio Digiploma, no
modo automático, com o certificado e-CNPJ da instituição armazenado no Digiploma e a política AD-RT da ICP-Brasil; nesse caso, eles nunca
passam pelo Signer.

O tipo da organização define quais arquivos o Digiploma envia ao Signer:

* **Emissora e Registradora**: o XML do diploma e o XML da documentação acadêmica. Por isso, os signatários da emissora assinam
  `DadosDiploma` duas vezes, uma em cada arquivo.
* **Emissora**: só o XML da documentação acadêmica. Depois de assinado, a emissão é enviada à registradora.
* **Registradora**: o XML do diploma, montado com o elemento `DadosDiploma` do XML da documentação acadêmica da emissora, copiado sem
  alterações para que as assinaturas dele continuem válidas. A registradora assina só as etapas Registro e Armazenamento.

## A assinatura de um diploma, do início ao fim

O diagrama abaixo acompanha um diploma de uma organização **Emissora e Registradora**, da requisição de criação até a renovação do seu
carimbo de tempo de arquivamento.

![A sequência de chamadas entre o seu sistema, o Digiploma, o Lacuna Signer e os signatários](https://docs.lacunasoftware.com/images/digiploma/signer-sequence-pt.svg)

1. O seu sistema cria o diploma ([`POST /api/degrees`](https://docs.lacunasoftware.com/articles/digiploma/api/degrees#criar-um-diploma), um [lote](https://docs.lacunasoftware.com/articles/digiploma/api/batches) ou o formulário). O
   Digiploma gera os dois arquivos XML, valida-os pelos schemas do MEC e os envia ao Signer, um documento para cada, na pasta do Signer
   indicada na requisição, se houver. O diploma fica `Created`.
2. Os signatários assinam no Signer, etapa após etapa.
3. Quando um documento é concluído, o Signer chama o webhook do Digiploma. O Digiploma não confia no corpo da chamada: ele relê o
   documento no Signer, com a chave da própria organização, e só age se o documento estiver concluído. O diploma fica `Active` quando o XML
   do diploma é assinado e é concluído quando os dois arquivos estão assinados: o Digiploma então envia o
   [webhook `DegreeConcluded`](https://docs.lacunasoftware.com/articles/digiploma/api/webhooks#eventos) ao seu sistema.
4. A partir daí, o Digiploma [renova o carimbo de tempo de arquivamento](https://docs.lacunasoftware.com/articles/digiploma/revalidation) dos dois arquivos antes que ele expire.

O Signer só informa os documentos concluídos. Se um signatário recusar um documento no Signer, nada muda no Digiploma: o diploma continua
`Created` até que você o cancele, e o cancelamento exclui do Signer os documentos pendentes.

> **Observação: Onde ficam os arquivos assinados**
>
> Baixe os arquivos assinados pelo Digiploma ([Baixar os arquivos](https://docs.lacunasoftware.com/articles/digiploma/api/degrees#baixar-os-arquivos)), não pelo Signer. O Digiploma os lê
> do Signer enquanto não mudam; quando acrescenta um novo carimbo de tempo de arquivamento, ele guarda o arquivo renovado, e a cópia do
> Signer deixa de ter o carimbo mais recente.

## Conectar o Digiploma ao Signer

O Digiploma chama a API do Signer com uma chave de API do Signer, salva em **Configurações** na organização; sem ela, as requisições de
criação falham com `SignerApiKeyNotSet`. O Signer responde ao Digiploma por um webhook, autenticado por uma chave de API do Digiploma.
Nas instalações on-premises, [Configurar a integração com o Signer](https://docs.lacunasoftware.com/articles/digiploma/on-premises/signer-setup) mostra os dois lados, passo a passo.

## Veja também

* [Modelos e fluxos de assinatura](https://docs.lacunasoftware.com/articles/digiploma/api/templates-and-flows)
* [Emitir e registrar diplomas](https://docs.lacunasoftware.com/articles/digiploma/api/degrees)
* [Revalidação de diplomas](https://docs.lacunasoftware.com/articles/digiploma/revalidation)
* [Lacuna Signer](https://docs.lacunasoftware.com/articles/signer)