Add Digital Signature sample

Fix typo

More cleanup

Author: datalogics-bruceh

Security/AddDigitalSignature/AddDigitalSignature.cpp

@@ -0,0 +1,139 @@
+//
+// Copyright (c) 2025, Datalogics, Inc. All rights reserved.
+//
+// This sample adds a digital signature with a logo to a PDF document.
+//
+// Command-line:  <input-file> <output-file> <logo file>   (All optional)
+//
+
+#include <iostream>
+#include <string>
+#include "InitializeLibrary.h"
+#include "APDFLDoc.h"
+#include "PERCalls.h"
+
+// Header that includes Digital Signature methods
+#include "DLExtrasCalls.h"
+
+#define INPUT_LOC "../../../../Resources/Sample_Input/"
+#define DEF_INPUT "SixPages.pdf"
+#define DEF_OUTPUT "AddDigitalSignature-out.pdf"
+#define DEF_LOGO_FILE "ducky_alpha.tif"
+
+// DEF_CERT_FILE points to the signer certificate which may be binary(.der file format)
+// or base-64 encoded(.pem file format).
+#define DEF_CERT_FILE "Credentials/DER/RSA_certificate.der"
+
+// DEF_KEY_FILE points to the private key corresponding to the signer certificate defined above.
+// A key can be binary (.der file format) or base-64 encoded (.pem file format).
+#define DEF_KEY_FILE "Credentials/DER/RSA_privKey.der"
+
+int main(int argc, char **argv) {
+    APDFLib lib;
+
+    ASErrorCode errCode = 0;
+    if (lib.isValid() == false) {
+        errCode = lib.getInitError();
+        std::cout << "Initialization failed with code " << errCode << std::endl;
+        return errCode;
+    }
+
+    std::string const csInputFileName(argc > 1 ? argv[1] : INPUT_LOC DEF_INPUT);
+    std::string const csOutputFileName(argc > 2 ? argv[2] : DEF_OUTPUT);
+    std::string const csLogoFileName(argc > 3 ? argv[2] : INPUT_LOC DEF_LOGO_FILE);
+    std::cout << "Will apply a digital signature to " << csInputFileName.c_str() << " with a logo "
+              << csLogoFileName.c_str() << " and save as " << csOutputFileName.c_str() << std::endl;
+
+    DURING
+
+        // Open the input document.
+        APDFLDoc APDoc(csInputFileName.c_str(), true);
+        PDDoc inDoc = APDoc.getPDDoc();
+
+        // Setup Sign params
+        PDSignDocSignParams const signParams = PDSignDocSignInitParams();
+
+        PDSignDocSetFieldID(signParams, CreateFieldWithQualifiedName);
+
+        // Set the size and location of the signature box (optional)
+        // If not set, invisible signature will be placed on first page
+        ASFixedRect annotLocation;
+        annotLocation.left = ASFloatToFixed(1.0 * 72);
+        annotLocation.right = ASFloatToFixed(4.0 * 72);
+        annotLocation.top = ASFloatToFixed(6.0 * 72);
+        annotLocation.bottom = ASFloatToFixed(8.0 * 72);
+        PDSignDocSetSignatureBoxPageNumber(signParams, 0);
+        PDSignDocSetSignatureBoxRectangle(signParams, &annotLocation);
+
+        ASText fieldName = ASTextFromEncoded("Signature_es_:signatureblock", PDGetHostEncoding());
+        PDSignDocSetFieldName(signParams, fieldName);
+
+        // Set credential related attributes
+        PDSignDocSetDigestCategory(signParams, sha256);
+        PDSignDocSetCredentialDataFormat(signParams, NonPFX);
+
+        ASPathName certPath = APDFLDoc::makePath(INPUT_LOC DEF_CERT_FILE);
+        ASPathName keyPath = APDFLDoc::makePath(INPUT_LOC DEF_KEY_FILE);
+
+        ASFile asCertFileDER{nullptr};
+        ASErrorCode err = ASFileSysOpenFile64(nullptr, certPath, (ASFILE_READ | ASFILE_SERIAL), &asCertFileDER);
+
+        ASFile asKeyFileDER{nullptr};
+        err = ASFileSysOpenFile64(nullptr, keyPath, (ASFILE_READ | ASFILE_SERIAL), &asKeyFileDER);
+
+        PDSignDocSetNonPfxSignerCert(signParams, asCertFileDER, 0, OnDisk);
+        PDSignDocSetNonPfxPrivateKey(signParams, asKeyFileDER, 0, OnDisk);
+
+        // Setup the signer information
+        ASText name = ASTextFromEncoded("John Doe", PDGetHostEncoding());
+        ASText location = ASTextFromEncoded("Chicago, IL", PDGetHostEncoding());
+        ASText reason = ASTextFromEncoded("Approval", PDGetHostEncoding());
+        ASText contact = ASTextFromEncoded("Datalogics, Inc.", PDGetHostEncoding());
+
+        // Setup the logo image (optional)
+        ASPathName logoPath = APDFLDoc::makePath(csLogoFileName.c_str());
+        ASFile asLogoFile{nullptr};
+        err = ASFileSysOpenFile64(nullptr, logoPath, (ASFILE_READ | ASFILE_SERIAL), &asLogoFile);
+        PDEImage logo{DLCreatePDEImageFromASFile(asLogoFile)};
+        ASFixed const opacity{FloatToASFixed(0.50f)};
+
+        PDSignDocSetSignerInfo(signParams, logo, opacity, name, location, reason, contact,
+                               DisplayTraits::kDisplayAll);
+
+        // Setup Save params
+        PDSignDocSaveParams const saveParams = PDSignDocSaveInitParams();
+        ASPathName outPathName = APDFLDoc::makePath(csOutputFileName.c_str());
+
+        PDSignDocSetOutputPath(saveParams, outPathName);
+
+        // Finally, sign and save the document
+        PDSignDocWithParams(inDoc, saveParams, signParams);
+
+        // Cleanup
+        ASTextDestroy(fieldName);
+        ASTextDestroy(name);
+        ASTextDestroy(location);
+        ASTextDestroy(reason);
+        ASTextDestroy(contact);
+
+        // Release logo object
+        PDERelease(reinterpret_cast<PDEObject>(logo));
+        ASFileSysReleasePath(nullptr, logoPath);
+
+        // Release credential objects
+        ASFileSysReleasePath(nullptr, certPath);
+        ASFileSysReleasePath(nullptr, keyPath);
+        ASFileClose(asCertFileDER);
+        ASFileClose(asKeyFileDER);
+
+        ASFileClose(asLogoFile);
+        PDDocClose(inDoc);
+        ASFileSysReleasePath(nullptr, outPathName);
+
+    HANDLER
+        errCode = ERRORCODE;
+        lib.displayError(errCode);
+    END_HANDLER
+
+    return errCode;
+};

Security/README.md

@@ -1,3 +1,6 @@
+## AddDigitalSignature
+Demonstrates adding a digital signature with a logo to a PDF document.
+
 ## AddPassword
 Demonstrates protecting a PDF with a password. To open or edit the saved PDF, you must supply the password.