管理 OU 内应用


创建应用后,应用开发人员可以对当前组织(OU)内创建的应用进行全面管理。管理功能包括查看服务账号、审批其它 OU 的获取申请、修改应用信息、管理权限点、处理 RSA 密钥对以及导出、导入、删除应用等。

查看服务账号


服务账号(AccessKeySecretKey)用于调用 EnOS Open API,实现数据交互或功能扩展,例如查询设备数据或触发工作流。仅当前 OU 创建的 组织内应用 支持查看完整服务账号信息,而 已获取应用 无法查看 SecretKey


备注

务必妥善保存服务账号,避免泄露。若泄露,可联系系统管理员重置该服务账号。


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

  2. 点击应用卡片进入 应用详情 页面,查看应用的服务账号(Access Key 和 Secret Key)等基本信息。


../_images/app_details.png

审批应用获取申请


若其它 OU 提交了获取应用的申请,应用开发人员需审批申请,并分配菜单和权限点。

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

  2. 点击应用卡片进入 应用详情 页面,在 审批列表 标签页下可看到申请当前应用的客户信息。

  3. 选择需要审批的客户,可在弹出的对话框中分配该客户 OU 可用的菜单和权限点。选择 审批通过审批不通过 完成审批。


审批通过的申请记录将出现在该应用的 客户管理 标签页下,应用开发人员可随时查看或修改已授权的菜单和权限点。

修改应用

修改基本信息


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

  2. 点击应用卡片进入 应用详情 页面,在页面下方选择 修改

  3. 按需修改应用信息,包括名称、标识符、地址、分类、图标和描述等。AccessKey 和 SecretKey 不可修改。

  4. 点击 确认,修改立即生效。


若当前应用已共享到客户 OU,修改内容将同步到客户 OU,可能存在一定缓存,需要刷新页面。

修改菜单


应用开发人员可编辑或删除已有菜单,以及调整客户 OU 的菜单访问权限。

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

  2. 点击应用卡片进入 应用详情 页面,进入 菜单管理 标签页。在菜单列表中进行对应操作:

    • 点击相应菜单的 客户批量授权 authorize 图标。弹窗中展示所有已获取该应用的客户 OU,可选择需要给哪些客户(OU)授权当前菜单。

    • 点击 编辑菜单 edit,编辑该菜单的名称、标识符、排序和描述。

    • 点击 删除菜单 delete,删除该菜单。菜单下的子菜单及其所有授权关系将一并删除。


修改菜单后,客户 OU 将同步更新,可能存在一定缓存,需刷新应用页面以应用新权限。

修改权限点


应用开发人员可调整客户 OU 的功能权限点。

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

  2. 点击应用卡片进入 应用详情 页面,进入 权限点管理 标签页。在权限点列表中进行对应操作:

    • 点击相应权限点的 客户批量授权 authorize 图标。弹窗中展示所有已获取本应用的客户 OU,可选择需要给哪些客户(OU)授权当前权限点。

    • 点击 编辑权限点 edit,编辑该权限点的名称、标识符和描述。

    • 点击 删除权限点 delete,删除该权限点。权限点的所有授权关系将一并删除。


修改权限点的标识符后,应用开发人员需调整代码,客户 OU 的管理员需要重新为角色分配该权限点。

修改权限点的授权后,客户 OU 的管理员可按需为角色分配该权限点。

更换 RSA 密钥对


一个应用下同一时间最多只有 1 个生效的密钥对。若原密钥对已泄露,或私钥密码丢失,可更换密钥对。

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

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

  3. 选择 更换密钥对。更换密钥对后,原密钥对将失效,页面上将无法查看和下载。已通过原密钥对加密的数据仍可使用本地保存的私钥解密。


../_images/iam_service_account_secret_pair.png

导出应用


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

  2. 点击应用卡片进入 应用详情 页面,在右上角选择 导出应用

  3. 应用将导入为 JSON 格式,包含应用基本信息、菜单和权限点,可直接在其它 OU 进行导入。


服务账号和 RSA 密钥对不会随应用导出。

导入应用


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

  2. 选择 导入应用,导入 JSON 文件。

  3. 导入成功后,当前 OU 将创建新应用,可重新配置菜单、权限点和 RSA 密钥对。


导入的应用将生成新的服务账号。

删除应用


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

  2. 点击应用卡片进入 应用详情 页面,在右上角选择 删除应用

  3. 删除后,该应用所授权的 OU 和用户将无法访问该应用。


若该应用已共享到其它 OU,建议在删除前提前通知客户 OU 的管理员,避免影响终端用户。