xmlsecurity/README.md

   1 # Stuff for Document Signing
   2
   3 This code provides dialogs, and infrastructure wrapping `libxmlsec` and
   4 `gpgme` that implements document signing.
   5
   6 For signing a document, a personal key pair is used, which consists of a
   7 private key and a public key, which is added to the document in addition
   8 to the digital signature of the document, when signing it.
   9
  10 The document signing can be done both for the source ODF/OOXML files and
  11 the exported PDF files. It is also possible to sign existing PDF files.
  12
  13 To test the signed PDFs, one can use the `pdfverify` in this way:
  14
  15     ./bin/run pdfverify $PWD/xmlsecurity/qa/unit/pdfsigning/data/2good.pdf
  16
  17 The file parameter should be an absolute path.
  18
  19 This is the output of `pdfverify` for `2good.pdf`:
  20
  21 ```
  22 verifying signatures
  23 found 2 signatures
  24 signature #0: digest match? 1
  25 signature #0: partial? 0
  26 signature #1: digest match? 1
  27 signature #1: partial? 0
  28 ```
  29
  30 ## References
  31 * [Adobe: Digital Signatures in a PDF](https://www.adobe.com/devnet-docs/etk_deprecated/tools/DigSig/Acrobat\_DigitalSignatures_in_PDF.pdf)
  32 * [Adobe: Acrobat DC Digital Signatures - Supported Standards](https://www.adobe.com/devnet-docs/acrobatetk/tools/DigSigDC/standards.html)