Verificación de actas DossierAI
Estas instrucciones permiten comprobar la firma del registro de emisión y si el PDF recibido coincide exactamente con el emitido. Con el paquete privado completo también se comprueban el certificado asociado y la huella del archivo de la evidencia.
1. Obtenga el material
- Conserve el PDF recibido. Abra la dirección de verificación o el código QR que aparecen en él.
- Descargue el paquete público y guárdelo como
paquete.json. Contiene el registro de emisión, sus bytes firmados, su firma y las claves públicas aplicables. - Para comprobar el certificado y la evidencia, solicite a una persona autorizada el paquete completo desde el historial privado de la plataforma. Guárdelo como
paquete-privado.json.
La consulta pública de una exportación de informe permite comprobar su registro y comparar un PDF local. El informe y el certificado completo se descargan únicamente con acceso autorizado.
2. Obtenga las claves desde su publicación de confianza
Descargue el manifiesto de producción desde esta dirección y guárdelo como claves-confiables.json:
curl --fail --output claves-confiables.json https://dossierai.io/.well-known/dossierai-forensic-keys.jsonCompruebe el identificador de la clave de firma (kid) y su huella SHA-256. La huella identifica los bytes DER SPKI de la clave pública. El manifiesto conserva las claves públicas anteriores para verificar emisiones históricas.
Utilice este manifiesto obtenido por separado como referencia de confianza. Una clave incluida únicamente en un paquete recibido no acredita por sí sola que pertenezca a DossierAI.
Las emisiones de desarrollo, test y desarrollo local se verifican con el manifiesto de la API de su propio entorno, indicado en el acta. Sus claves no forman parte del manifiesto de producción.
La vigencia publicada corresponde a la información del emisor; las fechas del registro proceden de DossierAI. Una clave retirada de nuevas firmas puede seguir verificando emisiones históricas.
3. Verifique con el script sin dependencias
Necesita Node.js 20 o superior. El script utiliza únicamente funciones incluidas en Node.js y trabaja con los archivos locales. No necesita instalar paquetes ni enviar el PDF o la evidencia a DossierAI.
Descargar script de verificaciónColoque el script y los archivos en la misma carpeta. Para comprobar el registro y el PDF:
node verify-forensic-package.mjs paquete.json claves-confiables.json documento.pdf --extract verificacionPara comprobar también el certificado y el archivo de la evidencia con el paquete privado:
node verify-forensic-package.mjs paquete-privado.json claves-confiables.json documento.pdf evidencia.bin --extract verificacion-completaLas carpetas de extracción deben ser nuevas. Los archivos *.signed.bin contienen los bytes exactos firmados; el perito no necesita reconstruir la canonicalización JSON.
El script comprueba el manifiesto de confianza, el entorno, las firmas Ed25519, la relación entre el JSON y sus bytes firmados, y las huellas que vinculan los archivos. Finaliza con código 0 cuando las comprobaciones solicitadas son correctas y con código 1 si no se completan.
En certificados HMAC del esquema anterior, la comprobación independiente cubre la firma Ed25519 del registro de emisión, la huella del certificado y las huellas vinculadas. La autenticación HMAC original es interna de DossierAI y requiere un secreto que no se entrega.
Certificado descargado desde el modal forense
El botón del certificado entrega un paquete privado con el JSON original, los bytes exactos firmados, la firma y la clave pública aplicable. No crea una emisión nueva.
node verify-forensic-package.mjs certificado.json claves-confiables.json evidencia.bin --extract verificacion-certificadoEste paquete permite comprobar la firma Ed25519 del certificado y, si se aporta, la huella de la evidencia. La comprobación de un acta concreta requiere además su registro de emisión y su PDF. Para un certificado HMAC sin registro Ed25519 asociado, el script indica que la autenticación es interna y termina con código 2; este resultado no equivale a verificar públicamente el HMAC.
4. Repita la comprobación con OpenSSL 3.0 o superior
Compruebe su versión:
openssl versionEstos comandos requieren OpenSSL 3.0 o superior con Ed25519 y pkeyutl -rawin. El comando openssl disponible en macOS puede ser LibreSSL. Si no dispone de OpenSSL compatible, utilice siempre como alternativa el script sin dependencias del paso 3.
Después de extraer el paquete, compruebe la firma del registro sobre sus bytes exactos:
openssl pkeyutl -verify -pubin -keyform DER -inkey verificacion/issuance.public.spki.der -rawin -in verificacion/issuance.signed.bin -sigfile verificacion/issuance.sigCon un paquete privado cuyo certificado sea Ed25519, compruebe además la firma del certificado:
openssl pkeyutl -verify -pubin -keyform DER -inkey verificacion-completa/certificate.public.spki.der -rawin -in verificacion-completa/certificate.signed.bin -sigfile verificacion-completa/certificate.sigCompare las huellas completas con las incluidas en el registro y, para la evidencia, en el certificado:
openssl dgst -sha256 documento.pdf
openssl dgst -sha256 verificacion-completa/certificate.original.json
openssl dgst -sha256 evidencia.binEl resultado esperado para cada firma Ed25519 es Signature Verified Successfully. Las huellas SHA-256 deben coincidir íntegramente. El certificado original se utiliza con sus bytes conservados, incluidos sus espacios y saltos de línea.
Referencias técnicas: OpenSSL pkeyutl y RFC 8785.
Contenido eliminado y documentos anteriores
Si el PDF o la copia del certificado ya no se conservan en DossierAI, permanece el registro mínimo firmado. Con su paquete público y el PDF que usted conserve puede seguir comprobando la firma del registro y la coincidencia del documento.
Las emisiones con plantillas acta-1 y report-1 conservan su número y sus bytes originales. También se verifican con estas instrucciones cuando cuentan con un registro de emisión. Una consulta de certificado sin una emisión concreta de PDF permite comprobar ese certificado, sin atribuir una emisión a un PDF presentado.
Escanear un QR consulta un registro. Para comprobar el PDF recibido es necesario calcular la huella de ese archivo. Las comprobaciones se refieren a las firmas y a las huellas de los archivos examinados.