This section defines security options for the PDF document.
Note: When the PDF/A format is specified the security options for the document will not used and will be ignored, it is advisable therefore to actually disable security to enable faster file processing.
Name |
Values |
Description |
PDFXv3 |
|---|---|---|---|
Enabled |
Boolean |
Specifies if the PDF document should be secured or not. If this property has the value False, no other properties from this section will be used. Default = False |
Use |
HasUserPassword |
Boolean |
These properties define if the PDF document will contain a valid User and Owner password. If the PDF document has no user password, this document can be opened without the need to enter a password in any PDF viewing or manipulation tool—even if an Owner password is set. To ensure robust security, set both an Owner and User password. Default = False |
(new) |
HasOwnerPassword |
Boolean |
Default = False |
(new) |
UserPassword |
String |
Defines the User password. This password is used for opening the document with user privileges. Default = empty string. |
UserPwd |
OwnerPassword |
String |
Defines the Owner password. This password is required to change permissions/security settings in the PDF document. If this password is empty or the same as the User password, changing the permissions /security will be impossible. Default = empty string. |
OwnerPwd |
Type |
0 (40RSA) 1 (128RSA) 2 (128AES) 3 (256AES) 4 (256AES_R6) |
Defines the security method used for encrypting the document. The value of this property specifies which subsection ( Perms40 or Perms128) will be used to define users permission for the document. The last option—256AES_R6—represents encryption algorithm that should be introduced in PDF 2.0 Specification, but already used by Adobe Acrobat products. Default = 0 (40RSA) |
Level
|
Perms40.AllowPrinting |
Boolean
|
These options apply when using 40RSA security
Default = False
|
40.AllowPrinting |
Perms40.AllowChanging |
40.AllowChanging |
||
Perms40.AllowCopying |
40.AllowCopying |
||
Perms40.AllowComments |
40.AllowComments |
||
Perms128.ContentAccess |
128.ContentAccess |
||
Perms128.AllowCopying |
128.AllowCopying |
||
Perms128.Changes |
0 - 4 |
These options apply to 128 and 256 bit security Types. 0 = No changes will be allowed. 1 = Only document assembly is allowed for the user. 2 = Only form field fill-in and signing is allowed. 3 = Allows comment authoring, form field fill-in and signing of the document. 4 = Allows general editing, comments and form field authoring for the user. Default = 0 |
128.Changes |
Perms128.Printing |
0 (not allowed) 1 (low resolution) 2 (fully allowed) |
(128 and 256 bit only) Specifies user's permissions for printing the document. Default = 0 |
128.Printing |
Perms128.EncryptMeta |
Boolean |
(128 and 256 bit only) Specifies if metadata In the PDF document should be encrypted or not. N.B. This property is applicable for PDF specifications 1.6 and higher. Default = True |
(new) |
Examples
//;Test user/owner passwords
//PDFX,Security.Enabled,True
//PDFX,Security.HasUserPassword,True
//PDFX,Security.HasOwnerPassword,True
//PDFX,Security.UserPassword,userpw
//PDFX,Security.OwnerPassword,ownerpw
//PDFX,Security.Type,256AES
//PDFX,Security.Perms128.Changes,0
//PDFX,Security.Perms128.Printing,2
Compatibility
Mostly supported by PDFXv3, except for the 256 bit modes. Names of some of the properties have changed, but are auto-converted from the v3 to v5 form when applicable (but not vice versa).
