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:

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

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

Note

Nosso suporte ao desenvolvedor 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 para a definição do modelo). Veja um exemplo abaixo:

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

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

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

Ou, em caso de rejeição:

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

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