Zig Requires Chilkat v11.7.0+

Get the Encryption and Permissions of a Loaded PDF

See more PDF Protection Examples

Demonstrates the getInfo operation of Protection, which reports how the loaded PDF is protected: the method and algorithm, whether a password is needed to open it, how it was opened (with the user password, the owner password, an empty password, or a certificate), and each permission. The loaded member describes the file as it is, the pending member describes the security it will be saved with, and changed says whether the two differ. getInfo is the one operation that does not need owner rights. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // The PDF used in this example is available at encrypted_user_password.pdf

    const pdf = try chilkat.Pdf.init();
    defer pdf.deinit();

    // The password must be set before loading.
    pdf.setUserPassword("secret");
    pdf.loadFile("qa_data/pdf/encrypted_user_password.pdf") catch {
        std.debug.print("{s}\n", .{try pdf.getLastErrorText(alloc)});
        return;
    };

    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    const json_out = try chilkat.JsonObject.init();
    defer json_out.deinit();
    pdf.protection("getInfo", json, json_out) catch {
        std.debug.print("{s}\n", .{try pdf.getLastErrorText(alloc)});
        return;
    };

    json_out.setEmitCompact(false);
    std.debug.print("{s}\n", .{try json_out.emit(alloc)});

    // "loaded" is the security the file has.  "pending" is the security it will be saved with, which
    // is the same until an operation such as encrypt or changePermissions changes it.
    std.debug.print("algorithm: {s}\n", .{try json_out.stringOf(alloc, "loaded.algorithm")});
    std.debug.print("opened with: {s}\n", .{try json_out.stringOf(alloc, "loaded.openedWith")});
    std.debug.print("password needed to open: {}\n", .{json_out.boolOf("loaded.userPasswordRequired")});
    std.debug.print("may print: {s}\n", .{try json_out.stringOf(alloc, "loaded.permissions.print")});
    std.debug.print("may copy: {}\n", .{json_out.boolOf("loaded.permissions.copy")});
    std.debug.print("changed: {}\n", .{json_out.boolOf("changed")});

    // Sample output:

    // {
    //   "changed": false,
    //   "loaded": {
    //     "encrypted": true,
    //     "method": "password",
    //     "algorithm": "rc4-128",
    //     "pdfVersion": "1.3",
    //     "scope": "all",
    //     "userPasswordRequired": true,
    //     "ownerPasswordSet": true,
    //     "openedWith": "user",
    //     "permissions": {
    //       "print": "full",
    //       "modify": true,
    //       "copy": true,
    //       "accessibility": true,
    //       "annotate": true,
    //       "fillForms": true,
    //       "assemble": true
    //     }
    //   },
    //   "pending": {
    //     "encrypted": true,
    //     "method": "password",
    //     "algorithm": "rc4-128",
    //     "pdfVersion": "1.3",
    //     "scope": "all",
    //     "userPasswordRequired": true,
    //     "ownerPasswordSet": true,
    //     "permissions": {
    //       "print": "full",
    //       "modify": true,
    //       "copy": true,
    //       "accessibility": true,
    //       "annotate": true,
    //       "fillForms": true,
    //       "assemble": true
    //     }
    //   }
    // }
    //
    // algorithm: rc4-128
    // opened with: user
    // password needed to open: True
    // may print: full
    // may copy: True
    // changed: False
}