Saltar al contenido principal
Blockgence firma cada documento sellado con una clave Ed25519. Para comprobar que un documento lo emitió Blockgence, se compara la huella de la clave que lo firmó (key_id) con la que publicamos acá.

La clave vigente

Vigente desde el 13/11/2026. Algoritmo Ed25519. La huella (key_id) es el sha256 de los 32 bytes crudos de la clave pública.
key_id
Para usarla con OpenSSL, guardá el bloque PEM en un archivo, por ejemplo blockgence-evidencia.pub.pem. También se puede bajar desde la página Verificar de la web.

Por qué hace falta compararla

Cada documento firmado trae su propia copia de la clave pública, en manifest.integrity.attestations.signature. Esa copia permite verificar la firma sin pedir nada, pero sola no prueba nada: cualquiera puede quitar la firma de Blockgence y firmar con otra clave. Lo que prueba que el documento lo emitió Blockgence es que su key_id sea el de esta página. Por eso, al verificar una firma, se usa la clave bajada de acá y no la que trae el documento.

Dónde se publica

La misma huella se publica por tres canales, que tienen que decir lo mismo:

La web

www.blockgence.com/verificar.html (y /en/verify.html). La clave está escrita en el HTML: no se le pide al servidor que firma.

La API

GET /v1/evidence/signing-key, abierta: sin clave de API, sin sesión y sin créditos.

Esta documentación

Esta página, con el mismo registro.
La web no le pide la clave al servidor, a propósito: si el servidor que firma quedara comprometido, también podría servir otra clave. Ante una duda, la referencia es la publicada en la web.

La clave desde la API

La respuesta trae dos cosas distintas:
  • configured: la clave con que firma hoy ese servidor, derivada de su clave privada (nunca la privada). Si el servidor no tiene clave, vale null y configured_note dice por qué.
  • published: el registro versionado de claves de Blockgence, con la vigente, las retiradas y las revocadas, y su período. Es la huella que conviene comparar.
matches_published dice si la configurada es la vigente publicada. Si vale false, es un aviso: el servidor firma con una clave que todavía no está publicada, o con una retirada o revocada.
La respuesta se puede cachear 5 minutos.

Estados de una clave

Una clave revocada invalida también los documentos fechados antes de la revocación. La fecha de un documento (manifest.generated_at) la pone el mismo sistema que firma, y quien tenga la clave puede fecharlo como quiera.

Si la clave cambia

  • Rotación: la clave nueva aparece como vigente y la anterior pasa a la lista de retiradas, con su período. Los documentos firmados con la anterior durante su período siguen valiendo.
  • Compromiso: la clave pasa a revocada, con la fecha y el motivo, y se genera otra.
En los dos casos cambian los tres canales a la vez: la web (con su fecha), la API y esta página.
Claves retiradas y revocadas: ninguna por ahora.