pdf-lector-firmas

Verifying PDF signature

The signed PDF file has the public certificate embedded in it, so all we need to verify a PDF file is the file itself. This package is a clone from ninja-labs-tech/verify-pdf with update on dependencies, cause we got issue when installing the package with node >= 16 & npm >= 8

Installation

npm i pdf-lector-firmas

Importing

// CommonJS require
const verifyPDF = require('pdf-lector-firmas');

// ES6 imports
import verifyPDF from 'pdf-lector-firmas';

Verifying

Verify the digital signature of the pdf and extract the certificates details

Node.js

const verifyPDF = require('pdf-lector-firmas');
const signedPdfBuffer = fs.readFileSync('yourPdf');

const {
    verified,
    authenticity,
    integrity,
    expired,
    signatures
} = verifyPDF(signedPdfBuffer);

Browser

import verifyPDF from 'pdf-lector-firmas';

const readFile = (e) => {
    const file = e.target.files[0]
    let reader = new FileReader();
    reader.onload = function(e) {
        const { verified } = verifyPDF(reader.result);
    }
    reader.readAsArrayBuffer(file);
};

• signedPdfBuffer: signed PDF as buffer.
• verified: The overall status of verification process.
• authenticity: Indicates if the validity of the certificate chain and the root CA (overall in case of multiple signatures).
• integrity: Indicates if the pdf has been tampered with or not (overall in case of multiple signatures).
• expired: Indicates if any of the certificates has expired.
• signatures: Array that contains the certificate details and signatureMeta (Reason, ContactInfo, Location and Name) for each signature.

Certificates

You can get the details of the certificate chain by using the following api.

const { getCertificatesInfoFromPDF } = require('pdf-lector-firmas');  // require

import { getCertificatesInfoFromPDF } from 'pdf-lector-firmas';  // ES6

const certs = getCertificatesInfoFromPDF(signedPdfBuffer);

• signedPdfBuffer: signed PDF as buffer.

• certs:

  • issuedBy: The issuer of the certificate.
  • issuedTo: The owner of the certificate.
  • validityPeriod: The start and end date of the certificate.
  • pemCertificate: Certificate in pem format.
  • clientCertificate: true for the client certificate.

Credits

• This incredible NPM Package by ninja-labs-tech.