---
title: "Configurar a integração com o Signer"
description: "Conexão entre o Digiploma e o Lacuna Signer: chave de API do Signer no Digiploma e webhook do Signer que avisa o Digiploma quando um documento é assinado."
canonical: "https://docs.lacunasoftware.com/articles/digiploma/on-premises/signer-setup"
locale: "pt-BR"
product: "Digiploma"
last_updated: "2026-10-12"
---

# Configurar a integração com o Signer

O Digiploma coleta todas as assinaturas por meio de uma instância do [Lacuna Signer](https://docs.lacunasoftware.com/articles/signer). Esta página descreve como
conectar as duas aplicações, para que o Digiploma crie documentos no Signer e o Signer avise o Digiploma quando eles forem assinados.

A integração é configurada dos dois lados, cada um na sua organização:

* **Digiploma → Signer**: o Digiploma chama a API do Signer com uma chave de API do Signer, salva nas configurações da organização no
  Digiploma.
* **Signer → Digiploma**: o Signer notifica o Digiploma por um webhook, autenticado por uma chave de API do Digiploma.

Por isso, é preciso ter uma organização em cada aplicação antes de começar.

![Como o Digiploma e o Signer se conectam: duas chamadas, duas chaves de API](https://docs.lacunasoftware.com/images/digiploma/signer-connection-pt.svg)

Os números do diagrama seguem a configuração:

1. No Signer, crie uma aplicação e uma chave de API ([Configuração no Digiploma](https://docs.lacunasoftware.com/articles/digiploma/on-premises/signer-setup#configuração-no-digiploma)).
2. No Digiploma, salve essa chave em **Configurações**.
3. No Digiploma, crie uma aplicação e copie a chave de API dela ([Configuração no Signer](https://docs.lacunasoftware.com/articles/digiploma/on-premises/signer-setup#configuração-no-signer)).
4. No Signer, habilite os webhooks da organização, autenticados com essa chave.

O Digiploma só age sobre documentos concluídos e, antes disso, relê cada um no Signer com a própria chave. Para saber o que acontece
depois, veja [Assinaturas e o Lacuna Signer](https://docs.lacunasoftware.com/articles/digiploma/signatures#a-assinatura-de-um-diploma-do-início-ao-fim).

## Criação de Organização
Para criar uma organização, abra a área de administração do sistema pelo menu do usuário: **Sys Admin** no Digiploma,
**Administração** no Signer (imagem abaixo).

![Adm](https://docs.lacunasoftware.com/images/digiploma/adm-sys-admin.png)

Selecione **Organizações**.

![Organizations](https://docs.lacunasoftware.com/images/digiploma/organizations.png)

### Digiploma
Clique em **Adicionar**

![AddOrganizationDigiploma](https://docs.lacunasoftware.com/images/digiploma/digiploma-add-organization.png)

Agora, basta preencher as informações necessárias, selecionar o tipo da organização e clicar em **Criar**. O apelido é opcional.

![SaveOrganization](https://docs.lacunasoftware.com/images/digiploma/digiploma-save-organization.png)

Tipos de organização:
- **Emissora e Registradora**: será possível realizar emissão e registro;
- **Emissora**: será possível realizar apenas emissão;
- **Registradora**: será possível realizar apenas registro.

### Signer

- Caso não exista nenhuma organização, clique em **Nova organização**

![NewOrganization](https://docs.lacunasoftware.com/images/digiploma/new-organization.png)

- Caso já exista alguma organização, clique no ícone **+**:

![AddOrganization](https://docs.lacunasoftware.com/images/digiploma/add-organization.png)

Agora, basta preencher as informações necessárias e clicar em **Salvar**. O CNPJ é opcional.

![SaveOrganization](https://docs.lacunasoftware.com/images/digiploma/save-organization.png)

## Configuração no Digiploma

Para configurar a integração no Digiploma, é necessário criar uma chave de API no Signer.

### Signer
Para gerar a **chave de API**, crie uma aplicação selecionando a organização criada anteriormente: 

![Applications](https://docs.lacunasoftware.com/images/digiploma/applications.png)

![Create application](https://docs.lacunasoftware.com/images/digiploma/create-application.png)

Em seguida gere a chave na opção **Chaves**:

![Application keys](https://docs.lacunasoftware.com/images/digiploma/application-keys.png)

![Application create key](https://docs.lacunasoftware.com/images/digiploma/application-keys-add.png)

![Create key submit](https://docs.lacunasoftware.com/images/digiploma/create-key.png)

Copie a **chave de API** gerada (esse valor não pode ser recuperado posteriormente), onde será utilizada no Digiploma.

### Digiploma

Na tela inicial do Digiploma com a organização já selecionada, selecione **Configurações**.

![Configurations](https://docs.lacunasoftware.com/images/digiploma/configuration.png)

![AddSignerKey](https://docs.lacunasoftware.com/images/digiploma/digiploma-add-signer-key.png)

Agora, basta colar a **chave de API** copiada do Signer.

## Configuração no Signer

Para configurar a integração no Signer, é necessário criar uma chave de API no Digiploma.

### Digiploma

Para gerar a **chave de API**, crie uma aplicação selecionando a organização criada anteriormente: 

![Applications](https://docs.lacunasoftware.com/images/digiploma/digiploma-applications.png)

![Create application](https://docs.lacunasoftware.com/images/digiploma/digiploma-create-application.png)

Copie a **chave de API** gerada (esse valor não pode ser recuperado posteriormente), onde será utilizada no Signer.

### Signer

Vá até a página de **Administração**, selecione **Organização**, selecione a organização criada anteriormente e **habilite os webhooks**.

![EnableWebhooks](https://docs.lacunasoftware.com/images/digiploma/enable-webhooks.png)

1. O campo **URL** deve ser preenchido com o endereço de sua instância do Digiploma seguido do caminho padrão de webhooks conforme o exemplo abaixo:

    ```text
    https://seu-digiploma.com.br/api/degrees/webhook
    ```

2. No campo **Tipo de autenticação** deve ser selecionado o tipo **X-Api-Key**.
3. No campo **Token de Autenticação** deve ser preenchido a **chave de API** copiada do Digiploma.

![SetupWebhook](https://docs.lacunasoftware.com/images/digiploma/setup-webhook.png)