Tornar determinística a serialização de JSON antes de calcular hashes

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Defina um contrato de serialização restrito antes de calcular o hash de JSON e diferencie a saída repetível do Python de um JSON canônico válido entre linguagens.

Defina o domínio de dados aceito

Para uma impressão digital (fingerprint) interna, usada apenas em Python, restrinja a entrada a objetos com chaves do tipo string, listas, strings, booleanos, null e inteiros, caso a equivalência de ponto flutuante não seja necessária. Rejeite valores não suportados em vez de convertê-los silenciosamente.

Exemplo de serializador

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()

A documentação do Python descreve a ordenação de chaves e as opções de serialização JSON. A função pressupõe que a entrada já passou pela validação do domínio escolhido; ela não é um validador completo de canonicalização.

Fixtures de aceitação

Objetos com as mesmas chaves string, inseridas em ordens diferentes, devem gerar o mesmo hash. Listas com a ordem dos elementos diferente não devem gerar o mesmo hash. Rejeite NaN e infinito. Decida explicitamente se 1 e 1.0, ou strings Unicode normalizadas de formas diferentes, representam o mesmo valor para a aplicação.

Limites

Não use esta função como formato de assinatura interoperável sem um esquema de canonicalização especificado para várias linguagens e sem vetores de teste compartilhados. Guarde a versão da serialização junto com os hashes armazenados, para que uma mudança posterior no codificador ou na política de domínio não seja confundida com adulteração do conteúdo.

Escopo e base

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.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

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.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.