conferência pericial

Verificar um documento por conta própria

Todo documento fechado na UseSign recebe um manifesto de evidências: um arquivo com os códigos do documento, quem assinou, como cada pessoa foi identificada e o resumo da trilha — assinado com a chave da plataforma. Esta página explica como conferir a assinatura desse arquivo sem depender de nós.

Só quer saber se um documento é legítimo?

Não é preciso nada disto. Em usesign.com.br/validar você solta o PDF e vê na hora quem assinou, quando, e se algum byte mudou desde o fechamento — sem conta, sem instalar nada e sem digitar comando.

O que está nesta página é o caminho pericial: conferir a assinatura criptográfica do manifesto na sua própria máquina, para uso técnico ou para contestar um documento.

Validar um documento

Por que isso importa

Uma prova que só quem a produziu consegue verificar não é prova. A chave que assina o manifesto é mantida fora do banco de dados da plataforma — e a chave pública correspondente é publicada aqui. Isso permite que qualquer pessoa, com ferramenta própria, confirme que o manifesto não foi alterado depois de assinado, inclusive por nós.

Verificar a assinatura do manifesto

O passo a passo abaixo confirma a assinatura criptográfica sem passar por nenhum servidor nosso. Ele pressupõe linha de comando e Python.

Ver os comandos

1. Baixe os três arquivos:

# o manifesto do documento (troque <código> pelo código de 32 caracteres)
curl -o manifesto.json https://usesign.com.br/v/<código>/manifesto

# a chave pública da plataforma
curl -o chave.json https://usesign.com.br/.well-known/usesign-selo.json

# o verificador — 150 linhas de Python, sem nada da UseSign dentro
curl -O https://usesign.com.br/verificar-manifesto.py

2. Rode:

pip install cryptography
python3 verificar-manifesto.py manifesto.json chave.json

3. A resposta é uma das duas:

A ASSINATURA CONFERE.

O manifesto não foi alterado desde que a UseSign o assinou. Os códigos do documento e o resumo da trilha que ele declara são os que existiam quando o documento foi fechado.

A ASSINATURA NÃO CONFERE.

O manifesto foi alterado depois de assinado, ou não corresponde a esta chave.

4. Por fim, compare o arquivo em mãos com o código que o manifesto declara em SHA-256 assinado:

shasum -a 256 documento.pdf

Prefere não instalar nada?

O verificador é um arquivo de texto e pode ser lido antes de rodar — ele tem 150 linhas e nenhuma dependência da UseSign. Se preferir escrever o seu, as instruções exatas do que é assinado estão dentro do próprio manifesto, no campo como_verificar, e a chave pública está em /selo (o mesmo conteúdo servido em /.well-known/usesign-selo.json).

O que este selo atesta

O selo atesta que a UseSign emitiu aquele artefato e aquela trilha, e que nenhum dos dois mudou desde então. A data e a hora registradas são as do relógio da plataforma, em sincronia com o horário oficial do Brasil.