创建应用


应用开发人员可在 EnOS 应用门户中创建应用,用于实现业务功能。创建的应用可在当前 OU 内使用,也可以分享至其它 OU。应用创建后,系统将生成服务账号(包括 AccessKeySecretKey),用于调用 EnOS API 以实现数据交互和功能扩展。

本文档详细介绍如何创建应用,包括新建应用、添加菜单以及配置权限点,为终端用户提供个性化的应用体验。

步骤 1:新建应用


  1. 登录 EnOS 应用门户 > 开发者控制台,进入 应用注册 ,选择 创建应用 按钮。

  2. 在创建应用窗口中输入以下字段:

    字段

    说明

    应用名称

    应用展示在终端用户界面的名称,支持国际化名称。

    标识符

    应用的标识符,当终端用户访问应用时,将展示在应用的 URL 中。若不填,系统将自动生成。

    应用地址

    应用的访问地址,可不填。终端用户访问应用时,将默认进入第一个菜单地址。

    应用分类

    应用所属的行业或领域。

    应用类型

    可选 Web(网页端)或 Mobile(移动端)。

    应用图标

    应用的图标,将展示在应用注册列表。

    详细描述

    应用的描述,将展示在应用详情页面。

  3. 点击 确认,完成应用创建。


应用创建完成之后,将展示在 组织应用 标签下,表示该应用是在当前 OU 内创建。


../_images/create_app.png

步骤 2:添加菜单


  1. 登录 EnOS 应用门户 > 开发者控制台,进入 应用注册 ,选择一个应用,进入 应用详情 页面。

  2. 选择 菜单管理 标签页,点击 新建菜单,在弹窗中输入以下字段:

    字段

    描述

    名称

    菜单名称。当终端用户访问应用时,应用名称将展示在应用左侧菜单栏,支持国际化。

    标识符

    菜单的标识符,在该应用下唯一。

    级别

    可选择** 一级菜单** 或 二级菜单

    上级菜单

    若在 级别 中选择了 二级菜单,则需为二级菜单选择其上级菜单。

    排序

    决定当前菜单在其所在层级内的排序,取值为从 1 开始的整数,序号小的菜单排在上方。

    URL

    菜单的 URL 地址,可填入行业应用组件的原生菜单地址,也可填写第三方页面地址。

    描述

    菜单的描述,支持国际化。

  3. 点击 确认,完成菜单的创建。


../_images/menu_management.png


添加菜单后,可在应用详情的 菜单管理 页面查看菜单列表。后续可联系 OU 管理员,为应用创建菜单组,并为应用的终端用户按角色分配菜单组。更多信息,参见 管理菜单组

步骤 3(可选):创建权限点


权限点用于实现应用内细粒度功能的访问控制,例如限制只有特定用户可以执行“创建记录”或“删除数据”等操作。通过配置权限点,应用开发人员可以为应用的功能设置访问权限,并与角色分配结合,确保终端用户只能访问其被授权的功能。

  1. 登录 EnOS 应用门户 > 开发者控制台,进入 应用注册 ,选择一个应用,进入 应用详情 页面。

  2. 权限点管理 页面,选择 新建权限点

  3. 在弹窗中填入权限点的名称、标识符和描述。

    • 名称:权限点的显示名称,例如“创建记录”或“删除数据”,支持国际化。

    • 标识符:权限点的唯一标识符,用于在代码中引用,例如 create_record 或 delete_data。

    • 描述:权限点的功能说明,例如“允许用户创建新的数据记录”,支持国际化。


备注


../_images/create_permission.png


配置完成后,可在 权限点管理 页面查看权限点列表。后续可联系 OU 管理员,为应用的终端用户按角色分配权限点。更多信息,参见 管理角色

步骤 4(可选):创建 RSA 密钥对


每个应用可拥有一个 RSA 密钥对,密钥对由 RSA 公钥和 RSA 私钥组成。通过 接入服务 V2.4 API 获取 product secret 和 device secret 时,返回的参数值经过加密,需使用 RSA 私钥解密,得到实际的值。有关解密的更多信息,参见 解密 Product/Device Secret

如有需要,可按照以下步骤为应用创建 RSA 密钥对。


备注

妥善保管私钥和私钥密码,丢失后无法恢复。


  1. 登录 EnOS 应用门户 > 开发者控制台,进入 应用注册

  2. 点击应用卡片进入 应用详情 页面,进入 RSA 密钥对 页面。

  3. 点击 创建密钥对,将自动生成 RSA 密钥对。如有需要,可设置 私钥密码 为私钥进行加密。私钥密码需妥善保存,页面将不再展示。如不需要,可直接留空。

  4. 创建后,可在 RSA 密钥对 页面,查看 RSA 公钥和私钥。

    • 生效时间:创建或更换该 RSA 密钥对的时间。

    • RSA 公钥:点击 复制 copy 复制公钥。

    • RSA 私钥:点击私钥文件名(例如 test001.pem)下载私钥文件。若已配置私钥密码,则下载的私钥将经过加密处理,使用私钥时需与 私钥密码 配合使用。


../_images/iam_service_account_secret_pair.png