开发者中心

系统管理

概述

系统管理应用程序允许帐户管理员管理用户、应用程序、规则和存储的文件,以及为该帐户配置多个选项。你可以:

首页截图

"首页"屏幕提供导航链接到系统管理应用程序的主要部分。它也显示帐户的订阅信息。订阅信息描述了您使用了多少容量,以及您订阅的可选应用程序是什么样的。容量部分显示:

  • API请求:QuarkIoE功能调用的计数,包括从设备的功能调用(例如,发送测量)或从应用程序(例如,查看设备列表)的功能调用。
  • 设备的请求:只有当调用一个设备(例如,发送一个测量)时才计算。
  • 存储:存储在帐户中的数据总额。此值可被留存策略存储文件大小影响。
  • 存储配额:如果每个设备的存储限制设置,用户被限制到一个最大数据使用量
  • 设备:连接到帐户的设备总数。这是设备管理应用程序的 "全部设备"菜单中列出的设备和它们的直接和间接子设备的总和。
  • 用户:帐户中配置的所有用户的总和,包括活跃和非活跃的。

“这个月”显示从本月开始的使用信息。"上个月"显示最近完整一个月。

Home

管理用户

要管理租户的用户,请单击"用户"菜单。新客户通常会包含两个用户:初始管理员用户和"sysadmin"用户。初始管理员用户配置当您的帐户被创建。此用户不能被删除,只编辑。"sysadmin"用户是一个用户,QuarkIoE支持用来指导你通过你的试用期。

注意:"sysadmin"用户可能不存在,这取决于你的供应商。

点击用户
添加用户

点击"添加用户"来增加一个新的用户。

  • 输入用户将使用登录到您的帐户的用户名。
  • 选择如果用户将被激活。如果这个开关被设置为“禁用“,用户将无法登录。
  • 输入用户的第一个和最后一个名称。这是纯粹的信息,将显示在顶部右侧旁边的用户符号时,用户登录。
  • 输入用户的电子邮件地址。请注意,您需要提供一个有效的,唯一的电子邮件地址在这里,以使用户重新设置他们的密码。
  • 输入电话号码。再次,这是纯粹的信息。
  • 如果您选择检查“密码重置“,用户将在下一次登录后选择一个新的密码。
  • 输入密码并确认密码。(参见“登录“以了解更多关于密码强度的信息。)
  • 将用户添加到相关的用户组
  • 分配设备和应用权限
  • 最后,单击“保存“按钮。
添加用户

没有一个星号(“*“,例如,“名“,“姓“)不是强制性的。

编辑用户

要编辑现有用户,只需单击列表中的用户就可以了。除了用户名以外的所有用户信息都可以修改。要更改密码,请单击“更改密码“。单击“保存“后,您已完成编辑。

禁用或删除用户

在一个用户显示禁用和删除右侧按钮悬停。“关闭“按钮只是禁用用户。用户将继续存在,但将无法登录。删除按钮(“X“)永久删除用户。

删除用户

用户组管理

为了简化用户管理,可以将具有相同权限的用户放置到代表典型权限集的用户组中。一个单一的用户可以是多个用户组的一部分。新帐户通常会默认包含四个用户组。这些用户组有常见的有用的权限设置:

  • 管理员:具有所有权限集组。
  • 业务:本集团的用户可以使用所有的设备和他们的数据,但不能管理帐户。
  • 读者:在这个组中的用户可以读取所有数据,但不能作出任何更改(包括发送命令到设备)
  • 设备:一组具有典型的最小默认权限的设备。

所有组都可以修改和删除。

用户组

添加用户组

添加一个用户组:

  • 点击“创建用户组“。
  • 输入用户组的名称。
  • 编辑权限
  • 点击“保存“按钮。
编辑用户组

所有用户组的详细信息都可以编辑。要编辑一组,请单击组列表中的组的名称。在您完成修改组后,单击“保存“按钮。编辑用户组可能更改组中的所有用户的权限,并可能影响设备的正确功能。因此,您必须确认您的更改,如下面的截图所示。

Confirm group editing
删除用户组

要删除一个组,只需悬停在组名上,然后单击“X“按钮。将出现一个确认对话框。单击“确定“,组将被删除。

删除用户组

权限管理

QuarkIoE区分三种权限可以分配给用户和用户组:

  • 帐户广泛的权限(“角色“):这些都是标志,使用户能够无条件地读取或修改某些类型的数据在您的帐户,如看到所有设备,并能够编辑所有设备。
  • 设备或设备组特定的权限:这些权限定义在一个粒度级别访问您的帐户中的数据,如能够与一组特定的设备的报警。
  • 应用程序访问权限:这些定义,用户将看到他们的应用程序切换器的应用。

用户已使用以下规则计算的权限集:

  • 一个用户有被授予给用户的所有组的权限的总和。
  • 如果一个用户具有更广泛的权限,则忽略了相应的更具体的权限。例如,如果一个用户有权限查看所有应用程序,您不能编辑应用程序访问权限,直到您删除所有应用程序的权限为止。同样地,如果一个用户已完全访问完整的库存,任何库存相关的权限都将被忽略。
  • 设备- /组-特定的权限继承到所有的直接和间接的子设备和子资产。例如,如果您将“读“权限分配给一组设备,用户将自动能够看到该组中的所有设备。
分配帐户的权限

当您编辑一个组时,一个带有“角色“的表被列在组名的下面。这些表示以下类型数据的权限:

  • 租户统计:查看此帐户的使用数据,如系统管理应用程序的首页上显示的。
  • 选项管理:查看或编辑帐户选项,如密码策略。
  • 应用程序管理:查看或编辑在这个帐户中可用的应用程序。
  • 用户管理:查看或编辑用户、用户组和权限。
  • 自己的用户管理:查看或编辑自己的用户。
  • 标识:查看或编辑设备的标识符。
  • 库存:查看或编辑库存数据。
  • 测量:查看或创建设备的测量。
  • 事件:查看或创建设备事件。
  • 警报:查看或编辑设备的警报。
  • 审核:查看或创建设备的审计记录。
  • 设备控制:设备或查看或编辑命令。发送命令到设备。
  • CEP管理:查看或编辑QuarkIoE事件语言规则。
  • 保留规则:查看或编辑保留规则。
  • 批量操作:查看或创建批量操作。

对于各种类型,以下权限可用:

  • 阅读:阅读特定类型的数据。
  • 管理:创建、修改和删除特定类型的数据。(不包括“读“!)

请注意,不是所有类型的数据都可以被修改(例如,审计记录)。对于库存数据,有一个额外类型的权限:“创建“。“创建“权限允许用户在库存中创建设备,并完全管理用户拥有的这些设备。然而,用户不能读取或管理其他用户拥有的设备。这主要是用来限制设备的可用权限。

分配权限点击相应的复选框。如果您希望在特定的列中选择或清除所有条目,请使用顶部的按钮:

  • 清除所有:清除所有选中的角色。
  • 选择所有:选择所有的角色。
  • 选择所有读:选择“读“的所有类型和取消选择其他角色。
  • 选择所有的管理:选择“admin“和其他所有类型的选择。
全部角色
指定设备特定权限

要在设备级或设备组级别上分配更多的粒度权限,在编辑用户组的同时访问“用户权限“部分,或编辑用户组时“组权限“部分。

  • 通过键入管理对象的名称或名称,选择一个托管对象(设备或设备组)。
  • 为选定的托管对象选择此权限的范围。范围限制了该托管对象的特定类型的数据的权限。用星号(“*“)授予所有类型的托管对象的数据权限。
  • 限制数据(“类型“)中特定内容的权限(“类型“)。例如,限制用户只能发送启动命令到设备,使用“操作“的范围和“c8y_restart“型。再次,用星号(“*“)作为任何内容通配符。
  • 选择权限授予:使用“读“读取数据。使用“管理“来创建、修改和删除数据。用星号(“*“)指定读行政许可。
  • 点击“添加“按钮。
  • 点击“保存“按钮。
用户权限

如上所述,设备组的权限继承到该组的子设备和子资产。

分配应用程序访问权限

要将应用程序分配给特定的用户和用户组,访问该用户或用户组的“应用程序访问“部分。请注意,应用程序访问部分是不可见的,如果用户或用户组已经访问了所有应用程序。该部分显示市场应用程序和自己的应用程序。市场应用程序通常是您的帐户被订阅的应用程序。自己的应用程序是您添加到您的帐户中的应用程序,请参见下面的。检查应该向用户或用户组提供的所有应用程序。

Application access

管理应用

除了现成的市场应用,你也可以通过访问“我的应用程序“菜单提供自己的应用程序在您的帐户。这些应用程序可以“SmartApps“或通用的HTML5应用程序。

QuarkIoE,就像标准的设备管理、控制台和系统管理应用程序。SmartApps组装一套所谓的“插件“。插件在用户界面中提供新的功能。即使没有编程,你可以创建预变化提供的应用程序通过简单的组装自己的插件以不同的方式,例如,隐藏不需要的插件。了解更多信息,查看概念指南。

当一个应用程序被创建时,您可以通过在应用程序上的鼠标悬停来复制、打开和删除它。“克隆“函数重复应用程序,而“打开“按钮只打开应用程序。在“克隆“按钮被按下时弹出一个弹出窗口将出现一个独特的应用程序名称和应用程序路径需要输入。

我的应用程序
使用库应用程序

“库应用程序“的HTML5应用程序托管通过外部储存库。这样一个库可以是,例如,一个版本控制系统,如bitbucket或GitHub。完成配置:

  • 输入应用程序路径。此路径将是调用应用程序的链接的一部分。例如,如果你使用"hello"作为应用程序路径,应用程序的网址将是"/apps/hello"。
  • 输入您的应用程序托管的服务器地址。在这个网址,需要有一个index.html文件到您的应用程序提供了切入点。
  • 输入一个用户名来访问您的存储库(可选)。
  • 输入一个密码来访问您的存储库(可选)。
  • 点击“保存“。

用户名和密码是使用HTTP基本认证传输。

使用外部应用程序

“外部应用程序“仅仅是运行在其他地方的应用程序的链接。提供的网址,点击“保存“的应用,使链路可用的应用程序切换器。

编辑应用程序

要编辑一个应用程序,只需点击它的名称。根据应用程序的类型(例如托管的,外部的),不同的字段可以被修改。

请注意,“身份证“、“应用程序键“和“路径“不能更改一次配置。

订阅插件

配置通过SmartApps提供的功能,选择“插件“选项卡。订阅“插件“:

  • 通过点击名称选择应用程序。
  • 点击“插件“。
  • 通过通过可用插件列表滚动找到所需的插件。您可以通过从下拉菜单中选择一个插件类别来减少列表,或开始键入插件的名称。点击插件名称展开插件的描述。
  • 悬停在所需的插件,并点击“订阅“按钮。
  • 点击“保存更改“按钮。
插件

订阅插件,它们将显示在“订阅插件“列表。退订插件:

  • 悬停在订阅插件。
  • 单击“取消“。
  • 单击“保存更改“。
Unsubscribe plugin
上传档案

您可以在同一时间上传托管应用程序的不同版本,并在这些版本之间切换。上传存档:

  • 通过单击它的名称选择应用程序。
  • 点击“档案“标签。
  • 点击“上传存档“,并浏览到您的文件夹中的归档。
  • “上传“上传的档案QuarkIoE点击。
上传档案

一旦上传,档案可以下载,激活或删除,如果必要的话。活动存档(由云图标表示)是当前正在为您的帐户的用户提供的应用程序的版本。此版本不能被删除。

删除应用程序

要删除一个应用程序,只需在应用程序名称上悬停,然后单击“X“按钮。确认弹出窗口将出现。单击“确定“,应用程序将被删除。

删除应用程序

处理模拟器

QuarkIoE提供了一个简单的模拟能力的设备。通过这种方式,用户可以在开发过程中测试他们的应用程序对模拟设备。要查看模拟器部分,请单击“ “模拟器“中的“应用“菜单。

添加模拟器

添加新模拟器,电击"添加模拟器"

  • 输入模拟器名称。该名称将用于模拟设备。
  • 选择模拟实例的数量。例如,如果选择两个实例,创建了两套具有选定传感器的模拟设备。
  • 选择所需的传感器。这将揭示两个新的领域:“价值观“和“区间“。价值观“包含一个播放列表以分号分隔的数字,这将在“间隔“秒了。例如,如果你使用“16.7;18;20“作为“值“和5秒的间隔,第一个模拟传感器读数将是16.7。五秒后,18秒的第二个值将被记录。再过五秒,20将被记录。再过五秒,程序将从第一个值开始。
  • 点击“保存“

请注意,模拟器的最大数量是10。

添加模拟器
启动、暂停或删除模拟器

模拟器可以有两个状态,运行和暂停。要启动一个模拟器,先将其悬停在其名称上,然后单击“运行设备“按钮。

启动模拟器

要停止一个模拟器,只需按下“停止设备“按钮,而在所需的模拟器名称悬停。要删除一个模拟器,悬停在模拟器的名称,按下“X“按钮,并确认弹出窗口。

请注意,模拟器目前无法编辑。相反,你必须添加一个新的。

租户管理

与子租户可以100%个独立的数据从一个客户一个客户。

背景:作为租户管理员,您的租户中的所有数据都是从所有其他租户的数据中分离出的100%。然而,您的租户中的数据是默认共享的所有用户都有一个帐户,除非通过用户权限限制。此外,所有用户共享的数据,如用户帐户和分析规则。

如果你想要100%数据隔离不处理用户的权限,然后使用次租户。每个转租已经完全隔离的数据区。所有的quarkioe特征(如用户管理、应用管理、规则管理)用于无其他次租户转租的能见度。

此功能是一个可选的功能,这是不适用于所有租户。

如果您订阅了该功能,但您没有看到它,联系支持。

为了管理次租户点击次租户菜单。租户转租管理包括:创建、激活、悬浮、订阅的应用和选择。

子租户

注意租户ID仍然是独一无二的,所以没有两住户可以创建具有相同的“URL/ID“子租户。 还要注意,子租户不能创建一个额外的层次租户。

添加子租户

添加新的子租户,点击"建立租户"

请注意,用星号(“*“)领域是强制性的。

  • 输入新租户唯一的域/URL。这个URL讲用于接入应用程序(例如:tenant@quarkioe.com)。
  • 输入公司名称。
  • 输入管理员邮件地址。注意您需要提供一个有效的邮件地址用来重置用户密码。
  • 输入管理员用户名用来登录。
  • 输入联系人名,可选。
  • 输入联系人电话,可选。
  • 选择是否希望有密码重置链接作为电子邮件发送。如果您没有选择此选项,您将必须输入密码,并确认密码。(参见“登录)“关于密码强度的更多信息。
  • 点击"保存"按钮。
租户创建
编辑,停用和删除子租户

为了编辑子租户,点击需要修改的子租户。所有的字段都可以被编辑除了"ID"和"管理员名"。

当完成编辑后,点击"保存"按钮。

注意,当租户被暂停,他的数据还保留在数据库中,并且在以后的任意时间可被重新激活。另一方面,当租户被删除,他的数据将被删除。

鼠标停在一个租户上将显示"停用"和"删除"按钮。删除按钮显示为一个红叉形。要停用或删除租户,点击各自的按钮。

用量统计检索

用量统计菜单提供每一个子租户的信息。信息包括:

  • Id:唯一的子租户id。
  • 外部参考:这个字段是免费使用的,例如,你可以添加一个链接到客户关系管理系统,在这里或内部客户编号。
  • API需求: 多个API请求,包括从设备和应用程序来的请求。
  • 设备API请求: 多个从设备发来的API请求。
  • 存储(MB): 你账户中数据存储的大小。
  • 设备数: 租户中所有设备的连接数。
  • 用户申请: 该栏显示应用程序的转租订阅数。
  • 建立时间: 租户的建立日期和时间。
用量统计

事件处理管理

使用事件处理中,您可以指定实时业务逻辑是自动运行的quarkioe当新数据到达的或现有的数据被修改。该逻辑被部署在所谓的“模块“。模块包括一组语句,你写在quarkioe事件语言。点击“事件处理“,查看当前的模块或创建新的模块。

事件处理

一个用户友好的方式来指定实时业务逻辑是通过所谓的“智能规则在控制台应用程序提供的“。智能规则“也实现了QuarkIoE事件语言语句罩“下,你可以看到他们,当你点击“事件处理“。然而,您不能从事件处理用户界面编辑智能规则。

建立新模块

添加新模块,点击"新模块"。

  • 输入模块名字。您只能输入字母和数字并不能有空
  • 如果您想立即运行模块中的语句,将状态设置为“部署“。否则,将状态设置为“未部署“。
  • 在大文本字段开始输入您的CEL声明标记为"身体"。要获得一些灵感,请从"示例"下拉菜单中选择一个例子,然后点击"添加示例"。示例CEL声明将会黏贴到"身体"文本字段的游标位置。
  • 点击"保存"按钮。
新建模块

如果您选择“部署“状态,您将在用户界面上看到一个绿色的“连接“框。当你的语句产生一些输出时,你会看到它下面这个“连接“框。点击一行输出展开语句的详细输出。单击“清除所有“将从屏幕上删除输出。

管理模块

要修改您的模块,只需点击模块的名称。要删除您的模块,悬停在模块的名称,并单击“X“按钮。确认窗口将弹出。按“确定“,该模块将被删除。

删除模块

请注意,而不是删除模块,您也可以通过设置“状态“在“编辑“菜单中“未部署“来禁用它。不要忘记点击“保存“按钮。

变更报警优先顺序

“报警映射“让你改变的严重性和文本的报警,以适应他们对你的业务优先事项。例如,连接到一个设备的损失可能是至关重要的,但它是默认情况下,一个“重要“报警。要改变这一点,添加一个报警映射来改变连接损失到“严重“的警报。

报警映射
添加一个报警映射

要修改警报的严重性,确定要修改的报警类型,通过单击报警列表中的一个闹钟。然后在“报警映射“菜单中单击“添加报警映射“。

  • 输入要修改的报警类型。
  • 选择所需的新的严重程度,或选择“下拉“,以不显示所有的报警。
  • 输入一个新的报警文本。这一步是可选的。如果您不输入任何文本,报警中的原始文本将被保存。
  • 点击“保存“。
更改或删除报警映射

更改报警映射,

  • locate报警的报警和映射“部分单击对其名称。
  • 变化的严重程度和/或文本。
  • 点击"保存"。

删除报警级别,悬停在报警类型并单击“X“按钮。确认窗口将弹出。按“确定“删除报警映射。

更改设置

通过扩大“设置“菜单,管理员可以:

修改密码策略

要更改密码设置,请单击“密码“。要限制用户密码的有效性,设置用户必须更改密码的天数。如果你不想强迫你的用户改变密码,使用“0“为无限有效性的密码。

默认情况下,用户可以使用任何密码,包括八个字符或更长的时间。如果您选择“强制执行所有密码都是“强“(绿色)“,您的用户必须提供强大的密码,如“登录"。

默认情况下,系统限制用户不使用历史上使用的密码,换句话说,由用户提供的最后N个密码被系统和系统所记住,限制了用户不使用它们。N是可配置的,默认值为n为10。

点击"保存"来保存设置。

Password settings
修改默认应用

通过“应用程序“菜单,管理员可以更改在没有应用程序定义的用户中的所有用户在没有应用程序时所使用的默认应用程序。请务必使用一个所有用户都可以访问的应用程序。

修改接入控制设置

通过“应用程序“菜单,管理员可以启用跨域资源共享或“CORS“在quarkioe API。更多信息,见http://enable-cors.org。

启用服务器代理

在“服务器端代理“菜单中,“通过电子邮件发送仪表板“智能规则可以启用或禁用。启用,选中该复选框并单击“保存“。

进入OpenIT凭证。

在应用程序中的几个功能使用了短消息发送。它可以用来使登录更安全,有两个因素认证。当触发报警时,可以发送一条短信。短信可发送指令到设备。通过开启提供的服务可以使用这种效果。在这一节中,用户可以输入其凭据来激活需要发送短信的功能。

管理数据保留时间

“保留规则“让你控制多久的数据将被存储在你的帐户。例如,您可能需要存储测量值为90天,但已经删除了10天之后的警报。默认情况下,所有的历史数据被删除后60天。

保留规则通常是在夜间运行的。当您编辑保留规则时,您将不会看到即时效果,例如,在系统管理应用程序的首页上的使用部分中。

添加规则

要添加附加的“保留规则“,请单击“添加规则“。到“最大年龄“的领域,你可以输入一个星号(“*“)到各个领域,允许在这一领域的任何价值。

  • 选择要清理的数据类型(报警、测量、事件、操作、审计日志)。
  • 输入一个片段类型或类型,如果你想更具体的关于数据被清理。例如,清理所有的连接丢失报警规则,选择“报警“,进入“c8y_unavailabilityalarm“变成“type“。
  • 如果您想从特定设备中删除数据,将设备标识输入为“源“。
  • 输入“最大时间“(最大允许值为10年)。
  • 点击"保存"按钮。

Add retention rule

请注意,报警只被删除,如果他们是在“清除“状态。

要删除规则,请单击“X“按钮,然后单击“确定“后弹出弹出窗口。

管理存储配额报警邮箱

如果为租户设置存储配额,则只可见此部分。租户管理员可以设置一个用户组和一个电子邮件的阈值将被发送一天,如果存储使用的是高于存储配额的百分比。电子邮件警告也可以被禁用。默认设置是发送一封电子邮件给“管理员“组当存储达到80%最大存储。

管理文件

文件库提供了一个存储在您的帐户中的文件的概述。要查看这些文件,请单击“系统管理“菜单中的“文件库“。请注意这里列出的文件可能来自不同的来源。例如,他们可能是软件图像,从设备的配置快照,从设备或Web应用程序上传的“我的应用程序“菜单上传的日志文件。要删除一个文件,请单击“文件“旁边的“X“按钮。

文件存储

如果文件对应于一个有效的应用程序,它不能从这里删除。您首先需要删除或升级应用程序才能删除它。

存储配额

当设备的每个设备的存储配额由平台管理员设置时,存储配额为一个租户。可向用户提供的总存储是使用公式的每个设备X设备的存储配额计算的。每天晚上都要进行一次检查,以确保不超过配额。

在超过配额的情况下,一个电子邮件被发送到所有的租户管理员警告他们,数据将被删除的第24h后,如果配额仍超标,所有数据留存的限制是由一个固定的百分比降低。这个百分比被确定为允许存储的数据在配额下的最小值。

例如,让我们假设一个租户的10GB存储配额。留存规则是80天的测量值,所有其他数据的90天。

  • 第1日:在夜间检查,总的存储计算13gb。一封电子邮件发送给所有的租户管理员。
  • 第2日:库存总量仍在13gb。该系统确定保留规则的15%的减少是足够的存储配额下。因此,任何测量超过68天(80天- 15%)和任何其他数据,77天(90天- 15%结果在76.5天,四舍五入到77天)被删除。总的存储现在是9.8gb。