> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/cess/duvidas-frequentes.md).

# 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).
