Some test text!

Loading...
Guides

PDFTron Custom Security Handler using JavaScript

The PDFTron Custom Security Handler provides a means to encrypt files in a way that cannot be decrypted by other applications. This makes it especially suitable for Digital Rights Management (DRM) use cases. This is an alternative to defining your own custom encryption method. In particular using the PDFTron Custom Security Handler is much simpler as it comes built-in with PDFTron SDK.

Like other encryption methods a password is required to encrypt and decrypt the document. This custom security handler also requires the application choose a unique unsigned integer custom id (typically one per application) of their choice to encrypt and decrypt the document. Using this unique id provides an extra level of security as even other applications based on PDFTron SDK will not typically be configured to open files secured with that particular id.

Encrypting a PDFTron Custom secured document using the password and application custom id

The first step before encrypting is to choose an application custom id. A typical way to create this is to use a random generator to create a 32-bit number. This number would then be used throughout your document workflow.

Note that when using WebViewer you would generally perform the encryption on the server side, but the code is shown below for reference and will look similar on the server.

Once that is done, the document can be encrypted:

<html>
  <script src="../lib/core/webviewer-core.min.js"></script>
  <script src="../lib/core/pdf/PDFNet.js"></script>
  <script>
    (async function() {
      Core.setWorkerPath('../lib/core');
      const PDFNet = Core.PDFNet;

      const doc = await PDFNet.PDFDoc.createFromURL(fileURL);

      // Create PDFTron custom security handler with a custom id. Replace this with your own integer
      const customHandler = await PDFNet.PDFTronCustomSecurityHandler.create(myCustomId);

      // Set a new password required to open a document
      customHandler.changeUserPasswordUString(myPassword);

      // Note: document takes the ownership of customHandler.
      doc.setSecurityHandler(customHandler);

      // Save the encrypted document
      const docArrayBuffer = await doc.saveMemoryBuffer(PDFNet.SDFDoc.SaveOptions.e_remove_unused);
    })()
  </script>
</html>

Encrypt and Decrypt PDF Files
Full sample code which illustrates some of our encryption support.

Decrypting a PDFTron Custom secured document using the password and application custom id

The same application custom id and password using during encryption are required for decryption. Failing to provide the correct password or application custom id will prevent opening the encrypted document.

To decrypt a PDF with PDFTron Custom security:

If you're opening the file through the WebViewer UI or WebViewer Core then you can use the customHandlerId option in loadDocument.

With the WebViewer UI:

WebViewer({
  // options
}, viewerElement)
.then(instance => {
  instance.UI.loadDocument('secure.pdf', {
    password: 'password',
    customHandlerId: 42
  });
});

With the WebViewer Core:

myDocumentViewerInstance.loadDocument('secure.pdf', {
  password: (callback) => {
    return callback('password');
  },
  customHandlerId: 42
});

If you would like to use the full API to do this with a PDFDoc in memory:

<html>
  <script src="../lib/core/webviewer-core.min.js"></script>
  <script src="../lib/core/pdf/PDFNet.js"></script>
  <script>
    (async function() {
      Core.setWorkerPath('../lib/core');
      // Register the PDFTron Custom Security handler with the same custom id used in encryption.
      // Calling this function is a requirement to load files encrypted with PDFTronCustomSecurityHandler.
      await PDFNet.addPDFTronCustomHandler(myCustomId);

      const doc_enc = await PDFNet.PDFDoc.createFromURL(filename);
      if ((await doc_enc.initStdSecurityHandlerUString(myPassword))) {
        // The password is correct! Document can now be used for reading and editing
      }
    })()
  </script>
</html>

Encrypt and Decrypt PDF Files
Full sample code which illustrates some of our encryption support.

Get the answers you need: Support

Upcoming Webinar: Customer Experience and Retaining Control: Boosting Document Automation and Efficiency in Financial Services | Sept 15, 2022 at 11 am PT

PDFTron SDK

The Platform

NEW

© 2022 PDFTron Systems Inc. All rights reserved.

Privacy

Terms of Use