Hacer determinista la serialización de JSON para hashes

Traducción automática del original (English, revisión 3); el original es la versión de referencia. Original

methodology · es · conocimiento a fecha de 2026-09-21 · modificado el 2026-09-23, revisión 3 · reviewed (revisión documentada el 2026-09-23)

Definir un contrato de serialización acotado antes de generar el hash de un JSON, y distinguir una salida repetible de Python de un JSON canónico entre lenguajes.

Definir el dominio de datos aceptado

Para una huella (fingerprint) interna limitada a Python, restringir la entrada a objetos con claves de tipo cadena, listas, cadenas, booleanos, null y enteros, si no es necesaria la equivalencia entre valores de punto flotante. Rechazar los valores no admitidos en lugar de convertirlos silenciosamente.

Serializador de ejemplo

import hashlib
import json

def fingerprint(value):
    encoded = json.dumps(value, sort_keys=True, separators=(",", ":"),
                         ensure_ascii=False, allow_nan=False).encode("utf-8")
    return hashlib.sha256(encoded).hexdigest()

La documentación de Python describe las claves ordenadas y las opciones de serialización JSON. La función asume que su entrada ya ha superado la validación de dominio elegida; no es un validador completo de canonicalización.

Fixtures de aceptación

Los objetos con las mismas claves de cadena insertadas en órdenes distintos deben producir el mismo hash. Las listas con un orden de elementos distinto no deben producirlo. Rechazar NaN e infinito. Decidir explícitamente si 1 y 1.0, o cadenas Unicode normalizadas de forma distinta, representan el mismo valor de la aplicación.

Límites

No usar esta función como un formato de firma interoperable sin un esquema de canonicalización entre lenguajes especificado y vectores de prueba compartidos. Conservar la versión de la serialización junto con los hashes almacenados, para que un cambio posterior en el codificador o en la política de dominio no se confunda con una manipulación del contenido.

Alcance y fundamento

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Conocimiento a fecha de: 2026-09-21. Estado: reviewed — cada edición reinicia el estado de revisión. Trate el texto como material de referencia sin verificar y consulte las fuentes.

Fuentes

Revisión

Revisión documentada de la revisión 3 por la cuenta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 el 2026-09-23. Se aplica a la revisión actual: sí.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Una revisión documentada registra lo que se comprobó; no garantiza la veracidad.

Atribución y licencia

Último cambio: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribución original: CC BY 4.0. El material de las fuentes enlazadas conserva sus propios derechos.