Class PdfV1SecurityHandler

V1 security handler implementing 40-bit RC4 encryption. This is the original PDF encryption format (PDF 1.1).

Example

const handler = new PdfV1SecurityHandler({
    password: 'user123',
    ownerPassword: 'admin456'
})

Hierarchy (View Summary)

PdfStandardSecurityHandler
- PdfV1SecurityHandler
  - PdfV2SecurityHandler

Constructors

constructor

new PdfV1SecurityHandler(
options: PdfStandardSecurityHandlerOptions,
): PdfV1SecurityHandler
Creates a new standard security handler.
Parameters
- options: PdfStandardSecurityHandlerOptions
  Configuration options including passwords and document ID.
Returns PdfV1SecurityHandler
Inherited from PdfStandardSecurityHandler.constructor
- Defined in packages/pdf-lite/src/security/handlers/base.ts:351

Properties

dict

dict: PdfEncryptionDictionary

The encryption dictionary containing all encryption parameters.

`Protected` `Optional`documentId

documentId?: PdfId

Document identifier for key derivation.

encryptMetadata

encryptMetadata: boolean

Whether to encrypt document metadata.

`Protected` `Optional`masterKey

masterKey?: ByteArray

Derived master encryption key.

`Protected` `Optional`ownerKey

ownerKey?: ByteArray

Computed owner key (O value).

`Protected` `Optional`ownerPassword

ownerPassword?: ByteArray

Owner password for full access.

`Protected`password

password: ByteArray

User password for authentication.

permissions

permissions: number

Numeric permission flags.

`Protected` `Optional`userKey

userKey?: ByteArray

Computed user key (U value).

Methods

`Protected`buildPermissions

buildPermissions(perm: PdfPermissions): number
Builds the numeric permission flags from a PdfPermissions object.
Parameters
- perm: PdfPermissions
  The permissions to encode.
Returns number
The numeric permission flags.
Inherited from PdfStandardSecurityHandler.buildPermissions
- Defined in packages/pdf-lite/src/security/handlers/base.ts:188

canEncryptMetadata

canEncryptMetadata(): boolean
Checks if metadata encryption is enabled.

Returns boolean
True if metadata should be encrypted.
Inherited from PdfStandardSecurityHandler.canEncryptMetadata
- Defined in packages/pdf-lite/src/security/handlers/base.ts:445

`Protected`computeMasterKey

computeMasterKey(): Promise<ByteArray>
Computes the master encryption key from the password.

Returns Promise<ByteArray>
The computed master key.

Throws
Error if required parameters are missing or password is incorrect.
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:104

computeObjectKey

computeObjectKey(
    objectNumber?: number,
    generationNumber?: number,
    algorithm?: PdfEncryptionAlgorithmType,
): Promise<ByteArray>
Computes the object-specific encryption key.
Parameters
- OptionalobjectNumber: number
  The PDF object number.
- OptionalgenerationNumber: number
  The PDF generation number.
- Optionalalgorithm: PdfEncryptionAlgorithmType
  Optional algorithm type for key derivation.
Returns Promise<ByteArray>
The computed object key.

Throws
Error if object or generation number is invalid.
Overrides PdfStandardSecurityHandler.computeObjectKey
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:162

`Protected`computeOwnerKey

computeOwnerKey(): Promise<ByteArray>
Computes the owner key (O value) using RC4-40 algorithm.

Returns Promise<ByteArray>
The computed owner key.
Overrides PdfStandardSecurityHandler.computeOwnerKey
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:64

`Protected`computeUserKey

computeUserKey(): Promise<ByteArray>
Computes the user key (U value) using RC4-40 algorithm.

Returns Promise<ByteArray>
The computed user key.

Throws
Error if document ID, owner key, or permissions are not set.
Overrides PdfStandardSecurityHandler.computeUserKey
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:77

decodePermissions

decodePermissions(): PdfPermissions
Decodes the numeric permission flags into a PdfPermissions object.

Returns PdfPermissions
An object with boolean flags for each permission.
Inherited from PdfStandardSecurityHandler.decodePermissions
- Defined in packages/pdf-lite/src/security/handlers/base.ts:71

decrypt

decrypt(
    type: "string" | "stream" | "file",
    data: ByteArray,
    objectNumber?: number,
    generationNumber?: number,
): Promise<ByteArray>
Decrypts data using the appropriate cipher.
Parameters
- type: "string" | "stream" | "file"
  The type of content being decrypted.
- data: ByteArray
  The encrypted data.
- OptionalobjectNumber: number
  The PDF object number.
- OptionalgenerationNumber: number
  The PDF generation number.
Returns Promise<ByteArray>
The decrypted data.
Inherited from PdfStandardSecurityHandler.decrypt
- Defined in packages/pdf-lite/src/security/handlers/base.ts:591

decryptObject

decryptObject(object: PdfIndirectObject): Promise<void>
Recursively decrypts all strings and streams within an indirect object.
Parameters
- object: PdfIndirectObject
  The indirect object to decrypt.
Returns Promise<void>
Inherited from PdfStandardSecurityHandler.decryptObject
- Defined in packages/pdf-lite/src/security/handlers/base.ts:207

encrypt

encrypt(
    type: "string" | "stream" | "file",
    data: ByteArray,
    objectNumber?: number,
    generationNumber?: number,
): Promise<ByteArray>
Encrypts data using the appropriate cipher.
Parameters
- type: "string" | "stream" | "file"
  The type of content being encrypted.
- data: ByteArray
  The data to encrypt.
- OptionalobjectNumber: number
  The PDF object number.
- OptionalgenerationNumber: number
  The PDF generation number.
Returns Promise<ByteArray>
The encrypted data.
Inherited from PdfStandardSecurityHandler.encrypt
- Defined in packages/pdf-lite/src/security/handlers/base.ts:567

encryptObject

encryptObject(object: PdfIndirectObject): Promise<void>
Recursively encrypts all strings and streams within an indirect object.
Parameters
- object: PdfIndirectObject
  The indirect object to encrypt.
Returns Promise<void>
Inherited from PdfStandardSecurityHandler.encryptObject
- Defined in packages/pdf-lite/src/security/handlers/base.ts:252

`Protected`getCipher

getCipher(objectNumber?: number, generationNumber?: number): Promise<Cipher>
Gets an RC4 cipher for the specified object.
Parameters
- OptionalobjectNumber: number
  The PDF object number.
- OptionalgenerationNumber: number
  The PDF generation number.
Returns Promise<Cipher>
An RC4 cipher instance.
Overrides PdfStandardSecurityHandler.getCipher
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:198

getDocumentId

getDocumentId(): PdfId | undefined
Gets the document ID.

Returns PdfId | undefined
The document ID, or undefined if not set.
Inherited from PdfStandardSecurityHandler.getDocumentId
- Defined in packages/pdf-lite/src/security/handlers/base.ts:414

getKeyBits

getKeyBits(): number
Gets the encryption key length in bits.

Returns number
40 for V1 encryption.
Overrides PdfStandardSecurityHandler.getKeyBits
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:55

getName

getName(): string
Gets the security handler filter name.

Returns string
'Standard' for password-based encryption.
Inherited from PdfStandardSecurityHandler.getName
- Defined in packages/pdf-lite/src/security/handlers/base.ts:387

getRevision

getRevision(): number
Gets the encryption revision number.

Returns number
2 for V1 encryption.
Overrides PdfStandardSecurityHandler.getRevision
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:37

getVersion

getVersion(): number
Gets the encryption version number.

Returns number
1 for 40-bit RC4 encryption.
Overrides PdfStandardSecurityHandler.getVersion
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:46

`Protected`initKeys

initKeys(): Promise<void>
Initializes the user and owner keys if not already set.

Returns Promise<void>
Inherited from PdfStandardSecurityHandler.initKeys
- Defined in packages/pdf-lite/src/security/handlers/base.ts:510

isReady

isReady(): boolean
Checks if the handler is ready (has document ID).

Returns boolean
True if document ID is set.
Inherited from PdfStandardSecurityHandler.isReady
- Defined in packages/pdf-lite/src/security/handlers/base.ts:396

readEncryptionDictionary

readEncryptionDictionary(encryptionDictionary: PdfEncryptionDictionary): void
Reads encryption parameters from the encryption dictionary.
Parameters
- encryptionDictionary: PdfEncryptionDictionary
  The encryption dictionary from the PDF.
Returns void
Inherited from PdfStandardSecurityHandler.readEncryptionDictionary
- Defined in packages/pdf-lite/src/security/handlers/base.ts:454

recoverUserPassword

recoverUserPassword(ownerPassword?: string | ByteArray): Promise<string>
Recovers the user password from the owner password.
Parameters
- OptionalownerPassword: string | ByteArray
  The owner password.
Returns Promise<string>
The recovered user password as a string.
Overrides PdfStandardSecurityHandler.recoverUserPassword
- Defined in packages/pdf-lite/src/security/handlers/v1.ts:213

setDocumentId

setDocumentId(id: PdfId): void
Sets the document ID for key derivation.
Parameters
- id: PdfId
  The document ID array.
Returns void
Inherited from PdfStandardSecurityHandler.setDocumentId
- Defined in packages/pdf-lite/src/security/handlers/base.ts:405

setMasterKey

setMasterKey(masterKey: ByteArray): void
Sets the master encryption key directly.
Parameters
- masterKey: ByteArray
  The master key to use.
Returns void
Inherited from PdfStandardSecurityHandler.setMasterKey
- Defined in packages/pdf-lite/src/security/handlers/base.ts:611

setOwnerPassword

setOwnerPassword(ownerPassword: string | ByteArray): void
Sets the owner password.
Parameters
- ownerPassword: string | ByteArray
  The owner password string or bytes.
Returns void
Inherited from PdfStandardSecurityHandler.setOwnerPassword
- Defined in packages/pdf-lite/src/security/handlers/base.ts:433

setPassword

setPassword(password: string | ByteArray): void
Sets the user password.
Parameters
- password: string | ByteArray
  The user password string or bytes.
Returns void
Inherited from PdfStandardSecurityHandler.setPassword
- Defined in packages/pdf-lite/src/security/handlers/base.ts:423

write

write(): Promise<void>
Writes the encryption dictionary with all computed keys and parameters.

Returns Promise<void>
Throws
Error if required keys are not computed.
Inherited from PdfStandardSecurityHandler.write
- Defined in packages/pdf-lite/src/security/handlers/base.ts:520

Class PdfV1SecurityHandler

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns PdfV1SecurityHandler

Properties

dict

Protected OptionaldocumentId

encryptMetadata

Protected OptionalmasterKey

Protected OptionalownerKey

Protected OptionalownerPassword

Protectedpassword

permissions

Protected OptionaluserKey

Methods

ProtectedbuildPermissions

Parameters

Returns number

canEncryptMetadata

Returns boolean

ProtectedcomputeMasterKey

Returns Promise<ByteArray>

Throws

computeObjectKey

Parameters

Returns Promise<ByteArray>

Throws

ProtectedcomputeOwnerKey

Returns Promise<ByteArray>

ProtectedcomputeUserKey

Returns Promise<ByteArray>

Throws

decodePermissions

Returns PdfPermissions

decrypt

Parameters

Returns Promise<ByteArray>

decryptObject

Parameters

Returns Promise<void>

encrypt

Parameters

Returns Promise<ByteArray>

encryptObject

Parameters

Returns Promise<void>

ProtectedgetCipher

Parameters

Returns Promise<Cipher>

getDocumentId

Returns PdfId | undefined

getKeyBits

Returns number

getName

Returns string

getRevision

Returns number

getVersion

Returns number

ProtectedinitKeys

Returns Promise<void>

isReady

Returns boolean

readEncryptionDictionary

Parameters

Returns void

recoverUserPassword

Parameters

Returns Promise<string>

setDocumentId

Parameters

Returns void

setMasterKey

`Protected` `Optional`documentId

`Protected` `Optional`masterKey

`Protected` `Optional`ownerKey

`Protected` `Optional`ownerPassword

`Protected`password

`Protected` `Optional`userKey

`Protected`buildPermissions

`Protected`computeMasterKey

`Protected`computeOwnerKey

`Protected`computeUserKey

`Protected`getCipher

`Protected`initKeys