Contact Us 1-800-596-4880

AS2 Connector 6.5 Reference - Mule 4

Anypoint Connector for AS2 (AS2 Connector) enables trading partners to transmit and receive AS2 messages that contain EDI-X12, EDIFACT, XML, or binary payloads.

Configurations


Listener Config

General Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types for this configuration.

x

HTTP Listener

String

Reference to global HTTP Listener definition for our service endpoint used by partner for both action and signal messages.

x

Security Requirement Level

Enumeration, one of:

  • SIGNED

  • ENCRYPTED

  • SIGNED_ENCRYPTED

The security level required for any AS2 Listener using this configuration for all incoming messages. An error MDN response results if the security requirement is not met.

Keystore Password

String

The password of the provided keystore.

x

Keystore Path

String

The Absolute or relative path to the keystore containing certificates and private keys for self (this application) and the partner.

x

Private Key Password

String

If the private key to be used for signing/encryption is password protected, provide that value here.

Validate certificate expiration date

Boolean

If enabled, the connector can’t receive or send messages if the certificate is expired.

false

Warning before (days)

Number

The number of days before the certificate expiration date when the connector sends a warning message that the certificate is about to expire. For example, if the value of this field is 3, then the connector sends a warning message three days before the certificate expiration date.

This field applies only when the value of this field is greater than 0 and the Validate certificate expiration date field is enabled.

30

Partners Parameters

Name Type Description Default Value Required

Inbound Request Authentication

Authentication method to use for verifying the incoming HTTP request when using dedicated mode.

Do not select this field if you are using shared mode or you will receive an error.

Self config - AS2 Partner Name

String

AS2 system identifier used for AS2-From and AS2-To headers.

x

Self config - x509 Alias

String

Certificate, private key alias, or both in the keystore. Required if using signing or encryption.

Self config - email

String

Email address used as the HTTP From header when sending AS2 messages.

x

Self config - Listener Mode

Enumeration, one of:

  • Dedicated mode

  • Shared mode

  • Dedicated mode

    Enables you to configure a single AS2 listener endpoint to receive messages from one partner only.

    If you select Dedicated mode, check Partner config (mandatory) and configure the partner using the Dedicated mode fields in this table.

  • Shared Mode

    Enables you to configure a single AS2 listener endpoint to receive messages from multiple partners.

    If you select Shared mode, uncheck Partner config (mandatory) and configure each partner using the Shared mode fields in this table.

Dedicated mode

x

Dedicated mode - Partner Config - AS2 Partner Name

String

AS2 system identifier used for AS2-From and AS2-To headers.

x

Dedicated mode - Partner Config - x509 Alias

String

Certificate, private key alias, or both in the keystore. Required if using signing or encryption.

Dedicated mode - Partner Config - email

String

Email address used as the HTTP From header when sending AS2 messages.

x

Shared mode - Partners

Enumeration, one of:

  • Expression

  • Inline

Indicates whether to add partner information by using an expression or by entering values inline.

Expression

x

Shared mode - Partners - AS2 Partner Name

String

AS2 system identifier used for AS2-From and AS2-To headers.

x

Shared mode - Partners - x509 Alias

String

Certificate, private key alias, or both in the keystore. Required if using signing or encryption.

Shared mode - Partners - email

String

Email address used as the HTTP From header when sending an AS2 message.

x

Shared mode - Inbound Request Authentication

Authentication method to use for verifying the incoming HTTP request.

Advanced Parameters

Name Type Description Default Value Required

Check for duplicate messages

Checks for duplicate messages:

  • If selected, the connector checks to see if a new received message is duplicated, as determined by comparing the following values in the new message to those in existing messages:

    • Sender (from the AS2-From field)

    • Receiver (from the AS2-To field)

    • Message ID (from the Message-Id field)

    If all three values match an existing message, the connector rejects the duplicate message. If selected, you must:

    • Reference a global object store in the Object Store field. This object store will store the existing messages.

    • Add the object store dependency to your project by adding the ObjectStore component to the Studio canvas or adding it to the pom.xml, as follows:

      <dependency>
        <groupId>org.mule.connectors</groupId>
        <artifactId>mule-objectstore-connector</artifactId>
        <version>_latest-version_</version>
        <classifier>mule-plugin</classifier>
      </dependency>

      For the latest object store version, see the Object Store Connector Release Notes.

      If the MDN mode is AUTO, use the Idempotent Message Validator instead of the Check for duplicate messages field to check for duplicate messages. If the MDN mode is IMMEDIATE, the validator does not work. Therefore, in this circumstance, you must use the Check for duplicate messages field to check for duplicate messages. For more information, see Idempotent Message Validator.

    • If deselected, the connector accepts duplicate messages.

false

Object Store

Object Store

Object store where the connector stores new messages. This field is mandatory if the Check for duplicate messages field is selected.

For information about setting field values for this object store, see the Object Store Connector Reference.

You might experience limitations that are specific to the object store implementation you are using (Anypoint Object Store V2 (OSv2), CloudHub Object Store V1 (OSv1), or Mule Object Store), so configure the object store to suit your needs. For more information, see The Different Types of Object Stores Explained.

Expiration policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

Connection Types

Async MDN Connection Provider
Parameters
Name Type Description Default Value Required

Use Persistent Connections

Boolean

If false, each connection is closed after the first request completes.

false

Connection Timeout

Number

How long the connector waits before timing out when establishing a connection to the remote service. This value is qualified by the Connection Timeout Units field.

30

Connection Timeout Units

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the value of the Connection Timeout field.

SECONDS

Max Connections

Number

The maximum number of outbound connections to keep open at the same time. By default, the number of connections is unlimited.

-1

Connection Idle Timeout

Number

A timeout for how long a connection can remain idle before it is closed. The value of this attribute is only used when persistent connections are enabled. This value is qualified by the Connection Idle Timeout Units field.

30

Connection Idle Timeout Units

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the value of the Connection Idle Timeout field.

MINUTES

Retry Interval

Number

The interval between each retry, in seconds.

60

Retry Count

Number

The number of retries. A value of 0 means no retries.)

0

Proxy Config

One of:

Reusable configuration element for outbound connections through a proxy. A proxy element must define a host name and a port attributes, and optionally can define a username and password.

TLS Configuration

TLS

Reference to a TLS config element. This enables HTTPS for this configuration.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, the deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Associated Sources


MDN Listener Config

General Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

HTTP Listener

String

Reference to global HTTP Listener definition for our service endpoint used by a partner for both action and signal messages.

x

Keystore Password

String

The password of the provided keystore.

x

Keystore Path

String

The Absolute or relative path to the keystore containing certificates and private keys for self(this application) and the partner.

x

Private Key Password

String

If the private key to use for signing/encryption is password protected, provide that value here.

Validate certificate expiration date

Boolean

If enabled, the connector can’t receive or send messages if the certificate is expired.

false

Warning before (days)

Number

The number of days before the certificate expiration date when the connector sends a warning message that the certificate is about to expire. For example, if the value of this field is 3, then the connector sends a warning message three days before the certificate expiration date.

This field applies only when the value of this field is greater than 0 and the Validate certificate expiration date field is enabled.

30

Advanced Parameters

Name Type Description Default Value Required

Expiration policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

Partners Parameters

Name Type Description Default Value Required

Self config - AS2 Partner Name

String

AS2 system identifier used for AS2-From and AS2-To headers.

x

Self config - x509 Alias

String

Certificate, private key alias, or both in the keystore. Required if using signing or encryption.

Self config - email

String

Email address used as the HTTP From header when sending 12 messages.

x

MDN Listener Mode

Enumeration, one of:

  • Mdn dedicated mode

  • Mdn shared mode

  • Mdn dedicated mode

    Enables you to configure a single AS2 listener endpoint to receive MDNs from one partner only.

    If you select Mdn edicated mode, check Partner config (mandatory) and configure the partner using the Mdn dedicated mode fields in this table.

  • Mdn shared mode

    Enables you to configure a single AS2 listener endpoint to receive MDNs from multiple partners.

    If you select Mdn shared mode, uncheck Partner config (mandatory) and configure each partner using the Mdn shared mode fields in this table.

x

Mdn dedicated mode - Partner Config - AS2 Partner Name

String

AS2 system identifier used for AS2-From and AS2-To headers.

x

Mdn dedicated mode - Partner Config - x509 Alias

String

Certificate, private key alias, or both in the keystore. Required if using signing or encryption.

Dedicated mode

Mdn dedicated mode - Partner Config - email

String

Email address used as the HTTP From header when sending MDNs.

x

Mdn shared mode - Partners - AS2 Partner Name

String

AS2 system identifier used for AS2-From and AS2-To headers.

x

Mdn shared mode - Partners - x509 Alias

String

Certificate, private key alias, or both in the keystore. Required if using signing or encryption.

Mdn shared mode - Partners - email

String

Email address used as the HTTP From header when sending MDNs.

x

Associated Sources


Send Config

This class represents an extension configuration, values set in this class are commonly used across multiple operations since they represent something core from the extension.

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types for this configuration.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

General - Transfer Mode Configuration

Enumeration, one of:

  • Chunked transfer mode

  • Identity transfer mode

  • Threshold transfer mode

The transfer mode applied when sending information:

  • Chunked transfer mode

    Sends the headers without the Content-Length property and modifies the message body to transfer it as a series of chunks.

  • Identity transfer mode

    Sends the headers with the Content-Length property and sends the whole message body.

  • Threshold transfer mode

    Sends the headers and message body according to the specified threshold.

    • If the message body is less than or equal to the threshold, the connector uses the Identity transfer mode option.

    • If the message body is greater than the threshold, the connector uses the Chunked transfer mode option.

Chunked transfer mode

Threshold

Number

Threshold used when the General - Transfer Mode Configuration field is set to Threshold transfer mode.

64

Threshold Unit

Enumeration, one of:

  • Byte

  • GB

  • KB

Unit associated with the Threshold field.

KB

General - Propagate Content Transfer Encoding

Boolean

Indicates whether to propagate the content transfer encoding on the AS2 message sent to the partner:

  • True: The main content transfer encoding is propagated to every MIME part of the resulting message.

  • False: Signed and encrypted MIME parts are encoded with Base64.

False

General - Custom Message ID

String

Enables the specification of a custom AS2 Message ID

Partner Config - AS2 Partner Name

String

AS2 system identifier (used for AS2-From and AS2-To headers)

x

Partner Config - x509 Alias

String

Certificate, private key alias, or both in the keystore (required if using signing or encryption)

Partner Config - email

String

Email address used as HTTP From header when sending

x

Self config - AS2 Partner Name

String

AS2 system identifier (used for AS2-From and AS2-To headers)

x

Self config - x509 Alias

String

Certificate, private key alias or both in keystore (required if using signing or encryption)

Self config - email

String

Email address used as HTTP From header when sending

x

Subject

String

Free form text for MIME Subject header

MIC Signature Algorithm

Enumeration, one of:

  • MD5

  • SHA1

  • SHA224

  • SHA256

  • SHA384

  • SHA512

  • UNSIGNED

Algorithm to use when setting the message integrity check value.

UNSIGNED

MDN MIC Signature Algorithm

Enumeration, one of:

  • MD5

  • SHA1

  • SHA224

  • SHA256

  • SHA384

  • SHA512

  • UNSIGNED

Request partner to respond with a signed MDN using this algorithm for calculating MIC

UNSIGNED

Encryption Algorithm

Enumeration, one of:

  • DES

  • DES_EDE3

  • RC2

  • AES128_CBC

  • AES192_CBC

  • AES256_CBC

  • AES128_CCM

  • AES192_CCM

  • AES256_CCM

  • AES128_GCM

  • AES192_GCM

  • AES256_GCM

  • AES256_WRAP

  • CAST5

  • UNENCRYPTED

The Algorithm to use when encrypting the message to be sent

UNENCRYPTED

Content Transfer Encoding

Enumeration, one of:

  • BASE64

  • QUOTED_PRINTABLE

  • SEVEN_BIT

  • EIGHT_BIT

  • BINARY

The encoding to use on the content of AS2 message being sent.

BINARY

Request A Receipt

Enumeration, one of:

  • NONE

  • UNSIGNED

  • SIGNED_OPTIONAL

  • SIGNED_REQUIRED

How the connector behaves based on the received receipts.

UNSIGNED

Compression Type

Enumeration, one of:

  • NONE

  • ZLIB

The Compression type to use

NONE

Receipt Delivery URL

String

The asynchronous MDN delivery address to which the MDN is returned. This should be the fully formed URL to the As 2 mdn listener source, for example, https://example.com/mdn.

If a flow uses the Send With Async MDN operation, then either this field or the Receipt Delivery URL field associated with that operation is required. If both fields have values, the value for the operation overrides the value for the global configuration.

Keystore Password

String

The password of the provided keystore.

x

Keystore Path

String

The Absolute or relative path to the keystore containing certificates and private keys for self(this application) and the partner.

x

Private Key Password

String

If the private key to use for signing/encryption is password protected, provide that value here.

Validate certificate expiration date

Boolean

If enabled, the connector can’t receive or send messages if the certificate is expired.

false

Warning before (days)

Number

The number of days before the certificate expiration date when the connector sends a warning message that the certificate is about to expire. For example, if the value of this field is 3, then the connector sends a warning message three days before the certificate expiration date.

This field applies only when the value of this field is greater than 0 and the Validate certificate expiration date field is enabled.

30

Connection Types

Outbound Connection Config
Parameters
Name Type Description Default Value Required

Use Persistent Connections

Boolean

If false, each connection is closed after the first request completes.

false

Connection Timeout

Number

How long the connector waits before timing out when establishing a connection to the remote service. This value is qualified by the Connection Timeout Units field.

30

Connection Timeout Units

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the value of the Connection Timeout field.

SECONDS

Max Connections

Number

The maximum number of outbound connections to keep open at the same time. By default the number of connections is unlimited.

-1

Connection Idle Timeout

Number

A timeout for how long a connection can remain idle before it is closed. The value of this attribute is only used when persistent connections are enabled. This value is qualified by the value of the Connection Idle Timeout Units field.

30

Connection Idle Timeout Units

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the value of the Connection Idle Timeout field.

MINUTES

Proxy Config

One of:

Reusable configuration element for outbound connections through a proxy. A proxy element must define a host name and a port attributes, and optionally can define a username and a password.

Partner URL

String

Service endpoint URL to the partner.

x

Outbound Request Authentication

HttpRequestAuthentication

Authentication method to use for the HTTP request.

TLS Configuration

TLS

Reference to a TLS config element. This enables HTTPS for this configuration.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, the deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Sources

As2 Listener

<as2-mule4:as2-listener>

Represents a listener for AS2 sender requests.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Path

String

This path is appended to any path set in the listener configuration.

/

Connection Timeout

Number

An override for the timeout for establishing connections to the remote service as milliseconds. The default of 0 means this value is not used to override the configuration.

0

Non repudiation flow ref

String

The name of the configured flow that contains the Non repudiation listener source.

Mdn mode

Enumeration, one of:

  • AUTO

  • IMMEDIATE

MDN deliver mode:

  • AUTO: Sends an MDN at the end of the flow.

  • IMMEDIATE: Sends an MDN when the source receives a message.

IMMEDIATE

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Primary Node Only

Boolean

Whether to execute this source on only the primary node when running in a cluster.

Streaming Strategy

Configures how Mule processes streams. The default is to use repeatable streams.

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Reconnection Strategy

Configures a reconnection strategy to use when a connector operation fails to connect to an external server.

Output

Type

Binary

Attributes Type

For Configurations

As2 Mdn Listener

<as2-mule4:as2-mdn-listener>

Listens for AS2 requests and automatically sends an MDN back to the receipt URL provided in the transmission when a request is received.

If the receipt URL is inaccessible, the inbound AS2 message is not processed.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Path

String

This path is appended to any path set in the listener configuration.

/

Non repudiation flow ref

String

The name of the configured flow that contains the Non repudiation listener source.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Primary Node Only

Boolean

Whether to execute this source on only the primary node when running in a cluster.

Streaming Strategy

Configures how Mule processes streams. The default is to use repeatable streams.

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Output

Type

Binary

Attributes Type

For Configurations

Non repudiation listener

<as2-mule4:non-repudiation-listener>

Receives a signed copy of a receipt or a message for persistent non-repudiation storage.

Parameters

Name Type Description Default Value Required

Display Name

String

The name of this configuration. Connectors reference the configuration with this name.

x

Mime Type

String

The MIME type of the payload passed to this flow.

Encoding

String

The encoding of the payload passed to this flow.

Redelivery Policy

Defines a policy for processing the redelivery of the same message.

Streaming Strategy

Configures how Mule processes streams. The default is to use repeatable streams.

Primary Node Only

Boolean

Whether to execute this source on only the primary node when running in a cluster.

Output

Type

Binary

Attributes Type

Attributes Type

For Configurations

None.

Operations

Send With Async Mdn

<as2-mule4:send-with-async-mdn>

Performs the send async request using the configuration, client, and AS2 requester parameters, and completes the callback accordingly.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

General - Custom Message ID

String

Enables the specification of a custom AS2 Message ID.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configures how Mule processes streams. The default is to use repeatable streams.

AS2 MIME Type

String

The content type of the Document being sent via AS2 (for example, application/EDI-X12). There are no restrictions on the content-type that are supported.

#[payload.^mimeType]

Content Stream

Binary

The content InputStream to be sent.

#[payload]

Content Description

String

Content MIME part content description

File Name

String

Filename of the content stream. If not set, the content is transferred without a filename.

Request Receipt

Enumeration, one of:

  • NONE

  • UNSIGNED

  • SIGNED_OPTIONAL

  • SIGNED_REQUIRED

How the connector behaves based on the received receipts:

  • NONE: No receipt is expected.

  • SIGNED_OPTIONAL: Receipt can be signed or unsigned.

  • SIGNED_REQUIRED: Expects a signed receipt. The application fails if the receipt is unsigned.

  • UNSIGNED: Expects an unsigned receipt.

Require Processed

Boolean

Requires a processed response in the MDN to continue the flow. An error occurs if the response is unprocessed.

true

Connection Timeout

Number

Override for the timeout for establishing connections to the remote service as milliseconds. The default of 0 means this value is not used to override the configuration.

0

Non repudiation flow ref

String

Name of the configured flow that contains the Non repudiation listener source.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Reconnection Strategy

Configures a reconnection strategy to use when a connector operation fails to connect to an external server.

Custom headers

String

Enables you to add custom keys to include in outbound AS2 messages. For each key to include, enter values for these name-value pairs:

  • Name

    Name of the key to send to outbound AS2 messages, formatted as Name:key-name

  • Value

    Content of the key to send to outbound AS2 messages, formatted as Value:key-value

Receipt Delivery URL

String

The asynchronous MDN delivery address to which the MDN is returned. This should be the fully formed URL to the As 2 mdn listener source, for example, https://example.com/mdn.

If a flow uses the Send With Async MDN operation, then either this field or the Receipt Delivery URL field associated with that operation is required. If both fields have values, the value for the operation overrides the value for the global configuration.

Output

Type

Binary

Attributes Type

For Configurations

Throws

  • AS2-MULE4:CONFIGURATION

  • AS2-MULE4:UNAUTHORIZED

  • AS2-MULE4:CONNECTIVITY

  • AS2-MULE4:RETRY_EXHAUSTED

Send With Sync Mdn

<as2-mule4:send-with-sync-mdn>

Performs the send sync request using the configuration, client, and AS2 requester parameters, and completes the callback accordingly.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

General - Custom Message ID

String

Enables the specification of a custom AS2 Message ID.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configures how Mule processes streams. The default is to use repeatable streams.

AS2 MIME Type

String

The content type of the Document being sent via AS2 (for example, application/EDI-X12). There are no restrictions on the content-type that are supported.

#[payload.^mimeType]

Content Stream

Binary

The content InputStream to be sent.

#[payload]

Content Description

String

Content MIME part content description

File Name

String

Filename of the content stream. If not set, the content is transferred without a filename.

Request Receipt

Enumeration, one of:

  • NONE

  • UNSIGNED

  • SIGNED_OPTIONAL

  • SIGNED_REQUIRED

How the connector behaves based on the received receipts:

  • NONE: No receipt is expected.

  • SIGNED_OPTIONAL: Receipt can be signed or unsigned.

  • SIGNED_REQUIRED: Expects a signed receipt. The application fails if the receipt is unsigned.

  • UNSIGNED: Expects an unsigned receipt.

Require Processed

Boolean

Requires a processed response in the MDN to continue the flow. An error occurs if the response is unprocessed.

true

Require Processed

Boolean

Require Processed response in the MDN to continue the flow (otherwise there is an error)

true

Connection Timeout

Number

An override for the timeout for establishing connections to the remote service as milliseconds. The default of 0 means this value is not used to override the configuration.

0

Non repudiation flow ref

String

The name of the configured flow that contains the Non repudiation listener source.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Reconnection Strategy

Configures a reconnection strategy to use when a connector operation fails to connect to an external server.

Custom headers

String

Enables you to add custom keys to include in outbound AS2 messages. For each key to include, enter values for these name-value pairs:

  • Name

    Name of the key to send to outbound AS2 messages, formatted as Name:key-name

  • Value

    Content of the key to send to outbound AS2 messages, formatted as Value:key-value

Output

Type

Binary

Attributes Type

For Configurations

Throws

  • AS2-MULE4:CONFIGURATION

  • AS2-MULE4:MIME_PARSE

  • AS2-MULE4:UNAUTHORIZED

  • AS2-MULE4:CONNECTIVITY

  • AS2-MULE4:SIGNATURE_VERIFY

  • AS2-MULE4:RETRY_EXHAUSTED

Types

AS2 Basic Authentication

Field Type Description Default Value Required

Username

String

Username to authenticate.

x

Password

String

Password of user to authenticate.

x

AS2 Listener Attributes

Field Type Description Default Value Required

As2 Message Id

String

AS2 unique message ID from receiver to sender.

x

filename

String

Received filename.

x

Mime Type

String

MIME type, for example, application/xml.

x

From Name

String

AS2 Receiver name.

x

Headers

Object

AS2 HTTP headers that elaborate the message format.

x

Mdn Delivery Status

Enumeration, one of:

  • NONE

  • SUCCESS

  • FAILURE

AS2 message validation status

x

To Name

String

AS2 Sender name

x

AS2 Mdn Attributes

Field Type Description Default Value Required

As2 Message Id

String

AS2 unique message ID from receiver to sender.

x

Disposition Content

Object

AS2 processed MDN report as headers.

x

From Name

String

AS2 Receiver name

x

Headers

Object

AS2 HTTP headers that elaborate the message format.

x

Mdn Alg

Enumeration, one of:

  • MD5

  • SHA1

  • SHA224

  • SHA256

  • SHA384

  • SHA512

  • UNSIGNED

AS2 message integrity check algorithm used

x

Mdn Mic

String

AS2 message integrity check hashcode

x

Mdn Processed

Boolean

AS2 message validation status

false

Original AS2 Message Id

String

AS2 Message ID received

x

Report Text

String

MDN report text

x

To Name

String

AS2 Sender name

x

AS2 Send Attributes

Field Type Description Default Value Required

As2 Mdn Attributes

AS2 returned MDN attribute group

x

As2 Message Id

String

AS2 unique message ID from receiver to sender

x

From Name

String

AS2 receiver name

x

Headers

Object

AS2 HTTP headers that elaborate the message format

x

Msg MIC

String

AS2 message integrity check hashcode

x

Msg MIC Alg

String

AS2 message integrity check algorithm used

x

To Name

String

AS2 sender name

x

Crl File

Specifies the location of the certification revocation list (CRL) file.

Field Type Description Default Value Required

Path

String

Path to the CRL file.

Custom Ocsp Responder

Configures a custom OCSP responder for certification revocation checks.

Field Type Description Default Value Required

Url

String

URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.

Expiration Policy

Field Type Description Default Value Required

Max Idle Time

Number

Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the value of the Max Idle Time field.

Failure Status Code Validator

Field Type Description Default Value Required

Values

String

Comma-separated list of status codes that cause errors to be thrown.

x

KeyStore

Configures the keystore for TLS.

Field Type Description Default Value Required

Path

String

Path to the keystore. Mule resolves the path relative to the current classpath and file system.

Type

String

Type of keystore.

Alias

String

Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file.

Key Password

String

Password used to protect the private key.

Password

String

Password used to protect the keystore.

Algorithm

String

Encryption algorithm that the keystore uses.

NTLM Proxy

Field Type Description Default Value Required

Ntlm Domain

String

Domain of the NTLM proxy server.

x

Host

String

Hostname or IP address of the NTLM proxy server.

x

Port

Number

Port of the NTLM proxy server.

x

Username

String

Username to authenticate against the proxy server.

Password

String

Password to authenticate against the proxy server.

Non Proxy Hosts

String

NTLM hosts that the connector can access without using a proxy server.

Proxy

Field Type Description Default Value Required

Host

String

Hostname or IP address of the proxy server.

x

Port

Number

Port of the proxy server.

x

Username

String

Username to authenticate against the proxy server.

Password

String

Password to authenticate against the proxy server.

Non Proxy Hosts

String

Hosts that the connector can access without using a proxy server.

Reconnect

Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.

Field Type Description Default Value Required

Frequency

Number

How often to attempt to reconnect, in milliseconds.

Reconnection Attempts

Number

How many reconnection attempts to make.

Blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Reconnect Forever

Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.

Field Type Description Default Value Required

Frequency (ms)

Number

How often to reconnect, in milliseconds

Blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Reconnection

Configures a reconnection strategy for an operation.

Field Type Description Default Value Required

Fails Deployment

Boolean

What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:

  • true: Allow the deployment to fail.

  • false: Ignore the results of the connectivity test.

Reconnection Strategy

The reconnection strategy to use.

Redelivery Policy

Field Type Description Default Value Required

Max Redelivery Count

Number

The maximum number of times a message can be redelivered and processed unsuccessfully before triggering a process-failed message.

Use Secure Hash

Boolean

Whether to use a secure hash algorithm to identify a redelivered message.

Message Digest Algorithm

String

The secure hashing algorithm to use. If not set, the default is SHA-256.

Id Expression

String

Defines one or more expressions to use to determine when a message has been redelivered. This property can be set only if useSecureHash is false.

Object Store

Object Store

The object store where the redelivery counter for each message is stored.

Repeatable File Store Stream

Field Type Description Default Value Required

In Memory Size

Number

Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:

  • Configure a larger buffer size to avoid the number of times Mule needs to write the buffer on disk.

    This increases performance, but it also limits the number of concurrent requests your application can process, because it requires additional memory.

  • Configure a smaller buffer size to decrease memory load at the expense of response time.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which the value of In Memory Size is expressed

Repeatable In Memory Stream

Configures the in-memory streaming strategy by which the request fails if the data exceeds the value of the MAX Buffer Size field. Always run performance tests to find the optimal buffer size for your specific use case.

Field Type Description Default Value Required

Initial Buffer Size

Number

Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of the In Memory Size value.

Buffer Size Increment

Number

This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full.

Max Buffer Size

Number

Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a STREAM_MAXIMUM_SIZE_EXCEEDED error. A value of less than or equal to 0 means no limit.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit for the Initial Buffer Size, Buffer Size Increment, and Max Buffer Size fields.

Standard Revocation Check

Field Type Description Default Value Required

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer Crls

Boolean

Try CRL instead of OCSP first.

No Failback

Boolean

Do not use the secondary checking method, which is the method not specified in the Prefer Crls field.

Soft Fail

Boolean

Avoid verification failure when the revocation server cannot be reached or is busy.

Success Status Code Validator

Field Type Description Default Value Required

Values

String

Comma-separated list of status codes that indicate success.

x

TLS

Configures TLS to provide secure communications for the Mule app.

Field Type Description Default Value Required

Enabled Protocols

String

Comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

Comma-separated list of cipher suites enabled for this context.

Trust Store

Configures the TLS truststore.

Key Store

Configures the TLS keystore.

Revocation Check

Configures a revocation checking mechanism.

Truststore

Configures the truststore for TLS.

Field Type Description Default Value Required

Path

String

Path to the truststore. Mule resolves the path relative to the current classpath and file system.

Password

String

Password used to protect the truststore.

Type

String

Type of truststore.

Algorithm

String

Encryption algorithm used by the truststore.

Insecure

Boolean

If true, Mule stops performing certificate validations. Setting this field to true can make connections vulnerable to attacks.

View on GitHub