SetaPDF_Signer_DocumentSecurityStore Class representing a "Document Security Store" in a PDF document.

File: /SetaPDF v2/Signer/DocumentSecurityStore.php

Class hierarchy

Summary

Properties

$_document

protected SetaPDF_Core_Document SetaPDF_Signer_DocumentSecurityStore::$_document

The document instance


Methods

__construct()

The constructor.

Parameters
$document : SetaPDF_Core_Document
 

_addStream()

Adds a stream to the DSS data.

Parameters
$type : string

The type/key to which the data should be added.

$data : string
 

_getStreams()

protected SetaPDF_Signer_DocumentSecurityStore::_getStreams (
string $type
): array

Get a stream by its type from the DSS dictionary.

Parameters
$type : string
 

addCRL()

Add a CRL to the CRLs entry in the DSS dictionary.

Parameters
$crl : string
 

addCRLs()

public SetaPDF_Signer_DocumentSecurityStore::addCRLs (
string[] $crls
): void

Add CRLs to the CRLs entry in the DSS dictionary.

Parameters
$crls : string[]
 

addCertificate()

Add a certificate to the Certs entry in the DSS dictionary.

Parameters
$certificate : string
 

addCertificates()

public SetaPDF_Signer_DocumentSecurityStore::addCertificates (
string[] $certificates
): void

Add certificates to the Certs entry in the DSS dictionary.

Parameters
$certificates : string[]
 

addOCSP()

Add a OCSP response to the OCSPs entry in the DSS dictionary.

Parameters
$ocsp : string
 

addOCSPs()

public SetaPDF_Signer_DocumentSecurityStore::addOCSPs (
string[] $ocsps
): void

Add OCSP responses to the OCSPs entry in the DSS dictionary.

Parameters
$ocsps : string[]
 

addValidationRelatedInfo()

public SetaPDF_Signer_DocumentSecurityStore::addValidationRelatedInfo (
string $key [, array $crls = array ( ) [, array $ocsps = array ( ) [, array $certs = array ( ) [, null|SetaPDF_Core_DataStructure_Date|DateTime|string $timestamp = null ]]]]
): void

Add validation related information to the VRI dictionary of the DSS dictionary.

Parameters
$key : string

The sha1 digest of the signature.

$crls : array

An array of strings or SetaPDF_Core_Type_IndirectObjectInterface to streams of the CRLs.

$ocsps : array

An array of strings or SetaPDF_Core_Type_IndirectObjectInterface to streams of the OCSPs.

$certs : array

An array of strings or SetaPDF_Core_Type_IndirectObjectInterface to streams of the certs.

$timestamp : null|SetaPDF_Core_DataStructure_Date|DateTime|string
 

addValidationRelatedInfoByField()

public SetaPDF_Signer_DocumentSecurityStore::addValidationRelatedInfoByField (
string $fieldName [, array $crls = array ( ) [, array $ocsps = array ( ) [, array $certs = array ( ) [, null|SetaPDF_Core_DataStructure_Date|DateTime|string $timestamp = null ]]]]
): void

Add validation related information to the VRI dictionary of the DSS dictionary by a specific signature field.

Parameters
$fieldName : string

The signature field name.

$crls : array

An array of strings or SetaPDF_Core_Type_IndirectObjectInterface to streams of the CRLs.

$ocsps : array

An array of strings or SetaPDF_Core_Type_IndirectObjectInterface to streams of the OCSPs.

$certs : array

An array of strings or SetaPDF_Core_Type_IndirectObjectInterface to streams of the certs.

$timestamp : null|SetaPDF_Core_DataStructure_Date|DateTime|string
 

cleanUp()

Release cycled references.

getCRLs()

Get all CRLs the OCSPs entry in the DSS dictionary.

getCertificates()

Get all certificates from the Certs entry in the DSS dictionary.

getDictionary()

Get and/or creates the DSS dictionary.

Parameters
$create : bool
 

getOCSPs()

Get all OCSP responses from the OCSPs entry in the DSS dictionary.

getSignatureDigest()

public SetaPDF_Signer_DocumentSecurityStore::getSignatureDigest (
string $fieldName
): string

Get the signature digest of a signature field, which can be used as an index in the VRI dictionary.

For a document signature the bytes that are hashed are those of the signature's DER-encoded PKCS#7 (and its derivatives) binary data object (base-16 decoded byte string in the Contents entry in the signature dictionary).

For the signatures of the CRL and OCSP response, it is the respective signature object represented as a BER-encoded OCTET STRING encoded with primitive encoding.

For a Time-stamp's signature it is the bytes of the Time-stamp itself since the Time-stamp token is a signed data object.
Parameters
$fieldName : string
 

getValidationRelatedInfo()

public SetaPDF_Signer_DocumentSecurityStore::getValidationRelatedInfo (
[ null|string $key = null ]
): array|array[]|bool

Get validation related information.

Parameters
$key : null|string

The sha1 digest of the signature to get a specific information. Otherwise all found validation data is returend.

getValidationRelatedInfoByField()

public SetaPDF_Signer_DocumentSecurityStore::getValidationRelatedInfoByField (
string $fieldName
): array|array[]|bool

Get validation related information by a signature field name.

Parameters
$fieldName : string

The signature field name.