PDF Security Properties

Use the properties described in the table below to control the security settings for the output PDF documents.

Property Name Description

Enable PDF Security

Default: false

Description: If you specify "true," then the output PDF file is encrypted. You can then also specify the following properties:

  • Open document password

  • Modify permissions password

  • Encryption Level

Internal Name: pdf-security

Open document password

Default: N/A

Description: This password is required for opening the document. It enables users to open the document only. This property is enabled only when "Enable PDF Security" is set to "true". Note that BI Publisher follows Adobe's password restrictions. The password must contain only Latin 1 characters and must be no more than 32 bytes long.

Internal Name: pdf-open-password

Modify permissions password

Default: N/A

Description: This password enables users to override the security setting. This property is effective only when "Enable PDF Security" is set to "true". Note that BI Publisher follows the Adobe's password restrictions. The password must contain only Latin 1 characters and must be no more than 32 bytes long.

Internal Name: pdf-permissions-password

Encryption level

Default: 2 - high

Description: Specify the encryption level for the output PDF file. The possible values are:

  • 0: Low (40-bit RC4, Acrobat 3.0 or later)

  • 1: Medium (128-bit RC4, Acrobat 5.0 or later)

  • 2: High (128-bit AES, Acrobat 7.0 or later)

This property is effective only when "Enable PDF Security" is set to "true". When Encryption level is set to 0, you can also set the following properties:

  • Disable printing

  • Disable document modification

  • Disable context copying, extraction, and accessibility

  • Disable adding or changing comments and form fields

When Encryption level is set to 1 or higher, the following properties are available:

  • Enable text access for screen readers

  • Enable copying of text, images, and other content

  • Allowed change level

  • Allowed printing level

Internal Name: pdf-encryption-level

Disable document modification

Default: false

Description: Permission available when "Encryption level" is set to 0. When set to "true", the PDF file cannot be edited.

Internal Name: pdf-no-changing-the-document

Disable printing

Default: false

Description: Permission available when "Encryption level" is set to 0. When set to "true", printing is disabled for the PDF file.

Internal Name: pdf-no-printing

Disable adding or changing comments and form fields

Default: false

Description: Permission available when "Encryption level" is set to 0. When set to "true", the ability to add or change comments and form fields is disabled.

Internal Name: pdf-no-accff

Disable context copying, extraction, and accessibility

Default: false

Description: Permission available when "Encryption level" is set to 0. When set to "true", the context copying, extraction, and accessibility features are disabled.

Internal Name: pdf-no-cceda

Enable text access for screen readers

Default: true

Description: Permission available when "Encryption level" is set to 1 or higher. When set to "true", text access for screen reader devices is enabled.

Internal Name: pdf-enable-accessibility

Enable copying of text, images, and other content

Default: false

Description: Permission available when "Encryption level" is set to 1 or higher. When set to "true", copying of text, images, and other content is enabled.

Internal Name: pdf-enable-copying

Allowed change level

Default: 0

Description: Permission available when "Encryption level" is set to 1 or higher. Valid Values are:

  • 0: none

  • 1: Allows inserting, deleting, and rotating pages

  • 2: Allows filling in form fields and signing

  • 3: Allows commenting, filling in form fields, and signing

  • 4: Allows all changes except extracting pages

Internal Name: pdf-changes-allowed

Allowed printing level

Default: 0

Description: Permission available when "Encryption level" is set to 1 or higher. Valid values are:

  • 0: None

  • 1: Low resolution (150 dpi)

  • 2: High resolution

Internal Name: pdf-printing-allowed