Class PdfEtsiCadesDetachedSignatureObject

ETSI CAdES detached signature object (ETSI.CAdES.detached). Creates CAdES-compliant signatures with enhanced attributes.

Example

const signature = new PdfEtsiCadesDetachedSignatureObject({
    privateKey: keyBytes,
    certificate: certBytes,
    reason: 'Approval',
    timeStampAuthority: true
})

Hierarchy (View Summary)

PdfSignatureObject
- PdfEtsiCadesDetachedSignatureObject

Constructors

constructor

new PdfEtsiCadesDetachedSignatureObject(
    options: PdfSignatureSignOptions & {
        additionalCertificates?: ByteArray[];
        algorithm?: AsymmetricEncryptionAlgorithmParams;
        certificate: ByteArray;
        issuerCertificate?: ByteArray;
        policyDocument?: SignaturePolicyDocument;
        privateKey: ByteArray;
        revocationInfo?: RevocationInfo | "fetch";
        timeStampAuthority?: true | TimeStampAuthority;
    },
): PdfEtsiCadesDetachedSignatureObject
Creates a new CAdES detached signature object.
Parameters
- options: PdfSignatureSignOptions & {
      additionalCertificates?: ByteArray[];
      algorithm?: AsymmetricEncryptionAlgorithmParams;
      certificate: ByteArray;
      issuerCertificate?: ByteArray;
      policyDocument?: SignaturePolicyDocument;
      privateKey: ByteArray;
      revocationInfo?: RevocationInfo | "fetch";
      timeStampAuthority?: true | TimeStampAuthority;
  }
  Signature configuration options.
Returns PdfEtsiCadesDetachedSignatureObject
Overrides PdfSignatureObject.constructor
- Defined in packages/pdf-lite/src/signing/signatures/etsi-cades-detached.ts:76

Properties

additionalCertificates

additionalCertificates: ByteArray[]

Additional certificates for chain building.

`Optional`algorithm

algorithm?: AsymmetricEncryptionAlgorithmParams

Signature algorithm parameters.

certificate

certificate: ByteArray

Signer certificate.

content

content: PdfSignatureDictionary

`Optional`date

date?: Date

Signing date.

`Optional`encryptable

encryptable?: boolean

generationNumber

generationNumber: number

`Optional`issuerCertificate

issuerCertificate?: ByteArray

Issuer certificate for OCSP requests.

`Optional`location

location?: string

Signing location.

`Protected`modified

modified: boolean = true

Indicates whether the object has been modified. By default, assume it has been modified because it's a new object

objectNumber

objectNumber: number

offset

offset: Ref<number>

`Optional`orderIndex

orderIndex?: number

`Optional`policyDocument

policyDocument?: SignaturePolicyDocument

Signature policy document reference.

`Optional`postTokens

postTokens?: PdfToken[]

Optional tokens to prepend or append during serialization

`Optional`preTokens

preTokens?: PdfToken[]

Optional tokens to prepend or append during serialization

privateKey

privateKey: ByteArray

Private key for signing.

`Optional`reason

reason?: string

Reason for signing.

`Optional`revocationInfo

revocationInfo?: RevocationInfo | "fetch"

Revocation information or 'fetch' to retrieve automatically.

sign

sign: (
options: { bytes: ByteArray; embedRevocationInfo?: boolean },
) => Promise<{ revocationInfo?: RevocationInfo; signedBytes: ByteArray }> = ...

Signs the document bytes using CAdES detached format.

Type Declaration

- (
  options: { bytes: ByteArray; embedRevocationInfo?: boolean },
  ): Promise<{ revocationInfo?: RevocationInfo; signedBytes: ByteArray }>
- Signs the document bytes and returns the signature.
  Parameters
  - options: { bytes: ByteArray; embedRevocationInfo?: boolean }
    Signing options including bytes to sign.
  Returns Promise<{ revocationInfo?: RevocationInfo; signedBytes: ByteArray }>
  The signed bytes and optional revocation information.

Param: options

Signing options with bytes and revocation embedding flag.

Returns

The CMS SignedData and revocation information.

`Optional`timeStampAuthority

timeStampAuthority?: TimeStampAuthority

Timestamp authority configuration.

`Static` `Readonly`MAX_ORDER_INDEX

MAX_ORDER_INDEX: 2147483647

Accessors

objectType

get objectType(): string
The type of this PDF object

Returns string
Inherited from PdfSignatureObject.objectType
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:17

reference

get reference(): PdfObjectReference
Returns PdfObjectReference
Inherited from PdfSignatureObject.reference
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:48

signedBytes

get signedBytes(): ByteArray
Gets the raw signature bytes.

Returns ByteArray
The signature bytes.
Inherited from PdfSignatureObject.signedBytes
- Defined in packages/pdf-lite/src/signing/signatures/base.ts:172

signedHexadecimal

get signedHexadecimal(): PdfHexadecimal
Gets the signature hexadecimal content.

Returns PdfHexadecimal
The Contents entry as hexadecimal.

Throws
Error if Contents entry is missing.
Inherited from PdfSignatureObject.signedHexadecimal
- Defined in packages/pdf-lite/src/signing/signatures/base.ts:158

Methods

as

as<T extends PdfObject>(ctor: new (...args: any[]) => T): T
Attempts to cast the object to a specific PdfObject subclass
Type Parameters
- T extends PdfObject
Parameters
- ctor: new (...args: any[]) => T
Returns T
Inherited from PdfSignatureObject.as
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:65

clone

clone(): this
Creates a deep clone of the object

Returns this
Inherited from PdfSignatureObject.clone
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:117

equals

equals(other?: PdfObject): boolean
Compares this object to another for equality based on their token representations
Parameters
- Optionalother: PdfObject
Returns boolean
Inherited from PdfSignatureObject.equals
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:79

inPdf

inPdf(): boolean
Returns boolean
Inherited from PdfSignatureObject.inPdf
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:92

isEncryptable

isEncryptable(): boolean
Returns boolean
Inherited from PdfSignatureObject.isEncryptable
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:66

isModified

isModified(): boolean
Indicates whether the object has been modified. Override this method if the modified state is determined differently

Returns boolean
Inherited from PdfSignatureObject.isModified
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:130

matchesReference

matchesReference(ref?: PdfObjectReference): boolean
Parameters
- Optionalref: PdfObjectReference
Returns boolean
Inherited from PdfSignatureObject.matchesReference
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:96

order

order(): number
Gets the insertion order for this object in the PDF.

Returns number
High order value to place signature near end of document.
Inherited from PdfSignatureObject.order
- Defined in packages/pdf-lite/src/signing/signatures/base.ts:226

setByteRange

setByteRange(byteRange: number[]): void
Sets the byte range array for the signature.
Parameters
- byteRange: number[]
  Array of [offset1, length1, offset2, length2].
Returns void
Throws
Error if ByteRange entry is missing.
Inherited from PdfSignatureObject.setByteRange
- Defined in packages/pdf-lite/src/signing/signatures/base.ts:201

setModified

setModified(modified?: boolean): void
Sets the modified state of the object. Override this method if the modified state is determined differently
Parameters
- modified: boolean = true
Returns void
Inherited from PdfSignatureObject.setModified
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:27

setSignedBytes

setSignedBytes(signedBytes: ByteArray): void
Sets the signed bytes in the signature dictionary.
Parameters
- signedBytes: ByteArray
  The signature bytes to set.
Returns void
Throws
Error if Contents entry is missing.
Inherited from PdfSignatureObject.setSignedBytes
- Defined in packages/pdf-lite/src/signing/signatures/base.ts:182

toBytes

toBytes(padTo?: number): ByteArray
Converts the object to a ByteArray, optionally padding to a specified length
Parameters
- OptionalpadTo: number
Returns ByteArray
Inherited from PdfSignatureObject.toBytes
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:41

`Protected`tokenize

tokenize(): PdfToken[]
Tokenizes the object into an array of PdfTokens

Returns PdfToken[]
Inherited from PdfSignatureObject.tokenize
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:106

toString

toString(): string
Converts the object to a string representation

Returns string
Inherited from PdfSignatureObject.toString
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:56

toTokens

toTokens(): PdfToken[]
Converts the object to an array of PdfTokens, including any pre or post tokens

Returns PdfToken[]
Inherited from PdfSignatureObject.toTokens
- Defined in packages/pdf-lite/src/core/objects/pdf-object.ts:32

`Static`createPlaceholder

createPlaceholder<T extends PdfObject>(
    objectNumber?: number,
    generationNumber?: number,
    content?: T,
): PdfIndirectObject<T extends unknown ? PdfNull : T>
Type Parameters
- T extends PdfObject
Parameters
- OptionalobjectNumber: number
- OptionalgenerationNumber: number
- Optionalcontent: T
Returns PdfIndirectObject<T extends unknown ? PdfNull : T>
Inherited from PdfSignatureObject.createPlaceholder
- Defined in packages/pdf-lite/src/core/objects/pdf-indirect-object.ts:79

Class PdfEtsiCadesDetachedSignatureObject

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns PdfEtsiCadesDetachedSignatureObject

Properties

additionalCertificates

Optionalalgorithm

certificate

content

Optionaldate

Optionalencryptable

generationNumber

OptionalissuerCertificate

Optionallocation

Protectedmodified

objectNumber

offset

OptionalorderIndex

OptionalpolicyDocument

OptionalpostTokens

OptionalpreTokens

privateKey

Optionalreason

OptionalrevocationInfo

sign

Type Declaration

Parameters

Returns Promise<{ revocationInfo?: RevocationInfo; signedBytes: ByteArray }>

Param: options

Returns

OptionaltimeStampAuthority

Static ReadonlyMAX_ORDER_INDEX

Accessors

objectType

Returns string

reference

Returns PdfObjectReference

signedBytes

Returns ByteArray

signedHexadecimal

Returns PdfHexadecimal

Throws

Methods

as

Type Parameters

Parameters

Returns T

clone

Returns this

equals

Parameters

Returns boolean

inPdf

Returns boolean

isEncryptable

Returns boolean

isModified

Returns boolean

matchesReference

Parameters

Returns boolean

order

Returns number

setByteRange

Parameters

Returns void

Throws

setModified

Parameters

Returns void

setSignedBytes

Parameters

`Optional`algorithm

`Optional`date

`Optional`encryptable

`Optional`issuerCertificate

`Optional`location

`Protected`modified

`Optional`orderIndex

`Optional`policyDocument

`Optional`postTokens

`Optional`preTokens

`Optional`reason

`Optional`revocationInfo

`Optional`timeStampAuthority

`Static` `Readonly`MAX_ORDER_INDEX

`Protected`tokenize

`Static`createPlaceholder