SAP ABAP IMG Activity /UI2/JAM_REST_TUNNEL (Configure REST Tunnel)
Hierarchy
SAP_UI (Software Component) User Interface Technology
   CA-UI2 (Application Component) SAP UI for Decoupled Innovations
     /UI2/IMG (Package) IMG Activities
IMG Activity
ID /UI2/JAM_REST_TUNNEL Configure REST Tunnel  
Transaction Code /UI2/73000046   (empty) 
Created on 20140507    
Customizing Attributes /UI2/JAM_REST_TUNNEL   Configure REST Tunnel 
Customizing Activity /UI2/JAM_REST_TUNNEL   /UI2/JAM_REST_TUNNEL 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name /UI2/JAM_REST_TUNNEL    

Use

In this Customizing activity, you configure a REST tunnel to place indirect OData or REST calls to the external service provider. The use of this type of indirect OData or REST call prevents cross-domain authorization problems that would occur when using direct calls.

Note:

This configuration option is currently only supported for SAP Jam as the external service provider.

ABAP SMI provides a general REST tunnel that uses the same trusted connection as the one you have established in the Customizing steps for Server Settings and Application-Specific Server Settings. From the application’s perspective, the tunnel is called first before SAP Jam is called - that is, it is called indirectly.

The REST tunnel can be addressed as an ICF service using the ICF node path sap/bc/ui2/smi/rest_tunnel/. The REST tunnel splits the URL, and uses the authentication context as maintained in transaction CLB2_TUNNEL (view CLB2V_TUNNEL_C) for authentication with the service provider. It then rebuilds the URL and forwards the OData request to the target resource in SAP Jam.

By default, tunneling is not active.

Requirements

Standard settings

Activities

  1. To check whether the ICF node sap/bc/ui2/smi/rest_tunnel/ is activated, run transaction SICF.
  2. Run transaction CLB2_TUNNEL, and choose New Entries. Do one of the following:
    • To activate the REST tunnel for the OData endpoint of of the service metadata document, complete the fields as follows:

Field    Value

Service Provider Type    Select Jam.

Service Root    Enter api/v1/OData/$metadata.

    (This entry is case-sensitive.)

Resource Path    To use the default (that is, the unrestricted REST tunnel), leave the field empty.

Authentication Context    Select NONE (No authentication).

  • To activate the REST tunnel for the OData endpoint of SAP Jam, complete the fields as follows:

Field    Value

Service Provider Type    Select Jam.

Service Root    Enter api/v1/OData.

    (This entry is case-sensitive.)

Resource Path    To use the default (that is, the unrestricted REST tunnel), leave the field empty.

Authentication Context    Select USER (User context).

  • To activate the REST tunnel for the REST endpoint of SAP Jam, complete the fields as follows:

Field    Value

Service Provider Type    Select Jam.

Service Root    Enter api/v1/feed/post.

    (This entry is case-sensitive.)

Resource Path    To use the default (that is, the unrestricted REST tunnel), leave the field empty.

Authentication Context    Select USER (User context).

  1. Save your entries.

Example

Here is an example of a URL:

https://vmw3911.wdf.sap.corp:44335/sap/bc/ui2/smi/rest_tunnel/Jam/api/v1/OData/Groups('4711')

The URL consists of the following elements:

Element    Description

vmw3911.wdf.sap.corp:44335    back end host and port

sap/bc/ui2/smi/rest_tunnel    the ICF node path

Jam    the external service provider

api/v1/OData    the service root of the service provider

Groups('4711')    the resource path for the service

The REST tunnel then replaces the first part of the URL (including the service provider) by the address of the service provider (here: Jam) as maintained in the server settings of ABAP SMI.

Note:

The REST tunnel uses the DEFAULT application of ABAP SMI, thus the target server is selected as assigned to DEFAULT in the application-specific settings of ABAP SMI (See Customizing activity Define Application Settings).

Business Attributes
ASAP Roadmap ID 204   Establish Functions and Processes 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG /UI2/JAM_REST_TUNNEL 0 U000000043 SAP UI Integration - Social Media Collaboration Enablement 
Maintenance Objects
Maintenance object type C   Customizing Object 
Assigned objects
Customizing Object Object Type Transaction Code Sub-object Do not Summarize Skip Subset Dialog Box Description for multiple selections
CLB2V_TUNNEL_C V - View CLB2_TUNNEL  
History
Last changed by/on SAP  20140811 
SAP Release Created in 100