---
title: "Validação de arquivos - Sessões de assinatura"
description: "Como validar os arquivos escolhidos pelo usuário em sessões de assinatura do Rest PKI Core, inclusive com regra de formação de nomes por expressão regular."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/file-validation"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-10-12"
---

# Validação de arquivos - Sessões de assinatura

Você pode validar os arquivos escolhidos pelo usuário durante as sessões de assinatura utilizando os mecanismos descritos nesse artigo.

## Regra de formação de nomes de arquivos

Caso você tenha uma regra de formação para os nomes de arquivos que são aceitos, você pode configurar sua conta do Rest PKI Core para validar cada arquivo
selecionado pelo usuário usando uma expressão regular que represente a sua regra de formação.

Considere a situação hipotética em que somente sejam aceitos arquivos com nome começando com a letra `P` ou `X`, seguido de 6 dígitos e extensão `.pdf`.
Para validar essa condição, configurar-se-ia a regra de formação para:

```plaintext
^[PX]\d{6}\.pdf$
```

O usuário ficaria então impedido de escolher arquivos com nome fora desse padrão:

![Arquivo rejeitado por padrão](https://docs.lacunasoftware.com/images/rest-pki/core/file-rejected-pattern.png)

> **Observação**
>
> Nosso [suporte ao desenvolvedor](mailto:suporte@lacunasoftware.com) pode auxiliá-lo a montar a expressão regular a partir de uma descrição textual da sua
> regra de formação

## API de validação de arquivos

Também é possível configurar uma API de validação de arquivos, implementada pela sua aplicação, a ser chamada para validar cada arquivo escolhido pelo usuário.
A sua aplicação recebe o nome do arquivo (além do *MIME type* e tamanho em bytes) e retorna se o arquivo deve ou não ser aceito (e, caso negativo, o motivo da
rejeição).

A solicitação de validação consiste em uma requisição HTTP com verbo `POST` tendo como *payload* um objeto `ValidateFileRequest` (consulte a
[Referência da API](https://core.pki.rest/swagger) para a definição do modelo). Veja um exemplo abaixo:

```json
{
	"name": "P123456.pdf",
	"contentType": "application/pdf",
	"length": 2476032
}
```

A sua aplicação deve responder com um `ValidateFileResponse` conforme abaixo:

```json
{
	"accept": true,
	"rejectReason": null
}
```

Ou, em caso de rejeição:

```json
{
	"accept": false,
	"rejectReason": "Mensagem para o usuário"
}
```

A mensagem retornada pela sua aplicação será exibida para o usuário, por exemplo:

![Arquivo rejeitado por API](https://docs.lacunasoftware.com/images/rest-pki/core/file-rejected-api.png)

**Demonstrações e exemplos**

- Validate files uploaded to a Rest PKI Core signature session: [.NET](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/dotnet/mvc/PkiSuiteAspNetMvcSample/Controllers/ValidateFileRestCoreController.cs) · [Java](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/java/springmvc/src/main/java/com/lacunasoftware/pkisuite/controller/ValidateFileRestCoreController.java) · [PHP](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/php/plain/public/validate-file-rest-core/index.php)