Struct secureblackbox::XAdESSigner

Properties   Methods   Events   Config Settings   Errors  

The XAdESSigner struct creates XAdES-compliant signature files.

Syntax

secureblackbox::XAdESSigner

Remarks

XAdESSigner can sign XML documents in accordance with XAdES standard. Originally developed and adopted in the European Union, XAdES has quickly become a recognized international standard for signing XML documents. XAdES provides a convenient framework for creating short-lived and long-term signatures over any kind of XML documents, and is now used by governments, healthcare providers, banks, and independent service providers all across the globe. XAdESSigner signer = new XAdESSigner(); signer.getNewSignature().setHashAlgorithm("SHA512"); // Default hashing algorithm SHA256 signer.getNewSignature().setLevel(XAdESSignature.aslBaselineT); // Level of the signature // Select the document which contains the file that will be signed signer.setInputFile("MyFile.xml"); // Select the path where you want to save the signed document signer.setOutputFile("signedFile.xml"); // The certificate which the document will be signed with signer.setSigningCertificate(new Certificate("test.pfx","test")); // Provide the address of the Time Stamping Authority (TSA) server to be used for timestamping the signature signer.setTimestampServer("http://time.certum.pl"); signer.sign();

Standards and technologies supported

XAdESSigner offers the following signing capabilities:

• Create and upgrade XAdES signatures in accordance with the most recent XAdES specification (ETSI EN 319 132). Earlier versions are also supported.
• All profiles are supported (BES, EPES, T, C, X, XL, A, including the Extended variants).
• Timestamping using external TSAs.
• All industry-standard cryptographic algorithms (RSA, ECDSA, SHA256-512, and many others).

Configuring the signature parameters

Configuring XAdESSigner to make it produce a signature of the right type is the main task you would need to perform in your code. Normally the service or software you will be communicating your XML documents to will provide you with the list of requirements that your signatures should match.

Typically, those will dictate the following key aspects of the signatures:

• The signature Form, sometimes referred to as Level (such BES, T, XL, A, or Extended-XLong). This can be adjusted with the new_sig_level property.
• Whether the signature should be detached, enveloped, or enveloping: adjust via new_sig_signature_type property.
• When creating a timestamped signature (such as T or A), provide the address of your online TSA service via timestamp_server property.
• When creating long-term signatures that include the signing chain and validation material, tune up validation parameters via revocation_check, offline_mode, and ignore_chain_validation_errors properties.

In some circumstances you will also need to adjust the following lower-level settings:

• Choose a specific XAdES version between 1.4.1, 1.3.2, 1.2.2, and 1.1.1, and assign it to new_sig_xades_version property.
• Specify the needed canonicalization method using the new_sig_canonicalization_method property.
• Provide the hash algorithm via the new_sig_hash_algorithm property.

Signing certificates

XAdESSigner can use certificates residing on different media. Besides generic certificates stored in PFX or PEM files (A1), it can operate with non-exportable certificates residing on hardware media (A3) or in the cloud.

Non-exportable certificates can be accessed transparently via a Windows CSP or a PKCS#11 driver, if supplied by the certificate issuer. Proprietary interfaces can be plugged in with the external signing feature (see below).

You can use CertificateManager and CertificateStorage components to access the signing certificate. Assign the certificate to signing_certificate property, and optionally provide the remainder of its chain via signing_chain property.

Note: If signing with a non-exportable key (such as residing on a hardware device or in the cloud), please make sure you keep the original CertificateStorage object open until the signing is completed. This is because the storage component provides a 'bridge' to the private key. If the storage is closed prematurely, this bridge is destroyed, and the private key can't be used.

You don't need to provide a signing certificate or chain when timestamping and upgrading signatures, since this type of operation does not involve the signing private key.

Signing the document

Now that you have set up all signature properties and attached the signing certificate, it is time to proceed to signing. You can provide the input document in one of the following forms: as a file (assign the path to input_file property), as a stream (assign to input_stream property), or as a byte array (assign to input_bytes). Similarly, the output can be collected in one of the same forms, either by passing the destination path or stream via output_file and output_stream respectively, or by reading the resulting document bytes from the output_bytes property after the signing completes.

Having set up the input and output (unless using output_bytes, which should be read later), call the component's sign method. This will initiate the signing process. Depending on the settings, the signing may be as straightforward as calculating the document hash and signing it with the private key (e.g. in XAdES-BES variant), or it may involve advanced chain validation routines (XAdES-XL or -A). During the latter the component may contact a number of external revocation information sources (CRL and OCSP servers) to establish the validity of the signing certificate.

If a TSA server was provided via the timestamp_server property, the component will contact it too to timestamp the new signature.

During the signing XAdESSigner may fire events to let your code know of certain conditions. It may fire on_tls_cert_validate if one of the HTTP endpoints involved in the operation (which may be a CRL, OCSP, or TSA service) works over TLS and needs its certificate to be validated. It may also fire on_format_element and on_format_text to let your code apply custom formatting to XML document elements. If XAdESSigner fails to resolve one of the references in the signature, it will fire on_resolve_reference to let your code help with resolving it.

When the signing operation completes, the output file, stream, or byte array will contain the signature of the requested kind. Note that while enveloped and enveloping signatures contain the signed content within them, detached signatures assume that you supply the original content separately.

Apart from signing, XAdESSigner can perform operations on signatures of other kinds. Use upgrade method to upgrade an existing XAdES signature to a higher level (e.g. BES to XL). Use timestamp to add a generic or validation timestamp to an existing signature.

External signing and DCAuth

XAdESSigner, like many other components offered by the product, supports two methods of signing with external keys. These methods are fully independent of each other: you can choose the one that suits your usage scenario best.

Synchronous method: ExternalSign

This is a simpler method that basically lets you infiltrate into the heart of the signing routine by taking care of the hash signing operation. The component does the rest of the job (hash calculation, preparation of signature objects, CRL/OCSP retrieval).

To initiate this method, call sign_external instead of sign. When the hash is ready, it will be passed back to your code with on_external_sign event. Your event handler needs to sign the hash with the private key and return the created signature back to the component - which will embed it into the document.

You don't need your signing certificate to contain an associated private key when using this method. The certificate itself (its public copy) may be needed though, as it is often included in the hash calculation.

This method is synchronous, meaning sign_external provides you the results immediately upon its completion.

Asynchronous method: DCAuth

DCAuth is a SecureBlackbox-own know-how technology. This protocol was designed to allow sharing of private keys across environments, allowing the signer and the private key to reside on different systems. It works in the following way:

• The signing party - such as XAdESSigner - initiates the operation using sign_async_begin call. This produces two outcomes: a pre-signed document (a document with a blank signature placeholder), and a request state (an object containing a hash that needs to be signed). At this point the XAdESSigner instance can be released, and the process itself terminated (which may be useful when run as part of a web page).
• The request state is passed to the private key holder party. The private key holder passes the request state to a DCAuth object, which parses the request state, extracts the hash, and signs it. The output of DCAuth processing is another object, response state, which contains the signature. The private key holder then sends the response state back to the signing party.
• The signing party re-creates the controls, and passes the response state, together with the pre-signed version of the document, to the signer's sign_async_end method. sign_async_end extracts the signature from the response state and incorporates it into the pre-signed document.

This method is asynchronous in that sense that, from the signing party's viewpoint, it splits the signing operation into the pre-signing and completion stages which can be performed independently from each other and in different execution contexts. This makes this method particularly helpful for use in web pages and other scenarios where the signing key is not available in real time.

Fine-grained chain validation setup

Chain validation is a sophisticated, multi-faceted procedure that involves a lot of variables. Depending on the configuration of your operating environment, the specifics of the PKI framework being used, and the validation policy you need to follow, you may want to tune up your chain validation parameters so they fit them best. A summary of such parameters is given below.

• revocation_check lets you choose between and/or prioritize revocation origins. OCSP sources are often preferred to CRL because of their real-time capability and the smaller size of validation tokens they produce.
• offline_mode is a master switch that stops the struct from looking for any validation tokens online. If this property is switched on, the struct will only use the known_certificates, trusted_certificates, known_crls, and known_ocsps collections to look for the missing validation material.
• ignore_chain_validation_errors makes the struct ignore any major validation issues it encounters (such us an untrusted chain or missing CRL). This option is handy for debugging and for creating signatures in the environments where the signing certificate is not trusted.
• known_certificates, known_crls, and known_ocsps let you provide your own validation material. This may be useful when working in offline_mode, where the signer has no access to the validation sources, or where the validation material has already been collected.
• trusted_certificates lets you provide a list of trust anchors, either as a complement to the system's or as an alternative to it.
• blocked_certificates lets you provide a list of blocked/distrusted certificates. Any CA certificate contained in it will be deemed untrusted/invalid.

The following parameters are not directly related to chain validation, but may have an implicit effect on it.

• proxy, socket_settings, and tls_settings let you tune up the connectivity and TLS options in accordance with local preferences.
• tls_client_chain lets you provide the client certificate and its chain for TLS client authentication.
• Subscribe to on_tls_cert_validate to validate any TLS certificates of the services involved in chain validation.

The results of the chain validation procedure, upon its completion, are published in the following properties:

• chain_validation_result contains the primary result of the chain validation routine: valid, valid but untrusted, invalid, or undefined.
• chain_validation_details provides the details of the factors that contributed to the chain validation result, such as an outdated certificate, a missing CRL, or a missing CA certificate.
• validation_log contains the detailed chain validation log. The log can often be very helpful in nailing down various validation issues.

Object Lifetime

The new() method returns a mutable reference to a struct instance. The object itself is kept in the global list maintained by SecureBlackbox. Due to this, the XAdESSigner struct cannot be disposed of automatically. Please, call the dispose(&mut self) method of XAdESSigner when you have finished using the instance.

Property List

---

The following is the full list of the properties of the struct with short descriptions. Click on the links for further details.

Method List

---

The following is the full list of the methods of the struct with short descriptions. Click on the links for further details.

Event List

---

The following is the full list of the events fired by the struct with short descriptions. Click on the links for further details.

Config Settings

---

The following is a list of config settings for the struct with short descriptions. Click on the links for further details.

auto_validate_signatures property (XAdESSigner Struct)

Specifies whether struct should validate any present signatures when the document is opened.

Syntax

fn auto_validate_signatures(&self ) -> Result<bool, SecureBlackboxError> 
fn set_auto_validate_signatures(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

This setting is switched off by default to speed up document processing. Even if the document is loaded with this property set to false, you can validate the signatures manually on a later stage using the revalidate method.

Data Type

bool

blocked_cert_count property (XAdESSigner Struct)

The number of records in the BlockedCert arrays.

Syntax

fn blocked_cert_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_blocked_cert_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• blocked_cert_bytes
• blocked_cert_handle

The array indices start at 0 and end at blocked_cert_count - 1.

Data Type

i32

blocked_cert_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn blocked_cert_bytes(&self , BlockedCertIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

The BlockedCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BlockedCertCount property.

This property is read-only.

Data Type

Vec

blocked_cert_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn blocked_cert_handle(&self , BlockedCertIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_blocked_cert_handle(&self, BlockedCertIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The BlockedCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the BlockedCertCount property.

Data Type

i64

check_trusted_lists property (XAdESSigner Struct)

Specifies whether the struct should attempt to validate chain trust via a known Trusted List.

Syntax

fn check_trusted_lists(&self ) -> Result<bool, SecureBlackboxError> 
fn set_check_trusted_lists(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Set this property to true to enable the component to validate chain trust against an internal list of known Trusted Lists (such as EUTL).

Data Type

bool

crl_count property (XAdESSigner Struct)

The number of records in the CRL arrays.

Syntax

fn crl_count(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• crl_bytes
• crlca_key_id
• crl_entry_count
• crl_handle
• crl_issuer
• crl_issuer_rdn
• crl_location
• crl_next_update
• crl_sig_algorithm
• crl_source
• crltbs
• crl_this_update

The array indices start at 0 and end at crl_count - 1.

This property is read-only.

Data Type

i32

crl_bytes property (XAdESSigner Struct)

Returns the raw CRL data in DER format.

Syntax

fn crl_bytes(&self , CRLIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw CRL data in DER format.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

Vec

crlca_key_id property (XAdESSigner Struct)

A unique identifier (fingerprint) of the CA certificate's private key, if present in the CRL.

Syntax

fn crlca_key_id(&self , CRLIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

A unique identifier (fingerprint) of the CA certificate's private key, if present in the CRL.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

Vec

crl_entry_count property (XAdESSigner Struct)

Returns the number of certificate status entries in the CRL.

Syntax

fn crl_entry_count(&self , CRLIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

Returns the number of certificate status entries in the CRL.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

i32

crl_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn crl_handle(&self , CRLIndex : i32) -> Result<i64, SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

i64

crl_issuer property (XAdESSigner Struct)

The common name of the CRL issuer (CA), typically a company name.

Syntax

fn crl_issuer(&self , CRLIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The common name of the CRL issuer (CA), typically a company name.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

String

crl_issuer_rdn property (XAdESSigner Struct)

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the CRL issuer.

Syntax

fn crl_issuer_rdn(&self , CRLIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

A collection of information, in the form of [OID, Value] pairs, uniquely identifying the CRL issuer.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

String

crl_location property (XAdESSigner Struct)

The URL that the CRL was downloaded from.

Syntax

fn crl_location(&self , CRLIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The URL that the CRL was downloaded from.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

String

crl_next_update property (XAdESSigner Struct)

The planned time and date of the next version of this CRL to be published.

Syntax

fn crl_next_update(&self , CRLIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The planned time and date of the next version of this CRL to be published.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

String

crl_sig_algorithm property (XAdESSigner Struct)

The public key algorithm that was used by the CA to sign this CRL.

Syntax

fn crl_sig_algorithm(&self , CRLIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

"0"

Remarks

The public key algorithm that was used by the CA to sign this CRL.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

String

crl_source property (XAdESSigner Struct)

Returns the source (location or disposition) of a cryptographic primitive entity, such as a certificate, CRL, or OCSP response.

Syntax

fn crl_source(&self , CRLIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Unknown
1   // Signature
2   // Document
3   // User
4   // Local
5   // Online

Default Value

0

Remarks

Returns the source (location or disposition) of a cryptographic primitive entity, such as a certificate, CRL, or OCSP response.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

i32

crltbs property (XAdESSigner Struct)

The to-be-signed part of the CRL (the CRL without the signature part).

Syntax

fn crltbs(&self , CRLIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

The to-be-signed part of the CRL (the CRL without the signature part).

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

Vec

crl_this_update property (XAdESSigner Struct)

The date and time at which this version of the CRL was published.

Syntax

fn crl_this_update(&self , CRLIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The date and time at which this version of the CRL was published.

The CRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CRLCount property.

This property is read-only.

Data Type

String

data_bytes property (XAdESSigner Struct)

Use this property to pass the external data to struct in the byte array form.

Syntax

fn data_bytes(&self ) -> Result<Vec<u8>, SecureBlackboxError> 
fn set_data_bytes(&self, value : Vec<u8>) ->  Option<SecureBlackboxError> 
fn set_data_bytes_ref(&self, value : &[u8]) ->  Option<SecureBlackboxError> 

Remarks

Assign a byte array containing the external data to be processed to this property.

Data Type

Vec

data_file property (XAdESSigner Struct)

A file containing the external data covered by a detached signature.

Syntax

fn data_file(&self ) -> Result<String, SecureBlackboxError> 
fn set_data_file(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_data_file_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

In the case of a detached signature, use this property to provide the external data to the struct from a file. Alternatively, provide the data via data_stream.

Data Type

String

data_type property (XAdESSigner Struct)

Specifies the external data type.

Syntax

fn data_type(&self ) -> Result<i32, SecureBlackboxError> 
fn set_data_type(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // XML
1   // Binary
2   // Base64

Default Value

0

Remarks

Use this property to specify the type of the external data (either data_file, data_stream or data_bytes properties) for struct.

Data Type

i32

data_uri property (XAdESSigner Struct)

Specifies a detached data resource URI.

Syntax

fn data_uri(&self ) -> Result<String, SecureBlackboxError> 
fn set_data_uri(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_data_uri_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Specifies a URI used for data being signed, usually the data filename if stored along with a detached signature.

Data Type

String

encoding property (XAdESSigner Struct)

Specifies XML encoding.

Syntax

fn encoding(&self ) -> Result<String, SecureBlackboxError> 
fn set_encoding(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_encoding_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify the encoding to apply to the XML documents.

Data Type

String

external_crypto_async_document_id property (XAdESSigner Struct)

Specifies an optional document ID for SignAsyncBegin() and SignAsyncEnd() calls.

Syntax

fn external_crypto_async_document_id(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_async_document_id(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_async_document_id_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Specifies an optional document ID for SignAsyncBegin() and SignAsyncEnd() calls.

Use this property when working with multi-signature DCAuth requests and responses to uniquely identify documents signed within a larger batch. On the completion stage, this value helps the signing component identify the correct signature in the returned batch of responses.

If using batched requests, make sure to set this property to the same value on both the pre-signing (SignAsyncBegin) and completion (SignAsyncEnd) stages.

Data Type

String

external_crypto_custom_params property (XAdESSigner Struct)

Custom parameters to be passed to the signing service (uninterpreted).

Syntax

fn external_crypto_custom_params(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_custom_params(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_custom_params_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Custom parameters to be passed to the signing service (uninterpreted).

Data Type

String

external_crypto_data property (XAdESSigner Struct)

Additional data to be included in the async state and mirrored back by the requestor.

Syntax

fn external_crypto_data(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_data(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_data_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Additional data to be included in the async state and mirrored back by the requestor.

Data Type

String

external_crypto_external_hash_calculation property (XAdESSigner Struct)

Specifies whether the message hash is to be calculated at the external endpoint.

Syntax

fn external_crypto_external_hash_calculation(&self ) -> Result<bool, SecureBlackboxError> 
fn set_external_crypto_external_hash_calculation(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether the message hash is to be calculated at the external endpoint. Please note that this mode is not supported by the DCAuth struct.

If set to true, the struct will pass a few kilobytes of to-be-signed data from the document to the OnExternalSign event. This only applies when SignExternal() is called.

Data Type

bool

external_crypto_hash_algorithm property (XAdESSigner Struct)

Specifies the request's signature hash algorithm.

Syntax

fn external_crypto_hash_algorithm(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_hash_algorithm(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_hash_algorithm_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

"SHA256"

Remarks

Specifies the request's signature hash algorithm.

Data Type

String

external_crypto_key_id property (XAdESSigner Struct)

The ID of the pre-shared key used for DC request authentication.

Syntax

fn external_crypto_key_id(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_key_id(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_key_id_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The ID of the pre-shared key used for DC request authentication.

Asynchronous DCAuth-driven communication requires that parties authenticate each other with a secret pre-shared cryptographic key. This provides an extra protection layer for the protocol and diminishes the risk of the private key becoming abused by foreign parties. Use this property to provide the pre-shared key identifier, and use external_crypto_key_secret to pass the key itself.

The same KeyID/KeySecret pair should be used on the DCAuth side for the signing requests to be accepted.

Note: The KeyID/KeySecret scheme is very similar to the AuthKey scheme used in various Cloud service providers to authenticate users.

Example: signer.ExternalCrypto.KeyID = "MainSigningKey"; signer.ExternalCrypto.KeySecret = "abcdef0123456789";

Data Type

String

external_crypto_key_secret property (XAdESSigner Struct)

The pre-shared key used for DC request authentication.

Syntax

fn external_crypto_key_secret(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_key_secret(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_key_secret_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The pre-shared key used for DC request authentication. This key must be set and match the key used by the DCAuth counterpart for the scheme to work.

Read more about configuring authentication in the external_crypto_key_id topic.

Data Type

String

external_crypto_method property (XAdESSigner Struct)

Specifies the asynchronous signing method.

Syntax

fn external_crypto_method(&self ) -> Result<i32, SecureBlackboxError> 
fn set_external_crypto_method(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // PKCS1
1   // PKCS7

Default Value

0

Remarks

Specifies the asynchronous signing method. This is typically defined by the DC server capabilities and setup.

Available options:

Data Type

i32

external_crypto_mode property (XAdESSigner Struct)

Specifies the external cryptography mode.

Syntax

fn external_crypto_mode(&self ) -> Result<i32, SecureBlackboxError> 
fn set_external_crypto_mode(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Default
1   // Disabled
2   // Generic
3   // DCAuth
4   // DCAuthJSON

Default Value

0

Remarks

Specifies the external cryptography mode.

Available options:

Data Type

i32

external_crypto_public_key_algorithm property (XAdESSigner Struct)

Provide the public key algorithm here if the certificate is not available on the pre-signing stage.

Syntax

fn external_crypto_public_key_algorithm(&self ) -> Result<String, SecureBlackboxError> 
fn set_external_crypto_public_key_algorithm(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_external_crypto_public_key_algorithm_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Provide the public key algorithm here if the certificate is not available on the pre-signing stage.

Data Type

String

fips_mode property (XAdESSigner Struct)

Reserved.

Syntax

fn fips_mode(&self ) -> Result<bool, SecureBlackboxError> 
fn set_fips_mode(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

This property is reserved for future use.

Data Type

bool

ignore_chain_validation_errors property (XAdESSigner Struct)

Makes the struct tolerant to chain validation errors.

Syntax

fn ignore_chain_validation_errors(&self ) -> Result<bool, SecureBlackboxError> 
fn set_ignore_chain_validation_errors(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

If this property is set to True, any errors emerging during certificate chain validation will be ignored. This setting may be handy if the purpose of validation is the creation of an LTV signature, and the validation is performed in an environment that doesn't trust the signer's certificate chain.

Data Type

bool

input_bytes property (XAdESSigner Struct)

Use this property to pass the input to struct in byte array form.

Syntax

fn input_bytes(&self ) -> Result<Vec<u8>, SecureBlackboxError> 
fn set_input_bytes(&self, value : Vec<u8>) ->  Option<SecureBlackboxError> 
fn set_input_bytes_ref(&self, value : &[u8]) ->  Option<SecureBlackboxError> 

Remarks

Assign a byte array containing the data to be processed to this property.

Data Type

Vec

input_file property (XAdESSigner Struct)

The XML document to sign.

Syntax

fn input_file(&self ) -> Result<String, SecureBlackboxError> 
fn set_input_file(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_input_file_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Provide a path to the XML file to sign.

Data Type

String

known_cert_count property (XAdESSigner Struct)

The number of records in the KnownCert arrays.

Syntax

fn known_cert_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_known_cert_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• known_cert_bytes
• known_cert_handle

The array indices start at 0 and end at known_cert_count - 1.

Data Type

i32

known_cert_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn known_cert_bytes(&self , KnownCertIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

The KnownCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCertCount property.

This property is read-only.

Data Type

Vec

known_cert_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn known_cert_handle(&self , KnownCertIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_known_cert_handle(&self, KnownCertIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The KnownCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCertCount property.

Data Type

i64

known_crl_count property (XAdESSigner Struct)

The number of records in the KnownCRL arrays.

Syntax

fn known_crl_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_known_crl_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• known_crl_bytes
• known_crl_handle

The array indices start at 0 and end at known_crl_count - 1.

Data Type

i32

known_crl_bytes property (XAdESSigner Struct)

Returns the raw CRL data in DER format.

Syntax

fn known_crl_bytes(&self , KnownCRLIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw CRL data in DER format.

The KnownCRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCRLCount property.

This property is read-only.

Data Type

Vec

known_crl_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn known_crl_handle(&self , KnownCRLIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_known_crl_handle(&self, KnownCRLIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The KnownCRLIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownCRLCount property.

Data Type

i64

known_ocsp_count property (XAdESSigner Struct)

The number of records in the KnownOCSP arrays.

Syntax

fn known_ocsp_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_known_ocsp_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• known_ocsp_bytes
• known_ocsp_handle

The array indices start at 0 and end at known_ocsp_count - 1.

Data Type

i32

known_ocsp_bytes property (XAdESSigner Struct)

A buffer containing the raw OCSP response data.

Syntax

fn known_ocsp_bytes(&self , KnownOCSPIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

A buffer containing the raw OCSP response data.

The KnownOCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownOCSPCount property.

This property is read-only.

Data Type

Vec

known_ocsp_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn known_ocsp_handle(&self , KnownOCSPIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_known_ocsp_handle(&self, KnownOCSPIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The KnownOCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the KnownOCSPCount property.

Data Type

i64

new_sig_canonicalization_method property (XAdESSigner Struct)

The XML canonicalization method that was used for signing.

Syntax

fn new_sig_canonicalization_method(&self ) -> Result<i32, SecureBlackboxError> 
fn set_new_sig_canonicalization_method(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // None
1   // Canon
2   // CanonComment
3   // ExclCanon
4   // ExclCanonComment
5   // MinCanon
6   // Canon_v1_1
7   // CanonComment_v1_1

Default Value

0

Remarks

The XML canonicalization method that was used for signing.

Supported canonicalization methods:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

i32

new_sig_chain_validation_details property (XAdESSigner Struct)

The details of a certificate chain validation outcome.

Syntax

fn new_sig_chain_validation_details(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

The details of a certificate chain validation outcome. They may often suggest the reasons that contributed to the overall validation result.

Returns a bit mask of the following options:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

i32

new_sig_chain_validation_result property (XAdESSigner Struct)

The outcome of a certificate chain validation routine.

Syntax

fn new_sig_chain_validation_result(&self ) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Valid
1   // ValidButUntrusted
2   // Invalid
3   // CantBeEstablished

Default Value

0

Remarks

The outcome of a certificate chain validation routine.

Available options:

Use the ValidationLog property to access the detailed validation log.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

i32

new_sig_claimed_signing_time property (XAdESSigner Struct)

The signing time from the signer's computer.

Syntax

fn new_sig_claimed_signing_time(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_claimed_signing_time(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_claimed_signing_time_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The signing time from the signer's computer.

Use this property to provide the signature production time. The claimed time is not supported by a trusted source; it may be inaccurate, forfeited, or wrong, and as such is usually taken for informational purposes only by verifiers. Use timestamp servers to embed verifiable trusted timestamps. The time is in UTC.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_compatibility_errors property (XAdESSigner Struct)

Returns compatibility errors encountered during validation.

Syntax

fn new_sig_compatibility_errors(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

Returns compatibility errors encountered during validation.

Use this property to get specific compatibility errors encountered during validation. Unlike chain validation details, compatibility errors indicate violations by the signature of the assumed signature level/profile. For example, BES signatures are required to contain the signing time attribute. A prospective BES signature without such attribute will invoke a compatibility error.

Supported values:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

i32

new_sig_contains_long_term_info property (XAdESSigner Struct)

Returns true if the signature was found to contain long-term validation details (certificates, CRLs, and OCSP response).

Syntax

fn new_sig_contains_long_term_info(&self ) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

Returns true if the signature was found to contain long-term validation details (certificates, CRLs, and OCSP response).

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

bool

new_sig_entity_label property (XAdESSigner Struct)

Use this property to get the signature entity label.

Syntax

fn new_sig_entity_label(&self ) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get the signature entity label.

This property returns a string label that uniquely identifies the signature. The label can be used to establish the signature target in the SignatureFound event or to select the signing chain via the SelectInfo method.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

String

new_sig_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn new_sig_handle(&self ) -> Result<i64, SecureBlackboxError> 
fn set_new_sig_handle(&self, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

i64

new_sig_hash_algorithm property (XAdESSigner Struct)

The hash algorithm used for signing.

Syntax

fn new_sig_hash_algorithm(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_hash_algorithm(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_hash_algorithm_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

"Unknown"

Remarks

The hash algorithm used for signing.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_issuer_rdn property (XAdESSigner Struct)

The Relative Distinguished Name of the signing certificate's issuer.

Syntax

fn new_sig_issuer_rdn(&self ) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The Relative Distinguished Name of the signing certificate's issuer.

A collection of information, in the form of [OID, Value] pairs, about the company that issued the signing certificate.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

String

new_sig_last_archival_time property (XAdESSigner Struct)

Indicates the most recent archival time of an archived signature This property returns the time of the most recent archival timestamp applied to the signature.

Syntax

fn new_sig_last_archival_time(&self ) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Indicates the most recent archival time of an archived signature

This property returns the time of the most recent archival timestamp applied to the signature. This property only makes sense for 'archived' (e.g. CAdES-A) signatures. Time is in UTC.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

String

new_sig_level property (XAdESSigner Struct)

Specifies which level or form of XAdES should be produced.

Syntax

fn new_sig_level(&self ) -> Result<i32, SecureBlackboxError> 
fn set_new_sig_level(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Unknown
1   // Generic
2   // BaselineB
3   // BaselineT
4   // BaselineLT
5   // BaselineLTA
6   // BES
7   // EPES
8   // T
9   // C
10   // X
11   // XType1
12   // XType2
13   // XL
14   // XLType1
15   // XLType2
16   // A
17   // ExtendedBES
18   // ExtendedEPES
19   // ExtendedT
20   // ExtendedC
21   // ExtendedX
22   // ExtendedXType1
23   // ExtendedXType2
24   // ExtendedXLong
25   // ExtendedXL
26   // ExtendedXLType1
27   // ExtendedXLType2
28   // ExtendedA
29   // BaselineExtendedB
30   // BaselineExtendedT
31   // BaselineExtendedLT
32   // BaselineExtendedLTA

Default Value

2

Remarks

Specifies which level or form of XAdES should be produced.

Use this property to specify the level or form of advanced electronic signature to be produced.

Use the Generic value to produce XML-DSIG signature.

The supported levels and forms are:

* For XAdES form from XAdES v1.1.1 use either BES or EPES form values ** Extended forms are supported starting from XAdES v1.3.2

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

i32

new_sig_parent_entity property (XAdESSigner Struct)

Use this property to get the parent signature label.

Syntax

fn new_sig_parent_entity(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_parent_entity(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_parent_entity_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get the parent signature label.

This property contains the unique entity label of the current signature's parent object - typically a higher-level signature or a timestamp.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_policy_hash property (XAdESSigner Struct)

The signature policy hash value.

Syntax

fn new_sig_policy_hash(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_policy_hash(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_policy_hash_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The signature policy hash value.

Use this property to get the signature policy hash from EPES signatures

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_policy_hash_algorithm property (XAdESSigner Struct)

The algorithm that was used to calculate the signature policy hash Use this property to get or set the hash algorithm used to calculate the signature policy hash.

Syntax

fn new_sig_policy_hash_algorithm(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_policy_hash_algorithm(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_policy_hash_algorithm_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The algorithm that was used to calculate the signature policy hash

Use this property to get or set the hash algorithm used to calculate the signature policy hash. Read the actual hash value from new_sig_policy_hash.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_policy_id property (XAdESSigner Struct)

The policy ID that was included or to be included into the signature.

Syntax

fn new_sig_policy_id(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_policy_id(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_policy_id_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The policy ID that was included or to be included into the signature.

Use this property to retrieve the signature policy identifier from EPES signatures.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_policy_uri property (XAdESSigner Struct)

The signature policy URI that was included in the signature.

Syntax

fn new_sig_policy_uri(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_policy_uri(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_policy_uri_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The signature policy URI that was included in the signature.

Use this property to set or retrieve the URI of the signature policy from EPES signatures.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

new_sig_serial_number property (XAdESSigner Struct)

The serial number of the signing certificate.

Syntax

fn new_sig_serial_number(&self ) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

The serial number of the signing certificate.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

Vec

new_sig_signature_bytes property (XAdESSigner Struct)

Returns the binary representation of the XML-DSig/XAdES signature.

Syntax

fn new_sig_signature_bytes(&self ) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the binary representation of the XML-DSig/XAdES signature.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

Vec

new_sig_signature_type property (XAdESSigner Struct)

The signature type to employ when signing the document.

Syntax

fn new_sig_signature_type(&self ) -> Result<i32, SecureBlackboxError> 
fn set_new_sig_signature_type(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

1   // Detached
2   // Enveloping
4   // Enveloped

Default Value

4

Remarks

The signature type to employ when signing the document.

This property specifies the signature type to be used when signing the document.

Supported values:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

i32

new_sig_signature_validation_result property (XAdESSigner Struct)

The outcome of the cryptographic signature validation.

Syntax

fn new_sig_signature_validation_result(&self ) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Valid
1   // Unknown
2   // Corrupted
3   // SignerNotFound
4   // Failure
5   // ReferenceCorrupted

Default Value

0

Remarks

The outcome of the cryptographic signature validation.

The following signature validity values are supported:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

i32

new_sig_subject_key_id property (XAdESSigner Struct)

Contains the subject key identifier of the signing certificate.

Syntax

fn new_sig_subject_key_id(&self ) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Contains the subject key identifier of the signing certificate.

Subject Key Identifier is a (non-critical) X.509 certificate extension which allows the identification of certificates containing a particular public key. In SecureBlackbox, the unique identifier is represented by a SHA-1 hash of the bit string of the subject public key.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

Vec

new_sig_subject_rdn property (XAdESSigner Struct)

Contains information about the person owning the signing certificate.

Syntax

fn new_sig_subject_rdn(&self ) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains information about the person owning the signing certificate. Only certificates with given subject information will be enumerated during the search operation. Information is stored in the form of [Object Identifier, Value] pairs.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

String

new_sig_timestamped property (XAdESSigner Struct)

Use this property to establish whether the signature contains an embedded timestamp.

Syntax

fn new_sig_timestamped(&self ) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

Use this property to establish whether the signature contains an embedded timestamp.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

bool

new_sig_validated_signing_time property (XAdESSigner Struct)

Contains the certified signing time.

Syntax

fn new_sig_validated_signing_time(&self ) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains the certified signing time.

Use this property to obtain the signing time as certified by a timestamp from a trusted timestamping authority. This property is only non-empty if there was a valid timestamp included in the signature.

new_sig_claimed_signing_time returns a non-trusted signing time from the signer's computer.

Both times are in UTC.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

String

new_sig_validation_log property (XAdESSigner Struct)

Contains the complete log of the certificate validation routine.

Syntax

fn new_sig_validation_log(&self ) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains the complete log of the certificate validation routine.

Use this property to access the chain validation log produced by the struct. The log can be very useful when investigating issues with chain validation, as it contains a step-by-step trace of the entire validation procedure.

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

This property is read-only.

Data Type

String

new_sig_xades_version property (XAdESSigner Struct)

Specifies XAdES version.

Syntax

fn new_sig_xades_version(&self ) -> Result<i32, SecureBlackboxError> 
fn set_new_sig_xades_version(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Unknown
1   // 111
2   // 122
3   // 132
4   // 141

Default Value

3

Remarks

Specifies XAdES version.

This property specifies the version of the XAdES specification the signature should comply with.

The supported versions are:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

i32

new_sig_xml_element property (XAdESSigner Struct)

Specifies the XML element where to save the signature or containing the signature.

Syntax

fn new_sig_xml_element(&self ) -> Result<String, SecureBlackboxError> 
fn set_new_sig_xml_element(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_new_sig_xml_element_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Specifies the XML element where to save the signature or containing the signature.

This property specifies the XML element where to save the electronic signature or that contains the signature to be validated.

Supported values are:

The parameter specifies the index of the item in the array. The size of the array is controlled by the NewSigCount property.

Data Type

String

ocsp_count property (XAdESSigner Struct)

The number of records in the OCSP arrays.

Syntax

fn ocsp_count(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• ocsp_bytes
• ocsp_entry_count
• ocsp_handle
• ocsp_issuer
• ocsp_issuer_rdn
• ocsp_location
• ocsp_produced_at
• ocsp_sig_algorithm
• ocsp_source

The array indices start at 0 and end at ocsp_count - 1.

This property is read-only.

Data Type

i32

ocsp_bytes property (XAdESSigner Struct)

A buffer containing the raw OCSP response data.

Syntax

fn ocsp_bytes(&self , OCSPIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

A buffer containing the raw OCSP response data.

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

Vec

ocsp_entry_count property (XAdESSigner Struct)

The number of SingleResponse elements contained in this OCSP response.

Syntax

fn ocsp_entry_count(&self , OCSPIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

The number of SingleResponse elements contained in this OCSP response. Each SingleResponse element corresponds to a certificate status.

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

i32

ocsp_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn ocsp_handle(&self , OCSPIndex : i32) -> Result<i64, SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

i64

ocsp_issuer property (XAdESSigner Struct)

Indicates the issuer of this response (a CA or its authorized representative).

Syntax

fn ocsp_issuer(&self , OCSPIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Indicates the issuer of this response (a CA or its authorized representative).

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

String

ocsp_issuer_rdn property (XAdESSigner Struct)

Indicates the RDN of the issuer of this response (a CA or its authorized representative).

Syntax

fn ocsp_issuer_rdn(&self , OCSPIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Indicates the RDN of the issuer of this response (a CA or its authorized representative).

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

String

ocsp_location property (XAdESSigner Struct)

The location of the OCSP responder.

Syntax

fn ocsp_location(&self , OCSPIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The location of the OCSP responder.

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

String

ocsp_produced_at property (XAdESSigner Struct)

Specifies the time when the response was produced, in UTC.

Syntax

fn ocsp_produced_at(&self , OCSPIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Specifies the time when the response was produced, in UTC.

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

String

ocsp_sig_algorithm property (XAdESSigner Struct)

The public key algorithm that was used by the CA to sign this OCSP response.

Syntax

fn ocsp_sig_algorithm(&self , OCSPIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

"0"

Remarks

The public key algorithm that was used by the CA to sign this OCSP response.

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

String

ocsp_source property (XAdESSigner Struct)

Returns the source (location or disposition) of a cryptographic primitive entity, such as a certificate, CRL, or OCSP response.

Syntax

fn ocsp_source(&self , OCSPIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Unknown
1   // Signature
2   // Document
3   // User
4   // Local
5   // Online

Default Value

0

Remarks

Returns the source (location or disposition) of a cryptographic primitive entity, such as a certificate, CRL, or OCSP response.

The OCSPIndex parameter specifies the index of the item in the array. The size of the array is controlled by the OCSPCount property.

This property is read-only.

Data Type

i32

offline_mode property (XAdESSigner Struct)

Switches the struct to offline mode.

Syntax

fn offline_mode(&self ) -> Result<bool, SecureBlackboxError> 
fn set_offline_mode(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

When working in offline mode, the struct restricts itself from using any online revocation information sources, such as CRL or OCSP responders.

Offline mode may be useful if there is a need to verify the completeness of the validation information included within the signature or provided via known_certificates, known_crls, and other related properties.

Data Type

bool

output_bytes property (XAdESSigner Struct)

Use this property to read the output the struct object has produced.

Syntax

fn output_bytes(&self ) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Read the contents of this property after the operation has completed to read the produced output. This property will only be set if the output_file and output_stream properties had not been assigned.

This property is read-only.

Data Type

Vec

output_file property (XAdESSigner Struct)

Specifies the file where the signed document will be saved.

Syntax

fn output_file(&self ) -> Result<String, SecureBlackboxError> 
fn set_output_file(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_output_file_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Provide the full path to the file where the signed document should be saved.

Data Type

String

profile property (XAdESSigner Struct)

Specifies a pre-defined profile to apply when creating the signature.

Syntax

fn profile(&self ) -> Result<String, SecureBlackboxError> 
fn set_profile(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_profile_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Advanced signatures come in many variants, which are often defined by parties that needs to process them or by local standards. SecureBlackbox profiles are sets of pre-defined configurations which correspond to particular signature variants. By specifying a profile, you are pre-configuring the component to make it produce the signature that matches the configuration corresponding to that profile. 

Supported profiles:

"ES.Factura" profile equivalent to the following settings: using (XMLReference Ref = new XMLReference()) { Ref.ID = "Reference-1"; Ref.TargetXMLElement = ""; Ref.UseEnvelopedSignatureTransform = true; XAdESSigner.References.Add(Ref); } using (XMLReference Ref = new XMLReference()) { Ref.URI = "#KeyInfo-1"; XAdESSigner.References.Add(Ref); } XAdESSigner.NewSignature.XAdESVersion = XAdESVersions.xav132; XAdESSigner.NewSignature.Level = AdESSignatureLevels.aslEPES; XAdESSigner.Config("KeyInfoDetails=certificate"); XAdESSigner.Config("KeyInfoID=KeyInfo-1"); XAdESSigner.Config("ClaimedRoleText=emisor"); XAdESSigner.Config("SigPolicyId=http://www.facturae.es/politica_de_firma_formato_facturae/politica_de_firma_formato_facturae_v3_1.pdf"); XAdESSigner.Config("SigPolicyDescription=Pol" + "\u00ED" + "tica de Firma FacturaE v3.1"); XAdESSigner.Config("SigPolicyHash=3a18b197aba90fa6aff0dee912f0c006110bea13"); XAdESSigner.Config("SigPolicyHashAlgorithm=SHA1"); XAdESSigner.Config("DataObjectFormatObjectReference=#Reference-1"); XAdESSigner.Config("DataObjectFormatMimeType=text/xml"); XAdESSigner.Config("DataObjectFormatDescription=Factura electr" + "\u00F3" + "nica");

"XAdES.CounterSignature" profile allows to add XAdES countersignature to the existent XAdES-BES or EPES signature. Use XMLElement property to specify existent XAdES signature. Sample code: XAdESSigner.Profile = "XAdES.CounterSignature"; XAdESSigner.NewSignature.XAdES = false;

Data Type

String

proxy_address property (XAdESSigner Struct)

The IP address of the proxy server.

Syntax

fn proxy_address(&self ) -> Result<String, SecureBlackboxError> 
fn set_proxy_address(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_proxy_address_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The IP address of the proxy server.

Data Type

String

proxy_authentication property (XAdESSigner Struct)

The authentication type used by the proxy server.

Syntax

fn proxy_authentication(&self ) -> Result<i32, SecureBlackboxError> 
fn set_proxy_authentication(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // NoAuthentication
1   // Basic
2   // Digest
3   // NTLM

Default Value

0

Remarks

The authentication type used by the proxy server.

Data Type

i32

proxy_password property (XAdESSigner Struct)

The password to authenticate to the proxy server.

Syntax

fn proxy_password(&self ) -> Result<String, SecureBlackboxError> 
fn set_proxy_password(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_proxy_password_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The password to authenticate to the proxy server.

Data Type

String

proxy_port property (XAdESSigner Struct)

The port on the proxy server to connect to.

Syntax

fn proxy_port(&self ) -> Result<i32, SecureBlackboxError> 
fn set_proxy_port(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

The port on the proxy server to connect to.

Data Type

i32

proxy_type property (XAdESSigner Struct)

The type of the proxy server.

Syntax

fn proxy_type(&self ) -> Result<i32, SecureBlackboxError> 
fn set_proxy_type(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // None
1   // Socks4
2   // Socks5
3   // WebTunnel
4   // HTTP

Default Value

0

Remarks

The type of the proxy server.

Data Type

i32

proxy_request_headers property (XAdESSigner Struct)

Contains HTTP request headers for WebTunnel and HTTP proxy.

Syntax

fn proxy_request_headers(&self ) -> Result<String, SecureBlackboxError> 
fn set_proxy_request_headers(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_proxy_request_headers_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Contains HTTP request headers for WebTunnel and HTTP proxy.

Data Type

String

proxy_response_body property (XAdESSigner Struct)

Contains the HTTP or HTTPS (WebTunnel) proxy response body.

Syntax

fn proxy_response_body(&self ) -> Result<String, SecureBlackboxError> 
fn set_proxy_response_body(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_proxy_response_body_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Contains the HTTP or HTTPS (WebTunnel) proxy response body.

Data Type

String

proxy_response_headers property (XAdESSigner Struct)

Contains response headers received from an HTTP or HTTPS (WebTunnel) proxy server.

Syntax

fn proxy_response_headers(&self ) -> Result<String, SecureBlackboxError> 
fn set_proxy_response_headers(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_proxy_response_headers_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Contains response headers received from an HTTP or HTTPS (WebTunnel) proxy server.

Data Type

String

proxy_use_ipv6 property (XAdESSigner Struct)

Specifies whether IPv6 should be used when connecting through the proxy.

Syntax

fn proxy_use_ipv6(&self ) -> Result<bool, SecureBlackboxError> 
fn set_proxy_use_ipv6(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether IPv6 should be used when connecting through the proxy.

Data Type

bool

proxy_username property (XAdESSigner Struct)

Specifies the username credential for proxy authentication.

Syntax

fn proxy_username(&self ) -> Result<String, SecureBlackboxError> 
fn set_proxy_username(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_proxy_username_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Specifies the username credential for proxy authentication.

Data Type

String

reference_count property (XAdESSigner Struct)

The number of records in the Reference arrays.

Syntax

fn reference_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_reference_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• reference_auto_generate_element_id
• reference_canonicalization_method
• reference_custom_element_id
• reference_data_object_description
• reference_data_object_encoding
• reference_data_object_identifier
• reference_data_object_mime_type
• reference_digest_value
• reference_handle
• reference_has_data_object_format
• reference_hash_algorithm
• reference_has_uri
• reference_id
• reference_inclusive_namespaces_prefix_list
• reference_target_data
• reference_target_type
• reference_target_xml_element
• reference_type
• reference_uri
• reference_use_base64_transform
• reference_use_enveloped_signature_transform
• reference_use_xpath_filter2_transform
• reference_use_xpath_transform
• reference_validation_result
• reference_xpath_expression
• reference_xpath_filter2_expressions
• reference_xpath_filter2_filters
• reference_xpath_filter2_prefix_list
• reference_xpath_prefix_list

The array indices start at 0 and end at reference_count - 1.

Data Type

i32

reference_auto_generate_element_id property (XAdESSigner Struct)

Specifies whether the identifier (ID) attribute for a referenced (target) element should be auto-generated during signing.

Syntax

fn reference_auto_generate_element_id(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_auto_generate_element_id(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether the identifier (ID) attribute for a referenced (target) element should be auto-generated during signing. Used when the referenced element doesn't have an ID and CustomElementId and URI properties are empty.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_canonicalization_method property (XAdESSigner Struct)

Use this property to specify the canonicalization method for the transform of the reference.

Syntax

fn reference_canonicalization_method(&self , ReferenceIndex : i32) -> Result<i32, SecureBlackboxError> 
fn set_reference_canonicalization_method(&self, ReferenceIndex : i32, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // None
1   // Canon
2   // CanonComment
3   // ExclCanon
4   // ExclCanonComment
5   // MinCanon
6   // Canon_v1_1
7   // CanonComment_v1_1

Default Value

0

Remarks

Use this property to specify the canonicalization method for the transform of the reference. Use cxcmNone value to not to include canonicalization transform in transform chain. See XML-Signature Syntax and Processing specification for details.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

i32

reference_custom_element_id property (XAdESSigner Struct)

Specifies a custom identifier (ID) attribute for a referenced (target) element that will be set on signing.

Syntax

fn reference_custom_element_id(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_custom_element_id(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_custom_element_id_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Specifies a custom identifier (ID) attribute for a referenced (target) element that will be set on signing. Used when the referenced element doesn't have an ID and URI property is empty.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_data_object_description property (XAdESSigner Struct)

This property contains textual information related to the referenced data object, which is found in the corresponding DataObjectFormat's Description element.

Syntax

fn reference_data_object_description(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_data_object_description(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_data_object_description_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

This property contains textual information related to the referenced data object, which is found in the corresponding DataObjectFormat's Description element.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_data_object_encoding property (XAdESSigner Struct)

This property contains an indication of the encoding format of the referenced data object, which is found in the corresponding DataObjectFormat's Encoding element.

Syntax

fn reference_data_object_encoding(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_data_object_encoding(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_data_object_encoding_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

This property contains an indication of the encoding format of the referenced data object, which is found in the corresponding DataObjectFormat's Encoding element.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_data_object_identifier property (XAdESSigner Struct)

This property contains an identifier indicating the type of the referenced data object, which is found in the corresponding DataObjectFormat's ObjectIdentifier element.

Syntax

fn reference_data_object_identifier(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_data_object_identifier(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_data_object_identifier_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

This property contains an identifier indicating the type of the referenced data object, which is found in the corresponding DataObjectFormat's ObjectIdentifier element.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_data_object_mime_type property (XAdESSigner Struct)

This property contains an indication of the MIME type of the referenced data object, which is found in the corresponding DataObjectFormat's MimeType element.

Syntax

fn reference_data_object_mime_type(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_data_object_mime_type(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_data_object_mime_type_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

This property contains an indication of the MIME type of the referenced data object, which is found in the corresponding DataObjectFormat's MimeType element.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_digest_value property (XAdESSigner Struct)

Use this property to get or set the value of the digest calculated over the referenced data.

Syntax

fn reference_digest_value(&self , ReferenceIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 
fn set_reference_digest_value(&self, ReferenceIndex : i32, value : Vec<u8>) ->  Option<SecureBlackboxError> 
fn set_reference_digest_value_ref(&self, ReferenceIndex : i32, value : &[u8]) ->  Option<SecureBlackboxError> 

Remarks

Use this property to get or set the value of the digest calculated over the referenced data.

This property is optional and should be set only if you don't provide the actual data via TargetData or URI. If the data is set, then you don't need to set DigestValue since it will be calculated automatically.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

Vec

reference_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn reference_handle(&self , ReferenceIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_reference_handle(&self, ReferenceIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

i64

reference_has_data_object_format property (XAdESSigner Struct)

Specifies whether corresponding XAdES DataObjectFormat element is created for the current reference.

Syntax

fn reference_has_data_object_format(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_has_data_object_format(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether corresponding XAdES DataObjectFormat element is created for the current reference.

Check this property to find out if the reference has an associated DataObjectFormat element.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_hash_algorithm property (XAdESSigner Struct)

Specifies the hash algorithm to be used.

Syntax

fn reference_hash_algorithm(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_hash_algorithm(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_hash_algorithm_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

"SHA256"

Remarks

Specifies the hash algorithm to be used.

Supported values:

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_has_uri property (XAdESSigner Struct)

Specifies whether the URI is set (even when it is empty).

Syntax

fn reference_has_uri(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_has_uri(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

true

Remarks

Specifies whether the URI is set (even when it is empty).

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_id property (XAdESSigner Struct)

A user-defined identifier (ID) attribute of this Reference element.

Syntax

fn reference_id(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_id(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_id_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

A user-defined identifier (ID) attribute of this Reference element.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_inclusive_namespaces_prefix_list property (XAdESSigner Struct)

Use this property to specify InclusiveNamespaces PrefixList for exclusive canonicalization transform of the reference.

Syntax

fn reference_inclusive_namespaces_prefix_list(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_inclusive_namespaces_prefix_list(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_inclusive_namespaces_prefix_list_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify InclusiveNamespaces PrefixList for exclusive canonicalization transform of the reference. See XML-Signature Syntax and Processing specification for details.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_type property (XAdESSigner Struct)

The Reference's type attribute as defined in XMLDSIG specification.

Syntax

fn reference_type(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_type(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_type_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The Reference's type attribute as defined in XMLDSIG specification.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_target_data property (XAdESSigner Struct)

Contains the referenced external data when the digest value is not explicitly specified.

Syntax

fn reference_target_data(&self , ReferenceIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 
fn set_reference_target_data(&self, ReferenceIndex : i32, value : Vec<u8>) ->  Option<SecureBlackboxError> 
fn set_reference_target_data_ref(&self, ReferenceIndex : i32, value : &[u8]) ->  Option<SecureBlackboxError> 

Remarks

Contains the referenced external data when the digest value is not explicitly specified.

This property is optional and should only be set if you reference the external data via URI, and you don't provide the digest value explicitly via DigestValue.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

Vec

reference_target_type property (XAdESSigner Struct)

The reference's target type to use.

Syntax

fn reference_target_type(&self , ReferenceIndex : i32) -> Result<i32, SecureBlackboxError> 
fn set_reference_target_type(&self, ReferenceIndex : i32, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Auto
1   // XMLElement
2   // Data
3   // URI

Default Value

0

Remarks

The reference's target type to use.

Use this property to specify the reference's target type to use when forming the signature.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

i32

reference_target_xml_element property (XAdESSigner Struct)

This property specifies the referenced XML element.

Syntax

fn reference_target_xml_element(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_target_xml_element(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_target_xml_element_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

This property specifies the referenced XML element. Used when the URI property is not set. In this case, the URI value is generated based on the ID of the referenced (target) XML element. If the URI property is set, this property is ignored until the ResolveReference event.

Supported values are:

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_uri property (XAdESSigner Struct)

Use this property to get or set the URL which references the data.

Syntax

fn reference_uri(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_uri(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_uri_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get or set the URL which references the data. If the data is external, the application must set either TargetData or DigestValue. If TargetData is set, the digest is calculated automatically unless it is explicitly set by the application via DigestValue.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_use_base64_transform property (XAdESSigner Struct)

Specifies whether Base64 transform is included in transform chain.

Syntax

fn reference_use_base64_transform(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_use_base64_transform(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether Base64 transform is included in transform chain.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_use_enveloped_signature_transform property (XAdESSigner Struct)

Specifies whether enveloped signature transform is included in transform chain.

Syntax

fn reference_use_enveloped_signature_transform(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_use_enveloped_signature_transform(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether enveloped signature transform is included in transform chain.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_use_xpath_filter2_transform property (XAdESSigner Struct)

Specifies whether XPath Filter 2.

Syntax

fn reference_use_xpath_filter2_transform(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_use_xpath_filter2_transform(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether XPath Filter 2.0 transform is included in transform chain.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_use_xpath_transform property (XAdESSigner Struct)

Specifies whether XPath transform is included in transform chain.

Syntax

fn reference_use_xpath_transform(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 
fn set_reference_use_xpath_transform(&self, ReferenceIndex : i32, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Specifies whether XPath transform is included in transform chain.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

bool

reference_validation_result property (XAdESSigner Struct)

The outcome of the cryptographic reference validation.

Syntax

fn reference_validation_result(&self , ReferenceIndex : i32) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

The outcome of the cryptographic reference validation.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

This property is read-only.

Data Type

bool

reference_xpath_expression property (XAdESSigner Struct)

Use this property to specify XPath expression for XPath transform of the reference.

Syntax

fn reference_xpath_expression(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_xpath_expression(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_xpath_expression_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify XPath expression for XPath transform of the reference.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_xpath_filter2_expressions property (XAdESSigner Struct)

Use this property to specify XPointer expression(s) for XPath Filter 2.

Syntax

fn reference_xpath_filter2_expressions(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_xpath_filter2_expressions(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_xpath_filter2_expressions_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify XPointer expression(s) for XPath Filter 2.0 transform of the reference.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_xpath_filter2_filters property (XAdESSigner Struct)

Use this property to specify XPointer filter(s) for XPath Filter 2.

Syntax

fn reference_xpath_filter2_filters(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_xpath_filter2_filters(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_xpath_filter2_filters_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify XPointer filter(s) for XPath Filter 2.0 transform of the reference. The prefix list is comma-separated.

Supported values:

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_xpath_filter2_prefix_list property (XAdESSigner Struct)

Use this property to specify a prefix list for XPath Filter 2.

Syntax

fn reference_xpath_filter2_prefix_list(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_xpath_filter2_prefix_list(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_xpath_filter2_prefix_list_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify a prefix list for XPath Filter 2.0 transform of the reference. The prefix list is space-separated. Namespace URIs that are used are taken from XPathNamespaces property.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

reference_xpath_prefix_list property (XAdESSigner Struct)

Use this property to specify a prefix list for XPath transform of the reference.

Syntax

fn reference_xpath_prefix_list(&self , ReferenceIndex : i32) -> Result<String, SecureBlackboxError> 
fn set_reference_xpath_prefix_list(&self, ReferenceIndex : i32, value : &str) ->  Option<SecureBlackboxError> 
fn set_reference_xpath_prefix_list_ref(&self, ReferenceIndex : i32, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify a prefix list for XPath transform of the reference. The prefix list is space-separated. Namespace URIs that are used are taken from XPathNamespaces property.

The ReferenceIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ReferenceCount property.

Data Type

String

revocation_check property (XAdESSigner Struct)

Specifies the kind(s) of revocation check to perform for all chain certificates.

Syntax

fn revocation_check(&self ) -> Result<i32, SecureBlackboxError> 
fn set_revocation_check(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // None
1   // Auto
2   // AllCRL
3   // AllOCSP
4   // AllCRLAndOCSP
5   // AnyCRL
6   // AnyOCSP
7   // AnyCRLOrOCSP
8   // AnyOCSPOrCRL

Default Value

1

Remarks

Revocation checking is necessary to ensure the integrity of the chain and obtain up-to-date certificate validity and trustworthiness information.

Certificate Revocation Lists (CRLs) and Online Certificate Status Protocol (OCSP) responses serve the same purpose of ensuring that the certificate had not been revoked by the Certificate Authority (CA) at the time of use. Depending on your circumstances and security policy requirements, you may want to use either one or both of the revocation information source types.

This setting controls the way the revocation checks are performed for every certificate in the chain. Typically certificates come with two types of revocation information sources: CRL (certificate revocation lists) and OCSP responders. CRLs are static objects periodically published by the CA at some online location. OCSP responders are active online services maintained by the CA that can provide up-to-date information on certificate statuses in near real time.

There are some conceptual differences between the two. CRLs are normally larger in size. Their use involves some latency because there is normally some delay between the time when a certificate was revoked and the time the subsequent CRL mentioning that is published. The benefits of CRL is that the same object can provide statuses for all certificates issued by a particular CA, and that the whole technology is much simpler than OCSP (and thus is supported by more CAs).

This setting lets you adjust the validation course by including or excluding certain types of revocation sources from the validation process. The crcAnyOCSPOrCRL setting (give preference to the faster OCSP route and only demand one source to succeed) is a good choice for most typical validation environments. The "crcAll*" modes are much stricter, and may be used in scenarios where bulletproof validity information is essential.

NOTE: If no CRL or OCSP endpoints are provided by the CA, the revocation check will be considered successful. This is because the CA chose not to supply revocation information for its certificates, meaning they are considered irrevocable.

NOTE: Within each of the above settings, if any retrieved CRL or OCSP response indicates that the certificate has been revoked, the revocation check fails.

Data Type

i32

signature_count property (XAdESSigner Struct)

The number of records in the Signature arrays.

Syntax

fn signature_count(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• signature_bytes
• signature_canonicalization_method
• signature_chain_validation_details
• signature_chain_validation_result
• signature_claimed_signing_time
• signature_compatibility_errors
• signature_contains_long_term_info
• signature_entity_label
• signature_handle
• signature_hash_algorithm
• signature_issuer_rdn
• signature_last_archival_time
• signature_level
• signature_parent_entity
• signature_policy_hash
• signature_policy_hash_algorithm
• signature_policy_id
• signature_policy_uri
• signature_serial_number
• signature_subject_key_id
• signature_subject_rdn
• signature_timestamped
• signature_type
• signature_validated_signing_time
• signature_validation_log
• signature_validation_result
• signature_xades_version
• signature_xml_element

The array indices start at 0 and end at signature_count - 1.

This property is read-only.

Data Type

i32

signature_canonicalization_method property (XAdESSigner Struct)

The XML canonicalization method that was used for signing.

Syntax

fn signature_canonicalization_method(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // None
1   // Canon
2   // CanonComment
3   // ExclCanon
4   // ExclCanonComment
5   // MinCanon
6   // Canon_v1_1
7   // CanonComment_v1_1

Default Value

0

Remarks

The XML canonicalization method that was used for signing.

Supported canonicalization methods:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_chain_validation_details property (XAdESSigner Struct)

The details of a certificate chain validation outcome.

Syntax

fn signature_chain_validation_details(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

The details of a certificate chain validation outcome. They may often suggest the reasons that contributed to the overall validation result.

Returns a bit mask of the following options:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_chain_validation_result property (XAdESSigner Struct)

The outcome of a certificate chain validation routine.

Syntax

fn signature_chain_validation_result(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Valid
1   // ValidButUntrusted
2   // Invalid
3   // CantBeEstablished

Default Value

0

Remarks

The outcome of a certificate chain validation routine.

Available options:

Use the ValidationLog property to access the detailed validation log.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_claimed_signing_time property (XAdESSigner Struct)

The signing time from the signer's computer.

Syntax

fn signature_claimed_signing_time(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The signing time from the signer's computer.

Use this property to provide the signature production time. The claimed time is not supported by a trusted source; it may be inaccurate, forfeited, or wrong, and as such is usually taken for informational purposes only by verifiers. Use timestamp servers to embed verifiable trusted timestamps. The time is in UTC.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_compatibility_errors property (XAdESSigner Struct)

Returns compatibility errors encountered during validation.

Syntax

fn signature_compatibility_errors(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

Returns compatibility errors encountered during validation.

Use this property to get specific compatibility errors encountered during validation. Unlike chain validation details, compatibility errors indicate violations by the signature of the assumed signature level/profile. For example, BES signatures are required to contain the signing time attribute. A prospective BES signature without such attribute will invoke a compatibility error.

Supported values:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_contains_long_term_info property (XAdESSigner Struct)

Returns true if the signature was found to contain long-term validation details (certificates, CRLs, and OCSP response).

Syntax

fn signature_contains_long_term_info(&self , SignatureIndex : i32) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

Returns true if the signature was found to contain long-term validation details (certificates, CRLs, and OCSP response).

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

bool

signature_entity_label property (XAdESSigner Struct)

Use this property to get the signature entity label.

Syntax

fn signature_entity_label(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get the signature entity label.

This property returns a string label that uniquely identifies the signature. The label can be used to establish the signature target in the SignatureFound event or to select the signing chain via the SelectInfo method.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn signature_handle(&self , SignatureIndex : i32) -> Result<i64, SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i64

signature_hash_algorithm property (XAdESSigner Struct)

The hash algorithm used for signing.

Syntax

fn signature_hash_algorithm(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

"Unknown"

Remarks

The hash algorithm used for signing.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_issuer_rdn property (XAdESSigner Struct)

The Relative Distinguished Name of the signing certificate's issuer.

Syntax

fn signature_issuer_rdn(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The Relative Distinguished Name of the signing certificate's issuer.

A collection of information, in the form of [OID, Value] pairs, about the company that issued the signing certificate.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_last_archival_time property (XAdESSigner Struct)

Indicates the most recent archival time of an archived signature This property returns the time of the most recent archival timestamp applied to the signature.

Syntax

fn signature_last_archival_time(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Indicates the most recent archival time of an archived signature

This property returns the time of the most recent archival timestamp applied to the signature. This property only makes sense for 'archived' (e.g. CAdES-A) signatures. Time is in UTC.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_level property (XAdESSigner Struct)

Specifies which level or form of XAdES should be produced.

Syntax

fn signature_level(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Unknown
1   // Generic
2   // BaselineB
3   // BaselineT
4   // BaselineLT
5   // BaselineLTA
6   // BES
7   // EPES
8   // T
9   // C
10   // X
11   // XType1
12   // XType2
13   // XL
14   // XLType1
15   // XLType2
16   // A
17   // ExtendedBES
18   // ExtendedEPES
19   // ExtendedT
20   // ExtendedC
21   // ExtendedX
22   // ExtendedXType1
23   // ExtendedXType2
24   // ExtendedXLong
25   // ExtendedXL
26   // ExtendedXLType1
27   // ExtendedXLType2
28   // ExtendedA
29   // BaselineExtendedB
30   // BaselineExtendedT
31   // BaselineExtendedLT
32   // BaselineExtendedLTA

Default Value

2

Remarks

Specifies which level or form of XAdES should be produced.

Use this property to specify the level or form of advanced electronic signature to be produced.

Use the Generic value to produce XML-DSIG signature.

The supported levels and forms are:

* For XAdES form from XAdES v1.1.1 use either BES or EPES form values ** Extended forms are supported starting from XAdES v1.3.2

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_parent_entity property (XAdESSigner Struct)

Use this property to get the parent signature label.

Syntax

fn signature_parent_entity(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get the parent signature label.

This property contains the unique entity label of the current signature's parent object - typically a higher-level signature or a timestamp.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_policy_hash property (XAdESSigner Struct)

The signature policy hash value.

Syntax

fn signature_policy_hash(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The signature policy hash value.

Use this property to get the signature policy hash from EPES signatures

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_policy_hash_algorithm property (XAdESSigner Struct)

The algorithm that was used to calculate the signature policy hash Use this property to get or set the hash algorithm used to calculate the signature policy hash.

Syntax

fn signature_policy_hash_algorithm(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The algorithm that was used to calculate the signature policy hash

Use this property to get or set the hash algorithm used to calculate the signature policy hash. Read the actual hash value from signature_policy_hash.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_policy_id property (XAdESSigner Struct)

The policy ID that was included or to be included into the signature.

Syntax

fn signature_policy_id(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The policy ID that was included or to be included into the signature.

Use this property to retrieve the signature policy identifier from EPES signatures.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_policy_uri property (XAdESSigner Struct)

The signature policy URI that was included in the signature.

Syntax

fn signature_policy_uri(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The signature policy URI that was included in the signature.

Use this property to set or retrieve the URI of the signature policy from EPES signatures.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_serial_number property (XAdESSigner Struct)

The serial number of the signing certificate.

Syntax

fn signature_serial_number(&self , SignatureIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

The serial number of the signing certificate.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

Vec

signature_bytes property (XAdESSigner Struct)

Returns the binary representation of the XML-DSig/XAdES signature.

Syntax

fn signature_bytes(&self , SignatureIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the binary representation of the XML-DSig/XAdES signature.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

Vec

signature_type property (XAdESSigner Struct)

The signature type to employ when signing the document.

Syntax

fn signature_type(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

1   // Detached
2   // Enveloping
4   // Enveloped

Default Value

4

Remarks

The signature type to employ when signing the document.

This property specifies the signature type to be used when signing the document.

Supported values:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_validation_result property (XAdESSigner Struct)

The outcome of the cryptographic signature validation.

Syntax

fn signature_validation_result(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Valid
1   // Unknown
2   // Corrupted
3   // SignerNotFound
4   // Failure
5   // ReferenceCorrupted

Default Value

0

Remarks

The outcome of the cryptographic signature validation.

The following signature validity values are supported:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_subject_key_id property (XAdESSigner Struct)

Contains the subject key identifier of the signing certificate.

Syntax

fn signature_subject_key_id(&self , SignatureIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Contains the subject key identifier of the signing certificate.

Subject Key Identifier is a (non-critical) X.509 certificate extension which allows the identification of certificates containing a particular public key. In SecureBlackbox, the unique identifier is represented by a SHA-1 hash of the bit string of the subject public key.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

Vec

signature_subject_rdn property (XAdESSigner Struct)

Contains information about the person owning the signing certificate.

Syntax

fn signature_subject_rdn(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains information about the person owning the signing certificate. Only certificates with given subject information will be enumerated during the search operation. Information is stored in the form of [Object Identifier, Value] pairs.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_timestamped property (XAdESSigner Struct)

Use this property to establish whether the signature contains an embedded timestamp.

Syntax

fn signature_timestamped(&self , SignatureIndex : i32) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

Use this property to establish whether the signature contains an embedded timestamp.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

bool

signature_validated_signing_time property (XAdESSigner Struct)

Contains the certified signing time.

Syntax

fn signature_validated_signing_time(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains the certified signing time.

Use this property to obtain the signing time as certified by a timestamp from a trusted timestamping authority. This property is only non-empty if there was a valid timestamp included in the signature.

signature_claimed_signing_time returns a non-trusted signing time from the signer's computer.

Both times are in UTC.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_validation_log property (XAdESSigner Struct)

Contains the complete log of the certificate validation routine.

Syntax

fn signature_validation_log(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains the complete log of the certificate validation routine.

Use this property to access the chain validation log produced by the struct. The log can be very useful when investigating issues with chain validation, as it contains a step-by-step trace of the entire validation procedure.

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signature_xades_version property (XAdESSigner Struct)

Specifies XAdES version.

Syntax

fn signature_xades_version(&self , SignatureIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Unknown
1   // 111
2   // 122
3   // 132
4   // 141

Default Value

3

Remarks

Specifies XAdES version.

This property specifies the version of the XAdES specification the signature should comply with.

The supported versions are:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

i32

signature_xml_element property (XAdESSigner Struct)

Specifies the XML element where to save the signature or containing the signature.

Syntax

fn signature_xml_element(&self , SignatureIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Specifies the XML element where to save the signature or containing the signature.

This property specifies the XML element where to save the electronic signature or that contains the signature to be validated.

Supported values are:

The SignatureIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SignatureCount property.

This property is read-only.

Data Type

String

signing_cert_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn signing_cert_bytes(&self ) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

This property is read-only.

Data Type

Vec

signing_cert_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn signing_cert_handle(&self ) -> Result<i64, SecureBlackboxError> 
fn set_signing_cert_handle(&self, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

Data Type

i64

signing_chain_count property (XAdESSigner Struct)

The number of records in the SigningChain arrays.

Syntax

fn signing_chain_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_signing_chain_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• signing_chain_bytes
• signing_chain_handle

The array indices start at 0 and end at signing_chain_count - 1.

Data Type

i32

signing_chain_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn signing_chain_bytes(&self , SigningChainIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

The SigningChainIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SigningChainCount property.

This property is read-only.

Data Type

Vec

signing_chain_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn signing_chain_handle(&self , SigningChainIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_signing_chain_handle(&self, SigningChainIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The SigningChainIndex parameter specifies the index of the item in the array. The size of the array is controlled by the SigningChainCount property.

Data Type

i64

socket_dns_mode property (XAdESSigner Struct)

Selects the DNS resolver to use: the struct's (secure) built-in one, or the one provided by the system.

Syntax

fn socket_dns_mode(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_dns_mode(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Auto
1   // Platform
2   // Own
3   // OwnSecure

Default Value

0

Remarks

Selects the DNS resolver to use: the component's (secure) built-in one, or the one provided by the system.

Data Type

i32

socket_dns_port property (XAdESSigner Struct)

Specifies the port number to be used for sending queries to the DNS server.

Syntax

fn socket_dns_port(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_dns_port(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Specifies the port number to be used for sending queries to the DNS server.

Data Type

i32

socket_dns_query_timeout property (XAdESSigner Struct)

The timeout (in milliseconds) for each DNS query.

Syntax

fn socket_dns_query_timeout(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_dns_query_timeout(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

The timeout (in milliseconds) for each DNS query. The value of 0 indicates an infinite timeout.

Data Type

i32

socket_dns_servers property (XAdESSigner Struct)

The addresses of DNS servers to use for address resolution, separated by commas or semicolons.

Syntax

fn socket_dns_servers(&self ) -> Result<String, SecureBlackboxError> 
fn set_socket_dns_servers(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_socket_dns_servers_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The addresses of DNS servers to use for address resolution, separated by commas or semicolons.

Data Type

String

socket_dns_total_timeout property (XAdESSigner Struct)

The timeout (in milliseconds) for the whole resolution process.

Syntax

fn socket_dns_total_timeout(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_dns_total_timeout(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

The timeout (in milliseconds) for the whole resolution process. The value of 0 indicates an infinite timeout.

Data Type

i32

socket_incoming_speed_limit property (XAdESSigner Struct)

The maximum number of bytes to read from the socket, per second.

Syntax

fn socket_incoming_speed_limit(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_incoming_speed_limit(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

The maximum number of bytes to read from the socket, per second.

Data Type

i32

socket_local_address property (XAdESSigner Struct)

The local network interface to bind the socket to.

Syntax

fn socket_local_address(&self ) -> Result<String, SecureBlackboxError> 
fn set_socket_local_address(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_socket_local_address_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

The local network interface to bind the socket to.

Data Type

String

socket_local_port property (XAdESSigner Struct)

The local port number to bind the socket to.

Syntax

fn socket_local_port(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_local_port(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

The local port number to bind the socket to.

Data Type

i32

socket_outgoing_speed_limit property (XAdESSigner Struct)

The maximum number of bytes to write to the socket, per second.

Syntax

fn socket_outgoing_speed_limit(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_outgoing_speed_limit(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

The maximum number of bytes to write to the socket, per second.

Data Type

i32

socket_timeout property (XAdESSigner Struct)

The maximum period of waiting, in milliseconds, after which the socket operation is considered unsuccessful.

Syntax

fn socket_timeout(&self ) -> Result<i32, SecureBlackboxError> 
fn set_socket_timeout(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

60000

Remarks

The maximum period of waiting, in milliseconds, after which the socket operation is considered unsuccessful.

If Timeout is set to 0, a socket operation will expire after the system-default timeout (2 hrs 8 min for TCP stack).

Data Type

i32

socket_use_ipv6 property (XAdESSigner Struct)

Enables or disables IP protocol version 6.

Syntax

fn socket_use_ipv6(&self ) -> Result<bool, SecureBlackboxError> 
fn set_socket_use_ipv6(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Enables or disables IP protocol version 6.

Data Type

bool

timestamp_count property (XAdESSigner Struct)

The number of records in the Timestamp arrays.

Syntax

fn timestamp_count(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• timestamp_accuracy
• timestamp_bytes
• timestamp_certificate_index
• timestamp_chain_validation_details
• timestamp_chain_validation_result
• timestamp_contains_long_term_info
• timestamp_entity_label
• timestamp_hash_algorithm
• timestamp_parent_entity
• timestamp_serial_number
• timestamp_time
• timestamp_tsa_name
• timestamp_type
• timestamp_validation_log
• timestamp_validation_result

The array indices start at 0 and end at timestamp_count - 1.

This property is read-only.

Data Type

i32

timestamp_accuracy property (XAdESSigner Struct)

This property indicates the accuracy of the included time mark, in microseconds.

Syntax

fn timestamp_accuracy(&self , TimestampIndex : i32) -> Result<i64, SecureBlackboxError> 

Default Value

0

Remarks

This field indicates the accuracy of the included time mark, in microseconds.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

i64

timestamp_bytes property (XAdESSigner Struct)

Returns the raw timestamp data in DER format.

Syntax

fn timestamp_bytes(&self , TimestampIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw timestamp data in DER format.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

Vec

timestamp_certificate_index property (XAdESSigner Struct)

Returns the index of the TSA certificate in the Certificates collection.

Syntax

fn timestamp_certificate_index(&self , TimestampIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

-1

Remarks

Returns the index of the TSA certificate in the Certificates collection.

Use this property to look up the TSA certificate in the Certificates collection.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

i32

timestamp_chain_validation_details property (XAdESSigner Struct)

The details of a certificate chain validation outcome.

Syntax

fn timestamp_chain_validation_details(&self , TimestampIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

The details of a certificate chain validation outcome. They may often suggest the reasons that contributed to the overall validation result.

Returns a bit mask of the following options:

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

i32

timestamp_chain_validation_result property (XAdESSigner Struct)

The outcome of a certificate chain validation routine.

Syntax

fn timestamp_chain_validation_result(&self , TimestampIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Valid
1   // ValidButUntrusted
2   // Invalid
3   // CantBeEstablished

Default Value

0

Remarks

The outcome of a certificate chain validation routine.

Available options:

Use the ValidationLog property to access the detailed validation log.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

i32

timestamp_contains_long_term_info property (XAdESSigner Struct)

Returns true if the signature was found to contain long-term validation details (certificates, CRLs, and OCSP response).

Syntax

fn timestamp_contains_long_term_info(&self , TimestampIndex : i32) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

Returns true if the signature was found to contain long-term validation details (certificates, CRLs, and OCSP response).

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

bool

timestamp_entity_label property (XAdESSigner Struct)

Use this property to get the timestamp entity label.

Syntax

fn timestamp_entity_label(&self , TimestampIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get the timestamp entity label.

This property returns a string label that uniquely identifies the timestamp. The label can be used to establish the signature target in the SignatureFound event or to select the signing chain via the SelectInfo method.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

String

timestamp_hash_algorithm property (XAdESSigner Struct)

Returns the timestamp's hash algorithm.

Syntax

fn timestamp_hash_algorithm(&self , TimestampIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Returns the timestamp's hash algorithm.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

String

timestamp_parent_entity property (XAdESSigner Struct)

Use this property to get the label of the timestamp's parent entity.

Syntax

fn timestamp_parent_entity(&self , TimestampIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Use this property to get the label of the timestamp's parent entity.

This property references the EntityLabel of the object that the timestamp covers, typically a signature.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

String

timestamp_serial_number property (XAdESSigner Struct)

Returns the timestamp's serial number.

Syntax

fn timestamp_serial_number(&self , TimestampIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the timestamp's serial number.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

Vec

timestamp_time property (XAdESSigner Struct)

The time point incorporated into the timestamp.

Syntax

fn timestamp_time(&self , TimestampIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The time point incorporated into the timestamp.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

String

timestamp_type property (XAdESSigner Struct)

Returns the type of the timestamp.

Syntax

fn timestamp_type(&self , TimestampIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

Returns the type of the timestamp.

Available options:

Not all of the above timestamp types can be supported by a specific signature technology used (CAdES, PDF, XAdES).

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

i32

timestamp_tsa_name property (XAdESSigner Struct)

This value uniquely identifies the Timestamp Authority (TSA).

Syntax

fn timestamp_tsa_name(&self , TimestampIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

This value uniquely identifies the Timestamp Authority (TSA).

This property provides information about the entity that manages the TSA.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

String

timestamp_validation_log property (XAdESSigner Struct)

Contains the TSA certificate chain validation log.

Syntax

fn timestamp_validation_log(&self , TimestampIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains the TSA certificate chain validation log. This information is extremely useful if the timestamp validation fails.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

String

timestamp_validation_result property (XAdESSigner Struct)

Contains the timestamp validation outcome.

Syntax

fn timestamp_validation_result(&self , TimestampIndex : i32) -> Result<i32, SecureBlackboxError> 

Possible Values

0   // Valid
1   // Unknown
2   // Corrupted
3   // SignerNotFound
4   // Failure
5   // ReferenceCorrupted

Default Value

0

Remarks

Contains the timestamp validation outcome.

Use this property to check the result of the most recent timestamp validation.

The TimestampIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TimestampCount property.

This property is read-only.

Data Type

i32

timestamp_server property (XAdESSigner Struct)

The address of the timestamping server.

Syntax

fn timestamp_server(&self ) -> Result<String, SecureBlackboxError> 
fn set_timestamp_server(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_timestamp_server_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to provide the address of the Time Stamping Authority (TSA) server to be used for timestamping the signature.

SecureBlackbox supports RFC3161-compliant timestamping servers, available via HTTP or HTTPS.

If your timestamping service enforces credential-based user authentication (basic or digest), you can provide the credentials in the same URL:

http://user:password@timestamp.server.com/TsaService

For TSAs using certificate-based TLS authentication, provide the client certificate via the tls_client_chain property.

If this property is left empty, no timestamp will be added to the signature.

Starting from summer 2021 update (Vol. 2), the virtual timestamping service is supported, which allows you to intervene in the timestamping routine and provide your own handling for the TSA exchange. This may be handy if the service that you are requesting timestamps from uses a non-standard TSP protocol or requires special authentication option.

To employ the virtual service, assign an URI of the following format to this property:

virtual://localhost?hashonly=true&includecerts=true&reqpolicy=1.2.3.4.5&halg=SHA256&ignorenonce=true

Subscribe to on_notification event to get notified about the virtualized timestamping event. The EventID of the timestamping event is TimestampRequest. Inside the event handler, read the base16-encoded request from the EventParam parameter and forward it to the timestamping authority. Upon receiving the response, pass it back to the component, encoded in base16, via the TimestampResponse config property:

component.Config("TimestampResponse=308208ab...");

Note that all the exchange with your custom TSA should take place within the same invocation of the Notification event.

The hashonly parameter of the virtual URI tells the component to only return the timestamp message imprint via the EventParam parameter. If set to false, EventParam will contain the complete RFC3161 timestamping request.

The includecerts parameter specifies that the requestCertificates parameter of the timestamping request should be set to true.

The reqpolicy parameter lets you specify the request policy, and the halg parameter specifies the hash algorithm to use for timestamping.

The ignorenonce parameter allows you to switch off client nonce verification to enable compatibility with TSA services that do not support nonce mirroring.

All the parameters are optional.

Data Type

String

tls_client_cert_count property (XAdESSigner Struct)

The number of records in the TLSClientCert arrays.

Syntax

fn tls_client_cert_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_client_cert_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• tls_client_cert_bytes
• tls_client_cert_handle

The array indices start at 0 and end at tls_client_cert_count - 1.

Data Type

i32

tls_client_cert_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn tls_client_cert_bytes(&self , TLSClientCertIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

The TLSClientCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSClientCertCount property.

This property is read-only.

Data Type

Vec

tls_client_cert_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn tls_client_cert_handle(&self , TLSClientCertIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_tls_client_cert_handle(&self, TLSClientCertIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The TLSClientCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSClientCertCount property.

Data Type

i64

tls_server_cert_count property (XAdESSigner Struct)

The number of records in the TLSServerCert arrays.

Syntax

fn tls_server_cert_count(&self ) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• tls_server_cert_bytes
• tls_server_cert_fingerprint
• tls_server_cert_handle
• tls_server_cert_issuer
• tls_server_cert_issuer_rdn
• tls_server_cert_key_algorithm
• tls_server_cert_key_bits
• tls_server_cert_key_usage
• tls_server_cert_self_signed
• tls_server_cert_serial_number
• tls_server_cert_sig_algorithm
• tls_server_cert_subject
• tls_server_cert_subject_rdn
• tls_server_cert_valid_from
• tls_server_cert_valid_to

The array indices start at 0 and end at tls_server_cert_count - 1.

This property is read-only.

Data Type

i32

tls_server_cert_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn tls_server_cert_bytes(&self , TLSServerCertIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

Vec

tls_server_cert_fingerprint property (XAdESSigner Struct)

Contains the fingerprint (a hash imprint) of this certificate.

Syntax

fn tls_server_cert_fingerprint(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Contains the fingerprint (a hash imprint) of this certificate.

While there is no formal standard defining what a fingerprint is, a SHA1 hash of the certificate's DER-encoded body is typically used.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn tls_server_cert_handle(&self , TLSServerCertIndex : i32) -> Result<i64, SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

i64

tls_server_cert_issuer property (XAdESSigner Struct)

The common name of the certificate issuer (CA), typically a company name.

Syntax

fn tls_server_cert_issuer(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The common name of the certificate issuer (CA), typically a company name. This is part of a larger set of credentials available via tls_issuer_rdn.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_issuer_rdn property (XAdESSigner Struct)

A list of Property=Value pairs that uniquely identify the certificate issuer.

Syntax

fn tls_server_cert_issuer_rdn(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

A list of Property=Value pairs that uniquely identify the certificate issuer.

Example: /C=US/O=Nationwide CA/CN=Web Certification Authority

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_key_algorithm property (XAdESSigner Struct)

Specifies the public key algorithm of this certificate.

Syntax

fn tls_server_cert_key_algorithm(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

"0"

Remarks

Specifies the public key algorithm of this certificate.

Use the tls_key_bits, tls_curve, and tls_public_key_bytes properties to get more details about the key the certificate contains.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_key_bits property (XAdESSigner Struct)

Returns the length of the public key in bits.

Syntax

fn tls_server_cert_key_bits(&self , TLSServerCertIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

Returns the length of the public key in bits.

This value indicates the length of the principal cryptographic parameter of the key, such as the length of the RSA modulus or ECDSA field. The key data returned by the tls_public_key_bytes or tls_private_key_bytes property would typically contain auxiliary values, and therefore be longer.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

i32

tls_server_cert_key_usage property (XAdESSigner Struct)

Indicates the purposes of the key contained in the certificate, in the form of an OR'ed flag set.

Syntax

fn tls_server_cert_key_usage(&self , TLSServerCertIndex : i32) -> Result<i32, SecureBlackboxError> 

Default Value

0

Remarks

Indicates the purposes of the key contained in the certificate, in the form of an OR'ed flag set.

This value is a bit mask of the following values:

Set this property before generating the certificate to propagate the key usage flags to the new certificate.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

i32

tls_server_cert_self_signed property (XAdESSigner Struct)

Indicates whether the certificate is self-signed (root) or signed by an external CA.

Syntax

fn tls_server_cert_self_signed(&self , TLSServerCertIndex : i32) -> Result<bool, SecureBlackboxError> 

Default Value

false

Remarks

Indicates whether the certificate is self-signed (root) or signed by an external CA.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

bool

tls_server_cert_serial_number property (XAdESSigner Struct)

Returns the certificate's serial number.

Syntax

fn tls_server_cert_serial_number(&self , TLSServerCertIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the certificate's serial number.

The serial number is a binary string that uniquely identifies a certificate among others issued by the same CA. According to the X.509 standard, the (issuer, serial number) pair should be globally unique to facilitate chain building.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

Vec

tls_server_cert_sig_algorithm property (XAdESSigner Struct)

Indicates the algorithm that was used by the CA to sign this certificate.

Syntax

fn tls_server_cert_sig_algorithm(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

Indicates the algorithm that was used by the CA to sign this certificate.

A signature algorithm typically combines hash and public key algorithms together, such as sha256WithRSAEncryption or ecdsa-with-SHA256.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_subject property (XAdESSigner Struct)

The common name of the certificate holder, typically an individual's name, a URL, an e-mail address, or a company name.

Syntax

fn tls_server_cert_subject(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The common name of the certificate holder, typically an individual's name, a URL, an e-mail address, or a company name. This is part of a larger set of credentials available via tls_subject_rdn.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_subject_rdn property (XAdESSigner Struct)

A list of Property=Value pairs that uniquely identify the certificate holder (subject).

Syntax

fn tls_server_cert_subject_rdn(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

A list of Property=Value pairs that uniquely identify the certificate holder (subject).

Depending on the purpose of the certificate and the policies of the CA that issued it, the values included in the subject record may differ drastically and contain business or personal names, web URLs, email addresses, and other data.

Example: /C=US/O=Oranges and Apples, Inc./OU=Accounts Receivable/1.2.3.4.5=Value with unknown OID/CN=Margaret Watkins.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_valid_from property (XAdESSigner Struct)

The time point at which the certificate becomes valid, in UTC.

Syntax

fn tls_server_cert_valid_from(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The time point at which the certificate becomes valid, in UTC.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_server_cert_valid_to property (XAdESSigner Struct)

The time point at which the certificate expires, in UTC.

Syntax

fn tls_server_cert_valid_to(&self , TLSServerCertIndex : i32) -> Result<String, SecureBlackboxError> 

Default Value

""

Remarks

The time point at which the certificate expires, in UTC.

The TLSServerCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TLSServerCertCount property.

This property is read-only.

Data Type

String

tls_auto_validate_certificates property (XAdESSigner Struct)

Specifies whether server-side TLS certificates should be validated automatically using internal validation rules.

Syntax

fn tls_auto_validate_certificates(&self ) -> Result<bool, SecureBlackboxError> 
fn set_tls_auto_validate_certificates(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

true

Remarks

Specifies whether server-side TLS certificates should be validated automatically using internal validation rules.

Data Type

bool

tls_base_configuration property (XAdESSigner Struct)

Selects the base configuration for the TLS settings.

Syntax

fn tls_base_configuration(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_base_configuration(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Default
1   // Compatible
2   // ComprehensiveInsecure
3   // HighlySecure

Default Value

0

Remarks

Selects the base configuration for the TLS settings. Several profiles are offered and tuned up for different purposes, such as high security or higher compatibility.

Data Type

i32

tls_ciphersuites property (XAdESSigner Struct)

A list of ciphersuites separated with commas or semicolons.

Syntax

fn tls_ciphersuites(&self ) -> Result<String, SecureBlackboxError> 
fn set_tls_ciphersuites(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_tls_ciphersuites_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

A list of ciphersuites separated with commas or semicolons. Each ciphersuite in the list may be prefixed with a minus sign (-) to indicate that the ciphersuite should be disabled rather than enabled. Besides the specific ciphersuite modifiers, this property supports the all (and -all) aliases, allowing all ciphersuites to be blanketly enabled or disabled at once.

Note: the list of ciphersuites provided to this property alters the baseline list of ciphersuites as defined by tls_base_configuration. Remember to start your ciphersuite string with -all; if you need to only enable a specific fixed set of ciphersuites. The list of supported ciphersuites is provided below:

• NULL_NULL_NULL
• RSA_NULL_MD5
• RSA_NULL_SHA
• RSA_RC4_MD5
• RSA_RC4_SHA
• RSA_RC2_MD5
• RSA_IDEA_MD5
• RSA_IDEA_SHA
• RSA_DES_MD5
• RSA_DES_SHA
• RSA_3DES_MD5
• RSA_3DES_SHA
• RSA_AES128_SHA
• RSA_AES256_SHA
• DH_DSS_DES_SHA
• DH_DSS_3DES_SHA
• DH_DSS_AES128_SHA
• DH_DSS_AES256_SHA
• DH_RSA_DES_SHA
• DH_RSA_3DES_SHA
• DH_RSA_AES128_SHA
• DH_RSA_AES256_SHA
• DHE_DSS_DES_SHA
• DHE_DSS_3DES_SHA
• DHE_DSS_AES128_SHA
• DHE_DSS_AES256_SHA
• DHE_RSA_DES_SHA
• DHE_RSA_3DES_SHA
• DHE_RSA_AES128_SHA
• DHE_RSA_AES256_SHA
• DH_ANON_RC4_MD5
• DH_ANON_DES_SHA
• DH_ANON_3DES_SHA
• DH_ANON_AES128_SHA
• DH_ANON_AES256_SHA
• RSA_RC2_MD5_EXPORT
• RSA_RC4_MD5_EXPORT
• RSA_DES_SHA_EXPORT
• DH_DSS_DES_SHA_EXPORT
• DH_RSA_DES_SHA_EXPORT
• DHE_DSS_DES_SHA_EXPORT
• DHE_RSA_DES_SHA_EXPORT
• DH_ANON_RC4_MD5_EXPORT
• DH_ANON_DES_SHA_EXPORT
• RSA_CAMELLIA128_SHA
• DH_DSS_CAMELLIA128_SHA
• DH_RSA_CAMELLIA128_SHA
• DHE_DSS_CAMELLIA128_SHA
• DHE_RSA_CAMELLIA128_SHA
• DH_ANON_CAMELLIA128_SHA
• RSA_CAMELLIA256_SHA
• DH_DSS_CAMELLIA256_SHA
• DH_RSA_CAMELLIA256_SHA
• DHE_DSS_CAMELLIA256_SHA
• DHE_RSA_CAMELLIA256_SHA
• DH_ANON_CAMELLIA256_SHA
• PSK_RC4_SHA
• PSK_3DES_SHA
• PSK_AES128_SHA
• PSK_AES256_SHA
• DHE_PSK_RC4_SHA
• DHE_PSK_3DES_SHA
• DHE_PSK_AES128_SHA
• DHE_PSK_AES256_SHA
• RSA_PSK_RC4_SHA
• RSA_PSK_3DES_SHA
• RSA_PSK_AES128_SHA
• RSA_PSK_AES256_SHA
• RSA_SEED_SHA
• DH_DSS_SEED_SHA
• DH_RSA_SEED_SHA
• DHE_DSS_SEED_SHA
• DHE_RSA_SEED_SHA
• DH_ANON_SEED_SHA
• SRP_SHA_3DES_SHA
• SRP_SHA_RSA_3DES_SHA
• SRP_SHA_DSS_3DES_SHA
• SRP_SHA_AES128_SHA
• SRP_SHA_RSA_AES128_SHA
• SRP_SHA_DSS_AES128_SHA
• SRP_SHA_AES256_SHA
• SRP_SHA_RSA_AES256_SHA
• SRP_SHA_DSS_AES256_SHA
• ECDH_ECDSA_NULL_SHA
• ECDH_ECDSA_RC4_SHA
• ECDH_ECDSA_3DES_SHA
• ECDH_ECDSA_AES128_SHA
• ECDH_ECDSA_AES256_SHA
• ECDHE_ECDSA_NULL_SHA
• ECDHE_ECDSA_RC4_SHA
• ECDHE_ECDSA_3DES_SHA
• ECDHE_ECDSA_AES128_SHA
• ECDHE_ECDSA_AES256_SHA
• ECDH_RSA_NULL_SHA
• ECDH_RSA_RC4_SHA
• ECDH_RSA_3DES_SHA
• ECDH_RSA_AES128_SHA
• ECDH_RSA_AES256_SHA
• ECDHE_RSA_NULL_SHA
• ECDHE_RSA_RC4_SHA
• ECDHE_RSA_3DES_SHA
• ECDHE_RSA_AES128_SHA
• ECDHE_RSA_AES256_SHA
• ECDH_ANON_NULL_SHA
• ECDH_ANON_RC4_SHA
• ECDH_ANON_3DES_SHA
• ECDH_ANON_AES128_SHA
• ECDH_ANON_AES256_SHA
• RSA_NULL_SHA256
• RSA_AES128_SHA256
• RSA_AES256_SHA256
• DH_DSS_AES128_SHA256
• DH_RSA_AES128_SHA256
• DHE_DSS_AES128_SHA256
• DHE_RSA_AES128_SHA256
• DH_DSS_AES256_SHA256
• DH_RSA_AES256_SHA256
• DHE_DSS_AES256_SHA256
• DHE_RSA_AES256_SHA256
• DH_ANON_AES128_SHA256
• DH_ANON_AES256_SHA256
• RSA_AES128_GCM_SHA256
• RSA_AES256_GCM_SHA384
• DHE_RSA_AES128_GCM_SHA256
• DHE_RSA_AES256_GCM_SHA384
• DH_RSA_AES128_GCM_SHA256
• DH_RSA_AES256_GCM_SHA384
• DHE_DSS_AES128_GCM_SHA256
• DHE_DSS_AES256_GCM_SHA384
• DH_DSS_AES128_GCM_SHA256
• DH_DSS_AES256_GCM_SHA384
• DH_ANON_AES128_GCM_SHA256
• DH_ANON_AES256_GCM_SHA384
• ECDHE_ECDSA_AES128_SHA256
• ECDHE_ECDSA_AES256_SHA384
• ECDH_ECDSA_AES128_SHA256
• ECDH_ECDSA_AES256_SHA384
• ECDHE_RSA_AES128_SHA256
• ECDHE_RSA_AES256_SHA384
• ECDH_RSA_AES128_SHA256
• ECDH_RSA_AES256_SHA384
• ECDHE_ECDSA_AES128_GCM_SHA256
• ECDHE_ECDSA_AES256_GCM_SHA384
• ECDH_ECDSA_AES128_GCM_SHA256
• ECDH_ECDSA_AES256_GCM_SHA384
• ECDHE_RSA_AES128_GCM_SHA256
• ECDHE_RSA_AES256_GCM_SHA384
• ECDH_RSA_AES128_GCM_SHA256
• ECDH_RSA_AES256_GCM_SHA384
• PSK_AES128_GCM_SHA256
• PSK_AES256_GCM_SHA384
• DHE_PSK_AES128_GCM_SHA256
• DHE_PSK_AES256_GCM_SHA384
• RSA_PSK_AES128_GCM_SHA256
• RSA_PSK_AES256_GCM_SHA384
• PSK_AES128_SHA256
• PSK_AES256_SHA384
• PSK_NULL_SHA256
• PSK_NULL_SHA384
• DHE_PSK_AES128_SHA256
• DHE_PSK_AES256_SHA384
• DHE_PSK_NULL_SHA256
• DHE_PSK_NULL_SHA384
• RSA_PSK_AES128_SHA256
• RSA_PSK_AES256_SHA384
• RSA_PSK_NULL_SHA256
• RSA_PSK_NULL_SHA384
• RSA_CAMELLIA128_SHA256
• DH_DSS_CAMELLIA128_SHA256
• DH_RSA_CAMELLIA128_SHA256
• DHE_DSS_CAMELLIA128_SHA256
• DHE_RSA_CAMELLIA128_SHA256
• DH_ANON_CAMELLIA128_SHA256
• RSA_CAMELLIA256_SHA256
• DH_DSS_CAMELLIA256_SHA256
• DH_RSA_CAMELLIA256_SHA256
• DHE_DSS_CAMELLIA256_SHA256
• DHE_RSA_CAMELLIA256_SHA256
• DH_ANON_CAMELLIA256_SHA256
• ECDHE_ECDSA_CAMELLIA128_SHA256
• ECDHE_ECDSA_CAMELLIA256_SHA384
• ECDH_ECDSA_CAMELLIA128_SHA256
• ECDH_ECDSA_CAMELLIA256_SHA384
• ECDHE_RSA_CAMELLIA128_SHA256
• ECDHE_RSA_CAMELLIA256_SHA384
• ECDH_RSA_CAMELLIA128_SHA256
• ECDH_RSA_CAMELLIA256_SHA384
• RSA_CAMELLIA128_GCM_SHA256
• RSA_CAMELLIA256_GCM_SHA384
• DHE_RSA_CAMELLIA128_GCM_SHA256
• DHE_RSA_CAMELLIA256_GCM_SHA384
• DH_RSA_CAMELLIA128_GCM_SHA256
• DH_RSA_CAMELLIA256_GCM_SHA384
• DHE_DSS_CAMELLIA128_GCM_SHA256
• DHE_DSS_CAMELLIA256_GCM_SHA384
• DH_DSS_CAMELLIA128_GCM_SHA256
• DH_DSS_CAMELLIA256_GCM_SHA384
• DH_anon_CAMELLIA128_GCM_SHA256
• DH_anon_CAMELLIA256_GCM_SHA384
• ECDHE_ECDSA_CAMELLIA128_GCM_SHA256
• ECDHE_ECDSA_CAMELLIA256_GCM_SHA384
• ECDH_ECDSA_CAMELLIA128_GCM_SHA256
• ECDH_ECDSA_CAMELLIA256_GCM_SHA384
• ECDHE_RSA_CAMELLIA128_GCM_SHA256
• ECDHE_RSA_CAMELLIA256_GCM_SHA384
• ECDH_RSA_CAMELLIA128_GCM_SHA256
• ECDH_RSA_CAMELLIA256_GCM_SHA384
• PSK_CAMELLIA128_GCM_SHA256
• PSK_CAMELLIA256_GCM_SHA384
• DHE_PSK_CAMELLIA128_GCM_SHA256
• DHE_PSK_CAMELLIA256_GCM_SHA384
• RSA_PSK_CAMELLIA128_GCM_SHA256
• RSA_PSK_CAMELLIA256_GCM_SHA384
• PSK_CAMELLIA128_SHA256
• PSK_CAMELLIA256_SHA384
• DHE_PSK_CAMELLIA128_SHA256
• DHE_PSK_CAMELLIA256_SHA384
• RSA_PSK_CAMELLIA128_SHA256
• RSA_PSK_CAMELLIA256_SHA384
• ECDHE_PSK_CAMELLIA128_SHA256
• ECDHE_PSK_CAMELLIA256_SHA384
• ECDHE_PSK_RC4_SHA
• ECDHE_PSK_3DES_SHA
• ECDHE_PSK_AES128_SHA
• ECDHE_PSK_AES256_SHA
• ECDHE_PSK_AES128_SHA256
• ECDHE_PSK_AES256_SHA384
• ECDHE_PSK_NULL_SHA
• ECDHE_PSK_NULL_SHA256
• ECDHE_PSK_NULL_SHA384
• ECDHE_RSA_CHACHA20_POLY1305_SHA256
• ECDHE_ECDSA_CHACHA20_POLY1305_SHA256
• DHE_RSA_CHACHA20_POLY1305_SHA256
• PSK_CHACHA20_POLY1305_SHA256
• ECDHE_PSK_CHACHA20_POLY1305_SHA256
• DHE_PSK_CHACHA20_POLY1305_SHA256
• RSA_PSK_CHACHA20_POLY1305_SHA256
• AES128_GCM_SHA256
• AES256_GCM_SHA384
• CHACHA20_POLY1305_SHA256
• AES128_CCM_SHA256
• AES128_CCM8_SHA256

Data Type

String

tls_client_auth property (XAdESSigner Struct)

Enables or disables certificate-based client authentication.

Syntax

fn tls_client_auth(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_client_auth(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // NoAuth
1   // RequestCert
2   // RequireCert

Default Value

0

Remarks

Enables or disables certificate-based client authentication.

Set this property to true to tune up the client authentication type:

Data Type

i32

tls_extensions property (XAdESSigner Struct)

Provides access to TLS extensions.

Syntax

fn tls_extensions(&self ) -> Result<String, SecureBlackboxError> 
fn set_tls_extensions(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_tls_extensions_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Provides access to TLS extensions.

Data Type

String

tls_force_resume_if_destination_changes property (XAdESSigner Struct)

Whether to force TLS session resumption when the destination address changes.

Syntax

fn tls_force_resume_if_destination_changes(&self ) -> Result<bool, SecureBlackboxError> 
fn set_tls_force_resume_if_destination_changes(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Whether to force TLS session resumption when the destination address changes.

Data Type

bool

tls_groups property (XAdESSigner Struct)

Specifies a list of key exchange groups to attempt during the TLS key exchange.

Syntax

fn tls_groups(&self ) -> Result<String, SecureBlackboxError> 
fn set_tls_groups(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_tls_groups_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Specifies a list of key exchange groups to attempt during the TLS key exchange.

Keep this setting at its default value (empty string) to stick with the default list of key exchange groups. You can tweak the list by using '+' and '-' modifiers that are immediately followed by a group name or the all placeholder:

// Ensure the two x25519-based groups are enabled and the finite field DHE2048 is disabled client.TLSSettings.Groups = "+x25519mlkem768;+x25519;-ffdhe2048"; // Only enable the hybrid X25519/ML-KEM768 group client.TLSSettings.Groups = "-all;+x25519mlkem768";

The list of groups supported by the component is provided below. All the names are case-insensitive:

Elliptic curve-based groups:

• SECT163K1
• SECT163R1
• SECT163R2
• SECT193R1
• SECT193R2
• SECT233K1
• SECT233R1
• SECT239K1
• SECT283K1
• SECT283R1
• SECT409K1
• SECT409R1
• SECT571K1
• SECT571R1
• SECP160K1
• SECP160R1
• SECP160R2
• SECP192K1
• SECP192R1
• SECP224K1
• SECP224R1
• SECP256K1
• SECP256R1
• SECP384R1
• SECP521R1
• BRAINPOOLP256R1
• BRAINPOOLP384R1
• BRAINPOOLP512R1
• X25519
• X448

Finite field-based groups:

• FFDHE2048
• FFDHE3072
• FFDHE4096
• FFDHE6144
• FFDHE8192

Post-Quantum and Hybrid groups:

• MLKEM512
• MLKEM768
• MLKEM1024
• SECP256R1MLKEM768
• X25519MLKEM768
• SECP384R1MLKEM1024

Note: this property was called ECCurves in SecureBlackbox 2024 and older.

Data Type

String

tls_pre_shared_identity property (XAdESSigner Struct)

Defines the identity used when the PSK (Pre-Shared Key) key-exchange mechanism is negotiated.

Syntax

fn tls_pre_shared_identity(&self ) -> Result<String, SecureBlackboxError> 
fn set_tls_pre_shared_identity(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_tls_pre_shared_identity_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Defines the identity used when the PSK (Pre-Shared Key) key-exchange mechanism is negotiated.

Data Type

String

tls_pre_shared_key property (XAdESSigner Struct)

Contains the pre-shared key for the PSK (Pre-Shared Key) key-exchange mechanism, encoded with base16.

Syntax

fn tls_pre_shared_key(&self ) -> Result<String, SecureBlackboxError> 
fn set_tls_pre_shared_key(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_tls_pre_shared_key_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Contains the pre-shared key for the PSK (Pre-Shared Key) key-exchange mechanism, encoded with base16.

Data Type

String

tls_pre_shared_key_ciphersuite property (XAdESSigner Struct)

Defines the ciphersuite used for PSK (Pre-Shared Key) negotiation.

Syntax

fn tls_pre_shared_key_ciphersuite(&self ) -> Result<String, SecureBlackboxError> 
fn set_tls_pre_shared_key_ciphersuite(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_tls_pre_shared_key_ciphersuite_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Defines the ciphersuite used for PSK (Pre-Shared Key) negotiation.

Data Type

String

tls_renegotiation_attack_prevention_mode property (XAdESSigner Struct)

Selects the renegotiation attack prevention mechanism.

Syntax

fn tls_renegotiation_attack_prevention_mode(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_renegotiation_attack_prevention_mode(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Compatible
1   // Strict
2   // Auto

Default Value

2

Remarks

Selects the renegotiation attack prevention mechanism.

The following options are available:

Data Type

i32

tls_revocation_check property (XAdESSigner Struct)

Specifies the kind(s) of revocation check to perform.

Syntax

fn tls_revocation_check(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_revocation_check(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // None
1   // Auto
2   // AllCRL
3   // AllOCSP
4   // AllCRLAndOCSP
5   // AnyCRL
6   // AnyOCSP
7   // AnyCRLOrOCSP
8   // AnyOCSPOrCRL

Default Value

1

Remarks

Specifies the kind(s) of revocation check to perform.

Revocation checking is necessary to ensure the integrity of the chain and obtain up-to-date certificate validity and trustworthiness information.

This setting controls the way the revocation checks are performed for every certificate in the chain. Typically certificates come with two types of revocation information sources: CRL (certificate revocation lists) and OCSP responders. CRLs are static objects periodically published by the CA at some online location. OCSP responders are active online services maintained by the CA that can provide up-to-date information on certificate statuses in near real time.

There are some conceptual differences between the two. CRLs are normally larger in size. Their use involves some latency because there is normally some delay between the time when a certificate was revoked and the time the subsequent CRL mentioning that is published. The benefits of CRL is that the same object can provide statuses for all certificates issued by a particular CA, and that the whole technology is much simpler than OCSP (and thus is supported by more CAs).

This setting lets you adjust the validation course by including or excluding certain types of revocation sources from the validation process. The crcAnyOCSPOrCRL setting (give preference to the faster OCSP route and only demand one source to succeed) is a good choice for most typical validation environments. The "crcAll*" modes are much stricter, and may be used in scenarios where bulletproof validity information is essential.

NOTE: If no CRL or OCSP endpoints are provided by the CA, the revocation check will be considered successful. This is because the CA chose not to supply revocation information for its certificates, meaning they are considered irrevocable.

NOTE: Within each of the above settings, if any retrieved CRL or OCSP response indicates that the certificate has been revoked, the revocation check fails.

Data Type

i32

tls_ssl_options property (XAdESSigner Struct)

Various SSL (TLS) protocol options, set of cssloExpectShutdownMessage 0x001 Wait for the close-notify message when shutting down the connection cssloOpenSSLDTLSWorkaround 0x002 (DEPRECATED) Use a DTLS version workaround when talking to very old OpenSSL versions cssloDisableKexLengthAlignment 0x004 Do not align the client-side PMS by the RSA modulus size.

Syntax

fn tls_ssl_options(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_ssl_options(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

16

Remarks

Various SSL (TLS) protocol options, set of

Data Type

i32

tls_mode property (XAdESSigner Struct)

Specifies the TLS mode to use.

Syntax

fn tls_mode(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_mode(&self, value : i32) ->  Option<SecureBlackboxError> 

Possible Values

0   // Default
1   // NoTLS
2   // ExplicitTLS
3   // ImplicitTLS
4   // MixedTLS

Default Value

0

Remarks

Specifies the TLS mode to use.

Data Type

i32

tls_use_extended_master_secret property (XAdESSigner Struct)

Enables the Extended Master Secret Extension, as defined in RFC 7627.

Syntax

fn tls_use_extended_master_secret(&self ) -> Result<bool, SecureBlackboxError> 
fn set_tls_use_extended_master_secret(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

true

Remarks

Enables the Extended Master Secret Extension, as defined in RFC 7627.

Data Type

bool

tls_use_session_resumption property (XAdESSigner Struct)

Enables or disables the TLS session resumption capability.

Syntax

fn tls_use_session_resumption(&self ) -> Result<bool, SecureBlackboxError> 
fn set_tls_use_session_resumption(&self, value : bool) ->  Option<SecureBlackboxError> 

Default Value

false

Remarks

Enables or disables the TLS session resumption capability.

Data Type

bool

tls_versions property (XAdESSigner Struct)

The SSL/TLS versions to enable by default.

Syntax

fn tls_versions(&self ) -> Result<i32, SecureBlackboxError> 
fn set_tls_versions(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

48

Remarks

The SSL/TLS versions to enable by default.

Data Type

i32

trusted_cert_count property (XAdESSigner Struct)

The number of records in the TrustedCert arrays.

Syntax

fn trusted_cert_count(&self ) -> Result<i32, SecureBlackboxError> 
fn set_trusted_cert_count(&self, value : i32) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• trusted_cert_bytes
• trusted_cert_handle

The array indices start at 0 and end at trusted_cert_count - 1.

Data Type

i32

trusted_cert_bytes property (XAdESSigner Struct)

Returns the raw certificate data in DER format.

Syntax

fn trusted_cert_bytes(&self , TrustedCertIndex : i32) -> Result<Vec<u8>, SecureBlackboxError> 

Remarks

Returns the raw certificate data in DER format.

The TrustedCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TrustedCertCount property.

This property is read-only.

Data Type

Vec

trusted_cert_handle property (XAdESSigner Struct)

Allows to get or set a 'handle', a unique identifier of the underlying property object.

Syntax

fn trusted_cert_handle(&self , TrustedCertIndex : i32) -> Result<i64, SecureBlackboxError> 
fn set_trusted_cert_handle(&self, TrustedCertIndex : i32, value : i64) ->  Option<SecureBlackboxError> 

Default Value

0

Remarks

Allows to get or set a 'handle', a unique identifier of the underlying property object. Use this property to assign objects of the same type in a quicker manner, without copying them fieldwise.

When you pass a handle of one object to another, the source object is copied to the destination rather than assigned. It is safe to get rid of the original object after such operation. pdfSigner.setSigningCertHandle(certMgr.getCertHandle());

The TrustedCertIndex parameter specifies the index of the item in the array. The size of the array is controlled by the TrustedCertCount property.

Data Type

i64

validation_moment property (XAdESSigner Struct)

The time point at which signature validity is to be established.

Syntax

fn validation_moment(&self ) -> Result<String, SecureBlackboxError> 
fn set_validation_moment(&self, value : &str) ->  Option<SecureBlackboxError> 
fn set_validation_moment_ref(&self, value : &String) ->  Option<SecureBlackboxError> 

Default Value

""

Remarks

Use this property to specify the moment in time at which signature validity should be established. The time is in UTC. Leave the setting empty to stick to the default moment (either the signature creation time or the current time).

The validity of the same signature may differ depending on the time point chosen due to temporal changes in chain validities, revocation statuses, and timestamp times.

Data Type

String

add_data_reference method (XAdESSigner Struct)

Creates a new XML reference to the specified data.

Syntax

fn add_data_reference(&self, data_uri : &str, data : &[u8]) ->  Result<i32, SecureBlackboxError>

Remarks

Use this method to add a reference to the custom data. Pass the reference's URI via DataURI parameter.

This method uses hash_algorithm property to specify the hash algorithm of the reference.

The method returns the index of the new reference entry in the references collection.

add_known_namespace method (XAdESSigner Struct)

Adds known prefix and correspondent namespace URI.

Syntax

fn add_known_namespace(&self, prefix : &str, uri : &str) -> Result<(), SecureBlackboxError>

Remarks

Use this method to add a known prefix and namespace URI that are used in XPath expression within XMLElement/XMLNode property, and within TargetXMLElement and XPathPrefixList properties of the references.

add_reference method (XAdESSigner Struct)

Creates a new XML reference to the specified XML element.

Syntax

fn add_reference(&self, target_xml_element : &str, custom_id : &str, auto_generate_id : bool) ->  Result<i32, SecureBlackboxError>

Remarks

Use this method to add a reference to a particular XML element.

The reference's URI is set basing on the ID of the XML element. If the XML element doesn't have an ID then a CustomId value will be used. If CustomId is empty and AutoGenerateId is set, the ID will be generated automatically. An exception will be thrown otherwise.

This method uses canonicalization_method and hash_algorithm properties to specify the canonicalization method and hash algorithm of the reference.

The method returns the index of the new reference entry in the references collection.

close method (XAdESSigner Struct)

Closes an opened document.

Syntax

fn close(&self, save_changes : bool) -> Result<(), SecureBlackboxError>

Remarks

Use this method to close a previously opened document. Set SaveChanges to true to apply any changes made.

config method (XAdESSigner Struct)

Sets or retrieves a configuration setting.

Syntax

fn config(&self, configuration_string : &str) ->  Result<String, SecureBlackboxError>

Remarks

config is a generic method available in every struct. It is used to set and retrieve configuration settings for the struct.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the struct, access to these internal properties is provided through the config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

do_action method (XAdESSigner Struct)

Performs an additional action.

Syntax

fn do_action(&self, action_id : &str, action_params : &str) ->  Result<String, SecureBlackboxError>

Remarks

do_action is a generic method available in every struct. It is used to perform an additional action introduced after the product major release. The list of actions is not fixed, and may be flexibly extended over time.

The unique identifier (case insensitive) of the action is provided in the ActionID parameter.

ActionParams contains the value of a single parameter, or a list of multiple parameters for the action in the form of PARAM1=VALUE1;PARAM2=VALUE2;....

Common ActionIDs:

extract_async_data method (XAdESSigner Struct)

Extracts user data from the DC signing service response.

Syntax

fn extract_async_data(&self, async_reply : &str) ->  Result<String, SecureBlackboxError>

Remarks

Call this method before finalizing the asynchronous signing process to extract the data passed to the ExternalCrypto.Data property on the pre-signing stage.

The Data parameter can be used to pass some state or document identifier along with the signing request from the pre-signing to the completion async stage.

get_inner_xml method (XAdESSigner Struct)

Get the inner XML content of the selected XML element.

Syntax

fn get_inner_xml(&self, xpath : &str) ->  Result<String, SecureBlackboxError>

Remarks

Call this method to get the inner XML content of the selected XML element.

get_outer_xml method (XAdESSigner Struct)

Get the outer XML content of the selected XML element.

Syntax

fn get_outer_xml(&self, xpath : &str) ->  Result<String, SecureBlackboxError>

Remarks

Call this method to get the outer XML content of the selected XML element.

get_text_content method (XAdESSigner Struct)

Get the text content of the selected XML element.

Syntax

fn get_text_content(&self, xpath : &str) ->  Result<String, SecureBlackboxError>

Remarks

Call this method to get the text content of the selected XML element.

open method (XAdESSigner Struct)

Opens a document for signing or updating.

Syntax

fn open(&self) -> Result<(), SecureBlackboxError>

Remarks

Use this method to open a document for signing or updating. When finished, call close to complete or discard the operation.

reset method (XAdESSigner Struct)

Resets the struct settings.

Syntax

fn reset(&self) -> Result<(), SecureBlackboxError>

Remarks

reset is a generic method available in every struct.

revalidate method (XAdESSigner Struct)

Revalidates a signature in accordance with current settings.

Syntax

fn revalidate(&self, sig_label : &str, detached : bool) -> Result<(), SecureBlackboxError>

Remarks

Use this method to re-validate a signature in the opened XML document.

select_info method (XAdESSigner Struct)

Select signature information for a specific entity.

Syntax

fn select_info(&self, entity_label : &str, info_type : i32, clear_selection : bool) -> Result<(), SecureBlackboxError>

Remarks

Use this method to select (or filter) signature-related information for a specific signature element.

Provide the unique label of the entity that you are interested in via the EntityLabel parameter. Use one of the following filters, or their combination, to specify what information you are interested in:

Following the call, the relevant pieces of information will be copied to the respective component properties (Certificates, CRLs, OCSPs). Note that you can accumulate information in the properties by making repeated calls to select_info and keeping ClearSelection set to false.

This method is useful if you would like to read/display detailed information about a particular signature or timestamp.

set_inner_xml method (XAdESSigner Struct)

Set the inner XML content of the selected XML element.

Syntax

fn set_inner_xml(&self, xpath : &str, value : &str) -> Result<(), SecureBlackboxError>

Remarks

Call this method to set the inner XML content of the selected XML element.

set_text_content method (XAdESSigner Struct)

Set the text content of the selected XML element.

Syntax

fn set_text_content(&self, xpath : &str, value : &str) -> Result<(), SecureBlackboxError>

Remarks

Call this method to set the text content of the selected XML element.

sign method (XAdESSigner Struct)

Signs an XML document.

Syntax

fn sign(&self) -> Result<(), SecureBlackboxError>

Remarks

Call this method to generate a signature over an XML document.

sign_async_begin method (XAdESSigner Struct)

Initiates the asynchronous signing operation.

Syntax

fn sign_async_begin(&self) ->  Result<String, SecureBlackboxError>

Remarks

When using the DC framework, call this method to initiate the asynchronous signing process. Upon completion, a pre-signed copy of the document will be saved in output_file (or output_stream). Keep the pre-signed copy somewhere local, and pass the returned string ('the request state') to the DC processor for handling.

Upon receiving the response state from the DC processor, assign the path to the pre-signed copy to input_file (or input_stream), and call sign_async_end to finalize the signing.

Note that depending on the signing method and DC configuration used, you may still need to provide the public part of the signing certificate via the signing_certificate property.

Use the ExternalCrypto.AsyncDocumentID property to supply a unique document ID to include in the request. This is helpful when creating batches of multiple async requests, as it allows you to pass the whole response batch to sign_async_end and expect it to recover the correct response from the batch automatically.

AsyncState is a message of the distributed cryptography (DC) protocol. The DC protocol is based on the exchange of async states between a DC client (an application that wants to sign a PDF, XML, or Office document) and a DC server (an application that controls access to the private key). An async state can carry one or more signing requests, comprised of document hashes, or one or more signatures produced over those hashes.

In a typical scenario you get a client-side async state from the sign_async_begin method. This state contains document hashes to be signed on the DC server side. You then send the async state to the DC server (often represented by the DCAuth struct), which processes it and produces a matching signature state. The async state produced by the server is then passed to the sign_async_end method.

sign_async_end method (XAdESSigner Struct)

Completes the asynchronous signing operation.

Syntax

fn sign_async_end(&self, async_reply : &str) -> Result<(), SecureBlackboxError>

Remarks

When using the DC framework, call this method upon receiving the response state from the DC processor to complete the asynchronous signing process.

Before calling this method, assign the path to the pre-signed copy of the document obtained from the prior sign_async_begin call to input_file (or input_stream). The method will embed the signature into the pre-signed document, and save the complete signed document to output_file (or output_stream).

Note that depending on the signing method and DC configuration used, you may still need to provide the public part of the signing certificate via the signing_certificate property.

Use the ExternalCrypto.AsyncDocumentID parameter to pass a specific document ID if using batched AsyncReply. If used, it should match the value provided on the pre-signing (sign_async_begin) stage.

AsyncState is a message of the distributed cryptography (DC) protocol. The DC protocol is based on the exchange of async states between a DC client (an application that wants to sign a PDF, XML, or Office document) and a DC server (an application that controls access to the private key). An async state can carry one or more signing requests, comprised of document hashes, or one or more signatures produced over those hashes.

In a typical scenario you get a client-side async state from the sign_async_begin method. This state contains document hashes to be signed on the DC server side. You then send the async state to the DC server (often represented by the DCAuth struct), which processes it and produces a matching signature state. The async state produced by the server is then passed to the sign_async_end method.

sign_external method (XAdESSigner Struct)

Signs the document using an external signing facility.

Syntax

fn sign_external(&self) -> Result<(), SecureBlackboxError>

Remarks

Call this method to delegate the low-level signing operation to an external, remote, or custom signing engine. This method is useful if the signature has to be made by a device accessible through a custom or non-standard signing interface.

When all preparations are done and hash is computed, the struct fires on_external_sign event which allows to pass the hash value for signing.

timestamp method (XAdESSigner Struct)

Use this method to add an timestamp.

Syntax

fn timestamp(&self, sig_label : &str, timestamp_type : i32) -> Result<(), SecureBlackboxError>

Remarks

Call this method to timestamp the signature. Use the TimestampServer property to provide the address of the TSA (Time Stamping Authority) server which should be used for timestamping. This method could be called separately or in on_signature_validated event handler after successful signature validation. Use the TimestampType parameter to specify the type of timestamp to create

Supported timestamp types:

upgrade method (XAdESSigner Struct)

Upgrades existing XAdES signature to a new form.

Syntax

fn upgrade(&self, sig_label : &str, upgrade_kind : i32) -> Result<(), SecureBlackboxError>

Remarks

XAdES standard defines a number of different 'forms' of signatures which can be used for different purposes. Use this method to upgrade XAdES signature to a new form or level specified by UpgradeKind. Signatures can normally be upgraded from less sophisticated levels (BES, EPES) to more sophisticated (T, C, X, X-L, A).

The supported levels and forms are:

The supported additional upgrade kinds are:

on_chain_element_download event (XAdESSigner Struct)

Fires when there is a need to download a chain element from an online source.

Syntax

// XAdESSignerChainElementDownloadEventArgs carries the XAdESSigner ChainElementDownload event's parameters.
pub struct XAdESSignerChainElementDownloadEventArgs {
  fn kind(&self) -> i32
  fn cert_rdn(&self) -> &String
  fn ca_cert_rdn(&self) -> &String
  fn location(&self) -> &String
  fn action(&self) -> i32
  fn set_action(&self, value : i32)
}

// XAdESSignerChainElementDownloadEvent defines the signature of the XAdESSigner ChainElementDownload event's handler function.
pub trait XAdESSignerChainElementDownloadEvent {
  fn on_chain_element_download(&self, sender : XAdESSigner, e : &mut XAdESSignerChainElementDownloadEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_chain_element_download(&self) -> &'a dyn XAdESSignerChainElementDownloadEvent;
  pub fn set_on_chain_element_download(&mut self, value : &'a dyn XAdESSignerChainElementDownloadEvent);
  ...
}

Remarks

Subscribe to this event to be notified about validation element retrievals. Use the Action parameter to suppress the download if required.

on_chain_element_needed event (XAdESSigner Struct)

Fires when an element required to validate the chain was not located.

Syntax

// XAdESSignerChainElementNeededEventArgs carries the XAdESSigner ChainElementNeeded event's parameters.
pub struct XAdESSignerChainElementNeededEventArgs {
  fn kind(&self) -> i32
  fn cert_rdn(&self) -> &String
  fn ca_cert_rdn(&self) -> &String
}

// XAdESSignerChainElementNeededEvent defines the signature of the XAdESSigner ChainElementNeeded event's handler function.
pub trait XAdESSignerChainElementNeededEvent {
  fn on_chain_element_needed(&self, sender : XAdESSigner, e : &mut XAdESSignerChainElementNeededEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_chain_element_needed(&self) -> &'a dyn XAdESSignerChainElementNeededEvent;
  pub fn set_on_chain_element_needed(&mut self, value : &'a dyn XAdESSignerChainElementNeededEvent);
  ...
}

Remarks

Subscribe to this event to be notified about missing validation elements. Use the known_crls, known_certificates, and known_ocsps properties in the event handler to provide the missing piece.

on_chain_element_store event (XAdESSigner Struct)

This event is fired when a chain element (certificate, CRL, or OCSP response) should be stored along with a signature.

Syntax

// XAdESSignerChainElementStoreEventArgs carries the XAdESSigner ChainElementStore event's parameters.
pub struct XAdESSignerChainElementStoreEventArgs {
  fn kind(&self) -> i32
  fn body(&self) -> &[u8]
  fn uri(&self) -> &String
  fn set_uri(&self, value : &str)
  fn set_uri_ref(&self, value : &String)
}

// XAdESSignerChainElementStoreEvent defines the signature of the XAdESSigner ChainElementStore event's handler function.
pub trait XAdESSignerChainElementStoreEvent {
  fn on_chain_element_store(&self, sender : XAdESSigner, e : &mut XAdESSignerChainElementStoreEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_chain_element_store(&self) -> &'a dyn XAdESSignerChainElementStoreEvent;
  pub fn set_on_chain_element_store(&mut self, value : &'a dyn XAdESSignerChainElementStoreEvent);
  ...
}

Remarks

This event could occur if you are verifying XAdES-C form or higher. The Body parameter contains the element in binary form that should be stored along with a signature. Use the URI parameter to provide an URI of the stored element.

on_chain_validated event (XAdESSigner Struct)

Reports the completion of a certificate chain validation.

Syntax

// XAdESSignerChainValidatedEventArgs carries the XAdESSigner ChainValidated event's parameters.
pub struct XAdESSignerChainValidatedEventArgs {
  fn index(&self) -> i32
  fn entity_label(&self) -> &String
  fn subject_rdn(&self) -> &String
  fn validation_result(&self) -> i32
  fn validation_details(&self) -> i32
  fn cancel(&self) -> bool
  fn set_cancel(&self, value : bool)
}

// XAdESSignerChainValidatedEvent defines the signature of the XAdESSigner ChainValidated event's handler function.
pub trait XAdESSignerChainValidatedEvent {
  fn on_chain_validated(&self, sender : XAdESSigner, e : &mut XAdESSignerChainValidatedEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_chain_validated(&self) -> &'a dyn XAdESSignerChainValidatedEvent;
  pub fn set_on_chain_validated(&mut self, value : &'a dyn XAdESSignerChainValidatedEvent);
  ...
}

Remarks

This event is fired when a certificate chain validation routine completes. SubjectRDN identifies the owner of the validated certificate.

ValidationResult set to 0 (zero) indicates successful chain validation.

Any other value reports a failure, and ValidationDetails provides more details on its reasons.

on_chain_validation_progress event (XAdESSigner Struct)

This event is fired multiple times during chain validation to report various stages of the validation procedure.

Syntax

// XAdESSignerChainValidationProgressEventArgs carries the XAdESSigner ChainValidationProgress event's parameters.
pub struct XAdESSignerChainValidationProgressEventArgs {
  fn event_kind(&self) -> &String
  fn cert_rdn(&self) -> &String
  fn ca_cert_rdn(&self) -> &String
  fn action(&self) -> i32
  fn set_action(&self, value : i32)
}

// XAdESSignerChainValidationProgressEvent defines the signature of the XAdESSigner ChainValidationProgress event's handler function.
pub trait XAdESSignerChainValidationProgressEvent {
  fn on_chain_validation_progress(&self, sender : XAdESSigner, e : &mut XAdESSignerChainValidationProgressEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_chain_validation_progress(&self) -> &'a dyn XAdESSignerChainValidationProgressEvent;
  pub fn set_on_chain_validation_progress(&mut self, value : &'a dyn XAdESSignerChainValidationProgressEvent);
  ...
}

Remarks

Subscribe to this event to be notified about chain validation progress. Use the Action parameter to alter the validation flow.

The EventKind parameter reports the nature of the event being reported. The CertRDN and CACertRDN parameters report the distinguished names of the certificates that are relevant for the event invocation (one or both can be empty, depending on EventKind). Use the Action parameter to adjust the validation flow.

on_document_loaded event (XAdESSigner Struct)

This event is fired when the document has been loaded into memory.

Syntax

// XAdESSignerDocumentLoadedEventArgs carries the XAdESSigner DocumentLoaded event's parameters.
pub struct XAdESSignerDocumentLoadedEventArgs {
  fn cancel(&self) -> bool
  fn set_cancel(&self, value : bool)
}

// XAdESSignerDocumentLoadedEvent defines the signature of the XAdESSigner DocumentLoaded event's handler function.
pub trait XAdESSignerDocumentLoadedEvent {
  fn on_document_loaded(&self, sender : XAdESSigner, e : &mut XAdESSignerDocumentLoadedEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_document_loaded(&self) -> &'a dyn XAdESSignerDocumentLoadedEvent;
  pub fn set_on_document_loaded(&mut self, value : &'a dyn XAdESSignerDocumentLoadedEvent);
  ...
}

Remarks

The handler for this event is a good place to check document properties, which may be useful when preparing the signature, for example, the document format.

Set Cancel to true to terminate document processing on this stage.

on_error event (XAdESSigner Struct)

Information about errors during signing.

Syntax

// XAdESSignerErrorEventArgs carries the XAdESSigner Error event's parameters.
pub struct XAdESSignerErrorEventArgs {
  fn error_code(&self) -> i32
  fn description(&self) -> &String
}

// XAdESSignerErrorEvent defines the signature of the XAdESSigner Error event's handler function.
pub trait XAdESSignerErrorEvent {
  fn on_error(&self, sender : XAdESSigner, e : &mut XAdESSignerErrorEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_error(&self) -> &'a dyn XAdESSignerErrorEvent;
  pub fn set_on_error(&mut self, value : &'a dyn XAdESSignerErrorEvent);
  ...
}

Remarks

The event is fired in case of exceptional conditions during signing.

ErrorCode contains an error code and Description contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to XML.

on_external_sign event (XAdESSigner Struct)

Handles remote or external signing initiated by the SignExternal method or other source.

Syntax

// XAdESSignerExternalSignEventArgs carries the XAdESSigner ExternalSign event's parameters.
pub struct XAdESSignerExternalSignEventArgs {
  fn operation_id(&self) -> &String
  fn hash_algorithm(&self) -> &String
  fn pars(&self) -> &String
  fn data(&self) -> &String
  fn signed_data(&self) -> &String
  fn set_signed_data(&self, value : &str)
  fn set_signed_data_ref(&self, value : &String)
}

// XAdESSignerExternalSignEvent defines the signature of the XAdESSigner ExternalSign event's handler function.
pub trait XAdESSignerExternalSignEvent {
  fn on_external_sign(&self, sender : XAdESSigner, e : &mut XAdESSignerExternalSignEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_external_sign(&self) -> &'a dyn XAdESSignerExternalSignEvent;
  pub fn set_on_external_sign(&mut self, value : &'a dyn XAdESSignerExternalSignEvent);
  ...
}

Remarks

Assign a handler to this event if you need to delegate a low-level signing operation to an external, remote, or custom signing engine. Depending on the settings, the handler will receive a hashed or unhashed value to be signed.

The event handler must pass the value of Data to the signer, obtain the signature, and pass it back to the struct via the SignedData parameter.

OperationId provides a comment about the operation and its origin. It depends on the exact struct being used, and may be empty. HashAlgorithm specifies the hash algorithm being used for the operation, and Pars contains algorithm-dependent parameters.

The struct uses base16 (hex) encoding for the Data, SignedData, and Pars parameters. If your signing engine uses a different input and output encoding, you may need to decode and/or encode the data before and/or after the signing.

A sample MD5 hash encoded in base16: a0dee2a0382afbb09120ffa7ccd8a152 - lower case base16 A0DEE2A0382AFBB09120FFA7CCD8A152 - upper case base16

A sample event handler that uses the .NET RSACryptoServiceProvider class may look like the following: signer.OnExternalSign += (s, e) => { var cert = new X509Certificate2("cert.pfx", "", X509KeyStorageFlags.Exportable); var key = (RSACryptoServiceProvider)cert.PrivateKey; var dataToSign = e.Data.FromBase16String(); var signedData = key.SignHash(dataToSign, "2.16.840.1.101.3.4.2.1"); e.SignedData = signedData.ToBase16String(); };

on_format_element event (XAdESSigner Struct)

Reports the XML element that is currently being processed.

Syntax

// XAdESSignerFormatElementEventArgs carries the XAdESSigner FormatElement event's parameters.
pub struct XAdESSignerFormatElementEventArgs {
  fn start_tag_whitespace(&self) -> &String
  fn set_start_tag_whitespace(&self, value : &str)
  fn set_start_tag_whitespace_ref(&self, value : &String)
  fn end_tag_whitespace(&self) -> &String
  fn set_end_tag_whitespace(&self, value : &str)
  fn set_end_tag_whitespace_ref(&self, value : &String)
  fn level(&self) -> i32
  fn path(&self) -> &String
  fn has_child_elements(&self) -> bool
}

// XAdESSignerFormatElementEvent defines the signature of the XAdESSigner FormatElement event's handler function.
pub trait XAdESSignerFormatElementEvent {
  fn on_format_element(&self, sender : XAdESSigner, e : &mut XAdESSignerFormatElementEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_format_element(&self) -> &'a dyn XAdESSignerFormatElementEvent;
  pub fn set_on_format_element(&mut self, value : &'a dyn XAdESSignerFormatElementEvent);
  ...
}

Remarks

Path and Level specify the path to the XML element being processed and its nesting level, respectively.

HasChildElements specify if processed XML element has child elements.

Among other purposes, this event may be used to add whitespace formatting before or after a particular element in the signature.

on_format_text event (XAdESSigner Struct)

Reports XML text that is currently being processed.

Syntax

// XAdESSignerFormatTextEventArgs carries the XAdESSigner FormatText event's parameters.
pub struct XAdESSignerFormatTextEventArgs {
  fn text(&self) -> &String
  fn set_text(&self, value : &str)
  fn set_text_ref(&self, value : &String)
  fn text_type(&self) -> i32
  fn level(&self) -> i32
  fn path(&self) -> &String
}

// XAdESSignerFormatTextEvent defines the signature of the XAdESSigner FormatText event's handler function.
pub trait XAdESSignerFormatTextEvent {
  fn on_format_text(&self, sender : XAdESSigner, e : &mut XAdESSignerFormatTextEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_format_text(&self) -> &'a dyn XAdESSignerFormatTextEvent;
  pub fn set_on_format_text(&mut self, value : &'a dyn XAdESSignerFormatTextEvent);
  ...
}

Remarks

TextType parameter specifies the type of the XML text (normal or Base64-encoded) that is stored in the element; Path and Level specify the path to the XML element and its nesting level.

Among other purposes, this event may be used to add whitespace formatting before or after a particular element in the signature.

on_notification event (XAdESSigner Struct)

This event notifies the application about an underlying control flow event.

Syntax

// XAdESSignerNotificationEventArgs carries the XAdESSigner Notification event's parameters.
pub struct XAdESSignerNotificationEventArgs {
  fn event_id(&self) -> &String
  fn event_param(&self) -> &String
}

// XAdESSignerNotificationEvent defines the signature of the XAdESSigner Notification event's handler function.
pub trait XAdESSignerNotificationEvent {
  fn on_notification(&self, sender : XAdESSigner, e : &mut XAdESSignerNotificationEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_notification(&self) -> &'a dyn XAdESSignerNotificationEvent;
  pub fn set_on_notification(&mut self, value : &'a dyn XAdESSignerNotificationEvent);
  ...
}

Remarks

The struct fires this event to let the application know about some event, occurrence, or milestone in the struct. For example, it may fire to report completion of the document processing. The list of events being reported is not fixed, and may be flexibly extended over time.

The unique identifier of the event is provided in the EventID parameter. EventParam contains any parameters accompanying the occurrence. Depending on the type of the struct, the exact action it is performing, or the document being processed, one or both may be omitted.

This struct can fire this event with the following EventID values:

on_reference_validated event (XAdESSigner Struct)

Marks the end of a reference validation.

Syntax

// XAdESSignerReferenceValidatedEventArgs carries the XAdESSigner ReferenceValidated event's parameters.
pub struct XAdESSignerReferenceValidatedEventArgs {
  fn reference_index(&self) -> i32
  fn id(&self) -> &String
  fn uri(&self) -> &String
  fn ref_type(&self) -> &String
  fn digest_valid(&self) -> bool
}

// XAdESSignerReferenceValidatedEvent defines the signature of the XAdESSigner ReferenceValidated event's handler function.
pub trait XAdESSignerReferenceValidatedEvent {
  fn on_reference_validated(&self, sender : XAdESSigner, e : &mut XAdESSignerReferenceValidatedEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_reference_validated(&self) -> &'a dyn XAdESSignerReferenceValidatedEvent;
  pub fn set_on_reference_validated(&mut self, value : &'a dyn XAdESSignerReferenceValidatedEvent);
  ...
}

Remarks

The struct fires this event to report completion of a reference validation. A reference is a building block of a signature as it binds signature coverage to a particular piece of the document.

on_resolve_reference event (XAdESSigner Struct)

Asks the application to resolve a reference.

Syntax

// XAdESSignerResolveReferenceEventArgs carries the XAdESSigner ResolveReference event's parameters.
pub struct XAdESSignerResolveReferenceEventArgs {
  fn reference_index(&self) -> i32
  fn uri(&self) -> &String
}

// XAdESSignerResolveReferenceEvent defines the signature of the XAdESSigner ResolveReference event's handler function.
pub trait XAdESSignerResolveReferenceEvent {
  fn on_resolve_reference(&self, sender : XAdESSigner, e : &mut XAdESSignerResolveReferenceEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_resolve_reference(&self) -> &'a dyn XAdESSignerResolveReferenceEvent;
  pub fn set_on_resolve_reference(&mut self, value : &'a dyn XAdESSignerResolveReferenceEvent);
  ...
}

Remarks

This event is fired when the control could not automatically resolve a reference and requires custom treatment.

URI contains a reference to the data.

ReferenceIndex specifies the index of the reference to process.

Based on the reference's URI the event handler should set either TargetXMLElement or TargetData property of the reference.

on_signature_found event (XAdESSigner Struct)

Signifies the start of signature validation.

Syntax

// XAdESSignerSignatureFoundEventArgs carries the XAdESSigner SignatureFound event's parameters.
pub struct XAdESSignerSignatureFoundEventArgs {
  fn index(&self) -> i32
  fn entity_label(&self) -> &String
  fn issuer_rdn(&self) -> &String
  fn serial_number(&self) -> &[u8]
  fn subject_key_id(&self) -> &[u8]
  fn cert_found(&self) -> bool
  fn validate_signature(&self) -> bool
  fn set_validate_signature(&self, value : bool)
  fn validate_chain(&self) -> bool
  fn set_validate_chain(&self, value : bool)
}

// XAdESSignerSignatureFoundEvent defines the signature of the XAdESSigner SignatureFound event's handler function.
pub trait XAdESSignerSignatureFoundEvent {
  fn on_signature_found(&self, sender : XAdESSigner, e : &mut XAdESSignerSignatureFoundEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_signature_found(&self) -> &'a dyn XAdESSignerSignatureFoundEvent;
  pub fn set_on_signature_found(&mut self, value : &'a dyn XAdESSignerSignatureFoundEvent);
  ...
}

Remarks

This event tells the application that signature validation is about to start, and provides the details about the signer's certificate via its IssuerRDN, SerialNumber, and SubjectKeyID parameters. It fires for every signature located in the verified document or message.

The CertFound parameter is set to True if the struct has found the needed certificate in one of the known locations, and to False otherwise, in which case you must provide it manually via the known_certificates property.

Signature validation consists of two independent stages: cryptographic signature validation and chain validation. Separate validation results are reported for each, with the and properties respectively.

Use the ValidateSignature and ValidateChain parameters to tell the verifier which stages to include in the validation.

on_signature_validated event (XAdESSigner Struct)

Marks the completion of the signature validation routine.

Syntax

// XAdESSignerSignatureValidatedEventArgs carries the XAdESSigner SignatureValidated event's parameters.
pub struct XAdESSignerSignatureValidatedEventArgs {
  fn index(&self) -> i32
  fn entity_label(&self) -> &String
  fn issuer_rdn(&self) -> &String
  fn serial_number(&self) -> &[u8]
  fn subject_key_id(&self) -> &[u8]
  fn validation_result(&self) -> i32
  fn cancel(&self) -> bool
  fn set_cancel(&self, value : bool)
}

// XAdESSignerSignatureValidatedEvent defines the signature of the XAdESSigner SignatureValidated event's handler function.
pub trait XAdESSignerSignatureValidatedEvent {
  fn on_signature_validated(&self, sender : XAdESSigner, e : &mut XAdESSignerSignatureValidatedEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_signature_validated(&self) -> &'a dyn XAdESSignerSignatureValidatedEvent;
  pub fn set_on_signature_validated(&mut self, value : &'a dyn XAdESSignerSignatureValidatedEvent);
  ...
}

Remarks

This event is fired upon the completion of the signature validation routine, and reports the respective validation result.

Use the IssuerRDN, SerialNumber, and/or SubjectKeyID parameters to identify the signing certificate.

ValidationResult is set to 0 if the validation has been successful, or to a non-zero value in case of a validation failure.

on_timestamp_found event (XAdESSigner Struct)

Signifies the start of a timestamp validation routine.

Syntax

// XAdESSignerTimestampFoundEventArgs carries the XAdESSigner TimestampFound event's parameters.
pub struct XAdESSignerTimestampFoundEventArgs {
  fn index(&self) -> i32
  fn entity_label(&self) -> &String
  fn issuer_rdn(&self) -> &String
  fn serial_number(&self) -> &[u8]
  fn subject_key_id(&self) -> &[u8]
  fn cert_found(&self) -> bool
  fn validate_timestamp(&self) -> bool
  fn set_validate_timestamp(&self, value : bool)
  fn validate_chain(&self) -> bool
  fn set_validate_chain(&self, value : bool)
}

// XAdESSignerTimestampFoundEvent defines the signature of the XAdESSigner TimestampFound event's handler function.
pub trait XAdESSignerTimestampFoundEvent {
  fn on_timestamp_found(&self, sender : XAdESSigner, e : &mut XAdESSignerTimestampFoundEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_timestamp_found(&self) -> &'a dyn XAdESSignerTimestampFoundEvent;
  pub fn set_on_timestamp_found(&mut self, value : &'a dyn XAdESSignerTimestampFoundEvent);
  ...
}

Remarks

This event fires for every timestamp identified during signature processing, and reports the details about the signer's certificate via its IssuerRDN, SerialNumber, and SubjectKeyID parameters.

The CertFound parameter is set to True if the struct has found the needed certificate in one of the known locations, and to False otherwise, in which case you must provide it manually via the known_certificates property.

Just like with signature validation, timestamp validation consists of two independent stages: cryptographic signature validation and chain validation. Separate validation results are reported for each, with the and properties respectively.

Use the ValidateSignature and ValidateChain parameters to tell the verifier which stages to include in the validation.

on_timestamp_request event (XAdESSigner Struct)

Fires when the struct is ready to request a timestamp from an external TSA.

Syntax

// XAdESSignerTimestampRequestEventArgs carries the XAdESSigner TimestampRequest event's parameters.
pub struct XAdESSignerTimestampRequestEventArgs {
  fn tsa(&self) -> &String
  fn timestamp_request(&self) -> &String
  fn timestamp_response(&self) -> &String
  fn set_timestamp_response(&self, value : &str)
  fn set_timestamp_response_ref(&self, value : &String)
  fn suppress_default(&self) -> bool
  fn set_suppress_default(&self, value : bool)
}

// XAdESSignerTimestampRequestEvent defines the signature of the XAdESSigner TimestampRequest event's handler function.
pub trait XAdESSignerTimestampRequestEvent {
  fn on_timestamp_request(&self, sender : XAdESSigner, e : &mut XAdESSignerTimestampRequestEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_timestamp_request(&self) -> &'a dyn XAdESSignerTimestampRequestEvent;
  pub fn set_on_timestamp_request(&mut self, value : &'a dyn XAdESSignerTimestampRequestEvent);
  ...
}

Remarks

Subscribe to this event to intercept timestamp requests. You can use it to override timestamping requests and perform them in your code.

The TSA parameter indicates the timestamping service being used. It matches the value passed to the timestamp_server property. Set the SuppressDefault parameter to true if you would like to stop the built-in TSA request from going ahead. The built-in TSA request is also not performed if the returned TimestampResponse parameter is not empty.

on_timestamp_validated event (XAdESSigner Struct)

Reports the completion of the timestamp validation routine.

Syntax

// XAdESSignerTimestampValidatedEventArgs carries the XAdESSigner TimestampValidated event's parameters.
pub struct XAdESSignerTimestampValidatedEventArgs {
  fn index(&self) -> i32
  fn entity_label(&self) -> &String
  fn issuer_rdn(&self) -> &String
  fn serial_number(&self) -> &[u8]
  fn subject_key_id(&self) -> &[u8]
  fn time(&self) -> &String
  fn validation_result(&self) -> i32
  fn chain_validation_result(&self) -> i32
  fn chain_validation_details(&self) -> i32
  fn cancel(&self) -> bool
  fn set_cancel(&self, value : bool)
}

// XAdESSignerTimestampValidatedEvent defines the signature of the XAdESSigner TimestampValidated event's handler function.
pub trait XAdESSignerTimestampValidatedEvent {
  fn on_timestamp_validated(&self, sender : XAdESSigner, e : &mut XAdESSignerTimestampValidatedEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_timestamp_validated(&self) -> &'a dyn XAdESSignerTimestampValidatedEvent;
  pub fn set_on_timestamp_validated(&mut self, value : &'a dyn XAdESSignerTimestampValidatedEvent);
  ...
}

Remarks

This event is fired upon the completion of the timestamp validation routine, and reports the respective validation result.

ValidationResult is set to 0 if the validation has been successful, or to a non-zero value in case of a failure.

on_tls_cert_needed event (XAdESSigner Struct)

Fires when a remote TLS party requests a client certificate.

Syntax

// XAdESSignerTLSCertNeededEventArgs carries the XAdESSigner TLSCertNeeded event's parameters.
pub struct XAdESSignerTLSCertNeededEventArgs {
  fn host(&self) -> &String
  fn ca_names(&self) -> &String
}

// XAdESSignerTLSCertNeededEvent defines the signature of the XAdESSigner TLSCertNeeded event's handler function.
pub trait XAdESSignerTLSCertNeededEvent {
  fn on_tls_cert_needed(&self, sender : XAdESSigner, e : &mut XAdESSignerTLSCertNeededEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_tls_cert_needed(&self) -> &'a dyn XAdESSignerTLSCertNeededEvent;
  pub fn set_on_tls_cert_needed(&mut self, value : &'a dyn XAdESSignerTLSCertNeededEvent);
  ...
}

Remarks

This event fires to notify the implementation that a remote TLS server has requested a client certificate. The Host parameter identifies the host that makes a request, and the CANames parameter (optional, according to the TLS spec) advises on the accepted issuing CAs.

Use the tls_client_chain property in response to this event to provide the requested certificate. Please make sure the client certificate includes the associated private key. Note that you may set the certificates before the connection without waiting for this event to fire.

This event is preceded by the on_tls_handshake event for the given host and, if the certificate was accepted, succeeded by the on_tls_established event.

on_tls_cert_validate event (XAdESSigner Struct)

This event is fired upon receipt of the TLS server's certificate, allowing the user to control its acceptance.

Syntax

// XAdESSignerTLSCertValidateEventArgs carries the XAdESSigner TLSCertValidate event's parameters.
pub struct XAdESSignerTLSCertValidateEventArgs {
  fn server_host(&self) -> &String
  fn server_ip(&self) -> &String
  fn accept(&self) -> bool
  fn set_accept(&self, value : bool)
}

// XAdESSignerTLSCertValidateEvent defines the signature of the XAdESSigner TLSCertValidate event's handler function.
pub trait XAdESSignerTLSCertValidateEvent {
  fn on_tls_cert_validate(&self, sender : XAdESSigner, e : &mut XAdESSignerTLSCertValidateEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_tls_cert_validate(&self) -> &'a dyn XAdESSignerTLSCertValidateEvent;
  pub fn set_on_tls_cert_validate(&mut self, value : &'a dyn XAdESSignerTLSCertValidateEvent);
  ...
}

Remarks

This event is fired during a TLS handshake. Use the tls_server_chain property to access the certificate chain. In general, structs may contact a number of TLS endpoints during their work, depending on their configuration.

Accept is assigned in accordance with the outcome of the internal validation check performed by the struct, and can be adjusted if needed.

on_tls_established event (XAdESSigner Struct)

Fires when a TLS handshake with Host successfully completes.

Syntax

// XAdESSignerTLSEstablishedEventArgs carries the XAdESSigner TLSEstablished event's parameters.
pub struct XAdESSignerTLSEstablishedEventArgs {
  fn host(&self) -> &String
  fn version(&self) -> &String
  fn ciphersuite(&self) -> &String
  fn connection_id(&self) -> &[u8]
  fn abort(&self) -> bool
  fn set_abort(&self, value : bool)
}

// XAdESSignerTLSEstablishedEvent defines the signature of the XAdESSigner TLSEstablished event's handler function.
pub trait XAdESSignerTLSEstablishedEvent {
  fn on_tls_established(&self, sender : XAdESSigner, e : &mut XAdESSignerTLSEstablishedEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_tls_established(&self) -> &'a dyn XAdESSignerTLSEstablishedEvent;
  pub fn set_on_tls_established(&mut self, value : &'a dyn XAdESSignerTLSEstablishedEvent);
  ...
}

Remarks

The struct uses this event to notify the application about a successful completion of a TLS handshake.

The Version, Ciphersuite, and ConnectionId parameters indicate the security parameters of the new connection. Use the Abort parameter if you need to terminate the connection at this stage.

on_tls_handshake event (XAdESSigner Struct)

Fires when a new TLS handshake is initiated, before the handshake commences.

Syntax

// XAdESSignerTLSHandshakeEventArgs carries the XAdESSigner TLSHandshake event's parameters.
pub struct XAdESSignerTLSHandshakeEventArgs {
  fn host(&self) -> &String
  fn abort(&self) -> bool
  fn set_abort(&self, value : bool)
}

// XAdESSignerTLSHandshakeEvent defines the signature of the XAdESSigner TLSHandshake event's handler function.
pub trait XAdESSignerTLSHandshakeEvent {
  fn on_tls_handshake(&self, sender : XAdESSigner, e : &mut XAdESSignerTLSHandshakeEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_tls_handshake(&self) -> &'a dyn XAdESSignerTLSHandshakeEvent;
  pub fn set_on_tls_handshake(&mut self, value : &'a dyn XAdESSignerTLSHandshakeEvent);
  ...
}

Remarks

The struct uses this event to notify the application about the start of a new TLS handshake to Host. If the handshake is successful, this event will be followed by the on_tls_established event. If the server chooses to request a client certificate, the on_tls_cert_needed event will also be fired.

on_tls_shutdown event (XAdESSigner Struct)

Reports the graceful closure of a TLS connection.

Syntax

// XAdESSignerTLSShutdownEventArgs carries the XAdESSigner TLSShutdown event's parameters.
pub struct XAdESSignerTLSShutdownEventArgs {
  fn host(&self) -> &String
}

// XAdESSignerTLSShutdownEvent defines the signature of the XAdESSigner TLSShutdown event's handler function.
pub trait XAdESSignerTLSShutdownEvent {
  fn on_tls_shutdown(&self, sender : XAdESSigner, e : &mut XAdESSignerTLSShutdownEventArgs);
}

impl <'a> XAdESSigner<'a> {
  pub fn on_tls_shutdown(&self) -> &'a dyn XAdESSignerTLSShutdownEvent;
  pub fn set_on_tls_shutdown(&mut self, value : &'a dyn XAdESSignerTLSShutdownEvent);
  ...
}

Remarks

This event notifies the application about the closure of an earlier established TLS connection. Note that only graceful connection closures are reported.

Config Settings (XAdESSigner Struct)

The struct accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the struct, access to these internal properties is provided through the config method.

XAdESSigner Config Settings

Base Config Settings

Trappable Errors (XAdESSigner Struct)

XAdESSigner Errors