Pdf2pdfapi.Pdf2pdf Dim Done As Boolean Conv.Compliance = Epdfa1b Done = Conv.Convert("C:\In1.Pdf", "", "C:\Out1.Pdf", "C:\Temp\Log1.Txt") Set Conv = Nothing End Sub
Total Page:16
File Type:pdf, Size:1020Kb
User Manual 3Heights® PDF to PDF/A Converter API Version 6.18.0 Contents 1 Introduction ........................................................................ 6 1.1 Description .......................................................................... 6 1.2 Functions ........................................................................... 6 1.2.1 Features ......................................................................... 6 1.2.2 Formats ......................................................................... 7 Input Formats ................................................................ 7 Output Formats .............................................................. 8 1.2.3 Conformance .................................................................... 8 1.3 Interfaces ........................................................................... 8 1.4 Operating Systems .................................................................... 8 1.5 How to Best Read this Manual ........................................................... 9 1.6 Digital Signatures ..................................................................... 9 1.6.1 Overview ........................................................................ 9 1.6.2 Terminology ..................................................................... 9 1.6.3 Why Digitally Signing? ............................................................ 10 1.6.4 What is an Electronic Signature? .................................................... 11 Simple Electronic Signature .................................................... 11 Advanced Electronic Signature ................................................. 11 Qualified Electronic Signature .................................................. 12 1.6.5 How to Create Electronic Signatures ................................................. 12 Preparation Steps ............................................................ 12 Application of the Signature ................................................... 13 2 Installation and Deployment ......................................................... 15 2.1 Windows ........................................................................... 15 2.2 Linux and macOS .................................................................... 16 2.2.1 Linux .......................................................................... 16 2.2.2 macOS ......................................................................... 17 2.3 Zip Archive ......................................................................... 17 2.3.1 Development ................................................................... 18 2.3.2 Deployment .................................................................... 19 2.4 NuGet Package ...................................................................... 20 2.5 Interface Specific Installation Steps ...................................................... 20 2.5.1 COM Interface ................................................................... 20 2.5.2 Java Interface ................................................................... 21 2.5.3 .NET Interface ................................................................... 21 2.5.4 C Interface ...................................................................... 22 2.6 Uninstall, Install a New Version ......................................................... 22 2.7 Note about the Evaluation License ...................................................... 22 2.8 Special Directories .................................................................. 22 2.8.1 Directory for temporary files ....................................................... 22 2.8.2 Cache Directory ................................................................. 23 2.8.3 Font Directories ................................................................. 23 3 License Management ................................................................ 25 3.1 License Features .................................................................... 25 © PDF Tools AG – Premium PDF Technology 3Heights® PDF to PDF/A Converter API, September 16, 2021 | 1/108 4 Programming Interfaces ............................................................. 26 4.1 Visual Basic 6 ........................................................................ 26 4.2 .NET ............................................................................... 26 4.2.1 Visual Basic ..................................................................... 27 4.2.2 C# ............................................................................ 28 4.2.3 Deployment .................................................................... 28 4.2.4 Troubleshooting: TypeInitializationException ......................................... 28 4.3 ASP ............................................................................... 29 5 User’s Guide ....................................................................... 31 5.1 Process Description .................................................................. 31 5.1.1 Conversion Steps ................................................................ 32 5.1.2 Conversion Errors ................................................................ 32 Handling Conversion Errors .................................................... 33 5.1.3 Post Analysis .................................................................... 33 5.2 What is PDF/A? ...................................................................... 34 5.2.1 PDF/A1 ........................................................................ 34 5.2.2 What is the difference between PDF/A1b and PDF/A1a? ............................... 34 5.2.3 PDF/A2 ........................................................................ 35 5.2.4 PDF/A3 ........................................................................ 35 5.3 Color Spaces ........................................................................ 35 5.3.1 Colors in PDF .................................................................... 35 ICC Color Profiles ............................................................ 36 PDF/A Requirements ......................................................... 36 5.4 Fonts .............................................................................. 37 5.4.1 Font Cache .................................................................... 37 5.4.2 Microsoft Core Fonts on Linux or macOS ............................................. 37 5.4.3 Font Configuration File fonts.ini .................................................... 37 5.5 Cryptographic Provider ............................................................... 38 5.5.1 PKCS#11 Provider ............................................................... 39 Configuration ............................................................... 39 Interoperability Support ...................................................... 40 Selecting a Certificate for Signing ............................................... 40 Using PKCS#11 stores with missing issuer certificates ............................... 40 Cryptographic Suites ......................................................... 41 5.5.2 Windows Cryptographic Provider ................................................... 41 Configuration ............................................................... 42 Selecting a Certificate for Signing ............................................... 43 Certificates ................................................................. 43 Qualified Certificates ......................................................... 45 Cryptographic Suites ......................................................... 46 5.5.3 myBica Digital Signing Service ..................................................... 46 5.5.4 QuoVadis sealsign ............................................................... 48 5.5.5 Swisscom Allin Signing Service .................................................... 49 General Properties ........................................................... 49 Provider Session Properties .................................................... 50 OnDemand Certificates ....................................................... 51 StepUp Authorization using MobileID .......................................... 51 5.5.6 GlobalSign Digital Signing Service .................................................. 51 5.6 How to Create Digital Signatures ........................................................ 54 5.6.1 How to Create a PAdES Signature ................................................... 54 Create a PAdESBB Signature .................................................. 55 © PDF Tools AG – Premium PDF Technology 3Heights® PDF to PDF/A Converter API, September 16, 2021 | 2/108 Create a PAdESBT Signature .................................................. 56 5.6.2 How to Create a Visual Appearance of a Signature ...................................... 56 5.6.3 Guidelines for Mass Signing ........................................................ 57 Keep the session to the security device open for multiple sign operations .............. 57 Signing concurrently using multiple threads ...................................... 57 Thread safety with a PKCS#11 provider ........................................... 57 5.6.4 Miscellaneous ................................................................... 57 Caching of CRLs, OCSP, and Timestamp Reponses ................................. 57 How to Use a Proxy ..........................................................