为UI引擎前端项目创建数据源
本文档将指导您如何在UI引擎中创建数据源，为前端项目配置可访问的数据服务。
约束与限制
单个租户下的数据源数量默认上限为50个（含50个）。
前提条件
已登录应用运行态，并具备UI引擎操作权限。
创建数据源
- 在左侧导航栏中，单击“UI引擎”，进入“UI引擎”。
- 在左侧导航栏中，选择，进入“数据源管理”页面。
- 在“数据源管理”页面，单击“创建数据源”，弹出“创建数据源”窗口。
图1 创建数据源
- 在弹出的窗口中，根据实际业务需求，设置如下信息。
图2 设置数据源
表1 创建数据源配置信息 参数名称
参数说明
数据源分类
选择需要创建的数据源类型，用于确定后续配置项。
- 第三方API服务：用于接入外部系统或服务接口。
- xDM-F模型服务：用于对接iDME生态内基于统一模型的应用。
请注意：数据源创建完成后，数据源分类不可修改，请在创建前仔细确认。
xDM-F应用来源
仅当“数据源分类”为“xDM-F模型服务”时，需要配置。
- xDM-F设计态：从当前租户下的iDME应用中自动选取。
- 自定义：手动指定服务接口地址（适用于非标准部署或外部xDM-F兼容服务）。
请注意：数据源创建完成后，xDM-F应用来源不可修改，请在创建前仔细确认。
数据源名称
填写用于标识该数据源的名称。
长度不超过128个字符。
xDM-F应用
仅当“数据源分类”选择为“xDM-F模型服务”，且“xDM-F应用来源”选择为“xDM-F设计态”时，需要配置。
系统将自动列出当前登录账号所属租户下所有的iDME应用供选择。
请注意：数据源创建完成后，xDM-F应用不可修改，请在创建前仔细确认。
接口URL
在以下任一情况下需填写此配置项：
- “数据源分类”为“第三方API服务”。
- “数据源分类”为“xDM-F模型服务”且“xDM-F应用来源”为“自定义”。
仅支持“https://”或“http://”协议，且需要填写完整的域名或IP地址及路径。填写后需要通过“连接测试”，才可以保存数据源。
请选择认证方式
选择访问当前数据源所需的身份认证方式。
- 无鉴权：无需认证，可直接访问。适用于公开的工业数据查询接口（如产线公开看板数据）。
- IAM鉴权：通过华为云IAM服务进行统一的身份校验。
- JWT鉴权：使用JSON Web Token进行身份验证，适用于工业物联网场景。
请注意：
- 如果“xDM-F应用来源”选择“xDM-F设计态”，则认证方式仅支持“IAM鉴权”。
- 如果认证方式选择为“IAM鉴权”，数据源创建完成后，其认证方式不可修改，请在创建前仔细确认。
鉴权配置
仅当认证方式选择“IAM鉴权”时，需要配置。
- 鉴权账号名：IAM用户所属的账号名。长度限制为1-128个字符，仅支持大小写字母、数字、下划线（_）和中横线（-）组成。
- 鉴权项目：服务所在的项目ID（如cn-southwest-2）。长度限制为1-64个字符，仅支持大小写字母、数字、下划线（_）和中横线（-）组成。
- Access Key ID：访问密钥ID。长度不超过64个字符。
- Secret Access Key：与Access Key ID匹配的密钥。长度不超过64个字符。
认证请求头Name
当认证方式选择为“JWT鉴权”时，需要配置。
定义JWT令牌在HTTP请求头中携带的字段名称（如Authorization），用于调用服务时携带身份令牌。
长度限制为1-64个字符，仅支持大小写字母、数字、下划线（_）和中横线（-）组成。
认证请求头Value前缀
当认证方式选择为“JWT鉴权”时，可根据实际业务需求进行配置。
定义令牌值的前缀（如Bearer），用于匹配目标服务的认证规则。前缀将自动添加在生成的token之前。
长度限制为1-64个字符，仅支持大小写字母、数字、下划线（_）和中横线（-）组成。
JWT签名密钥
当认证方式选择为“JWT鉴权”时，需要配置。
选择用于签发和验证JWT令牌的密钥。
如果没有可选择的密钥，请先前往“密钥管理”进行创建，具体操作请参见为UI引擎前端项目创建访问密钥。
JWT Payload
当认证方式选择为“JWT鉴权”时，需要配置。
以JSON格式定义令牌中携带的用户信息（声明），支持变量替换。
示例：
{ "domainId": "{{domainId}}", "userId": "{{userId}}" }自定义请求头
当调用服务需要附加固定的HTTP Header时，可在此处添加。
- 参数名：长度限制为1-128个字符，仅支持大小写字母、数字、下划线（_）和中横线（-）组成，且不能包含空白字符。
- 参数值：长度限制为1-2048个字符，仅允许非汉字字符组成，且不能包含空白字符。
描述
填写数据源的业务说明，如用途、对接系统等，便于后续维护。
- 完成设置后，单击“保存”。
