/n software BizTalk Adapters V4 - Online Help
Available for:
/n software BizTalk Adapters V4
Questions / Feedback?

AS2 Adapter

Properties   Configuration Settings  

The AS2 Adapter adds AS2 send and receive capabilities to BizTalk Server.

Remarks

The AS2 Adapter adds AS2 send and receive capabilities to BizTalk Server. Built on top of the Drummond/eBusinessReady Certified IP*Works! EDI / AS2 Engine, the adapter allows you to easily incorporate secure EDI (EDI-INT) exchange into your current e-Business process architecture.

AS2 Receive Adapter

The AS2 Receive Adapter implements a fully-functional AS2 server that can communicate with your BizTalk Server. In order to use the AS2 Receiver, you must set the AS2SiteURL where your AS2 server is hosted, as well as the TradingPartner and ReceivingPartner AS2 identifiers. The AS2 Receiver will read all incoming requests and check them against these values to ensure that the request comes from a known sender and is actually intended for the receiving entity.

By default, the adapter sets the required MessageSecurity on incoming AS2 requests to the highest level. If your messages require security, you must set an EncryptionCert and/or SignerCert. It is also recommended that you set an MDNSigningCert in order to provide non-repudiation for your AS2 response.

Once the incoming AS2 request has been parsed and verified, the contents are submitted to your BizTalk Server to be processed. Upon successful submission, the adapter will generate and send an MDN receipt to your trading partner. If you wish to replace the default message generated by the adapter with your own message, you may set the ReceiptMessage property when configuring a receive location.

The AS2 Receiver is an isolated adapter, meaning that it is hosted by a separate application outside of the BizTalk Server. The adapter uses the incoming HTTP POST URL as the key for storing and retrieving its property set within BizTalk's database. Thus a single page can host multiple trading partner configurations.

AS2 Send Adapter

The AS2 Send Adapter adds a complete AS2 client within your BizTalk Server. In order to use it, you must set a minimum of three required properties: AS2To, AS2From and URL. It is also recommended that you set MDNTo, RecipientCert, ReceiptSignerCert, and SigningCert in order to ensure security, reliability, and non-repudiation.

The AS2 Send Adapter has support for SSL transport layer security. This may be enabled by setting the SSLCert and SSLAcceptServerCert to appropriate values.

Certification and Interoperability

The AS2 Adapter for BizTalk Server has been built on top of the IP*Works! EDI / AS2 Engine which has successfully completed the latest Drummond/eBusinessReady Certified program for AS2 interoperability. The product has undergone rigorous compliance testing and QA, demonstrating successful interoperability with all other DGI (UCC) AS2 certified products.

The eBusinessReady program provides neutral third party testing of solutions for interoperability and compliance. eBusinessReady is a joint partnership of the UCC (Uniform Code Council, Inc) and DGI (Drummond Group, Inc).

Please refer to the section on adapter configuration for a description of how to configure receive locations and send ports for this adapter.

Receiver Property List


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

AS2FromThe identity of the sending system.
AS2RequestFromThe identity of the sending system.
AS2RequestSubjectThe subject of the received message.
AS2SiteURLThe path to the website hosting the AS2 adapter.
AS2SubjectThe subject of the message.
AS2ToThe identity of the receiving system.
EDITypeThe MIME type of the data.
EncryptionCertThe digital id to be used for decryption.
EncryptionTypeThe MIME type of the encrypted data.
ErrorProcessingFlagsFlags controlling request processing errors.
ErrorReportingFlagsFlags controlling how errors affect the MDN.
ErrorThresholdThe maximum number of errors before the adapter shuts down.
FirewallA set of properties related to firewall access.
HTTPProxyA set of properties related to proxy access.
LogDirectoryThe path to a directory for logging.
LogFileThe log file written.
MaxThreadsThe maximum number of threads that the adapter may consume.
MDNThe MDN generated by the adapter.
MDNDispositionThe Disposition header in the MDN receipt.
MDNMICAlgorithmThe algorithm used to sign the outgoing MDN.
MDNMICValueThe Message Integrity Check(s) (one-way hash) of the EDI message.
MDNReceiptThe MDN-based receipt generated by the adapter.
MDNReportingUAThe name of the user agent performing the disposition.
MDNSendingModeThe level of end user interaction involved in sending the MDN.
MDNSignatureStatusThe validity of the signature in the MDN receipt.
MDNSigningCertThe digital id to be used to sign the MDN (optional).
MDNWarningA warning to appear in the MDN.
MessageSecurityRequired security level for incoming messages.
OtherDefines a set of configuration settings to be used by the adapter.
ReceiptDeliveryOptionA URL indicating how the receipt is to be delivered.
ReceiptHeadersThe AS2 headers that are returned with the receipt.
ReceiptMessageThe textual message that is included in the receipt.
ReceiptSigningProtocolThe protocol used to sign the outgoing MDN receipt.
ReceivedFileNameThe name of the file received by the AS2 adapter.
ReceiveModeControls whether the adapter is configured to process AS2 messages or MDN receipts.
ReceivingPartnerThe identity of AS2 receiving entity.
RequeueEndpointsWhether to requeue receive endpoints if the polling interval has not been reached.
RestartDirectoryThe directory to log cached files when using AS2 restart functionality.
RuntimeLicenseSpecifies the adapter runtime license key.
ScanResultThe result of parsing the request.
SignerCertThe signing certificate of the trading partner.
SSLAcceptServerCertFor sending HTTPS requests, a server certificate to unconditionally accept.
SSLCertThe certificate to use for client authentication during the SSL handshake.
TempPathA temporary local directory where data can be stored before the adapter processes it.
TimeoutA timeout for the adapter.
TradingPartnerThe trading partner that will be communicating with this receive location.
TransportLogTells the adapter where and how to report information about its operations.
URIThe Uniform Resource Identifier (URI) of the send port or receive location.

Sender Property List


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

AS2FromThe identity of the sending system.
AS2MessageIdThe Id of the message.
AS2SubjectThe subject of the message.
AS2ToThe identity of the receiving system.
AS2VersionThe version of AS2 being used.
CompressionFormatThe compression format (if any) to use.
EDIFileNameThe name to be used in the Content-Disposition MIME header of the outbound request.
EDITypeThe MIME type of the data.
EncryptionAlgorithmThe algorithm, if any, used to encrypt the EDI data.
EtagThe etag of the file.
FirewallA set of properties related to firewall access.
FromThe email address of the HTTP agent (optional).
HTTPPasswordA password if authentication is to be used.
HTTPProxyA set of properties related to proxy access.
HTTPUserA user name if authentication is to be used.
LogDirectoryThe path to a directory for logging.
LogFileThe log file written.
MaxThreadsThe maximum number of threads that the adapter may consume.
MaxTransmissionBatchSizeThe maximum number of messages that can be sent in a single batch.
MDNThe MDN generated by the adapter.
MDNDeliveryOptionA URL indicating how the receipt is to be delivered.
MDNMICValueThe Message Integrity Check(s) (one-way hash) of the EDI message.
MDNOptionsUsed to indicate the options requested for the MDN receipt.
MDNToUsed to indicate that a message disposition notification is requested.
OtherDefines a set of configuration settings to be used by the adapter.
ReceiptHeadersThe AS2 headers that are returned with the receipt.
ReceiptMessageThe textual message that is included in the receipt.
ReceiptSignerCertThe certificate of the receipt signer.
RecipientCertThe certificate of the recipient.
RestartDirectoryThe directory to log cached files when using AS2 restart functionality.
RuntimeLicenseSpecifies the adapter runtime license key.
SigningCertThe certificate used to sign the outgoing AS2 request.
SSLAcceptServerCertFor sending HTTPS requests, a server certificate to unconditionally accept.
SSLCertThe certificate to use for client authentication during the SSL handshake.
TimeoutA timeout for the adapter.
TransmitBatchModeHow the transmitter processes batches.
TransportLogTells the adapter where and how to report information about its operations.
URIThe Uniform Resource Identifier (URI) of the send port or receive location.
URLThe URL to post to.
UserAgentInformation about the user agent.

Configuration Settings


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

SignatureAlgorithmSignature algorithm to be used in outgoing messages.
SMTPFromThe senders address for asynchronous MDN delivery.
SMTPServerThe SMTP server for asynchronous MDN delivery.
SMTPSubjectThe SMTP message subject for asynchronous MDN delivery.
UseChunkedEncodingWhether to chunk outgoing posts.
SSLEnabledProtocolsUsed to enable/disable the supported security protocols.
AbsoluteTimeoutDetermines whether timeouts are inactivity timeouts or absolute timeouts.
LocalHostThe name of the local host or user-assigned IP interface through which connections are initiated or accepted.
TcpNoDelayWhether or not to delay when sending packets.
UseManagedSecurityAPITells the adapter whether or not to use the system security libraries or a managed implementation.

 
 
Copyright (c) 2017 /n software inc. - All rights reserved.
Build 4.0.6240.0