获取 ROMA Connect 的授权地址和业务地址
ROMA Connect侧,授权地址也称租户面IAM域名,业务地址也称ROMA外部API网关 域名。相关的地址请联系ROMA Connect侧的技术工程师获取。
两个地址的获取方式示例如下,此处仅是参考,请联系ROMA Connect侧的技术工程 师以实际环境获取为准。
● 租户面IAM域名:需要先知道绑定的账号所对应的Region,查看IAM页面的终端 节点表,Region所对应的终端节点就是租户面IAM域名。
● ROMA外部API网关域名:需要先知道绑定的账号所对应的Region,查看API页面 的终端节点表,Region所对应的终端节点就是ROMA外部API网关域名。
获取 ROMA Connect 委托授权
下面以华为云上的ROMA Connect举例说明。
步骤1 登录访问ROMA Connect的管理控制台,例如https://console.huaweicloud.com/
iam/?region=cn-north-4&locale=zh-cn#/iam/agencies。
步骤2 选择左侧菜单里的“委托”。
步骤3 单击界面右上角的“创建委托”。
步骤4 填写委托相关信息。然后单击下一步。
委托名称请根据需要自行填写。委托类型请选“普通”,委托的账号就是运营管理员 在运营管理台配置的“平台租户名”。持续时间根据需要选择。
注意
委托的账号必须是主账号,不能是子账号。
资产发布者和资产订阅者创建ROMA Connect授权委托时,使用的委托账号必须与运 营管理员配置的平台租户是同一个ROMA Connect上的同一个用户,运营管理员配置 的平台租户会在资产发布者进行来源授权的界面上进行提示,请看"委托账号"对应的 值。
资产发布者和资产订阅者创建ROMA Connect授权委托时指定的区域必须与运营管理 员配置的区域是同一个区域,如果创建委托不清楚具体区域,请在“区域级项目”里 选择“所有项目(包括未来在所有区域下创建的项目)”。
步骤5 选择作用范围和拥有的权限。
作用范围请根据实际需要填写,权限请选择“ROMA FullAccess”。
B 资产在 AppCube 上配置商品资产类型
资产类型的管理暂时需要在AppCube上进行配置,支持配置资产类型和资产订阅次数 等。步骤和截图仅为示例,请以实际环境为准。
步骤1 运营管理员登录AppCube的环境。
步骤2 进到AppCube首页,单击左上角的“管理”菜单。
步骤3 选择“应用管理 > BO配置”。
步骤4 单击“Digital Store Service”,进入该BO的“产品统一配置管理中心”界面。
步骤5 在“应用配置”下找到并单击“资产类型配置”。
步骤6 单击“新增”新增资产类型,参考表B-1填写类型的信息。
用户新增的类型只能挂在根类型下。
表B-1 新增资产类型字段
如果有在AppCube的开发态上定制开发过卡片组件并导入到ROMA Exchange的资源库中,可以填写卡片组件的名称。
最大订阅
C 在 AppCube 上创建共享中心的用户和授权
创建共享中心的用户
在AppCube上创建用户的方法如下,本文仅列大致步骤,具体请参见AppCube的产品 文档。
步骤1 用部署共享中心的用户登录AppCube的环境。
步骤2 进到AppCube首页,单击左上角的“管理”菜单。
步骤3 选择“用户管理 > 用户”,进入用户列表界面。
步骤4 创建共享中心连接用的用户B。
1. 在用户列表界面上,单击“新建”。
2. 参考图填写用户的信息。
注意
权限字段的取值,请选择“SharedOfferingProfile”;全名字段的取值建议有辨 识度,方便快速看出是哪个ROMA Exchange连接共享中心用的用户。
新建用户时的全名,是会在资产共享审批、获取共享资产审批或资产查询里会显 示,方便识别谁共享的资产或谁申请该共享资产或共享来源。
3. 单击“保存”。
步骤5 创建审批共享资产的管理员C。
1. 进到AppCube首页,单击左上角的“管理”菜单。
2. 选择“用户管理 > 用户”,进入用户列表界面。
3. 在用户列表界面上,单击“新建”。
4. 参考图填写用户的信息。
注意
权限字段的取值,请选择“SharedCenterOperation”;全名字段的取值建议有辨 识度,方便快速看出是哪个ROMA Exchange共享中心连接用的用户。
5. 单击“保存”。
----结束
创建授权
AppCube的授权信息获取方法如下,本文仅列大致步骤,具体请参见AppCube的产品 文档。
步骤1 用部署共享中心的用户登录AppCube的开发环境。
步骤2 进到AppCube首页,单击左上角的“管理”菜单。
步骤3 选择“系统管理 > OAuth”,进入OAuth管理界面。
步骤4 单击“新建”,然后参考下图填写信息,授权类型处选“客户端模式”,用户请选择 步骤4创建的用户,然后单击“保存”。
注意
用户注意选择分配给ROMA Exchange用的用户B,即在创建共享中心连接用的用户B。
这里的名称可以根据需要填写。
步骤5 在刚添加的记录后单击下图红框里的图标,系统下载秘钥文件。记录下秘钥文件里的 客户端ID(client id)和客户端秘钥(client_secret)。
----结束
D 在 AppCube 上创建用于运营管理的用户
也可以参见AppCube创建用户相关章节。
步骤1 用租户登录AppCube的环境。
步骤2 进到AppCube首页,单击左上角的“管理”菜单。
步骤3 选择“用户管理 > 用户”,进入用户列表界面。
步骤4 在用户列表界面上,单击“新建”。
步骤5 参考图填写用户的信息。
注意
权限字段的取值,请选择“Developer Profile”。
步骤6 单击“保存”。
----结束
E 常见问题
E.1 发布 ROMA Connect 集成应用资产、API 资产和消息服 务资产时无法查看到相关资产
现象描述
资产发布者发布ROMA Connect集成应用资产、API资产和消息服务资产时无法查看到 相关资产,而用户确实在ROMA Connect上创建过这些资产。
可能原因
因为ROMA Connect上分了主账号和子账号,在ROMA Exchange上不分主账号和子账 号,主账号和子账号在ROMA Exchange上看到的两个账号。
用户在ROMA Connect上创建这些资产和在ROMA Exchange上发布资产时,使用的不 是同一账号。
处理步骤
用户可以用资产发布时的账号访问ROMA Connect,查看该账号下是否有相关资产。
如果没有资产,则用户可以重新用当前账号创建资产。或者用已经创建了资产的账号 发布资产。
用户登录华为云,访问ROMA Connect的官网页面,查看该账号下是否有集成应用资 产。
如果没有,则资产发布者需要进入ROMA Connect控制台,以当前账号重新创建集成 应用。
如果是API资产,用户选择左边菜单的“服务集成APIC > API管理”进行查看。
如果是消息服务资产,用户选择左边菜单的“消息集成MQS > Topic管理”进行查看。
E.2 在 ROMA Exchange 运营管理台新增适配器时找不到入 口
在ROMA Exchange运营管理台新增适配器时找不到入口,可以按如下方法在AppCube 上增加,本章节仅是示例,请以实际环境为准。下面以增加
ROMAConnectAdapter_Auth.zip适配器包为例介绍,其他适配器包的添加方法和步骤 一样。
步骤1 以ROMA Exchange运营管理台的登录账号访问ROMA Exchange运行所在的 AppCube。
步骤2 选择“管理 > 应用管理 > 软件包管理 > 软件包安装”。
步骤3 单击“新建”。
步骤4 将准备好的适配器软件包拖入如下红框中。
步骤5 可以在界面如下红框的位置看到已经成功上传的软件包,然后单击“安装”。
步骤6 如果界面出现如下提示(如果是首次安装某一个适配器软件包一般不会出现),直接 点击“继续”。
步骤7 如果界面出现如下提示(如果之前成功安装过该适配器包才会提示),直接点击“确 定”,不会影响已经安装使用的适配器包。
步骤8 安装成功后,系统显示“安装成功”(只显示数秒即消失),用户可以查看软件包安 装列表,根据软件包名称和安装时间,查看相应的安装结果。
说明
安装完成后,系统默认激活适配器包。
步骤9 登录ROMA Exchange运营管理台,在ROMAExchangeOperationAPP里,选择菜单
“系统管理 > 来源管理”,在适配器对应的下拉框里,可以看到新增的适配器。
----结束