Configuration Guide

SAP AS2 Adapter

Using SAP NetWeaver Process Integration
 Configuration guide AS2 adapter

Contents
Use ....................................................................................................................................................... 3
Prerequisites ........................................................................................................................................ 3
Procedure............................................................................................................................................. 3
Configuring the Sender Channel ...................................................................................................... 3
Configuring the Receiver Channel ................................................................................................... 6
Additional Information ........................................................................................................................ 10

2
 Configuration guide AS2 adapter

Use
AS2 adapter is used to transport data securely and reliably over the Internet. Security is achieved by
using digital certificates and encryption. The Applicability Statement 2 is a protocol is used to transport
data securely and reliably over the Internet, based on HTTP and S/MIME. The partners are always
connected via the tried and tested HTTP protocol. The AS2 process is a clear choice thanks to its
effective firewall administration capability, signature, encryption, return receipt and rapid response
times.
You use this procedure to configure the AS2 adapter in the sender and receiver channels.

Prerequisites
You have deployed the AS2 adapter in the SAP Process Integration environment.
You must have logged in to the Integration Directory using the Integration Builder.
You have created a Communication Channel in the Integration Directory.
You have entered AS2 in the Adapter Type field in the Parameter section.

Procedure
1. Configure the sender channel to enable sending of messages between business partners.
For more information, see Configure the Sender Channel.
2. Configure the receiver channel to enable receiving of messages between business partners.
For more information, see Configure the Receiver Channel.

Configuring the Sender Channel

Use
You use this procedure to configure the message, signing, encryption and Message Disposition
Notification settings in the sender channel.
NOTE: Regular Expressions: On some parameters you can use regular expression. Some examples
are:
.* : All characters, zero or more times.
\. : A dot.
User1 : The name User1.
User. : The names User1, User2, Usera, Userb
A documentation of the syntax can be found in the java doc for the class java.util.regex. Pattern (Java
2 Platform SE v.1.4.2).

Prerequisites
You have selected Sender Radio button in the Parameter section of the Integration Builder.

Procedure
1. Configure the General settings. The table below provides more information on the parameters
and their descriptions.

Parameter Description Additional Information

Server
Expected URL-Path Enter the URL from The input is a regular expression.

3
 Configuration guide AS2 adapter
which you receive the
messages.
NOTE: The UME action
AS2Deliverage should
be assigned to the J2EE
user created for the
purpose of sending
messages into the
adapters public HTTP Here Partner name and Message
URL. The username and
password authentication
can be used and the
credentials are provided
to the partner in order to
call the adapter via
HTTP(s).
Message
Expected MessageID left Enter the left side of the
AS2 message ID.
Expected MessageID right Enter the right side of the
AS2 message ID.
Expected senders AS2 Enter the partners The input to the field is a regular
name unique AS2 name.
Expected own AS2 name Enter the companys The input to the field is a regular
unique AS2 name.
4
The incoming message is expected
at http(s)://server:port/AS2/<PATH>.
Recommended value for <PATH>
must be auth/.*
You could also provide value of
<PATH> like auth/<Partner
name>/<Message type>
type are regular expressions.
The input to the field is a regular
expression.
The value for the corresponding AS2
message field is checked against the
rule as specified in the regular
expression.
The default syntax check for this field
is performed against the regular
expression .* .
The input to the field is a regular
expression.
The value for the corresponding AS2
message field is checked against the
rule as specified in the regular
expression.
The default syntax check for this field
is performed against the regular
expression .* .
expression.
The value for the corresponding AS2
message field is checked against the
rule as specified in the regular
expression.
The default syntax check for this field
is performed against the regular
expression .* .
expression.
The value for the corresponding AS2
message field is checked against the
rule as specified in the regular
expression.
The default syntax check for this field
is performed against the regular
 Configuration guide AS2 adapter

expression .* .
Expected subject Enter the expected The input to the field is a regular
message subject. expression.
The value for the corresponding AS2
message field is checked against the
rule as specified in the regular
expression.
The default syntax check for this field
is performed against the regular
expression .* .
Charset
Charset conversion If you want to encode the
characters in the
message, select the
check box.
Source encoding Select the source The default value is ISO-8859-1.
encoding algorithm.
Destination encoding Select the destination The default value is UTF-8.
encoding algorithm.
Ambivalent configuration
Alert on messages in Select the check box If you
channels with ambivalent want the adapter to set the
configuration adapter specific message
attributes to the PI
message from the
incoming AS2 message.
Message configuration
Set dynamic parameters If you do not want the
adapter to use the
adapter specific
message attributes from
the PI message instead
of the configured values,
select the check box.
Quality of service Specify how a message For more information refer:
is to be processed by the
QoS
Integration Engine.
Archiving
NOTE: The following substitution parameters are available for archiving.
%SEQNUM: Attaches a sequence number starting with 1 to the archive name.
%RTSEQNUM: Attaches a consecutive, server wide, unique number starting with 1 to
the archive name.
%START: Attaches the start time of the adapter to the archive name.
%TIME: Attaches the archiving time in milliseconds to the archive name.
Archive messages If you want to archive all Enter the Archive location in the text
the processed files on box. The input is a file path location.
the PI server, select the It can contain the archiving
check box. substitution parameters.
Adapterstatus

5
 Configuration guide AS2 adapter

Adapter status If you want to enable

messages to be
exchanged, select
Active.

2. Configure the Signature and encryption settings. The table below provides more information
on the parameters and their description.

Parameter Description Additional Information

Signature
Verify signature If you want to verify the
signature of the partner,
select the check box.
Decryption
Decrypt If you want to decrypt the
message, select the check
box.
Select the public key
certificate from the NW
administrator keystore.
Select the certificate file from
the key store.
Select the private key from
the NW administrator
keystore.
Select the key file from the
key store.

3. Configure the Message Disposition Notification (MDN) settings. The table below provides
more information on the parameters and their description.

Parameter Description Additional Information

Sign MDN
View to own public key
certificate
Alias to own public key
certificate
View to own private key
Alias to own private key
If you want to sign the
message delivery notification,
select the check box.
Select the public key
certificate from the NW
administrator keystore.
Select the certificate file from
the key store.
Select the private key from
the NW administrator
keystore.
Select the key file from the
key store.

Configuring the Receiver Channel

Use
You use this procedure to configure the message, signing, encryption and Message Disposition
Notification settings in the receiver channel.
NOTE: Regular Expressions: On some parameters you can use regular expression. Some examples
are:
.* : all characters, zero or more times.

6
 Configuration guide AS2 adapter

\. : A dot.
User1 : the name User1.
User. : the names User1, User2, Usera, Userb
A documentation of the syntax can be found on Pattern (Java 2 Platform SE v.1.4.2).

Prerequisites
You have selected Receiver Radio button in the Parameter section of the Integration Builder.

Procedure
1. Configure the General settings. The table below provides more information on the parameters
and their description.

Parameter Description Additional Information

Recipient
Recipient URL Enter the URL where the AS2
server of the partner can be
reached.
NOTE: In case the HTTPS protocol is used to access the target partner's URL, the public key
certificate of the HTTP server of the remote station has to be deposited in the keystore view
Trusted CAs of the J2EE engine.
Basic HTTP Authentication If you want provide Enter the username and
authentication via HTTP, password for authentication.
select the check box.
Proxy server If you want provide Enter the host name and port
authentication via proxy number in the respective
server, select the check box. fields. The settings made
here apply to the entire VM
and therefore should be
chosen carefully. It is not
recommended to carry out
different settings for different
channels.
Basic Proxy Authentication If you want to provide basic Enter the username and
proxy authentication, select password for authentication.
the check box.
Message
File name Enter the file name which is
transmitted in case of signed
or encrypted messages.
MessageID left Enter the left side of the AS2 If this field is empty the XI
message ID. MessageID is used.
MessageID right Enter the right side of the If this field is empty the name
AS2 message ID. of the communication
channel is used.
Use compatible MessageID If you want the entire
MessageID to be shortened
to a maximum of 255
characters, select the check
box.
Own AS2 Name Enter the companys unique Specifies the AS2 name
which is transferred in AS2-
7

Recipients AS2 Name
Own Email address
Message subject
Content type
Charset
Charset conversion
Source encoding
Destination encoding
Dynamic configuration
Respect parameters
Archiving
NOTE: The following substitution parameters are available for archiving.
%SEQNUM: Attaches a sequence number starting with 1 to the archive name.
%RTSEQNUM: Attaches a consecutive, server wide, unique number starting with 1 to
the archive name.
%START: Attaches the start time of the adapter to the archive name.
Configuration guide AS2 adapter
AS2 name.
Enter the partners unique
AS2 name.
Enter your email address for
message delivery notification.
Enter the subject included in
the message.
Enter the content type with
which the message is
marked.
If you want to encode the
characters in the message,
select the check box.
Select the source encoding
algorithm.
Select the destination
encoding algorithm.
Select the check box if you
want to enforce overwriting of
the various AS2 message
fields, with the content of the
dynamic parameters in the XI
message instead of using the
values from the channel.
8
From-Parameter.
Specifies the AS2 name
which is transferred in AS2-
To-Parameter.
Specifies the email address
which is transmitted as
sender.
Specifies the content type
with which the message is
marked.
Standard: application/edi-x12
The default value is UTF-8.
The default value is ISO-
8859-1.
The following parameters
exist in the namespace
http://sap.com/xi/XI/AS2/AS2:
AS2URL: URL of the server
AS2Subject: Subject
AS2From: Sender name
AS2To: Recipient name
AS2FromEmail: Email
Address of the sender
AS2MessageId: Complete
MessageID
AS2MessageIdLeft: linker
Left part of the MessageID
AS2MessageIdRight: Right
part of the MessageID
AS2ContentType: Content
type of the Nachricht
AS2Filename: File name
 Configuration guide AS2 adapter
%TIME: Attaches the archiving time in milliseconds to the archive name.
Archive messages If you want to archive all the
processed files on the PI
server, select the check box.
Adapter status
Adapter status If you want to enable
messages to be exchanged,
select Active.
2. Configure the Signature and encryption settings. The table below provides more information
on the parameters and their description.
Parameter Description
Compression
Compress message If you want to compress the
message before sending it,
select the check box.
Signature
Sign message If you want to sign the
message before sending it,
select the check box.
Encryption
Encrypt message If you want to encrypt the
message before sending it,
select the check box.
3. Configure the Message Disposition Notification (MDN) settings. The table below provides
more information on the parameters and their description.
Parameter Description
Message Delivery Select the appropriate
Notification message delivery notification
type.
9
Enter the Archive location in
the text box. The input is a
file path location. It can
contain the archiving
substitution parameters.
Additional Information
Select the public key
certificate from the NW
administrator keystore.
Select the certificate file from
the key store.
Select the private key from
the NW administrator
keystore.
Select the key file from the
key store.
Select the algorithm for
encryption.
Select the recipients public
key certificate from the key
store.
Select the public key
certificate file from the key
store.
Additional Information
If you want the delivery
notification to be sent to the
partner through the same
channel, select synchronous.
If you want to the delivery
 Configuration guide AS2 adapter

notification to be sent to a
separate URL, select
asynchronous and enter the
URL.
Request Message Integrity If you want to establish
Check (MIC) message integrity at the
sender and receiver site,
select the check box.
Verify MIC If you want to verify the
requested MIC, select the
check box.
Request signing If you want to sign the
message before sending it,
select the check box.
Verify signature If you want to verify the Select the public key
signature of the message, certificate from the NW
select the check box. administrator keystore.
Select the certificate file from
the key store.
It is recommended to check
the verify signature option if
the request signing option is
checked.

Additional Information
Application Check
1. Open Internet explorer browser (do not use other browsers) and then load
http://<hostname>:<port>/nwa/start-stop.
This will load the Start & Stop: Java Instances page
2. Go to Java Applications tab. Let the NWA load all applications.
3. Filter the application name with keyword AS2.
4. The entry com.sap.aii.adapter.as2.app should exist
5. If any application is stopped (due to Lazy startup mode), start the application by selecting the
application & clicking the Start button. Its expected that the application starts successfully.

Communication Channel Monitor

You use the communication channel monitor to call information about communication channels that
are set up for the selected Adapter Engine, and to administrate these channels.
For more information, see Channel Monitor.

10

Copyright 2012 SAP AG. All rights reserved
SAP Library document classification: PUBLIC
No part of this publication may be reproduced or transmitted in any
form or for any purpose without the express permission of SAP AG.
The information contained herein may be changed without prior
notice. Some software products marketed by SAP AG and its
distributors contain proprietary software components of other software
vendors. Microsoft, Windows, Excel, Outlook, PowerPoint,
Silverlight, and Visual Studio are registered trademarks of Microsoft
Corporation. IBM, DB2, DB2 Universal Database, System i, System
i5, System p, System p5, System x, System z, System z10, z10, z/VM,
z/OS, OS/390, zEnterprise, PowerVM, Power Architecture, Power
Systems, POWER7, POWER6+, POWER6, POWER, PowerHA,
pureScale, PowerPC, BladeCenter, System Storage, Storwize, XIV,
GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2,
AIX, Intelligent Miner, WebSphere, Tivoli, Informix, and Smarter
Planet are trademarks or registered trademarks of IBM Corporation.
Linux is the registered trademark of Linus Torvalds in the United
States and other countries. Adobe, the Adobe logo, Acrobat,
PostScript, and Reader are trademarks or registered trademarks of
Adobe Systems Incorporated in the United States and other countries.
Oracle and Java are registered trademarks of Oracle and its affiliates.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the
Open Group. Citrix, ICA, Program Neighborhood, MetaFrame,
WinFrame, VideoFrame, and MultiWin are trademarks or registered
trademarks of Citrix Systems Inc. HTML, XML, XHTML, and W3C
are trademarks or registered trademarks of W3C, World Wide Web
Consortium, Massachusetts Institute of Technology. Apple, App Store,
iBooks, iPad, iPhone, iPhoto, iPod, iTunes, Multi-Touch, Objective-C,
Retina, Safari, Siri, and Xcode are trademarks or registered trademarks
of Apple Inc. IOS is a registered trademark of Cisco Systems Inc.
RIM, BlackBerry, BBM, BlackBerry Curve, BlackBerry Bold,
BlackBerry Pearl, BlackBerry Torch, BlackBerry Storm, BlackBerry
Storm2, BlackBerry PlayBook, and BlackBerry App World are
trademarks or registered trademarks of Research in Motion Limited.
Google App Engine, Google Apps, Google Checkout, Google Data
API, Google Maps, Google Mobile Ads, Google Mobile Updater,
Google Mobile, Google Store, Google Sync, Google Updater, Google
Voice, Google Mail, Gmail, YouTube, Dalvik and Android are
trademarks or registered trademarks of Google Inc. INTERMEC is a
registered trademark of Intermec Technologies Corporation. Wi-Fi is a
registered trademark of Wi-Fi Alliance. Bluetooth is a registered
SAP AG
Dietmar-Hopp-Allee 16
69190 Walldorf
Germany
T +49/18 05/34 34 24
F +49/18 05/34 34 20
www.sap.com
trademark of Bluetooth SIG Inc. Motorola is a registered trademark of
Motorola Trademark Holdings LLC. Computop is a registered
trademark of Computop Wirtschaftsinformatik GmbH. SAP, R/3, SAP
NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects
Explorer, StreamWork, SAP HANA, and other SAP products and
services mentioned herein as well as their respective logos are
trademarks or registered trademarks of SAP AG in Germany and other
countries. Business Objects and the Business Objects logo,
BusinessObjects, Crystal Reports, Crystal Decisions, Web
Intelligence, Xcelsius, and other Business Objects products and
services mentioned herein as well as their respective logos are
trademarks or registered trademarks of Business Objects Software Ltd.
Business Objects is an SAP company. Sybase and Adaptive Server,
iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products
and services mentioned herein as well as their respective logos are
trademarks or registered trademarks of Sybase Inc. Sybase is an SAP
company. Crossgate, m@gic EDDY, B2B 360, and B2B 360
Services are registered trademarks of Crossgate AG in Germany and
other countries. Crossgate is an SAP company. All other product and
service names mentioned are the trademarks of their respective
companies. Data contained in this document serves informational
purposes only. National product specifications may vary. These
materials are subject to change without notice. These materials are
provided by SAP AG and its affiliated companies ("SAP Group") for
informational purposes only, without representation or warranty of any
kind, and SAP Group shall not be liable for errors or omissions with
respect to the materials. The only warranties for SAP Group products
and services are those that are set forth in the express warranty
statements accompanying such products and services, if any. Nothing
herein should be construed as constituting an additional warranty.
Disclaimer
Some components of this product are based on Java. Any code
change in these components may cause unpredictable and severe
malfunctions and is therefore expressively prohibited, as is any
decompilation of these components.
Any Java Source Code delivered with this product is only to be used
by SAPs Support Services and may not be modified or altered in any
way.
Documentation in the SAP Service Marketplace
You can find this documentation at the following Internet address:
service.sap.com/instguides