Marcas de validação em PDF - Rest PKI Core
Antes da primeira assinatura de um PDF, o Rest PKI Core pode gerar uma cópia dele com marcas de validação: elementos visuais, como o link para verificar o documento, que ajudam quem lê o PDF a conferir a assinatura. A aparência das marcas vem das opções de marcação da organização (subscription). Essa cópia é o arquivo marcado, e é ela que recebe a assinatura quando o PDF é marcado.
O arquivo marcado aparece como markedFile no resumo do documento (GET api/documents/{id}) e nas notificações por webhook.
Ele só existe quando o arquivo original é um PDF e foi marcado; caso contrário, é nulo. Aplicações que fazem assinaturas CMS de PDFs podem entregar
o arquivo marcado ao usuário no lugar do arquivo .p7s: ele é um PDF que qualquer pessoa consegue abrir. Em assinaturas CMS destacadas (detached),
o arquivo marcado é o arquivo de dados que corresponde ao .p7s.
Uma cossignatura de um documento que já foi assinado no sistema nunca recebe marcas. A marcação só se aplica às assinaturas feitas por api/signature (duas etapas) e por sessões de assinatura; as APIs compatíveis com o Rest PKI legado não marcam o PDF.
Política de marcação
A política de marcação do PDF decide se o PDF é marcado antes de ser assinado e o que acontece quando as marcas não podem ser adicionadas. Adicionar marcas a um PDF que já tem assinaturas as invalidaria, e é aí que as políticas se diferenciam:
| Valor | No dashboard | Comportamento |
|---|---|---|
Never | Nunca | Nenhuma marca é adicionada: o PDF original é assinado. |
WhenPossible (padrão) | Quando possível | O Rest PKI Core tenta adicionar as marcas. Se o PDF enviado já tem assinaturas (por exemplo, foi assinado fora do sistema), o arquivo marcado é descartado sem aviso e o PDF original é assinado. |
Always | Sempre | As marcas são obrigatórias. Se o PDF enviado já tem assinaturas, a assinatura em duas etapas falha com o código PdfAlreadySigned e, na sessão de assinatura, o signatário vê o erro de arquivo já assinado. |
Configuração
A política é definida por organização, na opção Política de marcação do PDF do dashboard. A opção Usar padrão do sistema deixa a organização
sem política própria, e vale então a configuração Pdf:MarkingPolicy da instância, cujo padrão é WhenPossible. Veja
Configurações de PDF. A política não é escolhida por requisição.
Não confunda com as marcas personalizadas de uma assinatura PAdES (PdfSignatureOptions.Marks) nem com as marcas de api/pdf/AddMarks: são
outros recursos, descritos em Carimbos em PDF.