Qué necesitás
- El documento, en JSON (por ejemplo
documento.json). - Python 3, sin instalar nada más.
- OpenSSL 3.0 o posterior. El
/usr/bin/opensslde macOS es LibreSSL y no lee claves Ed25519: usá el de Homebrew (brew install openssl@3). - La clave pública de Blockgence, guardada como
blockgence-evidencia.pub.pem.
1
Recalcular la huella del contenido
Quitá Tiene que dar lo mismo que
manifest.integrity, ordená las claves, serializá sin espacios en UTF-8 y aplicá sha256:manifest.integrity.digest. Si no coincide, el documento cambió y no hace falta seguir.2
Armar el mensaje firmado
El mensaje es el texto
blockgence-integrity-v1:sha256: seguido de la huella que calculaste en el paso 1. Usá siempre la huella recalculada, nunca la que trae el documento.3
Extraer la firma
La firma es el campo
value de manifest.integrity.attestations.signature, en base64:4
Verificar con la clave publicada
Verificá con la clave bajada de la página de la clave pública, no con la que trae el documento:Tiene que responder
Signature Verified Successfully. Como se verifica con la clave publicada, una firma hecha con otra clave falla acá.5
Opcional: comparar la huella de la clave del documento
Guardá el El resultado se compara con el hex de
public_key_pem del documento en pub.pem. Esto tiene que dar el key_id publicado:sha256:d8853d1c1b7322b8b7e3bab730fccd0652c0c97a825c3317b3bc705d650f5c5f.manifest.integrity.recipe y la de la firma con OpenSSL en attestations.signature.verify_openssl.
Qué significa cada resultado
Qué prueba la firma y qué no
Prueba
Prueba
Que el documento lo emitió quien tiene la clave privada de Blockgence y que no cambió desde que se firmó.
No prueba que el contenido sea verdadero o completo
No prueba que el contenido sea verdadero o completo
Eso lo sostienen la metodología, las fuentes y lo que el propio documento declara que no pudo ver.
No prueba la hora
No prueba la hora
manifest.generated_at lo pone el propio sistema y no lo certifica un tercero. Una cota la da el sello de tiempo, si el documento lo trae.Verificar el sello de tiempo
Si el documento traeattestations.timestamp, la huella se puede anclar en Bitcoin con el cliente oficial de OpenTimestamps. El sello está apagado por defecto: muchos documentos no lo traen, y lo dicen en timestamp_note.
1
Bajar la prueba completa
La prueba que trae el documento es la pendiente, porque el documento no cambia después de emitirse. Esperá la confirmación en Bitcoin (unas horas) y bajá la completa del enlace
complete_proof_url, o de GET /v1/evidence/timestamp/{digest}.ots.2
Verificar con el cliente oficial
Con la huella recalculada en el paso 1 de arriba:Necesita un nodo de Bitcoin, aunque sea podado.
3
Sin nodo de Bitcoin
ots info <huella>.ots muestra el bloque y la raíz de Merkle. Esa raíz se compara con la cabecera del bloque en cualquier explorador. La prueba arranca en la huella: ots info muestra File sha256 hash: <huella>.