Security

<< Click to Display Table of Contents >>

Navigation:  GDI Print Directives >

Security

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).