Connections > Connection properties > AS2 connection properties
  

AS2 connection properties

Configure connection properties for an AS2 server.
Configure the following properties on the Connection page in Administrator:

Connection properties

The following table describes AS2 connection properties:
Connection property
Description
Runtime Environment
The name of the runtime environment that contains the Secure Agent that you want to run the tasks.
URL
URL of the server that receives the messages. The URL syntax must refer to a valid server and location. The host name can be an IP address or a domain name. The port number is the port on which the AS2 server listens.
AS2 From ID
Name or ID of the sender. If the receiving server filters by this ID, the IDs must match.
Value is case sensitive and can contain 1 to 128 ASCII printable characters in length. The value cannot contain white spaces.
AS2 To ID
Name or ID of the recipient.
Value is case sensitive and can contain 1 to 128 ASCII printable characters in length. The value cannot contain white spaces.
Username
User name to connect to the remote AS2 server.
Password
Password to connect to the remote AS2 server.
Connection Timeout
Maximum number of seconds to wait when attempting to connect to the server. A timeout occurs if a successful connection does not occur in the specified amount of time.
If the value is 0 or blank, the wait time is infinite.
Default is 60 seconds.
Read Timeout
Maximum number of seconds to wait when attempting to read a file from the server. A timeout occurs if the file is not read in the specified amount of time.
If the value is 0 or blank, the wait time is infinite.
Default is 0 seconds.
Connection Retry Attempts
Number of times to retry connecting to the AS2 server if a successful connection does not occur. This setting applies to both the initial connection and any reconnect attempts due to lost connections.
If the value is blank, no retries are attempted.
Default is blank.
Connection Retry Interval
Number of seconds to wait between each connection retry attempt.
For example, to retry to connect up to 10 times with a five second delay between retries, set Connection Retry Attempts to 10 and Connection Retry Interval to 5.
If the value is blank, the interval is 0 seconds.
Default is blank.
Follow Redirects
Whether or not to follow redirect links when creating a connection.
Default is false.
User Agent
Value used in the message header to indicate what application created or sent the message.
Use Chunked Encoding
Whether or not to pre-calculate the length of the request or send the request in chunks. Pre-calculating the content length might slow performance when sending large files. However, not all AS2 servers support chunked encoding.
Default is false.
Client Certificate Alias
Alias of the key within the default keystore to use for client authentication when required by the receiving AS2 server.
SSL Context Protocol
Protocol to use when creating the SSLContext. The protocol that you specify depends on the security providers installed in the Java Runtime Environment (JRE).
Note: In most cases, the default value of SSL is appropriate. However, for some IBM JRE implementations, the default value of SSL will not work if the server you are connecting to does not support SSLv3.
Default is SSL.
Enter the actual information in this section (optional).

Connection properties

Message properties

The following table describes AS2 connection message properties:
Connection property
Description
Trust Store Location
Path to the truststore that stores the public key certificates. Must be on the Secure Agent machine or on a server accessible to the Secure Agent.
Trust Store Password
Password to access the truststore.
Encrypt Messages
Whether or not to encrypt messages during transmission. Encrypting the message within the encrypted tunnel is optional, but highly recommended.
Default is false.
Encryption Algorithm
Algorithm to use to encrypt messages. Choose one of the following algorithms:
  • - AES128
  • - AES256
  • - CAST5
  • - IDEA
  • - TRIPLE-DES
  • - RC2
Default is AES128.
Encryption Certificate Alias
Certificate alias to use in the default trusted certificate keystore to encrypt the outgoing mesaage.
Sign Messages
Whether or not to sign the message with a digital signature. Signing messages is optional, but highly recommended.
Default is false.
Private Keystore Location
Location of the keystore that stores private keys and associated certificates. Applicable when signing messages is enabled.
Private Keystore Password
Password to access the keystore. Applicable when signing messages is enabled.
Signature Algorithm
Algorithm to use to sign messages. Applicable when signing messages is enabled.
Choose one of the following algorithms:
  • - SHA1
  • - SHA224
  • - SHA256
  • - SHA384
  • - SHA512
  • - MD5
Default is SHA1.
Signature Certificate Alias
Private key alias to use to sign the message. The private key is located in the default private keystore.
Compress Messages
Whether or not to compress messages to reduce bandwidth. If you enable this option, Informatica Intelligent Cloud Services compresses messages using the zlib format.
Default is false.

Receipt properties

The following table describes AS2 connection receipt properties:
Connection property
Description
Receipt Certificate Alias
Alias for the receipt certificate. Applicable when you configure the connection to require a signed receipt.
AS2 Connector uses the receipt certificate to verify that the certificate that signed the receipt is a certificate in the default trusted certificate keystore.
Optional if the receipt signature contains an embedded certificate. If the receipt signature does not contain an embedded certificate, you must specify the receipt certificate alias.
Receipt Transfer Encoding
Type of encoding to use for message receipts. This is useful when the receipt does not include the transfer encoding.
Use one of the following values:
  • - base64
  • - quoted-printable
  • - 7bit
  • - 8bit
  • - binary
Request Receipt
Whether or not to request a MDN receipt when the server receives the message. Select one of the following options:
  • - None. Do not require a receipt.
  • - Signed. Require a receipt signed with a digital signature.
  • - Unsigned. Require a receipt without a digital signature.
Default is none.
Destination
Mode with which to receive the MDN. Applicable when you request a receipt.
Select one of the following values:
  • - Joblog. Receive MDN in the job log, accessible in Monitor.
  • - File. Receive MDN in a file.
  • - Email. Receive MDN in an email.
  • - URL. Receive MDN through an URL.
  • - Discard. Discard MDN.
Default is joblog.
File
Path including the file name to store the MDN. Applicable for a file destination.
When File Exists
Determines how to resolve name conflict when a receipt file already exists. Applicable for a file destination.
Select one of the following values:
  • - Rename. Rename the new receipt file by adding a sequential number. For example, fileMdn 2.txt, fileMdn 3.txt
  • - Append. Append receipt to the existing file.
  • - Overwrite. Overwrite contents of the existing receipt file.
  • - Skip. Do not upload the receipt.
  • - Error. Duplicate file name causes error.
Default is rename.
Email Address
Email address to send the receipts. Applicable for an email destination.
Receipt URL
URL to post the receipts. Applicable for an URL destination.

Proxy properties

The following table describes AS2 connection proxy properties:
Connection property
Description
Enabled
Determines if a proxy server is enabled for the connector.
Default is disabled.
Proxy Type
Type of proxy server to use for the connection.
Select one of the following types:
  • - SOCKS. You can use SOCKS version 4 or 5.
  • - HTTPS.
  • - Informatica File Server proxy.
Verify with your network administrator which proxy server type to use.
Host
Host name or IP address of the proxy server on your network.
Alternate Host
Host name or IP address of an alternate proxy server on your network. The alternate proxy server is used when the primary proxy server is unavailable.
Port
Port number of the proxy server on your network. If left blank, the default port for HTTP is 80 and the default port for SOCKS is 1080.
User
User name to use for login when connecting to the proxy server.
Password
Password for connecting to the proxy server. Required if your network uses the proxy server to create HTTP or HTTPS connections.