# Como assinar arquivos digitalmente

## Visão geral

A assinatura digital de arquivos permite utilizar certificados digitais compatíveis com o ICP-Brasil para atestar a autenticidade do arquivo, visto que o Zeev docs consegue distinguir uma assinatura válida de uma inválida, além de alertar quando essa verificação não pôde ser realizada. Ao final do processo, você terá um arquivo no formato PDF, assinado.

{% hint style="warning" %}
**Importante:** Ao visualizar no Adobe Reader um documento assinado, ele pode não reconhecer o certificado-raiz ICP-Brasil como confiável, informando que alguma assinatura apresenta problemas. Veja como resolver [aqui](/zeevdocs/dia-a-dia-no-zeev-docs/como-consultar-documentos/como-assinar-arquivos-digitalmente/como-fazer-o-adobe-reader-reconhecer-seu-certificado.md).
{% endhint %}

O Zeev docs utiliza o padrão internacional "PAdES" (PDF Advanced Electronic Signature) no seu processo de assinatura digital. Este é um dos padrões de assinatura aceitos pelo ICP-Brasil, geralmente utilizado para a assinatura de documentos em formato PDF, visto que utiliza o padrão "PDF ISO 32000-1", onde as assinaturas realizadas no documento podem ser interpretadas e visualizadas por qualquer visualizador de PDF.

### O que é necessário para assinar um arquivo <a href="#o-que-e-necessario-para-assinar-um-arquivo" id="o-que-e-necessario-para-assinar-um-arquivo"></a>

Para assinar um arquivo digitalmente é necessário:

1. Ter o aplicativo [*Desktop integration*](/zeevdocs/dia-a-dia-no-zeev-docs/como-capturar-documentos/como-instalar-o-desktop-integration.md) em execução na sua máquina;
2. Possuir um certificado digital compatível com ICP-Brasil, no prazo de validade;
3. Ter um usuário com permissão para realizar essa operação.

### Como efetuar a assinatura de arquivos <a href="#como-efetuar-a-assinatura-de-arquivos" id="como-efetuar-a-assinatura-de-arquivos"></a>

É possível assinar arquivos das seguintes formas:

* Pelo módulo de Edição (manualmente);
* Pelo módulo de Visualização (manualmente);
* Pelo serviço de Conversão (automaticamente).

Tanto na **visualização**, quanto na **edição** do documento é exibido o botão "Assinar" no menu superior à direita.

{% hint style="info" %}
**Dicas:**&#x20;

* Apenas o arquivo que estiver sendo exibido no visualizador será carregado para assinatura, além disso, ele deve estar em um formato suportado;
* Usuários anônimos (externos), ao abrirem o documento por um link de acesso anônimo, podem assiná-lo digitalmente.&#x20;
  {% endhint %}

![Acesso à funcionalidade pelo módulo de Edição
](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos001.jpg)

Já a assinatura pelo serviço de **conversão**, sempre que o arquivo for convertido para o formato PDF será automaticamente assinado com um determinado certificado utilizado na configuração.

{% hint style="info" %}
**Dica:** para conseguir assinar os arquivos, é necessário instalar um certificado válido (.pfx) em sua máquina.
{% endhint %}

Na **visualização** ou **edição** do documento, ao clicar no botão "Assinar', será exibido um modal para com a lista de certificados instalados em sua máquina. Após selecionar o certificado, o arquivo será **assinado e convertido para PDF**, apresentando automaticamente no visualizador do Zeev docs, com a mensagem de validação da assinatura.

![Arquivo assinado](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos005.jpg)

#### Como verificar assinaturas de um arquivo <a href="#verificando-as-assinaturas-de-um-arquivo" id="verificando-as-assinaturas-de-um-arquivo"></a>

Ao **visualizar** ou **editar** um arquivo, é possível verificar se ele está assinado e se a assinatura é válida. Uma mensagem é apresentada na parte inferior do visualizador do arquivo, conforme as seguintes situações:

* **Nenhuma mensagem exibida:** o arquivo não está assinado ou a funcionalidade de assinatura não está habilitada no servidor.

![Mensagem de arquivo assinado não é exibido no cabeçalho do módulo
](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos006.jpg)

* **Assinatura válida:** todas as assinaturas do arquivo são consideradas válidas (emitidas pelo ICP-Brasil).

![Mensagem de assinatura válida
](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos007.jpg)

* **Assinatura não pôde ser validada:** alguma assinatura presente no arquivo não pôde ser validada no momento da visualização. Isso pode ocorrer por falta de conexão com a internet, por exemplo, impedindo que o sistema acesse a URL do órgão certificador.

![Mensagem de assinatura que não pôde ser validada
](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos008.jpg)

* **Assinatura inválida:** alguma assinatura presente no arquivo é inválida (está expirada ou não foi emitida pelo ICP-Brasil) ou o documento sofreu alguma alteração após a última assinatura.

![Mensagem de assinatura inválida](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos010.jpg)

![Mensagem de assinaturas revogadas](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos009.jpg)

Ao clicar na mensagem será carregado um modal com detalhes sobre todas as assinaturas realizadas no arquivo. &#x20;

![Assinaturas realizadas em um arquivo
](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos011.jpg)

Também é possível efetuar o download para visualizar mais detalhes de cada certificado utilizado nas assinaturas. Para isso, clique no ícone de download no final da linha de cada assinatura.

![Informações sobre uma das assinaturas do arquivo](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos012.png)

### Como os arquivos assinados são armazenados <a href="#armazenamento-de-arquivos-assinados" id="armazenamento-de-arquivos-assinados"></a>

Ao assinar um arquivo, é possível selecionar entre:

* **Substituir o arquivo original**: ao assinar um arquivo, o antigo será substituído pelo novo.
* **Criar uma versão do arquivo**, a cada vez que uma assinatura for realizada: ao assinar um arquivo, será criada uma versão, assim, o histórico de assinaturas ou modificações será mantido.\
  É possível visualizar o histórico de versões clicando no número da versão corrente e selecionando a versão que deseja visualizar. Logo após será exibido o(s) arquivo(s) referente(s) à versão selecionada.

![Versionamento de arquivo assinado](https://docs.zeev.it/upload/ecm3/Assinar-arquivos/AssinarArquivos013.jpg)

### Formatos de arquivos que podem ser assinados <a href="#formatos-de-arquivos-suportados" id="formatos-de-arquivos-suportados"></a>

Os formatos de arquivos que podem ser assinados no Zeev docs são:

* Documentos .pdf
* Documento do Microsoft Office
  * Word
    * .doc
    * .docx
    * .rtf
    * .odt
* Excel
  * .xls
  * .xlsb
  * .xlsx
  * .ods
* PowerPoint
  * .ppt
  * .pptx
  * .odp
* Imagens
  * .bmp
  * .dib
  * .gif
  * .jpg
  * .jpeg
  * .jpe
  * .jfif
  * .png
  * .wmf
  * .tif
  * .tiff
* Arquivos de texto
  * .txt
  * .html (página web)
  * .htm (página web)
* Microsoft Works
  * .wps
  * .wpd

{% hint style="warning" %}
**Importante:** após serem assinados, os arquivos serão **convertidos para PDF** (esse processo acontece automaticamente).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeevdocs/dia-a-dia-no-zeev-docs/como-consultar-documentos/como-assinar-arquivos-digitalmente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
