# Dúvidas frequentes

## 1. O que é o CESS ?

O CESS é um motor de assinatura que fornece validade jurídica aos documentos assinados digitalmente, por meio do certificado ICP-Brasil.

## &#x20;2. Como posso utilizar o CESS ?

Para utilizá-lo é necessário um prévio licenciamento da ferramenta. Ademais, o cliente final precisará de um certificado emitido na nuvem ou HSM local.

## 3 . Como instalar o CESS ?&#x20;

Nossa ferramenta funciona sobre um container docker, sendo possível ser gerenciada e escalada com o kubernets. Nossa imagem do sistema contém um redis e o motor de assinatura. Todavia, caso o cliente opte por utilize seu redis previante instalado, basta configurar a variável de ambiente *redisHost* e *redisPort.* Importante configurar regra de firewall para permitir acesso apenas do container, quando utilizado outro redis a não ser da imagem.

Para mais informações de requisitos, acesse [Instalação e configuração](/workspace/cess/instalacao-e-configuracao.md)

## 4. Qual padrão de assinatura utilizar ?

Depende. O padrão a ser utilizado provém da regra de negócio e finalidade do documento. Por exemplo, para um prescrição eletrônica é necessário uma assinatura PDF. No entanto, para outro fim, um simples CAdES é suficiente. Recomendamos caso tenha alguma dúvida em qual utilizar, contatar um dos nossos colaboradores para entedermos seu negócio e o auxiliar.

## 5. O CESS persiste os arquivos assinados?

Não. Os arquivos assinados pelo motor de assinatura ficam disponíveis apenas enquanto durar o *lifetime* dos mesmos. Por isso, recomendamos que após a realização da assinatura, a aplicação do cliente realize o download do arquivo e o armazene em algum lugar persistente.

## 6. Onde posso validar os documentos assinados?

Caso seu documento seja uma prescrição eletrônica, deverá validar no site oficial do ITI: [https://assinaturadigital.iti.gov.br](https://assinaturadigital.iti.gov.br/).

Caso seu documento não seja uma prescrição eletrônica, mas seja assinado utilizando certificado ICP-Brasil, deverá ser validado no verificador oficial do ITI: <https://verificador.iti.gov.br>.

## 7. Consigo escalar o CESS?

Há duas maneiras de escalá-lo:

1. **Mantendo as instâncias sem compartilhamento de memória e disco (mais recomendada):** Para isso, é necessário realizar o download de *n* imagens do sistema e colocá-las em portas distintas, por exemplo 8080, 8081, 8082 e etc. Após este processo, a aplicação do cliente precisará "manter" o estado daquela transação, ou seja, através de um proxy reverso ele precisa identificar qual foi o *nó* que recebeu a solicitação na criação da transação e nas requisições seguintes (upload arquivo, consulta transação e download do documento) enviar para o mesmo *nó.*<br>
2. **Mantendo compartilhamento de memória e disco:** Desta forma o cliente não precisará manter o estado da transação. Todavia, é preciso mapear um volume compartilhado entre os *nós* e um *cluster* de *redis.* Apesar desse modelo ser mais simples e fácil de ser implementado, não recomendamos quando há um grande volume de assinaturas diárias (em torno de 80 \~100 mil). Porque a replicação do *redis* começa ter gargalo, afetando o desempenho da aplicação.

Observação: não provemos *failover* ou *load balance* nativament&#x65;*.* Este processo deverá ser realizado pelo cliente.

## 8. O arquivo original permanence apenas na máquina local?

Sim. O arquivo original não sai da máquina local em nenhum momento. Para realizar a assinatura, apenas o hash do arquivo é enviado à nuvem.

## 9. O que devo fazer quando disco da VM encher ?

Os casos do disco - da VM - encher são bem raros, pois temos *garbage collector* que apaga os arquivos assinados quando seu tempo de vida expirar. Todavia se o *lifetime* estiver configurado com um valor alto e os arquivos não forem apagados a tempo, o container pode travar por falta de espaço.\
Para resolver este problema, segue os passos abaixo:

1. Pare o serviço do docker: **sudo** **systemctl stop docker**
2. Remova pasta /var/lib/docker: **sudo** **rm -rf /var/lib/docker/**
3. Inicie o serviço do docker: **sudo systemctl start docker**
4. Inicie a aplicação: **docker-compose -f&#x20;*****\<nome do arquivo.yml>*****&#x20;up**

## &#x20;10 . Devo permitir o monitoramento e a coleta de informações?&#x20;

Isto é uma decisão particular. O objetivo da coleta de informações para nosso monitoramento é auxiliar os clientes na prevenção e identificação de problemas relacionados ao motor de assinatura.&#x20;

As informações coletadas são do container e não do servidor (físico ou virtual) que hospeda o CESS.&#x20;

Caso o cliente opte pelo não monitoramento, deverá configurar a variável de ambiente **sendMonitoring=false.**

Para mais detalhes sobre o monitoramento, acesse [Monitoramento](/workspace/cess/monitoramento.md).


---

# 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://docs.vaultid.com.br/workspace/cess/duvidas-frequentes.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.
