更新时间:2025-01-03 GMT+08:00
分享

流程引擎流程SDK自定义配置

单点登录配置

如果您希望通过单点登录的方式访问流程引擎,可参考如下说明进行配置。流程引擎的SDK部署模式当前支持如下两种单点登录方式,请根据实际的流程引擎流程SDK资源规划进行配置。

  • IAM服务的单点登录

    此方式的单点登录依赖于华为云IAM服务,请确认已规划对应资源。

    配置参数

    是否必选

    参数说明

    示例

    basic.auth.iam.enable

    设置是否开启IAM服务的单点登录。

    • true:开启IAM服务的单点登录。
    • false:关闭IAM服务的单点登录。

    true

  • OrgID的单点登录

    此方式的单点登录依赖于华为云OrgID服务,请确认已规划对应资源。

    配置参数

    是否必选

    参数说明

    示例

    basic.auth.orgId.enable

    设置是否开启OrgID的单点登录。

    • true:开启OrgID的单点登录。
    • false:关闭OrgID的单点登录。

    true

    ssf.login.oauth2.client-id

    OrgID的Client ID。

    获取方法请参见获取组织凭证

    abc123

    ssf.login.oauth2.client-secret

    OrgID的Client Secret。

    获取方法请参见获取组织凭证

    abc123

    basic.runtime.org.code

    OrgID给用户颁发的code。

    获取方法请参见快速开始

    abc123

完成单点登录配置后,您可以根据如下登录地址,分别登录流程编排服务和流程运行服务。

  • 流程编排服务登录地址:
    http://{承载流程编排服务的服务器域名或IP地址}:{流程编排服务的端口号}/{流程编排服务文根}/index.html?#/processApplicationForm?tenantId={租户ID}&applicationId={应用ID}
  • 流程运行服务登录地址:
    http://{承载流程编排服务的服务器域名或IP地址}:{流程运行服务的端口号}/{流程运行服务文根}/wfAdminIndex.html#/process-tasks?tenantId={租户ID}&applicationId={应用ID}

其中,租户ID和应用ID为部署xDM-F SDK时公共信息配置中的TENANT_DOMAIN_ID和APP_IDENTIFIER。

本地登录认证配置

如果您希望通过本地登录认证的方式访问流程引擎,可参考如下说明进行配置。

配置参数

是否必选

参数说明

示例

basic.login.type

流程引擎的登录类型,配置为“LOCAL”

LOCAL

basic.auth.loginUrl

本地环境的登录地址。

LOCAL

basic.local.login.falway

设置是否执行本地登录flaway脚本

  • true:执行本地登录flaway脚本
  • false:不执行本地登录flaway脚本,默认为false。

false

ssf.login.logoutUri

本地环境的登出地址

格式为:

https://{流程引擎流程SDK部署服务器的IP地址}:{流程引擎流程SDK部署服务器的端口号}/definitionmicro/index.html

http://127.0.0.1:8003/definitionmicro/index.html

ssf.flyway.locations

本地环境登录的数据库信息

classpath:ssf/migration/postgresql

spring.datasource.ssf.url

本地环境登录数据库连接URL。

格式为:

jdbc:{SSF_RDS_TYPE}://{RDS_IP}:{RDS_PORT}/{RDS_DATABASE}_ssf?sslmode=require&stringtype=unspecified

其中,“RDS_IP”“RDS_PORT”“RDS_DATABASE”字段需与部署数据建模引擎运行SDK配置数据库的配置参数保存一致,“SSF_RDS_TYPE”字段需与部署数据建模引擎运行SDK配置本地环境的单点登录的配置参数保存一致。

jdbc:mariadb://127.0.0.1:5432/test_ssf?sslmode=require&stringtype=unspecified

spring.datasource.ssf.driverClassName

本地环境登录数据库连接类

此配置参数需与部署数据建模引擎运行SDK配置本地环境的单点登录“SSF_DRIVER”配置参数保存一致。

org.mariadb.jdbc.Driver

spring.datasource.ssf.username

本地环境登录数据库用户

admin

spring.datasource.ssf.password

本地环境登录数据库密码

admin

spring.datasource.ssf.mapperLocations

本地环境登录数据库脚本的存放地址

classpath*:ssf/mapper_postgresql/**/*.xml

ssf.sysmgr.sessionfilter.enabled

设置是否开启本地环境登录Session过滤器。

  • true:开启本地环境登录Session过滤器,默认为true
  • false:关闭本地环境登录Session过滤器

true

ssf.cookie-filter.enabled

设置是否开启本地环境登录Cookie过滤器。

  • true:开启本地环境登录Cookie过滤器
  • false:关闭本地环境登录Cookie过滤器,默认为false

false

ssf.csrf-filter.enabled

设置是否开启本地环境登录CSRF(Cross-Site Request Forgery,跨站请求伪造漏洞)过滤器。

  • true:开启本地环境登录CSRF过滤器。
  • false:关闭本地环境登录CSRF过滤器,默认为false

false

ssf.firstlogin.isRestPassWord

设置首次登录流程引擎时是否需要重置密码。

  • true:首次登录流程引擎时需要重置密码。
  • false:首次登录流程引擎时不需要重置密码,默认为false

false

IAM机机认证配置

流程引擎的机机认证默认使用JSON Web Token(JWT)进行校验,如果您已在流程引擎流程SDK资源规划中规划了IAM服务,并希望使用IAM机机认证,可参考如下说明进行配置。

配置参数

是否必选

参数说明

示例

basic.auth.iam.machine.enable

设置是否开启IAM服务的机机认证。

  • true:开启IAM服务的机机认证。
  • false:关闭IAM服务的机机认证。

true

basic.iam.token.validDomainId

仅当“basic.auth.iam.machine.enable”“true”时,此配置项必选。

当前IAM的租户ID。

如需添加多个租户ID,请用英文逗号隔开。

123456,456789

其他配置

其他配置包括是否开启限流降级、WSF防护等,您可以根据实际业务需求进行配置。

配置参数

是否必选

参数说明

示例

xdmf.init

设置是否开启xDM-F数据库表单初始化。

首次启动时,必须为true,后续可根据实际业务需求进行修改。

  • true:开启xDM-F数据库表单初始化,默认为true。
  • false:关闭xDM-F数据库表单初始化。

true

olc.app.switch

设置是否开启OLC(Overload Control)限流降级。

  • true:开启OLC限流降级。
  • false:关闭OLC限流降级,默认为false。

false

basic.wsf.enabled

设置是否开启WSF参数校验,用于防护XSS攻击、SQL注入攻击,以及DOC攻击。

  • true:开启WSF参数校验,默认为true。
  • false:关闭WSF参数校验。

true

相关文档