PAAS4SAAS - Display your custom application in SAAS - part 1: Setting up your integrated page in ERP Cloud

At Profource we have built a Banking Cloud PAAS solution, which we want to expose as an integrated page within ERP Cloud. The PAAS solution has been build using Simplified UI to offer a fully seamless integrated user experience.

In order to achieve this seamless integration, we also need a single sign-on principle as shown below. The user logs in into ERP Cloud and navigates to the integrated page exposed on his springboard. Behind the scenes the system calls the PAAS application using an URL containing a Jason Web Token (JWT), which is validated in the PAAS application and used to do SOAP calls back to the ERP cloud for obtaining data or performing any kind of processing.

But the first step is to define an integrated page that links to your application.

Setting up an integrated page

There are several ways to setup the integrated page, especially in Sales Cloud. In ERP Cloud however, we use the Page Integration Wizard rather than groovy script.

The first step is to register the third party application. 

R10 Setup
Navigate to Setup and Maintenance.

Now choose Manage Third Party Applications and enter your application with the full URL.

R11 Setup
Navigate to Setup and Maintenance > Manage Custom Setup Content (icon on the right) > Topology Definition (heading right) > Manage Third Party Applications (beneath list on the right).

Integrated Page Setup

Now navigate to the Tools, Page Integration Wizard and create a new page. If this is your first page you also need to define a category.

Instead of entering a webpage, choose the key and select your web application. Enter the start page you want to land on and add jwt as security token. 

In this example I'm exposing the sample for JWT Token validation as an integrated page. You can download that example from the link below

http://www.oracle.com/technetwork/indexes/samplecode/cloud-samples-2203466.html

“Rich UI with Data Visualization Components and JWT UserToken validation extending Oracle Sales Cloud– 1.0.1”

If necessary you can also add parameters to your startpage simply by adding them using ?myParam=[myvalue]

Now you need to do one more thing and that’s expand the window, because on default it shows up only small. Choose Customize Workarea Pages and drag the page in the right corner to its correct size.

So now we are all set on the SAAS side. If we click the icon from the springboard it will open the URL and navigate to the page passing the JWT.

There is one other thing you need to do to make sure your ADF solution can run as an integrated page, since it’s contained in an iFrame. In JDeveloper 12.1.3 you need to set the FRAMEBUSTING in web.xml to never

However, this is not the most secure way. In JDeveloper 12.2 you can use a whitelist. For more information see

“Now you can specify a list of origins that are allowed to frame documents in your application. To do this, use the org.apache.myfaces.trinidad.security.FRAME_BUSTING context parameter set to whitelist and the oracle.adf.view.ALLOWED_ORIGINS context parameter. For more information, see Framebusting.”

 Ok that's all now! You can run your application as an integrated page in Fusion ERP. Your application can run on premise or be deployed on Java Cloud Service of course.