Skip to Content

OAuth 2.0 authentication using REST Pooling, Value Mapping & Change List Web Services

OAuth 2.0 is widely used these days in most of the REST Services. To access any REST service which is using OAuth 2.0, you need ACCESS TOKEN from the REST providers.

 has already provided a blog for the same using UDF

Actual Scenario: You need to send data to a REST service but before you sent it you must have a valid access token which is provided by the same REST provider

Using the REST Lookup in a UDF you can definitely achieve this. But in my case the issue was that the number of transaction were too many to be handled by the Lookup.

So, to achieve this we used another scenario, REST Pooling Sender Channel & two standard web services ValueMappingServiceVi ChangeListServiceVi to change & activate value mapping respectively. This might not be the best way to achieve it, so If you have some better options do share the same so that the mass can know it. There might be an easy way too, mine may be complex for few of you.

My TEST Value Mapping:

First I’ll show the functionality of the two web services:

Path to test standard web services – http://<HOST>:<PORT>/wsnavigator

  1. ValueMappingServiceVi

After searching the web service, click Next, you’ll be able to see different operations that web service contains & use the one you need. In my case I’ll be using the first one i.e. change operation to change the value of an existing Value Mapping.

Click Next, & populate the data as shown in below screenshot:

MasterLanguage & languageCode = EN (for English)

ValueMappingID = Group ID (In my case it is 57d22255-b80a-11e7-bfd4-00059a3c7a00 & it remains the same in all environment after transport)

GroupName = Value Mapping Group (in my case it is TEST)

schemeID = Scheme

schemeAgencyID = Agency

value = Value (whatever value you want to update in value mapping, in my case to test I just used “new token value”)

Click Next, on right hand side you should see the result, with a ChangeListID (in my case it’s value is e2b8c6d1-18c1-11e8-a21c-00000036eb2e)

Now check your Value Mapping it should be updated with the new value & also there must be a change list created under your id for the same.

Now your Value Mapping is updated with the new value. But it should be activated before we can use it. So, to achieve it we’ll use another Web Service ChangeListServiceVi

2. ChangeListServiceVi

Use the same process as above:



Provide the same  ChangeListID we got in response from first web service (i.e. e2b8c6d1-18c1-11e8-a21c-00000036eb2e)

Refresh your change list in ID & you’ll see that your value mapping is activated.

Now all the above things we did, have to come under a PI scenario. It will be a REST Pooling -> SOAP -> SOAP scenario using Async-Sync Bridge.

To achieve this download the WSDLs for both the web services discussed above.

Path to download WSDL file for web services – NWA -> SOA -> Application and Scenario Communication -> Single Service Administration -> Service Definitions Tab -> Find

After downloading Zip file, extract it & you’ll find 4 wsdl files. You need to use file2 as it is the main file which will give you the External Definition & Service Interface.

Choose the option of “Import Service Interface” in ESR & import both the wsdl files. After importing you’ll see them under Service Interfaces. With Service Interface you’ll also see two External Definitions as well. Not discussing here how to import.

Here I renamed the “file2” before importing, to ED_ChangeListServiceViED_ValueMappingServiceVi

Data Type: Only 1 to be created


The above structure you can check with your REST provider, or you can also have it from the REST Pooling sender channel.

Message Type: Only 1 to be created


Service Interfaces: 4 required, out of which two are created by itself when we import wsdl files.

  1. SI_GetToken_Out – Outbound Asynchronous Stateless XI30 Compatible
  2. ValueMappingServiceVi – Created by importing, Inbound Synchronous Stateless with Operation changeOut_doc
  3. SI_ApgieeActivateToken_Out – Outbound Asynchronous Stateless. Uses the External Definition of above web service in Messages i.e. changeOut_doc
  4. ChangeListServiceVi – Created by importing, Inbound Asynchronous (by default it is Synchronous, changed it to Asynchronous as we don’t need any response from it), Stateless with XI30 Compatible. Uses operation activateIn_doc as External Definition to activate the objects.

Message Mappings: 2 Required

  1. MM_TokenRequest – we only need access_token from REST service in our value mapping, so only that is mapped to value field in the web service structure. Other values will be same as shown while testing ValueMappingServiceVi in WSNavigator & can be passed as Constants.
  2. MM_ActivateValueMapiing – we need only ChangeListID to be mapped to ChangeListActivateRequest

Operation Mappings – Again 2 required

  1. OM_GetToken – Sender is Async & Receiver is Sync. You’ll get a warning but it will get activated.
  2. OM_ActivateToken – Make sure to select the operation changeOut_doc as outbound service interface.

ID Objects


  1. REST_GetToken_SND – If your REST Provider supports XML then configure Data Type as “XML” in third tab i.e. Data Format
  2. SOAP_ChangeTokenValueMapping_RCV – You can use your SAP PI business system for the SOAP channels: Target URL is the endpoint of the web service ValueMappingServiceVi. Target URL – http://<HOST>:<PORT>/ValueMappingService/HTTPBasicAuth?wsdl&mode=ws_policy&style=document. Verify the same from SOA under NWA. Also, under Modules added RequestResponseBean & ResponseOnewayBean so as to pass the response from 1st web service to 2nd web service. For more details on these beans refer:  There are many blogs for the same on
  3. SOAP_ActivateTokenValueMapping_SND – Just required to send the response from 1st web service to the 2nd
  4. SOAP_ActivateTokenValueMapping_RCV – Channel for the second web service i.e. ChangeListServiceVi. Target URL: – http://<HOST>:<PORT>/ChangeListService/HTTPBasicAuth?wsdl&mode=ws_policy&style=document. Verify endpoint from SOA under NWA.

Integrated Configurations: 2 needed

  1.  | Your REST Provider | SI_GetToken_Out | | 
  2. | INTEGRATION_ENGINE_JAVA | ValueMappingServiceVi.changeOut_doc | | Your REST Provider – Make sure to create this ICO with virtual receiver as your REST Provider business system.

Running the scenario by just starting the REST Pooling Channel, we get below request

Received the access_token value as KK4WMDwoyvlhkqZFT1BuSaf5h5YT in JSON. Now the same should reflect in my Value Mapping & it does so.

Now use this value mapping in a java UDF to update the access token in the mapping where you want to connect to the REST Provider to send some data. Refer below code for Dynamic Configuration which will be used in REST Receiver Channel of the actual scenario.

DynamicConfiguration conf = (DynamicConfiguration) container.getTransformationParameters().get(StreamTransformationConstants.DYNAMIC_CONFIGURATION);
DynamicConfigurationKey tokenKey = DynamicConfigurationKey.create(“”,”XHeaderName1″);
conf.put(tokenKey, token);

Don’t use the above code as it is, for proper java coding use try-catch blocks & handle exceptions.

Under the REST Receiver Channel of Actual Scenario, REST URL Tab configure Pattern Variable Replacement

Under HTTP Headers tab enter the Header Name & Value Pattern as required by your REST Provider. In my case it was as shown below. The Authorization – Beared {Token} contains the value from the Value Mapping.

Quite a lengthy way to achieve OAuth 2.0 token, but a fruitful one. Kindly share a better way if you have one, as I still think there might be a better way to achieve it.


Ankit Mishra

You must be Logged on to comment or reply to a post.
    • Hi Rajesh,

      First test the web service ValueMappingServiceVi. Are you able to update any value mapping table in Integration Directory using this? If so, then your interfaces should work.


      Ankit Mishra

        • Hi Rajesh,

          If your Value Mapping is updated & activated then there shouldn't be any cache issues. It can be a very rare case that after updation & before activation of value mapping a request is triggered to fetch the data from value mapping. Even is this happens you can avoid such a case by updating the token value few minutes before the old one expires. So, in case your message picks an old value, it should get processed as the old token isn't expired.

          E.g. in case the token expires every 60 min, then update the value mapping every 55 min.



          • Hello Ankit Mishra,


            I had done exactly the same, ATP is set for sender REST Poll channel which indeed replaces every 55 mins with new tokens.


            What if some user is doing a delta cache in Production and also this particular Activation of change list in Production automatically looks to be little wild 🙂 Not sure if BASIS accepts this. Also in my case there is 3 hops with async-sync bridge.


            But still it is pretty good that values are storing and retrieving perfectly. 🙂

          • Hi Rajesh,

            Good to know its working for you 🙂

            Delta cache refresh case might be one in 1000. But it might or might not affect it. You can try to test that in lower environments.



  • hi Ankit,

    "OM_ActivateToken – Make sure to select the operation changeOut_doc as outbound service interface."

    in my case OM_ActivateToken operation mapping , source message it showing me changein_Out ,instead of changeOut_doc as you mention in above .

    and i not able to select the changeOut_doc.

    how to select the changeOut_doc

    see the below screen shot




    • Hi Santosh,


      Check your imported service interface for value mapping. While using the same in operation mapping select the correct operation.

      Refer point 2 in my blog to see the service interface. You may edit the operations as needed. I’ve used the operation changeOut_doc.

      Probably you need to check your service interface & edit it accordingly.



      Ankit Mishra

      • Hi Ankit,

        Thank you Ankit , it's working  now

        but now I getting problem  in 2 ICO configuration

        "INTEGRATION_ENGINE_JAVA | ValueMappingServiceVi.changeOut_doc | | Your REST Provider – Make sure to create this ICO with virtual receiver as your REST Provider business system."

        my case it not show the ValueMappingServiceVi,.changeOut_doc   interface in ICO

        as per my knowledge service interface load when we import the business system but is INTEGRATION_ENGINE_JAVA_... is not business system right?

        so how it will visible the ValueMappingServiceVI in ICO for INTEGRATION_ENGINE_JAVA

        communication component



        santosh rao



        • Hi Santosh,

          Your PI/PO system can be used as a Business System. Just use it as one & populate the ICO.

          Also, if it doesn't shows you the interface or namespace just copy/paste it from ESR while creating your ICO. It should work.


          Ankit Mishra

    • Hi Uday,


      At first I'll ask to get upgraded to PO 7.5 asap. PI 7.1 to PI 7.4 will end maintenance by 31.12.2020.


      Coming to your query, since REST adapter isn't available in 7.1 either you ask the provider to use SOAP service if possible, or check for any third party adapters for REST service. If there's no option then try to use Java Proxy to connect to REST service.



      Ankit Mishra

  • Nice blog ! Good to know this approach, I wasn't aware that ValueMappingService allows us the change operation also though I had read somewhere that iFlows in NW PO 7.4 onwards use these services but did not explore to this extent.