InstallationInstall Sana Add-on in SAP EnvironmentWeb Service Configuration (NetWeaver Gateway / ICF)

Install Sana Add-on in SAP Environment

  Open 'Install Sana Commerce on SAP Environment' wizard and choose you SAP version to see more information.

Web Service Configuration (NetWeaver Gateway / ICF)

After the Sana add-on was successfully installed and a service user was created, it is necessary to activate the web service that was imported into your Internet Communication Framework during add-on installation. It will make Sana Web service definition available to web store requests over the network via HTTP(S). The following steps explain how to activate the Sana web service.

Create Web service binding

Step 1: Open ICF by calling SICF as transaction code.

Step 2: You will be asked to maintain the SERVICE hierarchy type where you have to click Execute (F8).

Step 3: In the Virtuelle Hosts / Services area see the sanaecom service with the adapter below.

Step 4: Right-click on the sanaecom service and activate it. Do the same with the adapter underneath. The service and the adapter should fade in which means that they are active.

Step 5: When the service has been activated, you should find the correct URL/endpoint that will serve as an integration point between the Sana web store and SAP. Right-click on the adapter and select Test Service from the menu.

Step 6: Copy the URL from the SAP GUI Security message.

By default, it will assign 0 as a port number. Use the port number that is already activated in your landscape for communication via HTTP(S) or create a new one for Sana. You can find a list of all active services with ports in your ICF by clicking: Goto > ICM Monitor > Services (Shift+F1). If none is applicable for Sana, you can create a new one by clicking: Service > Create. Keep in mind that your changes/port configuration will be lost after you restart the ICM, unless you manually add ports to the server profile in RZ10.

Step 7: Once you have defined the necessary port number, you can finally assemble your endpoint that you can send to Sana consultant to test connection between SAP and Sana. Your endpoint will be made of:

[unique http protocol name] [port number] [default Sana extension] + [/executerequest]
[]  [8010]  [/sanaecom/adapter] [/executerequest]

Final URL will look like this:

       The Web service URL should be specified in the connection settings in Sana Admin: Tools > ERP connection. For more information, see 'ERP Connection'.

Step 8 (Optional): If your SAP system and Sana web store are located not in the same DMZ, it is important to secure web service communication of data with SSL.

The following security requirements can be set for a service/security node or an alias:

  • Standard (default)
  • SSL

To encrypt data for ICF communication, you can use SSL (Secure Sockets Layer).
If you use the SSL Client Certificate, the client authentication is performed by the HTTPS protocol. The target system must handle the issuer of the SAP NW AS SSL Client Certificate as trusted.
For information about SSL configuration of ICF services, see 'Security Requirements'.
For general information about SSL, see 'Configuring SAP NW AS to Support the SSL'.

If SSL is specified, then the HTTPS connection is required for this service. A call using the HTTP connection is answered with an error message.

To set up HTTPS connection for the service right-click on the sanaecom service and select Display Service in the menu. Afterwards, under the Logon Data tab click Change (Ctrl+F1).

In the Security Requirement area select SSL.

InstallationInstall Sana Add-on in SAP EnvironmentWeb Service Configuration (NetWeaver Gateway / ICF)