Configure Principal Propagation from Cloud Foundry to Neo

Create a new directory called approuter somewhere on your machine.

Create a new file called package.json inside this directory with the following content:

{
  "name": "approuter",
  "version": "1.0.0",
  "description": "",
  "scripts": {
"start": "node node_modules/@sap/approuter/approuter.js",
"test": "echo \"Error: no test specified\" && exit 1"
  },
  "license": "ISC",
  "dependencies": {
"@sap/approuter": "^5.3.0"
  }
}

This tells Node (npm) to fetch and start the approuter.

Create a file called .npmrc with the following content:

@sap:registry=https://npm.sap.com/

This tells Node (npm) where to find the SAP dependencies (the approuter and its dependencies).

Note: On Windows, if you get the error message “You must type a file name”, call your file .npmrc.. Windows will then automatically remove the trailing dot.

Create a file called xs-app.json with the following content:

{
  "welcomeFile": "index.html",
  "routes": [ {
  "source": "/espm-cloud-web/espm.svc/",
  "target": "/espm-cloud-web/espm.svc/",
  "destination": "retailerBackend"
}, {
    "source": "/espm-cloud-web/images/",
    "localDir": "static/images/"
}, {
  "source": "/",
  "localDir": "static/retailer/"
}
  ]
}

This configures the routing inside the approuter.

Create a folder called static.

Move the src/main/webapp/retailer folder (from the espm project) to the newly created static folder.

Note: This folder contains the HTML, CSS and JavaScript of the Retailer application.

Copy the src/main/webapp/images folder to the newly created static folder.

Note: The images are needed by the Shop and the Retailer application.

Create a zip archive called approuter.zip containing all the file in the approuter folder. It’s important that the files are in the top level of the zip file!
You can use this commands in bash (Linux and macOS) to create the zip file:

for file in static/retailer static/images xs-app.json .npmrc package.json ; do
  if [[ ! -e $file ]] ; then echo -e "\e[33m[WARNING] $file does not exist\e[0m"; fi ;
done
zip -r approuter.zip .

or use PowerShell (Windows):

foreach ($file in @("static\retailer", "static\images","xs-app.json",".npmrc", "package.json")){
   if (-not (Test-Path $file)) { Write-Warning "$file does not exist" }
}
Compress-Archive -Force -Path .\* -DestinationPath approuter.zip

This will also check that all files exist and print a warning if one or more is missing.
Note: You need to change to the approuter directory using the cd command first (Linux, macOS and Windows).

Create Destination Service Instance

• Navigate into your dev space.

• Open the Service Marketplace under Services.

• Find and click the destination tile.

• Click New Instance.

• Press Next three times.

• Enter the Instance Name: destination-demo-lite and click Finish.

Create Authorization & Trust Management Service Instance (aka XSUAA)

• Click the arrow next to destination (see screenshot) and select Authorization & Trust Management.

• Click New Instance.

• Press Next only once.

• Copy and past the following parameters and click Next.

  {
  	"xsappname": "connectivity-app",
  	"tenant-mode": "dedicated",
  	"authorities": ["uaa.user"],
  	"scopes": [{
  		"name": "uaa.user",
  		"description": "Default scope for user",
  		"granted-apps": ["xs_user", "*"]
  	}],
  	"role-templates": [{
  			"name": "USER",
  			"description": "Normal user",
  			"scope-references": [
  				"uaa.user"
  			]
  		}
  	]
  }
  

• Enter the Instance Name: xsuaa-demo and click Finish.

Create Manifest File for the approuter.

• Create a new file called approuter-manifest.yml with the following content:

    ---
    applications:
  
    - name: destination-demo-approuter
      host: destination-demo-approuter-<userid>
      buildpack: nodejs_buildpack
      memory: 128M
      path: ./approuter.zip
      env:
        NODE_TLS_REJECT_UNAUTHORIZED: 0
      services:
        - xsuaa-demo
        - destination-demo-lite
  

• Replace <userid> of the host property with your user id.

Deploy the Approuter

• Back in the Browser click the dev-space, Applications followed by Deploy Application.

• Click Browse and select approuter.zip as File Location. Then do the same for the Manifest Location and select the approuter-manifest.yml. Finally click Deploy.

• Wait until your application shows a green Started as State and then click on approuter-demo.

• Navigate to the Approuter by clicking the link as shown in the screenshot.

• Login using the E-Mail-Address and password of your trial account.