> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clave pública de Blockgence

> La clave Ed25519 con que Blockgence firma sus documentos, su huella, los tres lugares donde se publica y qué pasa cuando se rota o se revoca.

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

> [!NOTE]
>
> **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.

```text key_id theme={null}
sha256:d8853d1c1b7322b8b7e3bab730fccd0652c0c97a825c3317b3bc705d650f5c5f
```

```text PEM theme={null}
-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAro3Bpht0HXDL35PmxRYoDKMwaeX3rlBcCqCYszHaW20=
-----END PUBLIC KEY-----
```

```text Base64 (32 bytes crudos) theme={null}
ro3Bpht0HXDL35PmxRYoDKMwaeX3rlBcCqCYszHaW20=
```

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](https://www.blockgence.com/verificar.html).

## 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](https://docs.blockgence.com/es/methodology/verify-signature.md), 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:

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

> [card] La API
>
> `GET /v1/evidence/signing-key`, abierta: sin clave de API, sin sesión y sin créditos.

> [card] Esta documentación
>
> Esta página, con el mismo registro.

> [!NOTE]
>
> 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

```bash theme={null}
curl https://app.blockgence.com/v1/evidence/signing-key
```

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.

```json theme={null}
{
  "configured": {
    "algorithm": "ed25519",
    "key_id": "sha256:d8853d1c1b7322b8b7e3bab730fccd0652c0c97a825c3317b3bc705d650f5c5f",
    "public_key": "ro3Bpht0HXDL35PmxRYoDKMwaeX3rlBcCqCYszHaW20=",
    "public_key_pem": "-----BEGIN PUBLIC KEY-----\n…\n-----END PUBLIC KEY-----\n",
    "published_status": "active",
    "published_detail": "Es la clave vigente publicada por Blockgence (desde 2026-11-13)."
  },
  "configured_note": null,
  "published": {
    "algorithm": "ed25519",
    "web": {
      "es": "https://www.blockgence.com/verificar.html",
      "en": "https://www.blockgence.com/en/verify.html"
    },
    "active_key_id": "sha256:d8853d1c1b7322b8b7e3bab730fccd0652c0c97a825c3317b3bc705d650f5c5f",
    "keys": [{
      "key_id": "sha256:d8853d1c1b7322b8b7e3bab730fccd0652c0c97a825c3317b3bc705d650f5c5f",
      "status": "active",
      "valid_from": "2026-11-13",
      "valid_until": null,
      "revoked_at": null,
      "…": "…"
    }]
  },
  "matches_published": true,
  "signed_message": "blockgence-integrity-v1:sha256:<digest en hex>",
  "proves": "…",
  "does_not_prove": "…",
  "verify": ["…"]
}
```

La respuesta se puede cachear 5 minutos.

## Estados de una clave

| Estado | Qué quiere decir | ¿Vale lo firmado? |
| - | - | - |
| `active` | La vigente. Hay una sola. | Sí. |
| `retired` | Se reemplazó sin que se comprometiera. | Sí, lo firmado entre `valid_from` y `valid_until`. |
| `revoked` | Se comprometió, o hay sospecha. | **No**, tampoco lo fechado antes de `revoked_at`. |

> [!WARNING]
>
> 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.

> [!NOTE]
>
> **Claves retiradas y revocadas: ninguna por ahora.**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.