view não é o buffer inteiro: o detalhe que muda os bytes enviados à verificação em JavaScript
Ao manipular arquivos binários no navegador, é muito comum fatiar corretamente um trecho de dados (Uint8Array) e, logo em seguida, passar a região errada para a próxima função. O problema costuma morar em uma única propriedade: view.buffer aponta para o ArrayBuffer completo usado como armazenamento subjacente, e não apenas para o intervalo recortado por aquela view. Se a view começa no meio do buffer (byteOffset > 0), trocar view por view.buffer acaba incluindo bytes extras no início ou no fim da entrada.
Em parsers de documentos assinados, imagens ou protocolos de rede, esse detalhe muda completamente o comportamento do sistema: funções de hash, comparação ou verificação criptográfica processam os bytes recebidos literalmente, não a intenção de quem escreveu a chamada. O exemplo a seguir usa valores pequenos e ilustrativos, sem representar um arquivo P7M real.
O problema reproduzido em poucas linhas
const bytes = new Uint8Array([9, 10, 11, 12, 99]);
const trecho = bytes.subarray(1, 4);
console.log([...trecho]); // [10, 11, 12]
console.log([...new Uint8Array(trecho.buffer)]); // [9, 10, 11, 12, 99]
console.log(trecho.byteOffset, trecho.byteLength); // 1, 3
O método subarray() cria uma nova view sobre a mesma região de memória. A view guarda onde começa (byteOffset) e quantos bytes abrange (byteLength), enquanto a propriedade buffer continua referenciando o armazenamento compartilhado inteiro. A documentação da MDN sobre byteOffset detalha exatamente como esse deslocamento funciona. O trecho acima não realiza nenhuma operação criptográfica; ele apenas mostra a diferença entre o recorte pretendido e os bytes expostos pelo buffer subjacente.
Como preservar os limites ao chamar outras APIs
Sempre que a API de destino aceitar uma TypedArray (como Uint8Array), passe a própria view diretamente, sem descer para .buffer. A Web Cryptography API, por exemplo, em SubtleCrypto.verify, aceita uma TypedArray tanto para os dados quanto para a assinatura. Nesse caso, algoritmo, chave, formato da assinatura e entrada precisam estar alinhados ao protocolo adotado. A Promise retornada resolve para true ou false quando a verificação é executada, mas parâmetros ou entradas malformadas também podem rejeitar com erro — resultados que não devem ser resumidos de forma genérica como um simples "arquivo válido".
Se uma biblioteca ou interface realmente exigir um ArrayBuffer isolado contendo apenas o intervalo da view, faça uma cópia exata dos limites:
const isolado = trecho.buffer.slice(
trecho.byteOffset,
trecho.byteOffset + trecho.byteLength
);
console.log([...new Uint8Array(isolado)]); // [10, 11, 12]
Essa cópia aloca memória adicional e registra os bytes naquele instante: se o buffer original compartilhado for modificado depois, isolado não acompanha a alteração. Trata-se de uma decisão de posse e isolamento de dados, não de validação de assinatura.
O que o recorte de bytes não resolve sozinho
Isolar o intervalo certo na memória evita bugs de leitura, mas não esgota a verificação de um documento assinado. Três pontos merecem atenção:
- Saber quais bytes o protocolo exige: o formato CMS, especificado na RFC 5652, encapsula estruturas ASN.1, metadados e atributos. Chamar
SubtleCrypto.verifydiretamente sobre os bytes brutos do arquivo inteiro não equivale a verificar uma assinatura CMS: um parser compatível precisa montar exatamente a entrada de verificação prevista pela especificação, interpretar o algoritmo e extrair a chave adequada. Este artigo não implementa um verificador CMS. - Separar assinatura matemática de confiança e revogação: uma verificação criptográfica que retorna
trueconfirma a integridade matemática da assinatura sobre aqueles bytes, mas não prova por si só que o certificado pertence a uma cadeia confiável, que está dentro do prazo de validade ou que não foi revogado. Mantenha essas etapas separadas na interface e nos logs, distinguindo "não verificado" de "válido" — a falta de acesso à rede para consultar revogação, por exemplo, nunca deve ser tratada como ausência de revogação. - Cuidado com dados sensíveis em produção: os exemplos deste texto usam arrays fictícios. Ao lidar com documentos reais, evite despejar buffers ou trechos de payload em logs ou consoles compartilhados. Em ferramentas que processam arquivos localmente no navegador, como o P7M Online, essa separação entre o arquivo contêiner e os bytes extraídos também é uma boa questão de arquitetura (sem que isso represente qualquer afirmação sobre a implementação interna ou recursos de diagnóstico desse produto).
Checklist rápido para revisar a passagem de bytes
- A função ou API receptora aceita uma
TypedArray(view) ou exige umArrayBufferindependente? - A view possui
byteOffsetmaior que zero oubyteLengthmenor queview.buffer.byteLength? - O intervalo recortado corresponde exatamente aos bytes exigidos pela especificação do formato e pelo algoritmo?
- Existe risco de o buffer subjacente sofrer mutação antes da conclusão da operação assíncrona, exigindo um
.slice()? - O status retornado ao usuário reflete apenas a verificação criptográfica dos bytes, ou também contempla checagens independentes de validade, cadeia de confiança e revogação do certificado?
Uma view não cria um novo arquivo nem atesta integridade: ela é apenas uma janela sobre um espaço de memória. Respeitar os limites dessa janela é um passo pequeno, mas indispensável para garantir que o restante do pipeline opere exatamente sobre os dados pretendidos.