Ruby Requires Chilkat v11.7.0+

PDF Owner Password vs. User Password

See more PDF Protection Examples

Demonstrates the difference between the two passwords of an encrypted PDF. Either one opens the file. The user password gives the rights the permissions grant. The owner password gives owner rights: no restriction applies, and it is the only one that lets the security be changed or removed. Every Protection operation except getInfo needs owner rights, and Chilkat does not offer a way around that. Ruby

require 'chilkat'

success = false

#  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

json = Chilkat::CkJsonObject.new()
jsonOut = Chilkat::CkJsonObject.new()

#  Opened with the user password.
user = Chilkat::CkPdf.new()
user.put_UserPassword("secret")
success = user.LoadFile("qa_data/pdf/encrypted_user_password.pdf")
if (success == false)
    print user.lastErrorText() + "\n";
    exit
end

success = user.Protection("getInfo",json,jsonOut)
if (success == false)
    print user.lastErrorText() + "\n";
    exit
end

print "opened with: " + jsonOut.stringOf("loaded.openedWith") + "\n";

#  Changing the security needs owner rights, so this is refused.
success = user.Protection("removeEncryption",json,jsonOut)
if (success == false)
    print "removeEncryption was refused: the PDF was not opened with its owner password." + "\n";
end

#  Opened with the owner password.
owner = Chilkat::CkPdf.new()
owner.put_OwnerPassword("owner-secret")
success = owner.LoadFile("qa_data/pdf/encrypted_user_password.pdf")
if (success == false)
    print owner.lastErrorText() + "\n";
    exit
end

success = owner.Protection("getInfo",json,jsonOut)
if (success == false)
    print owner.lastErrorText() + "\n";
    exit
end

print "opened with: " + jsonOut.stringOf("loaded.openedWith") + "\n";

#  Now it is allowed.
success = owner.Protection("removeEncryption",json,jsonOut)
if (success == false)
    print owner.lastErrorText() + "\n";
    exit
end

print "removeEncryption succeeded; will be saved encrypted: " + jsonOut.BoolOf("pending.encrypted").to_s() + "\n";

#  Sample output:

#  opened with: user
#  removeEncryption was refused: the PDF was not opened with its owner password.
#  opened with: owner
#  removeEncryption succeeded; will be saved encrypted: False