hexapdf 0.28.0 → 0.31.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hexapdf
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Thomas Leitner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-12-30 00:00:00.000000000 Z
+date: 2023-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cmdparse
@@ -291,6 +291,7 @@ files:
 - examples/021-list_box.rb
 - examples/022-outline.rb
 - examples/023-images.rb
+- examples/024-digital-signatures.rb
 - examples/emoji-smile.png
 - examples/emoji-wink.png
 - examples/machupicchu.jpg
@@ -328,6 +329,17 @@ files:
 - lib/hexapdf/data_dir.rb
 - lib/hexapdf/dictionary.rb
 - lib/hexapdf/dictionary_fields.rb
+- lib/hexapdf/digital_signature.rb
+- lib/hexapdf/digital_signature/cms_handler.rb
+- lib/hexapdf/digital_signature/handler.rb
+- lib/hexapdf/digital_signature/pkcs1_handler.rb
+- lib/hexapdf/digital_signature/signature.rb
+- lib/hexapdf/digital_signature/signatures.rb
+- lib/hexapdf/digital_signature/signing.rb
+- lib/hexapdf/digital_signature/signing/default_handler.rb
+- lib/hexapdf/digital_signature/signing/signed_data_creator.rb
+- lib/hexapdf/digital_signature/signing/timestamp_handler.rb
+- lib/hexapdf/digital_signature/verification_result.rb
 - lib/hexapdf/document.rb
 - lib/hexapdf/document/destinations.rb
 - lib/hexapdf/document/files.rb
@@ -335,7 +347,6 @@ files:
 - lib/hexapdf/document/images.rb
 - lib/hexapdf/document/layout.rb
 - lib/hexapdf/document/pages.rb
-- lib/hexapdf/document/signatures.rb
 - lib/hexapdf/encryption.rb
 - lib/hexapdf/encryption/aes.rb
 - lib/hexapdf/encryption/arc4.rb
@@ -417,6 +428,7 @@ files:
 - lib/hexapdf/layout/line.rb
 - lib/hexapdf/layout/list_box.rb
 - lib/hexapdf/layout/numeric_refinements.rb
+- lib/hexapdf/layout/page_style.rb
 - lib/hexapdf/layout/style.rb
 - lib/hexapdf/layout/text_box.rb
 - lib/hexapdf/layout/text_fragment.rb
@@ -486,11 +498,6 @@ files:
 - lib/hexapdf/type/page_label.rb
 - lib/hexapdf/type/page_tree_node.rb
 - lib/hexapdf/type/resources.rb
-- lib/hexapdf/type/signature.rb
-- lib/hexapdf/type/signature/adbe_pkcs7_detached.rb
-- lib/hexapdf/type/signature/adbe_x509_rsa_sha1.rb
-- lib/hexapdf/type/signature/handler.rb
-- lib/hexapdf/type/signature/verification_result.rb
 - lib/hexapdf/type/trailer.rb
 - lib/hexapdf/type/viewer_preferences.rb
 - lib/hexapdf/type/xref_stream.rb
@@ -587,13 +594,23 @@ files:
 - test/hexapdf/content/test_parser.rb
 - test/hexapdf/content/test_processor.rb
 - test/hexapdf/content/test_transformation_matrix.rb
+- test/hexapdf/digital_signature/common.rb
+- test/hexapdf/digital_signature/signing/test_default_handler.rb
+- test/hexapdf/digital_signature/signing/test_signed_data_creator.rb
+- test/hexapdf/digital_signature/signing/test_timestamp_handler.rb
+- test/hexapdf/digital_signature/test_cms_handler.rb
+- test/hexapdf/digital_signature/test_handler.rb
+- test/hexapdf/digital_signature/test_pkcs1_handler.rb
+- test/hexapdf/digital_signature/test_signature.rb
+- test/hexapdf/digital_signature/test_signatures.rb
+- test/hexapdf/digital_signature/test_signing.rb
+- test/hexapdf/digital_signature/test_verification_result.rb
 - test/hexapdf/document/test_destinations.rb
 - test/hexapdf/document/test_files.rb
 - test/hexapdf/document/test_fonts.rb
 - test/hexapdf/document/test_images.rb
 - test/hexapdf/document/test_layout.rb
 - test/hexapdf/document/test_pages.rb
-- test/hexapdf/document/test_signatures.rb
 - test/hexapdf/encryption/common.rb
 - test/hexapdf/encryption/test_aes.rb
 - test/hexapdf/encryption/test_arc4.rb
@@ -663,6 +680,7 @@ files:
 - test/hexapdf/layout/test_inline_box.rb
 - test/hexapdf/layout/test_line.rb
 - test/hexapdf/layout/test_list_box.rb
+- test/hexapdf/layout/test_page_style.rb
 - test/hexapdf/layout/test_style.rb
 - test/hexapdf/layout/test_text_box.rb
 - test/hexapdf/layout/test_text_fragment.rb
@@ -705,11 +723,6 @@ files:
 - test/hexapdf/type/annotations/test_markup_annotation.rb
 - test/hexapdf/type/annotations/test_text.rb
 - test/hexapdf/type/annotations/test_widget.rb
-- test/hexapdf/type/signature/common.rb
-- test/hexapdf/type/signature/test_adbe_pkcs7_detached.rb
-- test/hexapdf/type/signature/test_adbe_x509_rsa_sha1.rb
-- test/hexapdf/type/signature/test_handler.rb
-- test/hexapdf/type/signature/test_verification_result.rb
 - test/hexapdf/type/test_annotation.rb
 - test/hexapdf/type/test_catalog.rb
 - test/hexapdf/type/test_cid_font.rb
@@ -732,7 +745,6 @@ files:
 - test/hexapdf/type/test_page_label.rb
 - test/hexapdf/type/test_page_tree_node.rb
 - test/hexapdf/type/test_resources.rb
-- test/hexapdf/type/test_signature.rb
 - test/hexapdf/type/test_trailer.rb
 - test/hexapdf/type/test_xref_stream.rb
 - test/hexapdf/utils/test_bit_field.rb

data/lib/hexapdf/document/signatures.rb

@@ -1,546 +0,0 @@
-# -*- encoding: utf-8; frozen_string_literal: true -*-
-#
-#--
-# This file is part of HexaPDF.
-#
-# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
-#
-# HexaPDF is free software: you can redistribute it and/or modify it
-# under the terms of the GNU Affero General Public License version 3 as
-# published by the Free Software Foundation with the addition of the
-# following permission added to Section 15 as permitted in Section 7(a):
-# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
-# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
-# INFRINGEMENT OF THIRD PARTY RIGHTS.
-#
-# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
-# License for more details.
-#
-# You should have received a copy of the GNU Affero General Public License
-# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
-#
-# The interactive user interfaces in modified source and object code
-# versions of HexaPDF must display Appropriate Legal Notices, as required
-# under Section 5 of the GNU Affero General Public License version 3.
-#
-# In accordance with Section 7(b) of the GNU Affero General Public
-# License, a covered work must retain the producer line in every PDF that
-# is created or manipulated using HexaPDF.
-#
-# If the GNU Affero General Public License doesn't fit your need,
-# commercial licenses are available at <https://gettalong.at/hexapdf/>.
-#++
-
-require 'openssl'
-require 'net/http'
-require 'hexapdf/error'
-require 'stringio'
-
-module HexaPDF
-  class Document
-
-    # This class provides methods for interacting with digital signatures of a PDF file.
-    class Signatures
-
-      # This is the default signing handler which provides the ability to sign a document with the
-      # adbe.pkcs7.detached or ETSI.CAdES.detached algorithms. It is registered under the :default
-      # name.
-      #
-      # == Usage
-      #
-      # The signing handler is used by default by all methods that need a signing handler. Therefore
-      # it is usually only necessary to provide the actual attribute values.
-      #
-      # This handler provides two ways to create the PKCS#7 signed-data structure required by
-      # Signatures#add:
-      #
-      # * By providing the signing certificate together with the signing key and the certificate
-      #   chain. This way HexaPDF itself does the signing. It is the preferred way if all the needed
-      #   information is available.
-      #
-      #   Assign the respective data to the #certificate, #key and #certificate_chain attributes.
-      #
-      # * By using an external signing mechanism. Here the actual signing happens "outside" of
-      #   HexaPDF, for example, in custom code or even asynchronously. This is needed in case the
-      #   signing certificate plus key are not directly available but only an interface to them
-      #   (e.g. when dealing with a HSM).
-      #
-      #   Assign a callable object to #external_signing. If the signing process needs to be
-      #   asynchronous, make sure to set the #signature_size appropriately, return an empty string
-      #   during signing and later use Signatures.embed_signature to embed the actual signature.
-      #
-      # Additional functionality:
-      #
-      # * Optionally setting the reason, location and contact information.
-      # * Making the signature a certification signature by applying the DocMDP transform method.
-      #
-      # Example:
-      #
-      #   # Signing using certificate + key
-      #   document.sign("output.pdf", certificate: my_cert, key: my_key,
-      #                 certificate_chain: my_chain)
-      #
-      #   # Signing using an external mechanism:
-      #   signing_proc = lambda do |io, byte_range|
-      #     io.pos = byte_range[0]
-      #     data = io.read(byte_range[1])
-      #     io.pos = byte_range[2]
-      #     data << io.read(byte_range[3])
-      #     signing_service.pkcs7_sign(data)
-      #   end
-      #   document.sign("output.pdf", signature_size: 10_000, external_signing: signing_proc)
-      #
-      # == Implementing a Signing Handler
-      #
-      # This class also serves as an example on how to create a custom handler: The public methods
-      # #signature_size, #finalize_objects and #sign are used by the digital signature algorithm.
-      # See their descriptions for details.
-      #
-      # Once a custom signing handler has been created, it can be registered under the
-      # 'signature.signing_handler' configuration option for easy use. It has to take keyword
-      # arguments in its initialize method to be compatible with the Signatures#handler method.
-      class DefaultHandler
-
-        # The certificate with which to sign the PDF.
-        attr_accessor :certificate
-
-        # The private key for the #certificate.
-        attr_accessor :key
-
-        # The certificate chain that should be embedded in the PDF; normally contains all
-        # certificates up to the root certificate.
-        attr_accessor :certificate_chain
-
-        # A callable object fulfilling the same role as the #sign method that is used instead of the
-        # default mechanism for signing.
-        #
-        # If this attribute is set, the attributes #certificate, #key and #certificate_chain are not
-        # used.
-        attr_accessor :external_signing
-
-        # The reason for signing. If used, will be set on the signature object.
-        attr_accessor :reason
-
-        # The signing location. If used, will be set on the signature object.
-        attr_accessor :location
-
-        # The contact information. If used, will be set on the signature object.
-        attr_accessor :contact_info
-
-        # The size of the serialized signature that should be reserved.
-        #
-        # If this attribute has not been set, an empty string will be signed using #sign to
-        # determine the signature size.
-        #
-        # The size needs to be at least as big as the final signature, otherwise signing results in
-        # an error.
-        attr_writer :signature_size
-
-        # The type of signature to be written (i.e. the value of the /SubFilter key).
-        #
-        # The value can either be :adobe (the default; uses a detached PKCS7 signature) or :etsi
-        # (uses an ETSI CAdES compatible signature).
-        attr_accessor :signature_type
-
-        # The DocMDP permissions that should be set on the document.
-        #
-        # See #doc_mdp_permissions=
-        attr_reader :doc_mdp_permissions
-
-        # Creates a new DefaultHandler with the given attributes.
-        def initialize(**arguments)
-          @signature_size = nil
-          arguments.each {|name, value| send("#{name}=", value) }
-        end
-
-        # Sets the DocMDP permissions that should be applied to the document.
-        #
-        # Valid values for +permissions+ are:
-        #
-        # +nil+::
-        #     Don't set any DocMDP permissions (default).
-        #
-        # +:no_changes+ or 1::
-        #     No changes whatsoever are allowed.
-        #
-        # +:form_filling+ or 2::
-        #     Only filling in forms and signing are allowed.
-        #
-        # +:form_filling_and_annotations+ or 3::
-        #     Only filling in forms, signing and annotation creation/deletion/modification are
-        #     allowed.
-        def doc_mdp_permissions=(permissions)
-          case permissions
-          when :no_changes, 1 then @doc_mdp_permissions = 1
-          when :form_filling, 2 then @doc_mdp_permissions = 2
-          when :form_filling_and_annotations, 3 then @doc_mdp_permissions = 3
-          when nil then @doc_mdp_permissions = nil
-          else
-            raise ArgumentError, "Invalid permissions value '#{permissions.inspect}'"
-          end
-        end
-
-        # Returns the size of the serialized signature that should be reserved.
-        #
-        # If a custom size is set using #signature_size=, it used. Otherwise the size is determined
-        # by using #sign to sign an empty string.
-        def signature_size
-          @signature_size || sign(StringIO.new, [0, 0, 0, 0]).size
-        end
-
-        # Finalizes the signature field as well as the signature dictionary before writing.
-        def finalize_objects(_signature_field, signature)
-          signature[:SubFilter] = :'ETSI.CAdES.detached' if signature_type == :etsi
-          signature[:Reason] = reason if reason
-          signature[:Location] = location if location
-          signature[:ContactInfo] = contact_info if contact_info
-
-          if doc_mdp_permissions
-            doc = signature.document
-            if doc.signatures.count > 1
-              raise HexaPDF::Error, "Can set DocMDP access permissions only on first signature"
-            end
-            params = doc.add({Type: :TransformParams, V: :'1.2', P: doc_mdp_permissions})
-            sigref = doc.add({Type: :SigRef, TransformMethod: :DocMDP, DigestMethod: :SHA1,
-                              TransformParams: params})
-            signature[:Reference] = [sigref]
-            (doc.catalog[:Perms] ||= {})[:DocMDP] = signature
-          end
-        end
-
-        # Returns the DER serialized OpenSSL::PKCS7 structure containing the signature for the given
-        # IO byte ranges.
-        #
-        # The +byte_range+ argument is an array containing four numbers [offset1, length1, offset2,
-        # length2]. The offset numbers are byte positions in the +io+ argument and the to-be-signed
-        # data can be determined by reading length bytes at the offsets.
-        def sign(io, byte_range)
-          if external_signing
-            external_signing.call(io, byte_range)
-          else
-            io.pos = byte_range[0]
-            data = io.read(byte_range[1])
-            io.pos = byte_range[2]
-            data << io.read(byte_range[3])
-            OpenSSL::PKCS7.sign(@certificate, @key, data, @certificate_chain,
-                                OpenSSL::PKCS7::DETACHED | OpenSSL::PKCS7::BINARY).to_der
-          end
-        end
-
-      end
-
-      # This is a signing handler for adding a timestamp signature (a PDF2.0 feature) to a PDF
-      # document. It is registered under the :timestamp name.
-      #
-      # The timestamp is provided by a timestamp authority and establishes the document contents at
-      # the time indicated in the timestamp. Timestamping a PDF document is usually done in context
-      # of long term validation but can also be done standalone.
-      #
-      # == Usage
-      #
-      # It is necessary to provide at least the URL of the timestamp authority server (TSA) via
-      # #tsa_url, everything else is optional and uses default values. The TSA server must not use
-      # authentication to be usable.
-      #
-      # Example:
-      #
-      #   document.sign("output.pdf", handler: :timestamp, tsa_url: 'https://freetsa.org/tsr')
-      class TimestampHandler
-
-        # The URL of the timestamp authority server.
-        #
-        # This value is required.
-        attr_accessor :tsa_url
-
-        # The hash algorithm to use for timestamping. Defaults to SHA512.
-        attr_accessor :tsa_hash_algorithm
-
-        # The policy OID to use for timestamping. Defaults to +nil+.
-        attr_accessor :tsa_policy_id
-
-        # The size of the serialized signature that should be reserved.
-        #
-        # If this attribute has not been set, an empty string will be signed using #sign to
-        # determine the signature size which will contact the TSA server
-        #
-        # The size needs to be at least as big as the final signature, otherwise signing results in
-        # an error.
-        attr_writer :signature_size
-
-        # The reason for timestamping. If used, will be set on the signature object.
-        attr_accessor :reason
-
-        # The timestamping location. If used, will be set on the signature object.
-        attr_accessor :location
-
-        # The contact information. If used, will be set on the signature object.
-        attr_accessor :contact_info
-
-        # Creates a new TimestampHandler with the given attributes.
-        def initialize(**arguments)
-          @signature_size = nil
-          arguments.each {|name, value| send("#{name}=", value) }
-        end
-
-        # Returns the size of the serialized signature that should be reserved.
-        def signature_size
-          @signature_size || (sign(StringIO.new, [0, 0, 0, 0]).size * 1.5).to_i
-        end
-
-        # Finalizes the signature field as well as the signature dictionary before writing.
-        def finalize_objects(_signature_field, signature)
-          signature.document.version = '2.0'
-          signature[:Type] = :DocTimeStamp
-          signature[:SubFilter] = :'ETSI.RFC3161'
-          signature[:Reason] = reason if reason
-          signature[:Location] = location if location
-          signature[:ContactInfo] = contact_info if contact_info
-        end
-
-        # Returns the DER serialized OpenSSL::PKCS7 structure containing the timestamp token for the
-        # given IO byte ranges.
-        def sign(io, byte_range)
-          hash_algorithm = tsa_hash_algorithm || 'SHA512'
-          digest = OpenSSL::Digest.new(hash_algorithm)
-          io.pos = byte_range[0]
-          digest << io.read(byte_range[1])
-          io.pos = byte_range[2]
-          digest << io.read(byte_range[3])
-
-          req = OpenSSL::Timestamp::Request.new
-          req.algorithm = hash_algorithm
-          req.message_imprint = digest.digest
-          req.policy_id = tsa_policy_id if tsa_policy_id
-
-          http_response = Net::HTTP.post(URI(tsa_url), req.to_der,
-                                         'content-type' => 'application/timestamp-query')
-          if http_response.kind_of?(Net::HTTPOK)
-            response = OpenSSL::Timestamp::Response.new(http_response.body)
-            if response.status == 0
-              response.token.to_der
-            else
-              raise HexaPDF::Error, "Timestamp token could not be created: #{response.failure_info}"
-            end
-          else
-            raise HexaPDF::Error, "Invalid TSA server response: #{http_response.body}"
-          end
-        end
-
-      end
-
-      # Embeds the given +signature+ into the /Contents value of the newest signature dictionary of
-      # the PDF document given by the +io+ argument.
-      #
-      # This functionality can be used together with the support for external signing (see
-      # DefaultHandler and DefaultHandler#external_signing) to implement asynchronous signing.
-      #
-      # Note: This will, most probably, only work on documents prepared for external signing by
-      # HexaPDF and not by other libraries.
-      def self.embed_signature(io, signature)
-        doc = HexaPDF::Document.new(io: io)
-        signature_dict = doc.signatures.find {|sig| doc.revisions.current.object(sig) == sig }
-        signature_dict_offset, signature_dict_length = locate_signature_dict(
-          doc.revisions.current.xref_section,
-          doc.revisions.parser.startxref_offset,
-          signature_dict.oid
-        )
-        io.pos = signature_dict_offset
-        signature_data = io.read(signature_dict_length)
-        replace_signature_contents(signature_data, signature)
-        io.pos = signature_dict_offset
-        io.write(signature_data)
-      end
-
-      # Uses the information in the given cross-reference section as well as the byte offset of the
-      # cross-reference section to calculate the offset and length of the signature dictionary with
-      # the given object id.
-      def self.locate_signature_dict(xref_section, start_xref_position, signature_oid)
-        data = xref_section.map {|oid, _gen, entry| [entry.pos, oid] if entry.in_use? }.compact.sort <<
-          [start_xref_position, nil]
-        index = data.index {|_pos, oid| oid == signature_oid }
-        [data[index][0], data[index + 1][0] - data[index][0]]
-      end
-
-      # Replaces the value of the /Contents key in the serialized +signature_data+ with the value of
-      # +contents+.
-      def self.replace_signature_contents(signature_data, contents)
-        signature_data.sub!(/Contents(?:\(.*?\)|<.*?>)/) do |match|
-          length = match.size
-          result = "Contents<#{contents.unpack1('H*')}"
-          if length < result.size
-            raise HexaPDF::Error, "The reserved space for the signature was too small " \
-              "(#{(length - 10) / 2} vs #{(result.size - 10) / 2}) - use the handlers " \
-              "#signature_size method to increase the reserved space"
-          end
-          "#{result.ljust(length - 1, '0')}>"
-        end
-      end
-
-      include Enumerable
-
-      # Creates a new Signatures object for the given PDF document.
-      def initialize(document)
-        @document = document
-      end
-
-      # Creates a signing handler with the given attributes and returns it.
-      #
-      # A signing handler name is mapped to a class via the 'signature.signing_handler'
-      # configuration option. The default signing handler is DefaultHandler.
-      def handler(name: :default, **attributes)
-        handler = @document.config.constantize('signature.signing_handler', name) do
-          raise HexaPDF::Error, "No signing handler named '#{name}' is available"
-        end
-        handler.new(**attributes)
-      end
-
-      # Adds a signature to the document and returns the corresponding signature object.
-      #
-      # This method will add a new signature to the document and write the updated document to the
-      # given file or IO stream. Afterwards the document can't be modified anymore and still retain
-      # a correct digital signature. To modify the signed document (e.g. for adding another
-      # signature) create a new document based on the given file or IO stream instead.
-      #
-      # +signature+::
-      #     Can either be a signature object (determined via the /Type key), a signature field or
-      #     +nil+. Providing a signature object or signature field provides for more control, e.g.:
-      #
-      #     * Setting values for optional signature object fields like /Reason and /Location.
-      #     * (In)directly specifying which signature field should be used.
-      #
-      #     If a signature object is provided and it is not associated with an AcroForm signature
-      #     field, a new signature field is created and added to the main AcroForm object, creating
-      #     that if necessary.
-      #
-      #     If a signature field is provided and it already has a signature object as field value,
-      #     that signature object is discarded.
-      #
-      #     If the signature field doesn't have a widget, a non-visible one is created on the first
-      #     page.
-      #
-      # +handler+::
-      #     The signing handler that provides the necessary methods for signing and adjusting the
-      #     signature and signature field objects to one's liking, see #handler and DefaultHandler.
-      #
-      # +write_options+::
-      #     The key-value pairs of this hash will be passed on to the HexaPDF::Document#write
-      #     method. Note that +incremental+ will be automatically set to ensure proper behaviour.
-      #
-      # The used signature object will have the following default values set:
-      #
-      # /Filter::    /Adobe.PPKLite
-      # /SubFilter:: /adbe.pkcs7.detached
-      # /M::         The current time.
-      #
-      # These values can be overridden in the #finalize_objects method of the signature handler.
-      def add(file_or_io, handler, signature: nil, write_options: {})
-        if signature && signature.type != :Sig
-          signature_field = signature
-          signature = signature_field.field_value
-        end
-        signature ||= @document.add({Type: :Sig})
-
-        # Prepare AcroForm
-        form = @document.acro_form(create: true)
-        form.signature_flag(:signatures_exist, :append_only)
-
-        # Prepare signature field
-        signature_field ||= form.each_field.find {|field| field.field_value == signature } ||
-          form.create_signature_field(generate_field_name)
-        signature_field.field_value = signature
-
-        if signature_field.each_widget.to_a.empty?
-          signature_field.create_widget(@document.pages[0], Rect: [0, 0, 0, 0])
-        end
-
-        # Prepare signature object
-        signature[:Filter] = :'Adobe.PPKLite'
-        signature[:SubFilter] = :'adbe.pkcs7.detached'
-        signature[:M] = Time.now
-        handler.finalize_objects(signature_field, signature)
-        signature[:ByteRange] = [0, 1_000_000_000_000, 1_000_000_000_000, 1_000_000_000_000]
-        signature[:Contents] = '00' * handler.signature_size # twice the size due to hex encoding
-
-        io = if file_or_io.kind_of?(String)
-               File.open(file_or_io, 'wb+')
-             else
-               file_or_io
-             end
-
-        # Save the current state so that we can determine the correct /ByteRange value and set the
-        # values
-        start_xref, section = @document.write(io, incremental: true, **write_options)
-        signature_offset, signature_length = self.class.locate_signature_dict(section, start_xref,
-                                                                              signature.oid)
-        io.pos = signature_offset
-        signature_data = io.read(signature_length)
-
-        io.seek(0, IO::SEEK_END)
-        file_size = io.pos
-
-        # Calculate the offsets for the /ByteRange
-        contents_offset = signature_offset + signature_data.index('Contents(') + 8
-        offset2 = contents_offset + signature[:Contents].size + 2 # +2 because of the needed < and >
-        length2 = file_size - offset2
-        signature[:ByteRange] = [0, contents_offset, offset2, length2]
-
-        # Set the correct /ByteRange value
-        signature_data.sub!(/ByteRange\[0 1000000000000 1000000000000 1000000000000\]/) do |match|
-          length = match.size
-          result = "ByteRange[0 #{contents_offset} #{offset2} #{length2}]"
-          result.ljust(length)
-        end
-
-        # Now everything besides the /Contents value is correct, so we can read the contents for
-        # signing
-        io.pos = signature_offset
-        io.write(signature_data)
-        signature[:Contents] = handler.sign(io, signature[:ByteRange].value)
-
-        # And now replace the /Contents value
-        self.class.replace_signature_contents(signature_data, signature[:Contents])
-        io.pos = signature_offset
-        io.write(signature_data)
-
-        signature
-      ensure
-        io.close if io && io != file_or_io
-      end
-
-      # :call-seq:
-      #   signatures.each {|signature| block }   -> signatures
-      #   signatures.each                        -> Enumerator
-      #
-      # Iterates over all signatures in the order they are found.
-      def each
-        return to_enum(__method__) unless block_given?
-
-        return [] unless (form = @document.acro_form)
-        form.each_field do |field|
-          yield(field.field_value) if field.field_type == :Sig && field.field_value
-        end
-      end
-
-      # Returns the number of signatures in the PDF document. May be zero if the document has no
-      # signatures.
-      def count
-        each.to_a.size
-      end
-
-      private
-
-      # Generates a field name for a signature field.
-      def generate_field_name
-        index = (@document.acro_form.each_field.
-                 map {|field| field.full_field_name.scan(/\ASignature(\d+)/).first&.first.to_i }.
-                 max || 0) + 1
-        "Signature#{index}"
-      end
-
-    end
-
-  end
-end