Struct ipworksedi::AS2Sender

Properties   Methods   Events   Config Settings   Errors  

The AS2Sender struct implements an AS2 / EDI-INT client.

Syntax

ipworksedi::AS2Sender

Remarks

The AS2Sender component may be used to send EDI or other messages over HTTP/S, using the AS2 protocol. It may also be used to verify synchronous or asynchronous server responses.

A typical AS2 transaction is as follows:

(1) The sender sends an EDI document to the receiver using HTTP or HTTPS. Typically the document will be signed and encrypted (particularly if SSL is not used). A signed receipt will also be requested.

(2) The receiver decrypts the message and verifies the signature.

(3) The receiver sends a signed receipt back to the client. The signature is over the hash of an MDN, which contains a hash of the received message.

When sending an EDI message, the client should specify, at a minimum, as2_from and as2_to, url, and edi_data. The post method should then be invoked.

To secure the EDI transmission, the message may be signed and/or encrypted by setting the appropriate certificates. By default, the struct will apply message security if the appropriate certificates are specified. To sign the data, set signing_cert. To encrypt, set recipient_certs. If the recipient uses different certificates for signing and encryption it will also be necessary to set receipt_signer_cert.

SSL will also be used if the scheme in url is "https". If your trading partner is using a self-signed certificate, it will be necessary to set ssl_accept_server_cert or trap the on_ssl_server_authentication event to accept the certificate.

The message may also be compressed by setting compression_format.

To request a receipt, or Message Disposition Notification (MDN), simply set the mdn_to property. The mdn_options property may be used to customize the request. By default, the struct will request a signed MDN over a SHA-256 hash.

The struct supports both synchronous and asynchronous MDN receipt delivery. By default, the struct requests synchronous MDN receipt delivery, and the MDN will be returned in the HTTP reply. To request asynchronous MDN delivery, set the mdn_delivery_option to the URL where MDN's are to be delivered.

The HTTP reply will automatically be processed by the struct. If an MDN was requested, post will validate the MDN and (if signed) establish non-repudiation of receipt. Any errors or warnings will cause the struct to throw an exception.

In either case, after the EDI transaction is processed successfully, the mdn_receipt will be populated with the appropriate values.

Validating Asynchronous MDNs

The struct may also be used to process and verify asynchronous MDNs. To do this, you should invoke read_async_receipt. This will read the receipt from the current HTTP context (or from mdn_receipt, if set manually), and allow you to determine your trading partner's identity and the message ID. You should then set receipt_signer_cert and original_content_mic, and finally invoke verify_receipt.

Object Lifetime

The new() method returns a mutable reference to a struct instance. The object itself is kept in the global list maintained by IPWorksEDI. Due to this, the AS2Sender struct cannot be disposed of automatically. Please, call the dispose(&mut self) method of AS2Sender 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.

as2_from property (AS2Sender Struct)

The AS2 Identifier of the sending system.

Syntax

fn as2_from(&self ) -> Result<String, IPWorksEDIError> 
fn set_as2_from(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_as2_from_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

May be company name, DUNS number, or anything agreed on by trading partners.

Required.

Data Type

String

as2_to property (AS2Sender Struct)

The AS2 Identifier of the receiving system.

Syntax

fn as2_to(&self ) -> Result<String, IPWorksEDIError> 
fn set_as2_to(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_as2_to_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

May be company name, DUNS number, or anything agreed on by trading partners.

Required.

Data Type

String

as2_version property (AS2Sender Struct)

The AS2 protocol version used for outgoing messages.

Syntax

fn as2_version(&self ) -> Result<String, IPWorksEDIError> 
fn set_as2_version(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_as2_version_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

"1.2"

Remarks

AS2Version specifies the AS2 protocol version declared in the AS2-Version header of outgoing messages. Valid values are "1.0", "1.1", "1.2" (default), and "1.3".

When set to "1.3", the following requirements apply:

• signature_algorithm and the requested MDN MIC algorithm specified by mdn_options must use SHA-256, SHA-384, or SHA-512. MD5, SHA-1, and SHA-224 are not permitted.
• encryption_algorithm may not be DES or 3DES. Use one of the AES options instead, such as "AESCBC256" (the default).
• An AS2-Product header identifying the sending software is included in each outgoing message.

MDNs received in response to AS2 1.3 messages are also subject to these requirements. An MDN signed using MD5, SHA-1, or SHA-224 is rejected.

Versions "1.0", "1.1", and "1.2" continue to permit legacy algorithms for compatibility with existing trading partners.

Data Type

String

async_mdn_info_dir property (AS2Sender Struct)

Path to a directory to store data used in verifying AsyncMDNs.

Syntax

fn async_mdn_info_dir(&self ) -> Result<String, IPWorksEDIError> 
fn set_async_mdn_info_dir(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_async_mdn_info_dir_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If post is invoked after setting async_mdn_info_dir and an asynchronous MDN is requested, the struct stores the data required to verify AsyncMDNs in a file in the specified directory. The name of the file is the message_id of the outgoing message.

async_mdn_info_dir is also used while verifying asynchronous MDNs using verify_receipt. The properties required to process AsyncMDNs, namely original_content_mic and mdn_options, are automatically read from the file saved at the time of sending the original message.

Data Type

String

attachment_count property (AS2Sender Struct)

The number of records in the Attachment arrays.

Syntax

fn attachment_count(&self ) -> Result<i32, IPWorksEDIError> 
fn set_attachment_count(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• attachment_content_type
• attachment_data
• attachment_file_name
• attachment_headers
• attachment_name

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

Data Type

i32

attachment_content_type property (AS2Sender Struct)

The MIME content-type of this ediattachment .

Syntax

fn attachment_content_type(&self , AttachmentIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_attachment_content_type(&self, AttachmentIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_attachment_content_type_ref(&self, AttachmentIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The MIME content-type of this EDIAttachment.

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

Data Type

String

attachment_data property (AS2Sender Struct)

This property contains the attachment data.

Syntax

fn attachment_data(&self , AttachmentIndex : i32) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_attachment_data(&self, AttachmentIndex : i32, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_attachment_data_ref(&self, AttachmentIndex : i32, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property contains the attachment data.

In a receiver, the struct decodes the attachment to the attachment_data property when attachment_data's value is first queried. This property will contain the full decrypted text of the attachment.

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

Data Type

Vec

attachment_file_name property (AS2Sender Struct)

The file name of the attachment.

Syntax

fn attachment_file_name(&self , AttachmentIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_attachment_file_name(&self, AttachmentIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_attachment_file_name_ref(&self, AttachmentIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The file name of the attachment. If incoming_directory has been specified, the attachment will be written to the specified directory and the name will be provided by this property. Otherwise, this will contain the name of the attachment as described in the attachment_headers.

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

Data Type

String

attachment_headers property (AS2Sender Struct)

The struct fills out Headers each time any of the other properties for that ediattachment are changed.

Syntax

fn attachment_headers(&self , AttachmentIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_attachment_headers(&self, AttachmentIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_attachment_headers_ref(&self, AttachmentIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The struct fills out attachment_headers each time any of the other properties for that EDIAttachment are changed. If additional headers are needed they should be appended after all the other properties for that EDIAttachment are set.

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

Data Type

String

attachment_name property (AS2Sender Struct)

Name is the final name to be associated with the contents of either the Data or FileName properties.

Syntax

fn attachment_name(&self , AttachmentIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_attachment_name(&self, AttachmentIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_attachment_name_ref(&self, AttachmentIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

attachment_name is the final name to be associated with the contents of either the attachment_data or attachment_file_name properties. This corresponds to the filename attribute of the Content-Disposition header for this attachment.

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

Data Type

String

cem_count property (AS2Sender Struct)

The number of records in the CEM arrays.

Syntax

fn cem_count(&self ) -> Result<i32, IPWorksEDIError> 
fn set_cem_count(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• cem_accepted
• cem_cert_id
• cem_cert_issuer
• cem_cert_serial_number
• cem_cert_store
• cem_cert_store_password
• cem_cert_store_type
• cem_cert_subject
• cem_cert_usage
• cem_rejection_reason
• cem_respond_by_date
• cem_response_url

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

Data Type

i32

cem_accepted property (AS2Sender Struct)

Whether the CEM request is accepted.

Syntax

fn cem_accepted(&self , CEMIndex : i32) -> Result<bool, IPWorksEDIError> 
fn set_cem_accepted(&self, CEMIndex : i32, value : bool) ->  Option<IPWorksEDIError> 

Default Value

false

Remarks

Whether the CEM request is accepted.

Before calling send_cem_response set this to True to accept the CEM request.

When processing a CEM response check this property to determine if the request was accepted.

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

Data Type

bool

cem_cert_id property (AS2Sender Struct)

A user defined identifier for the certificate.

Syntax

fn cem_cert_id(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_cert_id(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_cert_id_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

A user defined identifier for the certificate.

This property defines a user specified identifier for the certificate. This may be set to a value which helps the recipient identify the certificate. For instance "CompanyA.Encryption.Cert.2014".

This property may be set before calling send_cem_request or send_cem_response from AS2Sender.

This property may be queried when received a CEM request or response with AS2Receiver.

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

Data Type

String

cem_cert_issuer property (AS2Sender Struct)

This property holds the issuer of the certificate.

Syntax

fn cem_cert_issuer(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_cert_issuer(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_cert_issuer_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property holds the issuer of the certificate. This may be queried when receiving a CEM request with AS2Receiver. This may be set before calling send_cem_response with AS2Sender.

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

Data Type

String

cem_cert_serial_number property (AS2Sender Struct)

This property holds the serial number of the certificate.

Syntax

fn cem_cert_serial_number(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_cert_serial_number(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_cert_serial_number_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property holds the serial number of the certificate. This may be queried when receiving a CEM request with AS2Receiver. This may be set before calling send_cem_response with AS2Sender.

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

Data Type

String

cem_cert_store property (AS2Sender Struct)

The name of the certificate store for the certificate.

Syntax

fn cem_cert_store(&self , CEMIndex : i32) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_cem_cert_store(&self, CEMIndex : i32, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_cem_cert_store_ref(&self, CEMIndex : i32, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the certificate.

This property defines the store location for the type specified by cem_cert_store_type.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

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

Data Type

Vec

cem_cert_store_password property (AS2Sender Struct)

If the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.

Syntax

fn cem_cert_store_password(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_cert_store_password(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_cert_store_password_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.

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

Data Type

String

cem_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn cem_cert_store_type(&self , CEMIndex : i32) -> Result<i32, IPWorksEDIError> 
fn set_cem_cert_store_type(&self, CEMIndex : i32, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

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

Data Type

i32

cem_cert_subject property (AS2Sender Struct)

The subject of the certificate.

Syntax

fn cem_cert_subject(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_cert_subject(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_cert_subject_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

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

Data Type

String

cem_cert_usage property (AS2Sender Struct)

This property defines which usages are applicable to the certificate.

Syntax

fn cem_cert_usage(&self , CEMIndex : i32) -> Result<i32, IPWorksEDIError> 
fn set_cem_cert_usage(&self, CEMIndex : i32, value : i32) ->  Option<IPWorksEDIError> 

Default Value

15

Remarks

This property defines which usages are applicable to the certificate. This may be set to a binary 'OR' of one or more of the following values:

• 1 (TLS Client)
• 2 (TLS Server)
• 4 (Encryption)
• 8 (Signature)

The default value is "15", meaning all usages are allowed.

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

Data Type

i32

cem_rejection_reason property (AS2Sender Struct)

If Accepted is False this property specifies the reason a request was rejected.

Syntax

fn cem_rejection_reason(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_rejection_reason(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_rejection_reason_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If cem_accepted is False this property specifies the reason a request was rejected.

When using AS2Sender this may be set to a string value which the recipient will see.

When using AS2Receiver query this property for details on why the request was rejected.

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

Data Type

String

cem_respond_by_date property (AS2Sender Struct)

This property specifies the date by which the other party should respond.

Syntax

fn cem_respond_by_date(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_respond_by_date(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_respond_by_date_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property specifies the date by which the other party should respond. If the other party does not respond the new certificate may be used without any further notice. This property exists to assist the recipient in knowing when they should respond by. It does not guarantee a response by the specified date.

The format is of the XML standard dateTime type expressed in local time with UTC offset. For instance: "2005-08-31T00:21:00-05:00".

When using AS2Sender set this before calling send_cem_request.

When using AS2Receiver this property may be queried.

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

Data Type

String

cem_response_url property (AS2Sender Struct)

This property defines the URL to which the response should be sent.

Syntax

fn cem_response_url(&self , CEMIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cem_response_url(&self, CEMIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cem_response_url_ref(&self, CEMIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property defines the URL to which the response should be sent.

When using AS2Sender set this property before calling send_cem_request. This tells the recipient where to send the response.

When using AS2Receiver query this property to determine the URL where the response should be sent.

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

Data Type

String

compression_format property (AS2Sender Struct)

The compression format (if any) to use.

Syntax

fn compression_format(&self ) -> Result<i32, IPWorksEDIError> 
fn set_compression_format(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // None
1   // ZLIB

Default Value

0

Remarks

By default, outgoing data will not be compressed. Setting this property will instruct the struct to compress the outgoing data using the indicated format.

Compression is highly recommended for large messages, as it will reduce network bandwidth and processing time required.

The compression algorithm used is Zlib, as required by RFC 3274 and defined in RFCs 1950 and 1951.

Data Type

i32

cookie_count property (AS2Sender Struct)

The number of records in the Cookie arrays.

Syntax

fn cookie_count(&self ) -> Result<i32, IPWorksEDIError> 
fn set_cookie_count(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• cookie_domain
• cookie_expiration
• cookie_name
• cookie_path
• cookie_secure
• cookie_value

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

Data Type

i32

cookie_domain property (AS2Sender Struct)

The domain of a received cookie.

Syntax

fn cookie_domain(&self , CookieIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The domain of a received cookie. This property contains a domain name to limit the cookie to (if provided by the server). If the server does not provide a domain name, this property will contain an empty string. The convention in this case is to use the server name specified by url_server as the cookie domain.

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

This property is read-only.

Data Type

String

cookie_expiration property (AS2Sender Struct)

An expiration time for the cookie (if provided by the server).

Syntax

fn cookie_expiration(&self , CookieIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

An expiration time for the cookie (if provided by the server). The time format used is "Weekday, DD-Mon-YY HH:MM:SS GMT". If the server does not provide an expiration time, this property will contain an empty string. The convention is to drop the cookie at the end of the session.

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

This property is read-only.

Data Type

String

cookie_name property (AS2Sender Struct)

The name of the cookie.

Syntax

fn cookie_name(&self , CookieIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cookie_name(&self, CookieIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cookie_name_ref(&self, CookieIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The name of the cookie.

This property, along with cookie_value, stores the cookie that is to be sent to the server. The on_set_cookie event displays the cookies sent by the server and their properties.

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

Data Type

String

cookie_path property (AS2Sender Struct)

A path name to limit the cookie to (if provided by the server).

Syntax

fn cookie_path(&self , CookieIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A path name to limit the cookie to (if provided by the server). If the server does not provide a cookie path, the path property will be an empty string. The convention in this case is to use the path specified by url_path as the cookie path.

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

This property is read-only.

Data Type

String

cookie_secure property (AS2Sender Struct)

The security flag of the received cookie.

Syntax

fn cookie_secure(&self , CookieIndex : i32) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

The security flag of the received cookie. This property specifies whether the cookie is secure. If the value of this property is True, the cookie value must be submitted only through a secure (HTTPS) connection.

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

This property is read-only.

Data Type

bool

cookie_value property (AS2Sender Struct)

The value of the cookie.

Syntax

fn cookie_value(&self , CookieIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_cookie_value(&self, CookieIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_cookie_value_ref(&self, CookieIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The value of the cookie. A corresponding value is associated with the cookie specified by cookie_name. This property holds that value.

The on_set_cookie event provides the cookies set by the server.

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

Data Type

String

edi_data property (AS2Sender Struct)

This property contains the EDI payload of the transmission.

Syntax

fn edi_data(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_edi_data(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_edi_data_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property contains the EDI payload of the transmission.

In a receiver, this property will only be populated if incoming_directory and edi_output_stream have not been specified and parse_request finishes without an error, setting scan_result to 0. If so, Data will contain the full decrypted text of the EDI message.

The EDI message to send.

Data Type

Vec

edi_type property (AS2Sender Struct)

The Content-Type of the EDI message.

Syntax

fn edi_type(&self ) -> Result<String, IPWorksEDIError> 
fn set_edi_type(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_edi_type_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The Content-Type of the EDI message. Sample values might be "application/edi-x12", "application/edifact" or "application/xml".

Data Type

String

edi_name property (AS2Sender Struct)

Name is the final name to be associated with the contents of either the Data or FileName properties.

Syntax

fn edi_name(&self ) -> Result<String, IPWorksEDIError> 
fn set_edi_name(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_edi_name_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

"rfc1767.edi"

Remarks

edi_name is the final name to be associated with the contents of either the edi_data or edi_file_name properties. This corresponds to the filename attribute of the Content-Disposition header for the EDI payload.

When constructing EDI data to be sent, edi_name will be set to the same value as edi_file_name, but can be overridden after setting edi_file_name to indicate that another name should be used in the outbound request's Content-Disposition MIME header.

When receiving EDI data, edi_name will be read out of the "filename" attribute of the inbound request's Content-Disposition MIME header.

Data Type

String

edi_file_name property (AS2Sender Struct)

In a sender, if FileName is specified, the file specified will be used for the EDI payload of the transmission.

Syntax

fn edi_file_name(&self ) -> Result<String, IPWorksEDIError> 
fn set_edi_file_name(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_edi_file_name_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

In a sender, if edi_file_name is specified, the file specified will be used for the EDI payload of the transmission. edi_name will be populated with the name of the file.

In a receiver, when incoming_directory is set, this will be populated with the absolute path of the file which contains the processed message contents.

Note: When edi_output_stream is set, the data will be written to the stream and this property will not be populated.

Data Type

String

encryption_algorithm property (AS2Sender Struct)

The algorithm used to encrypt the EDI data.

Syntax

fn encryption_algorithm(&self ) -> Result<String, IPWorksEDIError> 
fn set_encryption_algorithm(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_encryption_algorithm_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

"AESCBC256"

Remarks

If recipient_certs contains a valid certificate, the data will be encrypted using this certificate and the algorithm specified in encryption_algorithm. If encryption_algorithm is set to the empty string, the data will not be encrypted.

The struct supports "AESCBC256", or industry-standard 256-bit AES-CBC encryption, by default.

The struct supports "AES" encryption with a default keysize of 128 bits. You may also set "AESCBC192", "AESCBC256", "AESGCM128", "AESGCM192", or "AESGCM256" for other AES modes and keysizes. 3DES and DES remain available for legacy interoperability.

Possible values are:

• 3DES
• DES
• AESCBC128
• AESCBC192
• AESCBC256 (default)
• AESGCM128
• AESGCM192
• AESGCM256

Data Type

String

etag property (AS2Sender Struct)

The Etag of the file being sent.

Syntax

fn etag(&self ) -> Result<String, IPWorksEDIError> 
fn set_etag(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_etag_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This specifies the etag for the file. This value should be set to an empty string the first time a file is sent using the restart command. The struct will generate a unique etag based on the processed contents of the file and set this property when sending begins.

If a file is interrupted, this value must be set when restart is called to resume transfer of the already processed file.

Data Type

String

firewall_auto_detect property (AS2Sender Struct)

Whether to automatically detect and use firewall system settings, if available.

Syntax

fn firewall_auto_detect(&self ) -> Result<bool, IPWorksEDIError> 
fn set_firewall_auto_detect(&self, value : bool) ->  Option<IPWorksEDIError> 

Default Value

false

Remarks

Whether to automatically detect and use firewall system settings, if available.

Data Type

bool

firewall_type property (AS2Sender Struct)

The type of firewall to connect through.

Syntax

fn firewall_type(&self ) -> Result<i32, IPWorksEDIError> 
fn set_firewall_type(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // None
1   // Tunnel
2   // SOCKS4
3   // SOCKS5
10   // SOCKS4A

Default Value

0

Remarks

The type of firewall to connect through. The applicable values are as follows:

Data Type

i32

firewall_host property (AS2Sender Struct)

The name or IP address of the firewall (optional).

Syntax

fn firewall_host(&self ) -> Result<String, IPWorksEDIError> 
fn set_firewall_host(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_firewall_host_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The name or IP address of the firewall (optional). If a firewall_host is given, the requested connections will be authenticated through the specified firewall when connecting.

If this property is set to a Domain Name, a DNS request is initiated. Upon successful termination of the request, this property is set to the corresponding address. If the search is not successful, the struct fails with an error.

Data Type

String

firewall_password property (AS2Sender Struct)

A password if authentication is to be used when connecting through the firewall.

Syntax

fn firewall_password(&self ) -> Result<String, IPWorksEDIError> 
fn set_firewall_password(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_firewall_password_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

A password if authentication is to be used when connecting through the firewall. If firewall_host is specified, the firewall_user and firewall_password properties are used to connect and authenticate to the given firewall. If the authentication fails, the struct fails with an error.

Data Type

String

firewall_port property (AS2Sender Struct)

The Transmission Control Protocol (TCP) port for the firewall Host .

Syntax

fn firewall_port(&self ) -> Result<i32, IPWorksEDIError> 
fn set_firewall_port(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

0

Remarks

The Transmission Control Protocol (TCP) port for the firewall firewall_host. See the description of the firewall_host property for details.

NOTE: This property is set automatically when firewall_firewall_type is set to a valid value. See the description of the firewall_firewall_type property for details.

Data Type

i32

firewall_user property (AS2Sender Struct)

A username if authentication is to be used when connecting through a firewall.

Syntax

fn firewall_user(&self ) -> Result<String, IPWorksEDIError> 
fn set_firewall_user(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_firewall_user_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

A username if authentication is to be used when connecting through a firewall. If firewall_host is specified, this property and the firewall_password property are used to connect and authenticate to the given Firewall. If the authentication fails, the struct fails with an error.

Data Type

String

from property (AS2Sender Struct)

The email address of the HTTP agent (optional).

Syntax

fn from(&self ) -> Result<String, IPWorksEDIError> 
fn set_from(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_from_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the from property contains a non-empty string, an HTTP From: header is added to the request. This header generally gives the email address of the requester of the document.

Data Type

String

local_host property (AS2Sender Struct)

The name of the local host or user-assigned IP interface through which connections are initiated or accepted.

Syntax

fn local_host(&self ) -> Result<String, IPWorksEDIError> 
fn set_local_host(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_local_host_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property contains the name of the local host as obtained by the gethostname() system call, or if the user has assigned an IP address, the value of that address.

In multihomed hosts (machines with more than one IP interface) setting LocalHost to the IP address of an interface will make the struct initiate connections (or accept in the case of server structs) only through that interface. It is recommended to provide an IP address rather than a hostname when setting this property to ensure the desired interface is used.

If the struct is connected, the local_host property shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multihomed hosts (machines with more than one IP interface).

NOTE: local_host is not persistent. You must always set it in code, and never in the property window.

This property contains the name of the local host as obtained by the gethostname() system call, or if the user has assigned an IP address, the value of that address.

In multihomed hosts (machines with more than one IP interface) setting LocalHost to the IP address of an interface will make the struct initiate connections (or accept in the case of server structs) only through that interface. It is recommended to provide an IP address rather than a hostname when setting this property to ensure the desired interface is used.

If the struct is connected, the local_host property shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multihomed hosts (machines with more than one IP interface).

NOTE: local_host is not persistent. You must always set it in code, and never in the property window.

Data Type

String

log_directory property (AS2Sender Struct)

The path to a directory for logging.

Syntax

fn log_directory(&self ) -> Result<String, IPWorksEDIError> 
fn set_log_directory(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_log_directory_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

Setting log_directory will instruct the component to log the details of each transmission to unique files in the specified directory. For each request processed, the struct will log the complete text of the outgoing request and the incoming response.

The struct will write multiple log file for each transmission, with separate extensions for each type of data:

One or more of these logs may be disabled by setting the LogOptions configuration setting.

log_directory supports several macros that can be used to specify a unique directory path. If the path specified does not already exist, the struct will attempt to create the directory. The following macros are supported:

The filenames will be chosen automatically by the struct. Each filename will be the system time, in the format YYYY-MM-DD-HH-MM-SS-MMMM, with extensions "-2", "-3", used in case files of those names already exist. After each transaction is processed log_file will contain the name of the files just written, minus the extension.

If logs cannot be written an exception will be thrown.

Data Type

String

log_file property (AS2Sender Struct)

The log file written.

Syntax

fn log_file(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

If log_directory is specified a log file will be written in the specified directory and log_file will contain the full path and name of the files written, minus the extension.

The struct will write multiple log files for each transmission, with separate extensions for each type of data:

This property is read-only.

Data Type

String

mdn_delivery_option property (AS2Sender Struct)

A URL indicating how the receipt is to be delivered.

Syntax

fn mdn_delivery_option(&self ) -> Result<String, IPWorksEDIError> 
fn set_mdn_delivery_option(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_mdn_delivery_option_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The default mode of operation is for the receipt to be returned synchronously within the HTTP reply. By specifying a valid URL, the user may request asynchronous delivery instead. The URL indicates the destination for the reply, and may use any appropriate protocol, such as "http", "https", or "mailto".

If mdn_delivery_option is set to an empty string, the receipt will be returned synchronously, and will be processed automatically by the struct. Clients requesting asynchronous delivery should provide their own processing for reading receipts.

Data Type

String

mdn_options property (AS2Sender Struct)

Used to indicate the options requested for the MDN receipt.

Syntax

fn mdn_options(&self ) -> Result<String, IPWorksEDIError> 
fn set_mdn_options(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_mdn_options_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

"signed-receipt-protocol=optional, pkcs7-signature; signed-receipt-micalg=optional, sha-256"

Remarks

By default, the struct will request that the MDN be signed with a PKCS#7 signature over a SHA-256 hash, which is the industry standard.

Set mdn_options to an empty string to request an unsigned receipt.

This property will automatically be updated when signature_algorithm is set. Normally you will not need to set this property, however you can set a value here to override the automatically generated value.

The string format is that of the Disposition-Notification-Options HTTP header, as specified in RFC 3335. As a form of shorthand, you may set this property to "sha1", "sha-256", or "md5" to request the indicated hash algorithm.

When as2_version is set to "1.3", MD5, SHA-1, and SHA-224 are not allowed in the requested MIC algorithms. SHA-256, SHA-384, or SHA-512 are recommended instead.

Data Type

String

mdn_receipt_content property (AS2Sender Struct)

This contains the entire content of the MDN Receipt.

Syntax

fn mdn_receipt_content(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_mdn_receipt_content(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_mdn_receipt_content_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This contains the entire content of the MDN Receipt. This is a multipart/report entity consisting of a machine readable mdn_receipt_mdn (Message Disposition Notification) and a human readable mdn_receipt_message, which itself may be embedded in a multipart/signed entity if requested by the AS2 sender.

Data Type

Vec

mdn_receipt_header_count property (AS2Sender Struct)

The number of headers in the MDN.

Syntax

fn mdn_receipt_header_count(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The number of headers in the MDN.

This property is read-only.

Data Type

i32

mdn_receipt_header_field property (AS2Sender Struct)

The property name of the MDN header currently selected by HeaderIndex .

Syntax

fn mdn_receipt_header_field(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The field name of the MDN header currently selected by mdn_receipt_header_index.

This property is read-only.

Data Type

String

mdn_receipt_header_index property (AS2Sender Struct)

Which MDN header is currently selected to populate HeaderField and HeaderValue .

Syntax

fn mdn_receipt_header_index(&self ) -> Result<i32, IPWorksEDIError> 
fn set_mdn_receipt_header_index(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

0

Remarks

Which MDN header is currently selected to populate mdn_receipt_header_field and mdn_receipt_header_value.

Valid values are 0 to mdn_receipt_header_count - 1.

Data Type

i32

mdn_receipt_headers property (AS2Sender Struct)

Headers contains all of the headers of the AS2 MDN Receipt as a single string.

Syntax

fn mdn_receipt_headers(&self ) -> Result<String, IPWorksEDIError> 
fn set_mdn_receipt_headers(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_mdn_receipt_headers_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

Headers contains all of the headers of the AS2 MDN Receipt as a single string. This will include headers such as AS2-From, AS2-To, Date, Content-Type, etc. In an AS2Sender, these will also contain the transport headers of the MDN Receipt (HTTP or SMTP headers, depending on the delivery option).

You can also use mdn_receipt_header_count, mdn_receipt_header_index, mdn_receipt_header_field, and mdn_receipt_header_value to easily iterate through each individual header.

Data Type

String

mdn_receipt_header_value property (AS2Sender Struct)

The value of the MDN header currently selected by HeaderIndex .

Syntax

fn mdn_receipt_header_value(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The value of the MDN header currently selected by mdn_receipt_header_index.

This property is read-only.

Data Type

String

mdn_receipt_mdn property (AS2Sender Struct)

MDN will contain the entire machine readable text of the Message Disposition Notification in the receipt.

Syntax

fn mdn_receipt_mdn(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

MDN will contain the entire machine readable text of the Message Disposition Notification in the receipt. It will report either success or failure depending on the processing status of the receiver. In either case, it will be RFC-compliant.

This property is read-only.

Data Type

String

mdn_receipt_message property (AS2Sender Struct)

The human-readable portion of the MDN receipt.

Syntax

fn mdn_receipt_message(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The human-readable portion of the MDN receipt.

The human-readable portion of the MDN receipt that indicates the status of the message processing. This can be used to provide the user with a helpful message in the event that an error is encountered.

This property is read-only.

Data Type

String

mdn_receipt_mic_value property (AS2Sender Struct)

The Message Integrity Check(s) (one-way hash) of the original EDI message.

Syntax

fn mdn_receipt_mic_value(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The Message Integrity Check(s) (one-way hash) of the original EDI message.

An MDN Receipt contains a MIC calculated over the EDI message that the receipt is in response to, to be matched on the sender side against a saved value for the original request to ensure that the integrity of the data that the receiver reports is preserved. When a signed receipt is requested, the MIC is be calculated using the algorithm used on the incoming message's signature, or SHA-1 if the incoming message is not signed.

The MIC will be base64 encoded and reported with the algorithm name as specified in RFC 3335; e.g., w7AguNJEmhF/qIjJw6LnnA==, md5.

This property is read-only.

Data Type

String

mdn_receipt_signing_protocol property (AS2Sender Struct)

This property contains the MIME type of the signature used, if any (i.

Syntax

fn mdn_receipt_signing_protocol(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

This property contains the MIME type of the signature used, if any (i.e., "application/pkcs7-signature"), to create this MDNReceipt. It will contain an empty string if the receipt is unsigned.

This property is read-only.

Data Type

String

mdn_to property (AS2Sender Struct)

Used to indicate that a message disposition notification is requested.

Syntax

fn mdn_to(&self ) -> Result<String, IPWorksEDIError> 
fn set_mdn_to(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_mdn_to_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If this property is set, a Disposition-Notification-To header will be added to the request, and an MDN will be requested. The value may be an email address, URL, etc., and while its presence is used to determine whether or not an MDN is sent, the value itself will typically be ignored by the server.

By default, the struct will request a PKCS#7 signature and synchronous delivery. You may set mdn_delivery_option to request an asynchronous MDN, and you may set mdn_options to request a different type of signature, or no signature at all.

Data Type

String

message_id property (AS2Sender Struct)

The Id of the message.

Syntax

fn message_id(&self ) -> Result<String, IPWorksEDIError> 
fn set_message_id(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_message_id_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The Id format is as in RFC 2822: id-left@id-right .

A unique Id will automatically be generated on startup. Sending a message will reset id-left if the MessageId has been used in the previous message.

If you set message_id to a string of the form "@(id-right)" a unique id-left will be generated. If you set message_id to an empty string, a new message_id will be generated with the same id-right.

After an mdn_receipt is returned or set, message_id will contain the Original-Message-ID found in the MDN Receipt.

Data Type

String

original_content_mic property (AS2Sender Struct)

The Message Integrity Check(s) (one-way hash) of the outgoing message.

Syntax

fn original_content_mic(&self ) -> Result<String, IPWorksEDIError> 
fn set_original_content_mic(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_original_content_mic_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

A MIC will be calculated over the outgoing message using the same algorithm in the signature_algorithm configuration used to sign the message. The property will be set when post (in AS3, send) is invoked, and the MIC will automatically be checked against the Original-Content-MIC in the MDN for synchronous MDNs.

The format is in RFC 3335, i.e. w7AguNJEmhF/qIjJw6LnnA==, md5, with a newline at the end.

If you are requesting an asynchronous MDN, you must save this value externally so that it can be loaded when the MDN is received (you may also use async_mdn_info_dir).

Data Type

String

proxy_auth_scheme property (AS2Sender Struct)

The type of authorization to perform when connecting to the proxy.

Syntax

fn proxy_auth_scheme(&self ) -> Result<i32, IPWorksEDIError> 
fn set_proxy_auth_scheme(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // Basic
1   // Digest
2   // Proprietary
3   // None
4   // Ntlm
5   // Negotiate

Default Value

0

Remarks

The type of authorization to perform when connecting to the proxy. This is used only when the proxy_user and proxy_password properties are set.

proxy_auth_scheme should be set to authNone (3) when no authentication is expected.

By default, proxy_auth_scheme is authBasic (0), and if the proxy_user and proxy_password properties are set, the struct will attempt basic authentication.

If proxy_auth_scheme is set to authDigest (1), digest authentication will be attempted instead.

If proxy_auth_scheme is set to authProprietary (2), then the authorization token will not be generated by the struct. Look at the configuration file for the struct being used to find more information about manually setting this token.

If proxy_auth_scheme is set to authNtlm (4), NTLM authentication will be used.

For security reasons, setting this property will clear the values of proxy_user and proxy_password.

Data Type

i32

proxy_auto_detect property (AS2Sender Struct)

Whether to automatically detect and use proxy system settings, if available.

Syntax

fn proxy_auto_detect(&self ) -> Result<bool, IPWorksEDIError> 
fn set_proxy_auto_detect(&self, value : bool) ->  Option<IPWorksEDIError> 

Default Value

false

Remarks

Whether to automatically detect and use proxy system settings, if available. The default value is false.

Data Type

bool

proxy_password property (AS2Sender Struct)

A password if authentication is to be used for the proxy.

Syntax

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

Default Value

""

Remarks

A password if authentication is to be used for the proxy.

If proxy_auth_scheme is set to Basic Authentication, the proxy_user and proxy_password properties are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If proxy_auth_scheme is set to Digest Authentication, the proxy_user and proxy_password properties are used to respond to the Digest Authentication challenge from the server.

If proxy_auth_scheme is set to NTLM Authentication, the proxy_user and proxy_password properties are used to authenticate through NTLM negotiation.

Data Type

String

proxy_port property (AS2Sender Struct)

The Transmission Control Protocol (TCP) port for the proxy Server (default 80).

Syntax

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

Default Value

80

Remarks

The Transmission Control Protocol (TCP) port for the proxy proxy_server (default 80). See the description of the proxy_server property for details.

Data Type

i32

proxy_server property (AS2Sender Struct)

If a proxy Server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

Syntax

fn proxy_server(&self ) -> Result<String, IPWorksEDIError> 
fn set_proxy_server(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_proxy_server_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If a proxy proxy_server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

If the proxy_server property is set to a domain name, a DNS request is initiated. Upon successful termination of the request, the proxy_server property is set to the corresponding address. If the search is not successful, an error is returned.

Data Type

String

proxy_ssl property (AS2Sender Struct)

When to use a Secure Sockets Layer (SSL) for the connection to the proxy.

Syntax

fn proxy_ssl(&self ) -> Result<i32, IPWorksEDIError> 
fn set_proxy_ssl(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // Automatic
1   // Always
2   // Never
3   // Tunnel

Default Value

0

Remarks

When to use a Secure Sockets Layer (SSL) for the connection to the proxy. The applicable values are as follows:

Data Type

i32

proxy_user property (AS2Sender Struct)

A username if authentication is to be used for the proxy.

Syntax

fn proxy_user(&self ) -> Result<String, IPWorksEDIError> 
fn set_proxy_user(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_proxy_user_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

A username if authentication is to be used for the proxy.

If proxy_auth_scheme is set to Basic Authentication, the proxy_user and proxy_password properties are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If proxy_auth_scheme is set to Digest Authentication, the proxy_user and proxy_password properties are used to respond to the Digest Authentication challenge from the server.

If proxy_auth_scheme is set to NTLM Authentication, the proxy_user and proxy_password properties are used to authenticate through NTLM negotiation.

Data Type

String

receipt_signer_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn receipt_signer_cert_effective_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

receipt_signer_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn receipt_signer_cert_expiration_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

receipt_signer_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn receipt_signer_cert_extended_key_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

receipt_signer_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn receipt_signer_cert_fingerprint(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

receipt_signer_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn receipt_signer_cert_fingerprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

receipt_signer_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn receipt_signer_cert_fingerprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

receipt_signer_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn receipt_signer_cert_issuer(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

receipt_signer_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn receipt_signer_cert_private_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The receipt_signer_cert_private_key may be available but not exportable. In this case, receipt_signer_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

receipt_signer_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn receipt_signer_cert_private_key_available(&self ) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a receipt_signer_cert_private_key is available for the selected certificate. If receipt_signer_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

receipt_signer_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn receipt_signer_cert_private_key_container(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the receipt_signer_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

receipt_signer_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn receipt_signer_cert_public_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

receipt_signer_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn receipt_signer_cert_public_key_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

receipt_signer_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn receipt_signer_cert_public_key_length(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

receipt_signer_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn receipt_signer_cert_serial_number(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

receipt_signer_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn receipt_signer_cert_signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

receipt_signer_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn receipt_signer_cert_store(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_receipt_signer_cert_store(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_receipt_signer_cert_store_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The receipt_signer_cert_store_type property denotes the type of the certificate store specified by receipt_signer_cert_store. If the store is password-protected, specify the password in receipt_signer_cert_store_password.

receipt_signer_cert_store is used in conjunction with the receipt_signer_cert_subject property to specify client certificates. If receipt_signer_cert_store has a value, and receipt_signer_cert_subject or receipt_signer_cert_encoded is set, a search for a certificate is initiated. Please see the receipt_signer_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

receipt_signer_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn receipt_signer_cert_store_password(&self ) -> Result<String, IPWorksEDIError> 
fn set_receipt_signer_cert_store_password(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_receipt_signer_cert_store_password_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

receipt_signer_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn receipt_signer_cert_store_type(&self ) -> Result<i32, IPWorksEDIError> 
fn set_receipt_signer_cert_store_type(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

receipt_signer_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn receipt_signer_cert_subject_alt_names(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

receipt_signer_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn receipt_signer_cert_thumbprint_md5(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

receipt_signer_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn receipt_signer_cert_thumbprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

receipt_signer_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn receipt_signer_cert_thumbprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

receipt_signer_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn receipt_signer_cert_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of receipt_signer_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

receipt_signer_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn receipt_signer_cert_usage_flags(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of receipt_signer_cert_usage_flags is a combination of the following flags:

Please see the receipt_signer_cert_usage property for a text representation of receipt_signer_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

receipt_signer_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn receipt_signer_cert_version(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

receipt_signer_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn receipt_signer_cert_subject(&self ) -> Result<String, IPWorksEDIError> 
fn set_receipt_signer_cert_subject(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_receipt_signer_cert_subject_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

receipt_signer_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn receipt_signer_cert_encoded(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_receipt_signer_cert_encoded(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_receipt_signer_cert_encoded_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The receipt_signer_cert_store and receipt_signer_cert_subject properties also may be used to specify a certificate.

When receipt_signer_cert_encoded is set, a search is initiated in the current receipt_signer_cert_store for the private key of the certificate. If the key is found, receipt_signer_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, receipt_signer_cert_subject is set to an empty string.

Data Type

Vec

recipient_cert_count property (AS2Sender Struct)

The number of records in the RecipientCert arrays.

Syntax

fn recipient_cert_count(&self ) -> Result<i32, IPWorksEDIError> 
fn set_recipient_cert_count(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• recipient_cert_effective_date
• recipient_cert_encoded
• recipient_cert_expiration_date
• recipient_cert_extended_key_usage
• recipient_cert_fingerprint
• recipient_cert_fingerprint_sha1
• recipient_cert_fingerprint_sha256
• recipient_cert_issuer
• recipient_cert_private_key
• recipient_cert_private_key_available
• recipient_cert_private_key_container
• recipient_cert_public_key
• recipient_cert_public_key_algorithm
• recipient_cert_public_key_length
• recipient_cert_serial_number
• recipient_cert_signature_algorithm
• recipient_cert_store
• recipient_cert_store_password
• recipient_cert_store_type
• recipient_cert_subject
• recipient_cert_subject_alt_names
• recipient_cert_thumbprint_md5
• recipient_cert_thumbprint_sha1
• recipient_cert_thumbprint_sha256
• recipient_cert_usage
• recipient_cert_usage_flags
• recipient_cert_version

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

Data Type

i32

recipient_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn recipient_cert_effective_date(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

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

This property is read-only.

Data Type

String

recipient_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn recipient_cert_expiration_date(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

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

This property is read-only.

Data Type

String

recipient_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn recipient_cert_extended_key_usage(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

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

This property is read-only.

Data Type

String

recipient_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn recipient_cert_fingerprint(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

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

This property is read-only.

Data Type

String

recipient_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn recipient_cert_fingerprint_sha1(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

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

This property is read-only.

Data Type

String

recipient_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn recipient_cert_fingerprint_sha256(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

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

This property is read-only.

Data Type

String

recipient_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn recipient_cert_issuer(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

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

This property is read-only.

Data Type

String

recipient_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn recipient_cert_private_key(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The recipient_cert_private_key may be available but not exportable. In this case, recipient_cert_private_key returns an empty string.

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

This property is read-only.

Data Type

String

recipient_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn recipient_cert_private_key_available(&self , RecipientCertIndex : i32) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a recipient_cert_private_key is available for the selected certificate. If recipient_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

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

This property is read-only.

Data Type

bool

recipient_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn recipient_cert_private_key_container(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the recipient_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

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

This property is read-only.

Data Type

String

recipient_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn recipient_cert_public_key(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

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

This property is read-only.

Data Type

String

recipient_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn recipient_cert_public_key_algorithm(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

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

This property is read-only.

Data Type

String

recipient_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn recipient_cert_public_key_length(&self , RecipientCertIndex : i32) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

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

This property is read-only.

Data Type

i32

recipient_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn recipient_cert_serial_number(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

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

This property is read-only.

Data Type

String

recipient_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn recipient_cert_signature_algorithm(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

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

This property is read-only.

Data Type

String

recipient_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn recipient_cert_store(&self , RecipientCertIndex : i32) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_recipient_cert_store(&self, RecipientCertIndex : i32, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_recipient_cert_store_ref(&self, RecipientCertIndex : i32, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The recipient_cert_store_type property denotes the type of the certificate store specified by recipient_cert_store. If the store is password-protected, specify the password in recipient_cert_store_password.

recipient_cert_store is used in conjunction with the recipient_cert_subject property to specify client certificates. If recipient_cert_store has a value, and recipient_cert_subject or recipient_cert_encoded is set, a search for a certificate is initiated. Please see the recipient_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

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

Data Type

Vec

recipient_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn recipient_cert_store_password(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_recipient_cert_store_password(&self, RecipientCertIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_recipient_cert_store_password_ref(&self, RecipientCertIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

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

Data Type

String

recipient_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn recipient_cert_store_type(&self , RecipientCertIndex : i32) -> Result<i32, IPWorksEDIError> 
fn set_recipient_cert_store_type(&self, RecipientCertIndex : i32, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

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

Data Type

i32

recipient_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn recipient_cert_subject_alt_names(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

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

This property is read-only.

Data Type

String

recipient_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn recipient_cert_thumbprint_md5(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

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

This property is read-only.

Data Type

String

recipient_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn recipient_cert_thumbprint_sha1(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

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

This property is read-only.

Data Type

String

recipient_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn recipient_cert_thumbprint_sha256(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

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

This property is read-only.

Data Type

String

recipient_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn recipient_cert_usage(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of recipient_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

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

This property is read-only.

Data Type

String

recipient_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn recipient_cert_usage_flags(&self , RecipientCertIndex : i32) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of recipient_cert_usage_flags is a combination of the following flags:

Please see the recipient_cert_usage property for a text representation of recipient_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

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

This property is read-only.

Data Type

i32

recipient_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn recipient_cert_version(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

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

This property is read-only.

Data Type

String

recipient_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn recipient_cert_subject(&self , RecipientCertIndex : i32) -> Result<String, IPWorksEDIError> 
fn set_recipient_cert_subject(&self, RecipientCertIndex : i32, value : &str) ->  Option<IPWorksEDIError> 
fn set_recipient_cert_subject_ref(&self, RecipientCertIndex : i32, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

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

Data Type

String

recipient_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn recipient_cert_encoded(&self , RecipientCertIndex : i32) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_recipient_cert_encoded(&self, RecipientCertIndex : i32, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_recipient_cert_encoded_ref(&self, RecipientCertIndex : i32, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The recipient_cert_store and recipient_cert_subject properties also may be used to specify a certificate.

When recipient_cert_encoded is set, a search is initiated in the current recipient_cert_store for the private key of the certificate. If the key is found, recipient_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, recipient_cert_subject is set to an empty string.

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

Data Type

Vec

restart_directory property (AS2Sender Struct)

The directory to log cached files when using AS2 restart functionality.

Syntax

fn restart_directory(&self ) -> Result<String, IPWorksEDIError> 
fn set_restart_directory(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_restart_directory_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If this property is set, the struct will cache all data to the restart_directory. Thus, when sending a file is interrupted, the struct can restart the transmission of the file starting where it was interrupted.

To use this functionality, simply set the restart_directory and call restart.

When using restart functionality, the data is completely processed to the restart_directory before sending begins.

NOTE: This directory will not automatically be cleaned up.

Data Type

String

rollover_signing_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn rollover_signing_cert_effective_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

rollover_signing_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn rollover_signing_cert_expiration_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

rollover_signing_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn rollover_signing_cert_extended_key_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

rollover_signing_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn rollover_signing_cert_fingerprint(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

rollover_signing_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn rollover_signing_cert_fingerprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

rollover_signing_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn rollover_signing_cert_fingerprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

rollover_signing_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn rollover_signing_cert_issuer(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

rollover_signing_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn rollover_signing_cert_private_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The rollover_signing_cert_private_key may be available but not exportable. In this case, rollover_signing_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

rollover_signing_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn rollover_signing_cert_private_key_available(&self ) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a rollover_signing_cert_private_key is available for the selected certificate. If rollover_signing_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

rollover_signing_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn rollover_signing_cert_private_key_container(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the rollover_signing_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

rollover_signing_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn rollover_signing_cert_public_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

rollover_signing_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn rollover_signing_cert_public_key_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

rollover_signing_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn rollover_signing_cert_public_key_length(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

rollover_signing_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn rollover_signing_cert_serial_number(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

rollover_signing_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn rollover_signing_cert_signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

rollover_signing_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn rollover_signing_cert_store(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_rollover_signing_cert_store(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_rollover_signing_cert_store_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The rollover_signing_cert_store_type property denotes the type of the certificate store specified by rollover_signing_cert_store. If the store is password-protected, specify the password in rollover_signing_cert_store_password.

rollover_signing_cert_store is used in conjunction with the rollover_signing_cert_subject property to specify client certificates. If rollover_signing_cert_store has a value, and rollover_signing_cert_subject or rollover_signing_cert_encoded is set, a search for a certificate is initiated. Please see the rollover_signing_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

rollover_signing_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn rollover_signing_cert_store_password(&self ) -> Result<String, IPWorksEDIError> 
fn set_rollover_signing_cert_store_password(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_rollover_signing_cert_store_password_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

rollover_signing_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn rollover_signing_cert_store_type(&self ) -> Result<i32, IPWorksEDIError> 
fn set_rollover_signing_cert_store_type(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

rollover_signing_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn rollover_signing_cert_subject_alt_names(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

rollover_signing_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn rollover_signing_cert_thumbprint_md5(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

rollover_signing_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn rollover_signing_cert_thumbprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

rollover_signing_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn rollover_signing_cert_thumbprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

rollover_signing_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn rollover_signing_cert_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of rollover_signing_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

rollover_signing_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn rollover_signing_cert_usage_flags(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of rollover_signing_cert_usage_flags is a combination of the following flags:

Please see the rollover_signing_cert_usage property for a text representation of rollover_signing_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

rollover_signing_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn rollover_signing_cert_version(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

rollover_signing_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn rollover_signing_cert_subject(&self ) -> Result<String, IPWorksEDIError> 
fn set_rollover_signing_cert_subject(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_rollover_signing_cert_subject_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

rollover_signing_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn rollover_signing_cert_encoded(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_rollover_signing_cert_encoded(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_rollover_signing_cert_encoded_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The rollover_signing_cert_store and rollover_signing_cert_subject properties also may be used to specify a certificate.

When rollover_signing_cert_encoded is set, a search is initiated in the current rollover_signing_cert_store for the private key of the certificate. If the key is found, rollover_signing_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, rollover_signing_cert_subject is set to an empty string.

Data Type

Vec

signature_algorithm property (AS2Sender Struct)

Signature algorithm to be used in outgoing messages.

Syntax

fn signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 
fn set_signature_algorithm(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_signature_algorithm_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

"sha-256"

Remarks

Signature Algorithm can be set to indicate the preferred signing algorithm. Possible values are:

• sha1
• md5
• sha-256 (or sha256) (default)
• sha-384 (or sha384)
• sha-512 (or sha512)
• sha-224 (or sha224)

The default value is "sha-256". When this property is set the mdn_options property is automatically updated to request the MDN receipt be signed with the same algorithm.

When as2_version is set to "1.3", MD5, SHA-1, and SHA-224 are not allowed for generated messages. "sha-256", "sha-384", or "sha-512" are recommended instead.

Data Type

String

signing_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn signing_cert_effective_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

signing_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn signing_cert_expiration_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

signing_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn signing_cert_extended_key_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

signing_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn signing_cert_fingerprint(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

signing_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn signing_cert_fingerprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

signing_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn signing_cert_fingerprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

signing_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn signing_cert_issuer(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

signing_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn signing_cert_private_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The signing_cert_private_key may be available but not exportable. In this case, signing_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

signing_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn signing_cert_private_key_available(&self ) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a signing_cert_private_key is available for the selected certificate. If signing_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

signing_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn signing_cert_private_key_container(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the signing_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

signing_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn signing_cert_public_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

signing_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn signing_cert_public_key_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

signing_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn signing_cert_public_key_length(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

signing_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn signing_cert_serial_number(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

signing_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn signing_cert_signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

signing_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn signing_cert_store(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_signing_cert_store(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_signing_cert_store_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The signing_cert_store_type property denotes the type of the certificate store specified by signing_cert_store. If the store is password-protected, specify the password in signing_cert_store_password.

signing_cert_store is used in conjunction with the signing_cert_subject property to specify client certificates. If signing_cert_store has a value, and signing_cert_subject or signing_cert_encoded is set, a search for a certificate is initiated. Please see the signing_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

signing_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn signing_cert_store_password(&self ) -> Result<String, IPWorksEDIError> 
fn set_signing_cert_store_password(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_signing_cert_store_password_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

signing_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn signing_cert_store_type(&self ) -> Result<i32, IPWorksEDIError> 
fn set_signing_cert_store_type(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

signing_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn signing_cert_subject_alt_names(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

signing_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn signing_cert_thumbprint_md5(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

signing_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn signing_cert_thumbprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

signing_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn signing_cert_thumbprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

signing_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn signing_cert_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of signing_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

signing_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn signing_cert_usage_flags(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of signing_cert_usage_flags is a combination of the following flags:

Please see the signing_cert_usage property for a text representation of signing_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

signing_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn signing_cert_version(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

signing_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn signing_cert_subject(&self ) -> Result<String, IPWorksEDIError> 
fn set_signing_cert_subject(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_signing_cert_subject_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

signing_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn signing_cert_encoded(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_signing_cert_encoded(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_signing_cert_encoded_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The signing_cert_store and signing_cert_subject properties also may be used to specify a certificate.

When signing_cert_encoded is set, a search is initiated in the current signing_cert_store for the private key of the certificate. If the key is found, signing_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, signing_cert_subject is set to an empty string.

Data Type

Vec

ssl_accept_server_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn ssl_accept_server_cert_effective_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

ssl_accept_server_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn ssl_accept_server_cert_expiration_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

ssl_accept_server_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn ssl_accept_server_cert_extended_key_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

ssl_accept_server_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn ssl_accept_server_cert_fingerprint(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

ssl_accept_server_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn ssl_accept_server_cert_fingerprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

ssl_accept_server_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn ssl_accept_server_cert_fingerprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

ssl_accept_server_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn ssl_accept_server_cert_issuer(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

ssl_accept_server_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn ssl_accept_server_cert_private_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The ssl_accept_server_cert_private_key may be available but not exportable. In this case, ssl_accept_server_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

ssl_accept_server_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn ssl_accept_server_cert_private_key_available(&self ) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a ssl_accept_server_cert_private_key is available for the selected certificate. If ssl_accept_server_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

ssl_accept_server_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn ssl_accept_server_cert_private_key_container(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the ssl_accept_server_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

ssl_accept_server_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn ssl_accept_server_cert_public_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

ssl_accept_server_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn ssl_accept_server_cert_public_key_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_accept_server_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn ssl_accept_server_cert_public_key_length(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

ssl_accept_server_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn ssl_accept_server_cert_serial_number(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

ssl_accept_server_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn ssl_accept_server_cert_signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_accept_server_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn ssl_accept_server_cert_store(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_ssl_accept_server_cert_store(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_ssl_accept_server_cert_store_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ssl_accept_server_cert_store_type property denotes the type of the certificate store specified by ssl_accept_server_cert_store. If the store is password-protected, specify the password in ssl_accept_server_cert_store_password.

ssl_accept_server_cert_store is used in conjunction with the ssl_accept_server_cert_subject property to specify client certificates. If ssl_accept_server_cert_store has a value, and ssl_accept_server_cert_subject or ssl_accept_server_cert_encoded is set, a search for a certificate is initiated. Please see the ssl_accept_server_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

ssl_accept_server_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn ssl_accept_server_cert_store_password(&self ) -> Result<String, IPWorksEDIError> 
fn set_ssl_accept_server_cert_store_password(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_ssl_accept_server_cert_store_password_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

ssl_accept_server_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn ssl_accept_server_cert_store_type(&self ) -> Result<i32, IPWorksEDIError> 
fn set_ssl_accept_server_cert_store_type(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

ssl_accept_server_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn ssl_accept_server_cert_subject_alt_names(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

ssl_accept_server_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn ssl_accept_server_cert_thumbprint_md5(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_accept_server_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn ssl_accept_server_cert_thumbprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_accept_server_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn ssl_accept_server_cert_thumbprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_accept_server_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn ssl_accept_server_cert_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of ssl_accept_server_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

ssl_accept_server_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn ssl_accept_server_cert_usage_flags(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of ssl_accept_server_cert_usage_flags is a combination of the following flags:

Please see the ssl_accept_server_cert_usage property for a text representation of ssl_accept_server_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

ssl_accept_server_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn ssl_accept_server_cert_version(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

ssl_accept_server_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn ssl_accept_server_cert_subject(&self ) -> Result<String, IPWorksEDIError> 
fn set_ssl_accept_server_cert_subject(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_ssl_accept_server_cert_subject_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

ssl_accept_server_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn ssl_accept_server_cert_encoded(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_ssl_accept_server_cert_encoded(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_ssl_accept_server_cert_encoded_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The ssl_accept_server_cert_store and ssl_accept_server_cert_subject properties also may be used to specify a certificate.

When ssl_accept_server_cert_encoded is set, a search is initiated in the current ssl_accept_server_cert_store for the private key of the certificate. If the key is found, ssl_accept_server_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, ssl_accept_server_cert_subject is set to an empty string.

Data Type

Vec

ssl_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn ssl_cert_effective_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

ssl_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn ssl_cert_expiration_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

ssl_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn ssl_cert_extended_key_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

ssl_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn ssl_cert_fingerprint(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

ssl_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn ssl_cert_fingerprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

ssl_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn ssl_cert_fingerprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

ssl_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn ssl_cert_issuer(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

ssl_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn ssl_cert_private_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The ssl_cert_private_key may be available but not exportable. In this case, ssl_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

ssl_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn ssl_cert_private_key_available(&self ) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a ssl_cert_private_key is available for the selected certificate. If ssl_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

ssl_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn ssl_cert_private_key_container(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the ssl_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

ssl_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn ssl_cert_public_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

ssl_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn ssl_cert_public_key_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn ssl_cert_public_key_length(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

ssl_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn ssl_cert_serial_number(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

ssl_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn ssl_cert_signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn ssl_cert_store(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_ssl_cert_store(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_ssl_cert_store_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ssl_cert_store_type property denotes the type of the certificate store specified by ssl_cert_store. If the store is password-protected, specify the password in ssl_cert_store_password.

ssl_cert_store is used in conjunction with the ssl_cert_subject property to specify client certificates. If ssl_cert_store has a value, and ssl_cert_subject or ssl_cert_encoded is set, a search for a certificate is initiated. Please see the ssl_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

ssl_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn ssl_cert_store_password(&self ) -> Result<String, IPWorksEDIError> 
fn set_ssl_cert_store_password(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_ssl_cert_store_password_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

ssl_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn ssl_cert_store_type(&self ) -> Result<i32, IPWorksEDIError> 
fn set_ssl_cert_store_type(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

ssl_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn ssl_cert_subject_alt_names(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

ssl_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn ssl_cert_thumbprint_md5(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn ssl_cert_thumbprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn ssl_cert_thumbprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn ssl_cert_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of ssl_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

ssl_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn ssl_cert_usage_flags(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of ssl_cert_usage_flags is a combination of the following flags:

Please see the ssl_cert_usage property for a text representation of ssl_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

ssl_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn ssl_cert_version(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

ssl_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn ssl_cert_subject(&self ) -> Result<String, IPWorksEDIError> 
fn set_ssl_cert_subject(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_ssl_cert_subject_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

ssl_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn ssl_cert_encoded(&self ) -> Result<Vec<u8>, IPWorksEDIError> 
fn set_ssl_cert_encoded(&self, value : Vec<u8>) ->  Option<IPWorksEDIError> 
fn set_ssl_cert_encoded_ref(&self, value : &[u8]) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The ssl_cert_store and ssl_cert_subject properties also may be used to specify a certificate.

When ssl_cert_encoded is set, a search is initiated in the current ssl_cert_store for the private key of the certificate. If the key is found, ssl_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, ssl_cert_subject is set to an empty string.

Data Type

Vec

ssl_provider property (AS2Sender Struct)

The Secure Sockets Layer/Transport Layer Security (SSL/TLS) implementation to use.

Syntax

fn ssl_provider(&self ) -> Result<i32, IPWorksEDIError> 
fn set_ssl_provider(&self, value : i32) ->  Option<IPWorksEDIError> 

Possible Values

0   // Automatic
1   // Platform
2   // Internal

Default Value

0

Remarks

This property specifies the SSL/TLS implementation to use. In most cases the default value of 0 (Automatic) is recommended and should not be changed. When set to 0 (Automatic), the struct will select whether to use the platform implementation or the internal implementation depending on the operating system as well as the TLS version being used.

Possible values are as follows:

Additional Notes

In most cases using the default value (Automatic) is recommended. The struct will select a provider depending on the current platform.

When Automatic is selected, on Windows, the struct will use the platform implementation. On Linux/macOS, the struct will use the internal implementation. When TLS 1.3 is enabled via SSLEnabledProtocols, the struct will always try and use the platform implementation. If the platform TLS 1.3 implementation is not available, the internal implementation will be used.

Data Type

i32

ssl_server_cert_effective_date property (AS2Sender Struct)

The date on which this certificate becomes valid.

Syntax

fn ssl_server_cert_effective_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

ssl_server_cert_expiration_date property (AS2Sender Struct)

The date on which the certificate expires.

Syntax

fn ssl_server_cert_expiration_date(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

ssl_server_cert_extended_key_usage property (AS2Sender Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn ssl_server_cert_extended_key_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

ssl_server_cert_fingerprint property (AS2Sender Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn ssl_server_cert_fingerprint(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

ssl_server_cert_fingerprint_sha1 property (AS2Sender Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn ssl_server_cert_fingerprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

ssl_server_cert_fingerprint_sha256 property (AS2Sender Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn ssl_server_cert_fingerprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

ssl_server_cert_issuer property (AS2Sender Struct)

The issuer of the certificate.

Syntax

fn ssl_server_cert_issuer(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

ssl_server_cert_private_key property (AS2Sender Struct)

The private key of the certificate (if available).

Syntax

fn ssl_server_cert_private_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The ssl_server_cert_private_key may be available but not exportable. In this case, ssl_server_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

ssl_server_cert_private_key_available property (AS2Sender Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn ssl_server_cert_private_key_available(&self ) -> Result<bool, IPWorksEDIError> 

Default Value

false

Remarks

Whether a ssl_server_cert_private_key is available for the selected certificate. If ssl_server_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

ssl_server_cert_private_key_container property (AS2Sender Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn ssl_server_cert_private_key_container(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The name of the ssl_server_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

ssl_server_cert_public_key property (AS2Sender Struct)

The public key of the certificate.

Syntax

fn ssl_server_cert_public_key(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

ssl_server_cert_public_key_algorithm property (AS2Sender Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn ssl_server_cert_public_key_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_server_cert_public_key_length property (AS2Sender Struct)

The length of the certificate's public key (in bits).

Syntax

fn ssl_server_cert_public_key_length(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

ssl_server_cert_serial_number property (AS2Sender Struct)

The serial number of the certificate encoded as a string.

Syntax

fn ssl_server_cert_serial_number(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

ssl_server_cert_signature_algorithm property (AS2Sender Struct)

The text description of the certificate's signature algorithm.

Syntax

fn ssl_server_cert_signature_algorithm(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_server_cert_store property (AS2Sender Struct)

The name of the certificate store for the client certificate.

Syntax

fn ssl_server_cert_store(&self ) -> Result<Vec<u8>, IPWorksEDIError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ssl_server_cert_store_type property denotes the type of the certificate store specified by ssl_server_cert_store. If the store is password-protected, specify the password in ssl_server_cert_store_password.

ssl_server_cert_store is used in conjunction with the ssl_server_cert_subject property to specify client certificates. If ssl_server_cert_store has a value, and ssl_server_cert_subject or ssl_server_cert_encoded is set, a search for a certificate is initiated. Please see the ssl_server_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

This property is read-only.

Data Type

Vec

ssl_server_cert_store_password property (AS2Sender Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn ssl_server_cert_store_password(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

This property is read-only.

Data Type

String

ssl_server_cert_store_type property (AS2Sender Struct)

The type of certificate store for this certificate.

Syntax

fn ssl_server_cert_store_type(&self ) -> Result<i32, IPWorksEDIError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

This property is read-only.

Data Type

i32

ssl_server_cert_subject_alt_names property (AS2Sender Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn ssl_server_cert_subject_alt_names(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

ssl_server_cert_thumbprint_md5 property (AS2Sender Struct)

The MD5 hash of the certificate.

Syntax

fn ssl_server_cert_thumbprint_md5(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_server_cert_thumbprint_sha1 property (AS2Sender Struct)

The SHA-1 hash of the certificate.

Syntax

fn ssl_server_cert_thumbprint_sha1(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_server_cert_thumbprint_sha256 property (AS2Sender Struct)

The SHA-256 hash of the certificate.

Syntax

fn ssl_server_cert_thumbprint_sha256(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_server_cert_usage property (AS2Sender Struct)

The text description of UsageFlags .

Syntax

fn ssl_server_cert_usage(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The text description of ssl_server_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

ssl_server_cert_usage_flags property (AS2Sender Struct)

The flags that show intended use for the certificate.

Syntax

fn ssl_server_cert_usage_flags(&self ) -> Result<i32, IPWorksEDIError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of ssl_server_cert_usage_flags is a combination of the following flags:

Please see the ssl_server_cert_usage property for a text representation of ssl_server_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

ssl_server_cert_version property (AS2Sender Struct)

The certificate's version number.

Syntax

fn ssl_server_cert_version(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

ssl_server_cert_subject property (AS2Sender Struct)

The subject of the certificate used for client authentication.

Syntax

fn ssl_server_cert_subject(&self ) -> Result<String, IPWorksEDIError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

This property is read-only.

Data Type

String

ssl_server_cert_encoded property (AS2Sender Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn ssl_server_cert_encoded(&self ) -> Result<Vec<u8>, IPWorksEDIError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The ssl_server_cert_store and ssl_server_cert_subject properties also may be used to specify a certificate.

When ssl_server_cert_encoded is set, a search is initiated in the current ssl_server_cert_store for the private key of the certificate. If the key is found, ssl_server_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, ssl_server_cert_subject is set to an empty string.

This property is read-only.

Data Type

Vec

subject property (AS2Sender Struct)

The subject of the message.

Syntax

fn subject(&self ) -> Result<String, IPWorksEDIError> 
fn set_subject(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_subject_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

The optional human-readable subject of the message. Some AS2 partners will use this field to send additional information about the transmission at the transport layer.

Data Type

String

timeout property (AS2Sender Struct)

The timeout for the struct.

Syntax

fn timeout(&self ) -> Result<i32, IPWorksEDIError> 
fn set_timeout(&self, value : i32) ->  Option<IPWorksEDIError> 

Default Value

60

Remarks

If the timeout property is set to 0, all operations will run uninterrupted until successful completion or an error condition is encountered.

If timeout is set to a positive value, the struct will wait for the operation to complete before returning control.

The struct will use do_events to enter an efficient wait loop during any potential waiting period, making sure that all system events are processed immediately as they arrive. This ensures that the host application does not freeze and remains responsive.

If timeout expires, and the operation is not yet complete, the struct fails with an error.

NOTE: By default, all timeouts are inactivity timeouts, that is, the timeout period is extended by timeout seconds when any amount of data is successfully sent or received.

The default value for the timeout property is 60 seconds.

Data Type

i32

url property (AS2Sender Struct)

The URL to which the request is made.

Syntax

fn url(&self ) -> Result<String, IPWorksEDIError> 
fn set_url(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_url_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

""

Remarks

This property specifies the URL to which the request is made. SSL will be used if and only if the URL scheme is "https".

Data Type

String

use_oaep property (AS2Sender Struct)

This property specifies whether or not to use Optimal Asymmetric Encryption Padding (OAEP).

Syntax

fn use_oaep(&self ) -> Result<bool, IPWorksEDIError> 
fn set_use_oaep(&self, value : bool) ->  Option<IPWorksEDIError> 

Default Value

false

Remarks

This property specifies whether or not to use Optimal Asymmetric Encryption Padding (OAEP). By default, this value is False and the struct will use PKCS1.

To specify nondefault OAEP options, please see OAEPRSAHashAlgorithm, OAEPMGF1HashAlgorithm, and OAEPParams

Data Type

bool

use_pss property (AS2Sender Struct)

This property specifies whether or not RSA-PSS will be used during signing and verification.

Syntax

fn use_pss(&self ) -> Result<bool, IPWorksEDIError> 
fn set_use_pss(&self, value : bool) ->  Option<IPWorksEDIError> 

Default Value

false

Remarks

This property specifies whether or not RSA-PSS will be used when signing and verifying messages. The default value is False.

Data Type

bool

user_agent property (AS2Sender Struct)

Information about the user agent.

Syntax

fn user_agent(&self ) -> Result<String, IPWorksEDIError> 
fn set_user_agent(&self, value : &str) ->  Option<IPWorksEDIError> 
fn set_user_agent_ref(&self, value : &String) ->  Option<IPWorksEDIError> 

Default Value

"IPWorks EDI AS2Sender Component - www.nsoftware.com"

Remarks

You may override the default with the name and version of your software.

Data Type

String

config method (AS2Sender Struct)

Sets or retrieves a configuration setting.

Syntax

fn config(&self, configuration_string : &str) ->  Result<String, IPWorksEDIError>

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_events method (AS2Sender Struct)

This method processes events from the internal message queue.

Syntax

fn do_events(&self) -> Result<(), IPWorksEDIError>

Remarks

When do_events is called, the struct processes any available events. If no events are available, it waits for a preset period of time, and then returns.

interrupt method (AS2Sender Struct)

This method interrupts the current method.

Syntax

fn interrupt(&self) -> Result<(), IPWorksEDIError>

Remarks

If there is no method in progress, interrupt simply returns, doing nothing.

post method (AS2Sender Struct)

Post data to the AS2 server, and check the receipt.

Syntax

fn post(&self) -> Result<(), IPWorksEDIError>

Remarks

Post data to the server. The reply will also be checked, and if a synchronous MDN was requested (i.e., mdn_to is not empty), it will be validated. After the method finishes, the mdn_receipt, ReceiptSigningProtocol, and receipt_signer_cert properties will be populated with the appropriate values.

The method operates synchronously, and will throw an exception if any errors or warnings occur. Errors might include a failure to decrypt or authenticate the receipt, the absence of an MDN when one was requested, TCP/IP errors, or any errors reported by the server in the MDN. Warnings might include the return of an unsigned receipt when a signed receipt was requested, or other warnings reported by the server in the MDN.

If an exception is thrown the error code will correspond to the severity of the warning or error, allowing client software to determine whether or not to accept the reply. If multiple errors occur, the exception will return a special error code, and the error message will contain a line for each error's code and description; i.e. "423: Failed to authenticate sender". If the error(s) is/are not fatal processing will not be interrupted, and the relevant properties will be populated as normal.

read_async_receipt method (AS2Sender Struct)

Reads an asynchronous MDN receipt from the current HTTP session.

Syntax

fn read_async_receipt(&self) -> Result<(), IPWorksEDIError>

Remarks

This method is reserved for future use. Instead, assign the body and headers of the request to mdn_receipt_content and mdn_receipt_headers, in that order. Setting mdn_receipt_headers will parse the receipt automatically.

reset method (AS2Sender Struct)

Resets the state of the control.

Syntax

fn reset(&self) -> Result<(), IPWorksEDIError>

Remarks

Resets all HTTP headers as well as edi_data, etc. After invoking this method the struct may be reused as if it were newly created.

restart method (AS2Sender Struct)

Restart sending of the file specified by the Etag property.

Syntax

fn restart(&self) -> Result<(), IPWorksEDIError>

Remarks

This method should be called when using the AS2 restart functionality. When called, the struct will process the file and cache the processed contents to the restart_directory. Before sending, the etag property will be populated with a unique etag which identifies the processed file.

If sending is interrupted or fails, this method should be called to restart sending of the previously processed file starting where the interruption occurred. In order to restart from the last transfer, the etag must be populated with the value from the last connection.

NOTE: When using restart functionality, the data is completely processed to the restart_directory before sending begins.

send_cem_request method (AS2Sender Struct)

Sends a Certificate Exchange Messaging (CEM) request.

Syntax

fn send_cem_request(&self, request_id : &str) -> Result<(), IPWorksEDIError>

Remarks

This method send the Certificate Exchange Messaging (CEM) request with the details specified in cem_details.

Certificate Exchange Messaging (CEM) allows for new certificates to be sent to a recipient and be automatically updated. This removes the requirement to manually send new certificates to a partner via email or other means. When both sides support this functionality updating certificates can be accomplished in a short period of time.

To prepare a CEM request populate the cem_details collection with at least one certificate. For instance if the certificate of the application will be updated soon, the cem_details may be populated with the corresponding public certificate to be sent to your partner. cem_details should only contain public certificates.

Set cem_respond_by_date to the date by which you expect a response. The format is of the XML standard dateTime type expressed in local time with UTC offset. For instance: "2005-08-31T00:21:00-05:00".

Optionally set cem_cert_id to a friendly identifier that the partner may use to help understand the purpose of the new certificate. For instance "New.Encryption.Cert.2014".

Set cem_response_url to the publicly accessible URL where the CEM response will be sent after the partner processes it.

The RequestId parameter uniquely identifies this CEM request and must be saved for use later when receiving the CEM response.

When calling this method the applicable cem_details properties are:

• cem_cert_store_type
• cem_cert_store
• cem_cert_store_password
• cem_cert_subject
• cem_respond_by_date
• cem_response_url
• cem_cert_usage (optional)
• cem_cert_id (optional)

send_cem_response method (AS2Sender Struct)

Sends a Certificate Exchange Messaging (CEM) response.

Syntax

fn send_cem_response(&self, request_id : &str) -> Result<(), IPWorksEDIError>

Remarks

This method send the Certificate Exchange Messaging (CEM) request with the details specified in cem_details.

A CEM request must have previously been received using AS2Receiver. To send the CEM response, populate cem_details with the certificate information and decide whether to accept or reject the request. The following properties may be set to specify the certificate:

• cem_cert_store_type
• cem_cert_store
• cem_cert_subject

Alternatively, the certificate information may be set:

• cem_cert_issuer
• cem_cert_serial_number

After specifying the certificate information choose whether to accept or reject the request. To accept the request set cem_accepted to True. To reject the request set cem_accepted to False and specify a reason in cem_rejection_reason.

Call send_cem_response and pass the CEM request Id that was retrieved from the request.

set_request_header method (AS2Sender Struct)

Allows the user to set or add arbitrary HTTP request headers.

Syntax

fn set_request_header(&self, header_name : &str, header_value : &str) -> Result<(), IPWorksEDIError>

Remarks

HeaderName should contain the header name, and HeaderValue should contain its value. Use this to set headers such as To, Date, etc. Note that a default value for Date will automatically be determined and this method may be used to override the default.

SetRequestHeader may be used to set any header except for the following: AS2-To, AS2-From, AS2-Version, Subject, Message-Id, Disposition-Notification-To, Disposition-Notification-Options, Receipt-Delivery-Option, Host, Content-Length.

set_tp_info method (AS2Sender Struct)

A convenient way to set AS2 communication parameters using XML strings.

Syntax

fn set_tp_info(&self, profile : &str) -> Result<(), IPWorksEDIError>

Remarks

SetTPInfo offers a convenient way to set AS2 communication parameters using XML strings. The format of the XML is the same as provided by the method GetTPInfo of AS2ProfileMgr.

The "self" information should always precede the partner information as shown below. AS2Sender as2sender = new AS2Sender(); AS2Profilemgr mgr = new AS2Profilemgr(); mgr.DataDir = @"C:\as2data"; as2sender.SetTPInfo(mgr.GetTPInfo("self")); as2sender.SetTPInfo(mgr.GetTPInfo("partnerOrg")); as2sender.EDIFile = @"C:\as2Data.x12"; as2sender.Post();

verify_receipt method (AS2Sender Struct)

Verifies an asynchronous MDN receipt.

Syntax

fn verify_receipt(&self) -> Result<(), IPWorksEDIError>

Remarks

VerifyReceipt verifies the receipt in mdn_receipt against original_content_mic, message_id and the preferences specified in mdn_options. The method operates similarly to post: After the method finishes, the mdn_receipt, ReceiptSigningProtocol, and receipt_signer_cert properties will be populated with the appropriate values.

The method operates synchronously, and will throw an exception if any errors or warnings occur. Errors might include a failure to decrypt or authenticate the receipt, the absence of an MDN when one was requested, TCP/IP errors, or any errors reported by the server in the MDN. Warnings might include the return of an unsigned receipt when a signed receipt was requested, or other warnings reported by the server in the MDN.

If an exception is thrown the error code will correspond to the severity of the warning or error, allowing client software to determine whether or not to accept the reply. If multiple errors occur, the exception will return a special error code, and the error message will contain a line for each error's code and description; i.e. "423: Failed to authenticate sender". If the error(s) is/are not fatal processing will not be interrupted, and the relevant properties will be populated as normal.

This method should be used to verify receipts received asynchronously; i.e., not in the HTTP reply to a POST. When posting, asynchronous MDN delivery may be requested by setting mdn_delivery_option.

on_connected event (AS2Sender Struct)

Fired immediately after a connection completes (or fails).

Syntax

// AS2SenderConnectedEventArgs carries the AS2Sender Connected event's parameters.
pub struct AS2SenderConnectedEventArgs {
  fn status_code(&self) -> i32
  fn description(&self) -> &String
}

// AS2SenderConnectedEvent defines the signature of the AS2Sender Connected event's handler function.
pub trait AS2SenderConnectedEvent {
  fn on_connected(&self, sender : AS2Sender, e : &mut AS2SenderConnectedEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_connected(&self) -> &'a dyn AS2SenderConnectedEvent;
  pub fn set_on_connected(&mut self, value : &'a dyn AS2SenderConnectedEvent);
  ...
}

Remarks

If the connection is made normally, status_code is 0 and description is "OK".

If the connection fails, status_code has the error code returned by the Transmission Control Protocol (TCP)/IP stack. description contains a description of this code. The value of status_code is equal to the value of the error.

Please refer to the Error Codes section for more information.

on_disconnected event (AS2Sender Struct)

Fired when a connection is closed.

Syntax

// AS2SenderDisconnectedEventArgs carries the AS2Sender Disconnected event's parameters.
pub struct AS2SenderDisconnectedEventArgs {
  fn status_code(&self) -> i32
  fn description(&self) -> &String
}

// AS2SenderDisconnectedEvent defines the signature of the AS2Sender Disconnected event's handler function.
pub trait AS2SenderDisconnectedEvent {
  fn on_disconnected(&self, sender : AS2Sender, e : &mut AS2SenderDisconnectedEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_disconnected(&self) -> &'a dyn AS2SenderDisconnectedEvent;
  pub fn set_on_disconnected(&mut self, value : &'a dyn AS2SenderDisconnectedEvent);
  ...
}

Remarks

If the connection is broken normally, status_code is 0 and description is "OK".

If the connection is broken for any other reason, status_code has the error code returned by the Transmission Control Protocol (TCP/IP) subsystem. description contains a description of this code. The value of status_code is equal to the value of the TCP/IP error.

Please refer to the Error Codes section for more information.

on_end_transfer event (AS2Sender Struct)

Fired when a document finishes transferring.

Syntax

// AS2SenderEndTransferEventArgs carries the AS2Sender EndTransfer event's parameters.
pub struct AS2SenderEndTransferEventArgs {
  fn direction(&self) -> i32
}

// AS2SenderEndTransferEvent defines the signature of the AS2Sender EndTransfer event's handler function.
pub trait AS2SenderEndTransferEvent {
  fn on_end_transfer(&self, sender : AS2Sender, e : &mut AS2SenderEndTransferEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_end_transfer(&self) -> &'a dyn AS2SenderEndTransferEvent;
  pub fn set_on_end_transfer(&mut self, value : &'a dyn AS2SenderEndTransferEvent);
  ...
}

Remarks

This event is fired first when the client finishes sending data to the server (in a POST or PUT request) and then when the document text finishes transferring from the server to the local host.

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

on_error event (AS2Sender Struct)

Fired when information is available about errors during data delivery.

Syntax

// AS2SenderErrorEventArgs carries the AS2Sender Error event's parameters.
pub struct AS2SenderErrorEventArgs {
  fn error_code(&self) -> i32
  fn description(&self) -> &String
}

// AS2SenderErrorEvent defines the signature of the AS2Sender Error event's handler function.
pub trait AS2SenderErrorEvent {
  fn on_error(&self, sender : AS2Sender, e : &mut AS2SenderErrorEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_error(&self) -> &'a dyn AS2SenderErrorEvent;
  pub fn set_on_error(&mut self, value : &'a dyn AS2SenderErrorEvent);
  ...
}

Remarks

The on_error event is fired in case of exceptional conditions during message processing. Normally the struct fails with an error.

The error_code parameter contains an error code, and the description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

on_header event (AS2Sender Struct)

Fired every time a header line comes in.

Syntax

// AS2SenderHeaderEventArgs carries the AS2Sender Header event's parameters.
pub struct AS2SenderHeaderEventArgs {
  fn field(&self) -> &String
  fn value(&self) -> &String
}

// AS2SenderHeaderEvent defines the signature of the AS2Sender Header event's handler function.
pub trait AS2SenderHeaderEvent {
  fn on_header(&self, sender : AS2Sender, e : &mut AS2SenderHeaderEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_header(&self) -> &'a dyn AS2SenderHeaderEvent;
  pub fn set_on_header(&mut self, value : &'a dyn AS2SenderHeaderEvent);
  ...
}

Remarks

The Field parameter contains the name of the HTTP header (same case as it is delivered). The Value parameter contains the header contents.

If the header line being retrieved is a continuation header line, then the Field parameter contains an empty string.

Note that only the top-level headers will be returned through this event, and that they are available through the reply_headers property.

The field parameter contains the name of the HTTP header (which is the same as it is delivered). The value parameter contains the header contents.

If the header line being retrieved is a continuation header line, then the field parameter contains "" (empty string).

on_log event (AS2Sender Struct)

Fired with log information while processing a message.

Syntax

// AS2SenderLogEventArgs carries the AS2Sender Log event's parameters.
pub struct AS2SenderLogEventArgs {
  fn log_type(&self) -> &String
  fn log_message(&self) -> &[u8]
}

// AS2SenderLogEvent defines the signature of the AS2Sender Log event's handler function.
pub trait AS2SenderLogEvent {
  fn on_log(&self, sender : AS2Sender, e : &mut AS2SenderLogEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_log(&self) -> &'a dyn AS2SenderLogEvent;
  pub fn set_on_log(&mut self, value : &'a dyn AS2SenderLogEvent);
  ...
}

Remarks

This event fires once for each log message generated by the struct. The verbosity is controlled by the LogLevel setting.

Log messages available through this event correspond to log files written to log_directory. This event provides a way to obtain log messages without relying on files on disk. This event fires regardless of the value of log_directory (i.e. when log_directory is empty the event will still fire).

The LogMessage event parameter holds the raw log data.

The LogType event parameter indicates the type of log. Possible values are:

on_set_cookie event (AS2Sender Struct)

Fired for every cookie set by the server.

Syntax

// AS2SenderSetCookieEventArgs carries the AS2Sender SetCookie event's parameters.
pub struct AS2SenderSetCookieEventArgs {
  fn name(&self) -> &String
  fn value(&self) -> &String
  fn expires(&self) -> &String
  fn domain(&self) -> &String
  fn path(&self) -> &String
  fn secure(&self) -> bool
}

// AS2SenderSetCookieEvent defines the signature of the AS2Sender SetCookie event's handler function.
pub trait AS2SenderSetCookieEvent {
  fn on_set_cookie(&self, sender : AS2Sender, e : &mut AS2SenderSetCookieEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_set_cookie(&self) -> &'a dyn AS2SenderSetCookieEvent;
  pub fn set_on_set_cookie(&mut self, value : &'a dyn AS2SenderSetCookieEvent);
  ...
}

Remarks

This event is fired for every Set-Cookie: header received from the HTTP server.

The name parameter contains the name of the cookie, with the corresponding value supplied in the value parameter.

The expires parameter contains an expiration time for the cookie (if provided by the server). The time format used is "Weekday, DD-Mon-YY HH:MM:SS GMT". If the server does not provide an expiration time, the expires parameter will be an empty string. In this case, the convention is to drop the cookie at the end of the session.

The domain parameter contains a domain name to limit the cookie to (if provided by the server). If the server does not provide a domain name, the domain parameter will be an empty string. The convention in this case is to use the server specified in the URL (url_server) as the cookie domain.

The path parameter contains a path name to limit the cookie to (if provided by the server). If the server does not provide a cookie path, the path parameter will be an empty string. The convention in this case is to use the path specified in the URL (url_path) as the cookie path.

The secure parameter specifies whether the cookie is secure. If the value of this parameter is True, the cookie value must be submitted only through a secure (HTTPS) connection.

on_ssl_server_authentication event (AS2Sender Struct)

Fired after the server presents its certificate to the client.

Syntax

// AS2SenderSSLServerAuthenticationEventArgs carries the AS2Sender SSLServerAuthentication event's parameters.
pub struct AS2SenderSSLServerAuthenticationEventArgs {
  fn cert_encoded(&self) -> &[u8]
  fn cert_subject(&self) -> &String
  fn cert_issuer(&self) -> &String
  fn status(&self) -> &String
  fn accept(&self) -> bool
  fn set_accept(&self, value : bool)
}

// AS2SenderSSLServerAuthenticationEvent defines the signature of the AS2Sender SSLServerAuthentication event's handler function.
pub trait AS2SenderSSLServerAuthenticationEvent {
  fn on_ssl_server_authentication(&self, sender : AS2Sender, e : &mut AS2SenderSSLServerAuthenticationEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_ssl_server_authentication(&self) -> &'a dyn AS2SenderSSLServerAuthenticationEvent;
  pub fn set_on_ssl_server_authentication(&mut self, value : &'a dyn AS2SenderSSLServerAuthenticationEvent);
  ...
}

Remarks

This event is where the client can decide whether to continue with the connection process or not. The Accept parameter is a recommendation on whether to continue or close the connection. This is just a suggestion: application software must use its own logic to determine whether to continue or not.

When Accept is False, Status shows why the verification failed (otherwise, Status contains the string "OK").

on_ssl_status event (AS2Sender Struct)

Fired when secure connection progress messages are available.

Syntax

// AS2SenderSSLStatusEventArgs carries the AS2Sender SSLStatus event's parameters.
pub struct AS2SenderSSLStatusEventArgs {
  fn message(&self) -> &String
}

// AS2SenderSSLStatusEvent defines the signature of the AS2Sender SSLStatus event's handler function.
pub trait AS2SenderSSLStatusEvent {
  fn on_ssl_status(&self, sender : AS2Sender, e : &mut AS2SenderSSLStatusEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_ssl_status(&self) -> &'a dyn AS2SenderSSLStatusEvent;
  pub fn set_on_ssl_status(&mut self, value : &'a dyn AS2SenderSSLStatusEvent);
  ...
}

Remarks

The event is fired for informational and logging purposes only. This event tracks the progress of the connection.

on_start_transfer event (AS2Sender Struct)

Fired when a document starts transferring (after the headers).

Syntax

// AS2SenderStartTransferEventArgs carries the AS2Sender StartTransfer event's parameters.
pub struct AS2SenderStartTransferEventArgs {
  fn direction(&self) -> i32
}

// AS2SenderStartTransferEvent defines the signature of the AS2Sender StartTransfer event's handler function.
pub trait AS2SenderStartTransferEvent {
  fn on_start_transfer(&self, sender : AS2Sender, e : &mut AS2SenderStartTransferEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_start_transfer(&self) -> &'a dyn AS2SenderStartTransferEvent;
  pub fn set_on_start_transfer(&mut self, value : &'a dyn AS2SenderStartTransferEvent);
  ...
}

Remarks

This event is fired first when the client starts sending data to the server (in a POST or PUT request) and then when the document text starts transferring from the server to the local host.

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

on_transfer event (AS2Sender Struct)

Fired while a document transfers (delivers document).

Syntax

// AS2SenderTransferEventArgs carries the AS2Sender Transfer event's parameters.
pub struct AS2SenderTransferEventArgs {
  fn direction(&self) -> i32
  fn bytes_transferred(&self) -> i64
  fn percent_done(&self) -> i32
  fn text(&self) -> &[u8]
}

// AS2SenderTransferEvent defines the signature of the AS2Sender Transfer event's handler function.
pub trait AS2SenderTransferEvent {
  fn on_transfer(&self, sender : AS2Sender, e : &mut AS2SenderTransferEventArgs);
}

impl <'a> AS2Sender<'a> {
  pub fn on_transfer(&self) -> &'a dyn AS2SenderTransferEvent;
  pub fn set_on_transfer(&mut self, value : &'a dyn AS2SenderTransferEvent);
  ...
}

Remarks

The text parameter contains the portion of the document text being received. It is empty if data are being posted to the server.

The bytes_transferred parameter contains the number of bytes transferred in this direction since the beginning of the document text (excluding HTTP response headers).

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

The PercentDone parameter shows the progress of the transfer in the corresponding direction. If PercentDone can not be calculated the value will be -1.

NOTE: Events are not re-entrant. Performing time-consuming operations within this event will prevent it from firing again in a timely manner and may affect overall performance.

Config Settings (AS2Sender 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.

AS2Sender Config Settings

HTTP Config Settings

TCPClient Config Settings

SSL Config Settings

Socket Config Settings

Base Config Settings

Trappable Errors (AS2Sender Struct)

AS2Sender Errors

SMIME Errors