如何为部署到 SAP BTP 平台上的 Node.js 应用提供

作者: 华山令狐冲 | 来源:发表于2021-08-31 09:21 被阅读0次

如何为部署到 SAP BTP 平台上的 Node.js 应用提供
Fiori-like Prototype ( SAP BTP 2
如何给运行在 SAP BTP 上的 Java 微服务增添访问控制
使用 cf push 部署应用到 SAP BTP 时遇到错误消息
使用 cf push 部署应用到 SAP BTP 后启动失败 s
Fiori-like Prototype ( 2021 SAP
在 SAP BTP 里使用 SAP HANA Cloud 试用版
SAP Business Technology Platform
CloudFoundry 环境上的 Java 应用开发如何指定
在SAP云平台的neo环境上使用SLF4J对Java程序进行日志

官方链接

本教程的目标是通过身份验证和授权来保护和部署产品列表应用程序，因此只有具有正确授权的用户才能获得身份验证应用程序中的产品。没有必要授权的用户可以登录应用程序，但看不到产品。

本教程的基础是一个 Node.js 应用程序，它使用 express 框架和 SAPUI5 来显示产品列表（参见屏幕截图）。

XSUAA and the Application Router

为了保护此产品列表应用程序，使用了两个组件。一种称为 XSUAA 服务，另一种称为应用路由器。应用程序路由器与 XSUAA 服务结合使用来验证用户并将用户路由到受保护的应用程序。

XSUAA 扮演 OAuth 授权服务的角色，而应用程序路由器扮演 OAuth 客户端的角色。此外，应用路由器充当应用的中央入口点。

为了防止在未经身份验证的情况下直接调用您的应用程序，有必要向您的应用程序添加一些代码。在我们的示例中，您使用 Node.js 护照身份验证中间件并使用 XSUAA JWT 策略对其进行配置。

此代码可防止在没有有效 JWT 的情况下直接调用产品列表应用程序。

checkReadScope 函数确保只有具有正确权限的用户才能查看产品。

If you want to use SAP modules locally, you need to add the npm configuration:

npm config set @sap:registry https://npm.sap.com

approuter 将使您能够创建到您的应用程序的安全路由。

在 manifest.yaml 中，您必须为应用程序定义主机名并添加目的地。清单文件用于将 XSUAA 服务实例绑定到您的应用程序。

使用参数 route 为您的应用程序指定一个特定的主机名。路由在整个 Cloud Foundry 环境中必须是唯一的，因此请确保向路由添加随机部分，例如您的姓名首字母和出生日期，如 product-list-ap25 和 approuter-product-list-ap25。稍后您还需要路由来配置目的地。

name 参数与之前在文件 xs-app.json 中定义的相同。 url 参数是应用程序主机名和 Cloud Foundry 环境区域 (https://<hostname>.cfapps.<region>.hana.ondemand.com) 的结果。 forwardAuthToken 参数设置为 true 可确保 approuter 将 JWT 令牌转发到目的地。

package.json 文件的依赖：

要使用 XSUAA 服务，需要一个名为 xs-security.json 的文件。该文件可以定义 XSUAA 服务实例的属性以及不同的角色和授权。在此示例中，该文件包含一个角色模板和一个具有产品列表查看者角色的角色集合，使用户可以稍后查看产品。

新建一个 security 文件夹，xs-security.json 文件内容维护如下：

{
    "xsappname": "product-list",
    "tenant-mode": "dedicated",
    "scopes": [
        {
            "name": "$XSAPPNAME.read",
            "description": "With this scope, USER can read products."
        }
    ],

    "role-templates": [
        {
            "name": "Viewer",
            "description": "Role to get the list of products",
            "scope-references": [
                "$XSAPPNAME.read"
            ]
        }
    ],
    "role-collections": [
        {
            "name": "ProductListViewer",
            "description": "Product List Viewer",
            "role-template-references": [
                "$XSAPPNAME.Viewer"
            ]
        }
    ]
}

这将创建一个具有角色模板的角色集合和一个具有阅读范围的角色，因此具有此角色的用户可以查看产品。

Prepare the approuter files

approuter 将使您能够创建到您的应用程序的安全路由。

将名为 approuter 的文件夹添加到您的产品列表文件夹中。
在该文件夹中创建一个名为 package.json 的文件。
添加以下内容：

{
    "name": "approuter",
    "dependencies": {
        "@sap/approuter": "^9.0.2"
    },
    "scripts": {
        "start": "node node_modules/@sap/approuter/approuter.js"
    }
}

xs-app.json 的内容：

{
  "routes": [{
    "source": "^/products",
    "target": "/",
    "destination": "products-destination"
  }]
}

这将创建一个名为 products-destination 的目的地。目的地稍后会在 manifest.yml 中引用。

Move static content to the application router

出于性能原因，最好将应用程序的图像放入带有应用程序路由器的静态资源文件夹中。

最后应用结构如下：

Update the manifest file

在清单文件中，您必须为应用程序定义主机名并添加目的地。清单文件用于将 XSUAA 服务实例绑定到您的应用程序。

applications:
# Application
- name: product-list
  instances: 1
  memory: 128M
  routes:
    - route: product-list-jerry.cfapps.eu10.hana.ondemand.com
  path: myapp
  buildpacks:
    - nodejs_buildpack  
  timeout: 180
  services:
    - xsuaa-service-tutorial

# Application Router
- name: approuter
  routes:
    - route: approuter-product-list-jerry.cfapps.eu10.hana.ondemand.com
  path: approuter
  buildpacks:
    - nodejs_buildpack
  memory: 128M
  services:
    - xsuaa-service-tutorial
  env:
    destinations: >
      [
        {"name":"products-destination",
         "url":"https://product-list-jerry.cfapps.eu10.hana.ondemand.com",
         "forwardAuthToken": true}
      ]