File Transfer

File Transfer

AS2 server configuration properties

AS2 server configuration properties

For each runtime environment that uses the File Integration Service, you can configure an AS2 server to receive files from remote AS2 servers.
You configure AS2 server properties on the
AS2 Server
tab of the
File Server for agent
page.
Configure the following types of properties:
  • General
  • SSL
  • Listeners
  • Message security
  • MDN (Message Disposition Notifications)
  • Upload restrictions

General properties

The following table describes general AS2 server properties:
Property
Description
Enable AS2 Server
Whether to enable the AS2 server.
When not enabled, the AS2 server cannot receive files.
Default is disabled.
AS2 Server Id
Name or ID used by the sender. Note the following rules for the ID:
  • The value is case sensitive.
  • The ID can contain up to 128 ASCII characters, special characters, and spaces.
Port
Port number for the AS2 server.
Default is 15400.
Local Address
Local address of the AS2 sever.
Enable SSL
Whether to use SSL encryption in communications with remote AS2 servers.
Default is disabled.

SSL properties

The following table describes the SSL properties:
Property
Description
SSL Protocol
Whether to use the SSL or TLS protocol to secure HTTPS connection.
Select one of the following values:
  • TLS. A new version of SSL, Transport Layer Security is used to secure the transmission.
  • SSL. A traditional Secure Socket Layer protocol is used to secure the transmission.
Default is SSL.
Enabled SSL Protocols
Specify the permissible TLS and SSL versions separated with a comma.
The supported versions are:
  • TLS: TLSv1.2, and TLSv1.3
  • SSL: SSLv2Hello and SSLv3
When a value is not specified, all the versions for the selected protocol are enabled.
Client Authentication
Whether the client must have a certificate to authenticate with the server.
Choose one of the following values:
  • None. The SSL connection runs without checking certificates and the user is authenticated with a password. If any of the information being transmitted requires a certificate, the connection fails.
  • Required. The SSL connection will not connect or authenticate a user unless a valid certificate is available.
  • Optional. The SSL connection looks for a valid certificate, but continues with password authentication if a certificate is not present.
Key Store Location
Location of the key store that stores the private key and associated certificates that the client uses to authenticate communications with the File Integration Service.
Include a path and a file name.
Key Store Password
Password to access the key store.
Key Store Type
Type of the private key store.
Use one of the following values:
  • JKS
  • PKCS12
Key Alias
Key alias or certificate for the private key used to sign the MDN.
Trust Store Location
The path to the trust store file that the File Integration Service uses for HTTPS communication.
Trust Store Password
Password to access the trust store.
Trust Store Type
Type of trust store.
Use one of the following values:
  • JKS
  • PKCS12

Listeners properties

You can add multiple server listeners to an AS2 server. Use a server listener to configure the AS2 server with a specific port number and local address. To add a server listener to the list, click
Add Listener
.
The following table describes the add listener properties:
Property
Description
Name
Name of the server listener.
Port
Port number of the server that the listener monitors.
Local Address
Local address of the server listener.
Enable SSL
Whether to enable SSL over HTTPS connection to communicate with the AS2 listener .
When disabled, use HTTP instead of HTTPS to establish a connection with the AS2 listener.
Default is disabled.
SSL Protocol
Applies when you enable SSL. Whether to use the SSL or TLS protocol to secure HTTPS connection.
Select one of the following values:
  • TLS. A new version of SSL, Transport Layer Security will be used to secure the transmission.
  • SSL. A traditional Secure Socket Layer protocol is used to secure the transmission.
Enabled SSL Protocols
Applies when you enable SSL. Specify the permissible TLS and SSL versions separated with a comma.
The supported versions are:
  • TLS: TLSv1.2, and TLSv1.3
  • SSL: SSLv2Hello and SSLv3
When no value is specified, all the versions for the selected protocol are enabled.
Client Authentication
Whether the client must have a certificate to authenticate with the server.
Choose one of the following values:
  • None. The SSL connection runs without checking certificates and the user is authenticated with a password. If any of the information being transmitted requires a certificate, the connection fails.
  • Required. The SSL connection will not connect or authenticate a user unless a valid certificate is available.
  • Optional. The SSL connection looks for a valid certificate, but continues with password authentication if a certificate is not present.
Key Store Location
Location of the key store that stores the private key and associated certificates that the client uses to authenticate communications with the File Integration Service.
Include a path and a file name.
Key Store Password
Password to access the key store.
Key Store Type
Type of private key store.
Use one of the following values:
  • JKS
  • PKCS12
Key Alias
A unique name assigned to a key in a Key Store.
Trust Store Location
The path to the trust store file that the File Integration Service uses for HTTPS communication.
Trust Store Password
Password to access the trust store.
Trust Store Type
Type of trust store.
Use one of the following values:
  • JKS (Java Key Store)
  • PKCS12 (Public-Key Cryptography Standards)

Message security properties

The following table describes basic message security properties:
Property
Description
Encryption Required
Whether files received by the File Integration Service must be encrypted.
Default is enabled.
Signature Required
Whether files from the remote AS2 server must contain a digital signature. If a signature is required, the File Integration Service rejects any messages without the signature.
Default is enabled.
Authentication Required
Whether the user is required to authenticate.
Default is disabled.
Decryption Certificate Alias
Key alias or certificate used to decrypt incoming messages. The alias references a certificate in the key store.
All partners who send AS2 messages must have the public portion of this certificate.

MDN properties

The following table describes message receipt properties:
Property
Description
MDN Signature Certificate Alias
Alias that refers to the private key that the AS2 server uses to sign the message receipt. The private key is in the default private key store.
Asynchronous MDN Automatic Approval
Whether to send a return receipt automatically or manually.
Enabled Proxy for Async MDN
Determines if a proxy server is enabled for Asynchronous MDN.
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.
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.

Upload restrictions properties

You can specify the types of files to allow or deny in an AS2 file upload. The following table describes the properties that control upload restrictions:
Property
Description
File Extension Filter Type
Whether to accept or deny the extensions in the File Extensions list.
Use one of the following values:
  • Do Not Filter. Accept all file types.
  • Accept. Accept files with the extensions listed in the File Extensions property.
  • Deny. Do not allow files with the extensions listed in the File Extensions property.
File Extensions
List of file extensions. Add the file extensions that correspond to the File Extension Filter Type. For example, to accept .csv and .txt files, in the File Extension Filter Type property, select
Accept
, and then add csv and txt to the list of file extensions.
To add an extension to the list, type the extension in the text box and click
Add
.
To remove an extension from the list, highlight the extension and click
Delete
.
File Extension Case Sensitive
Whether to factor case when you filter using the file extensions list. When enabled, files with extensions that do not match the case used in the File Extensions list cannot be uploaded.
For example, if the file extension list includes csv but not CSV, files with the extension of csv can be uploaded but files with the extension of CSV cannot be uploaded.
Allow Files with Extension
Whether to enable the file extension filter. When enabled, the file extension properties configured on this page determine which file types can be uploaded.
Default is enabled.
Allow Files with No Extension
Whether to allow files that do not include the extension in the file name.
Default is enabled.
Allow Files with No Name
Whether to allow files with no name. The Secure Agent saves files without a name using the following format:
as2data_<datetime>
where datetime is the current time stamp including milliseconds.
Default is enabled.
File Name Suffix Timestamp (Optional)
Whether to append timestamp to the file name. When enabled, the timestamp is suffixed to the file name.
Max Upload Size
Maximum file size that the AS2 server can upload, in megabytes.
Default is 5 MB.
When File Exists
Choose the action to be performed when a file that already exists in the folder is received again.
Select one of the following options:
  • Rename: Rename the newly received file.
  • Append: Append the changes to the existing file.
  • Overwrite: Overwrite the existing file with the newly received file.
  • Error: Display an error if the file already exists.

0 COMMENTS

We’d like to hear from you!