我的应用
创建应用
在我的应用中的顶部右侧找到创建应用按钮点击进入填写应用信息后创建应用,如下图:
管理
在我的应用页面找到创建好的应用点击管理进入配置应用,如下图:
应用信息
对应用的相关信息进行编辑设置,如下图:
说明:
-
服务商:系统自己生成,与账号的组织相关联
-
服务商电话:填写服务商的正确联系方式
-
应用协议:此应用的相关协议
-
应用预览图:此应用的预览图片
-
应用详情:应用的详细介绍,主要介绍实现功能与应用场景
-
标签管理:为此应用打上标签
开发测试管理
应用未上架前调试使用的地址,如下图:
说明:
- 应用回调地址(PC端):填写应用的访问地址(以http://开头)
- 应用回调地址(移动端):填写应用的访问地址(以http://开头)
- 是否接入应用安装确认事件默认是否。如果选择否上架的应用,开发者则无需对接应用的确认安装成功或失败的回调确认事件,组织在应用中心获取安装应用成功;相反如果选择是上架应用,开发者则需对接应用的确认安装成功或失败的回调确认事件,组织在应用中心获取安装应用才能安装成功。
文档管理
对开发对接中所需使用的文档进行上传管理,如下图:
权限管理
单击进入权限管理,可对开放api进行开通权限,也可根据权限状态进行筛选数据,同时需要那些权限只需要提交申请,待LicOS平台管理员审核通过即可使用,如下图:
事件订阅
针对组织和人员的变动,如用户离职、转岗变动后,如果订阅了会将对应的事件信息发到所填写的http://的地址上,应用放回收到所订阅过的事件信息。
用户事件
目前提供了:①用户事件:ACCOUNT_MODIFY(用户修改),ACCOUNT_NEW(用户新增),ACCOUNT_DELETE(用户删除)
用户事件 示例:用户新增
字段说明:
字段名 | 说明 |
---|---|
tenantId | 租户id |
msgId | 消息id |
type | 事件标识 |
content | 消息内容 |
accountId | 修改的账号id |
userStatus | 用户状态(正常NORMAL,禁用DISABLEL,冻结 FREEZE,删除DELETE) |
phone | 手机号码 |
alias | 别名 |
main | 是否主账号 |
avatar | 用户头像 |
orgId | 组织id |
邮箱 |
用户修改(编辑,启用,禁用)
用户删除
说明:用户新增和编辑时,当有多个部门时,会将多个orgId用逗号拼接的方式推送
组织事件
②组织事件:ORG_MODIFY(部门修改),ORG_DELETE(部门删除),ORG_NEW(部门新增)
组织事件 示例:部门新增
字段说明:
字段名 | 说明 |
---|---|
tenantId | 租户id |
msgId | 消息id |
type | 事件标识 |
content | 消息内容 |
name | 部门名称 |
description | 描述 |
orgId | 组织id |
parentId | 上级部门id |
部门修改
部门删除
应用事件
说明:这个事件只有从应用中心安装的应用才使用,控制台自建应用不使用。
③应用事件:APP_INSTALL(应用部署)-----应用安装后需要回调接口/msg/send/eventConfirm进行确认消息,确认是成功才会安装成功,并且展示在工作台;确认是失败,应用安装失败,不会展示在工作台。
其中,推送事件中新增operatorAccount字段,里面返回的内容是安装应用人的信息,同时已删除,已拒绝的用户不会推送,其余正常的用户,部门都会推送。
应用事件示例:应用安装
字段说明:
字段名 | 说明 |
---|---|
tenantId | 租户id |
msgId | 消息id |
type | 事件标识 |
content | 消息内容 |
appKey | 应用id |
accounts | 安装的那个租户下的人 |
operatorAccount字段中安装人信息的示例:
realname: 实名名称
说明:消息订阅的时候,应用安装事件是全量推;用户事件,组织事件是增量推
授权管理
授权方式
可以自定义应用的授权方式。授权方式有密码模式,刷新token,授权码,委托授权码,客户端模式
说明:①刷新token,授权码,客户端模式三种授权方式是必选的,其中刷新token也可以不选,但是不选的话access_token过期后无法更新;
②委托授权码授权方式是基于LicOS平台会话使用的,如果没有勾选,在工作台或已装应用上点击进入应用就不能免登进入,要免登就必须勾选;
③密码模式授权方式是会返回所有的token信息,使用会有一定的风险,建议可以不用勾选。
授权字段
选择添加所需要的授权字段后,在ID token中返回
对应授权字段说明:
序号 | 字段名称 | 字段类型 | 是否是标准字段 | 字段描述 | |
---|---|---|---|---|---|
1 | azp | 字符串 | 是 | 授权方 | |
2 | app_admin | 字符串 | 否 | 是否是应用管理员 | |
3 | iss | 字符串 | 是 | 令牌颁发者 | |
4 | aud | 字符串 | 是 | token接收者 | |
5 | powerList | 字符串 | 否 | 用户能力 | |
6 | phone_number | 字符串 | 否 | 用户电话号码 | |
7 | nickname | 字符串 | 否 | 用户昵称 | |
8 | name | 字符串 | 否 | 用户名 | |
9 | accountList | 字符串 | 否 | 账号信息列表 | |
10 | account_id | 字符串 | 否 | 账号id | |
11 | picture | 字符串 | 否 | 账号头像 | |
12 | phone_number_verified | 字符串 | 否 | 是否认证 | |
13 | tenant_name | 字符串 | 否 | 租户名称 | |
14 | sub | 字符串 | 是 | 主题标识符,用户id | |
15 | tenant_id | 字符串 | 否 | 租户id |
认证与安全
可以对应用的ID token,授权码设置有效期,另外授权码还能设置是否可循环使用;accesstoken,refreshtoken可以设置生成策略配置,另外refreshtoken还可以设置有效期
订阅主题配置
可以针对自己创建的应用,配置主题内容,提交审核,如下图:
说明:主题中的推送方式可以单条提交审核,也可以多条同时提交审核
应用上架
对创建的在线应用进行上架到应用中心或代理商,目前只是支持二选一要么上架到代理商,要么上架到应用中心。
上架到应用中心
上架到应用中心的应用是需要审核的,待LicOS平台管理员审核通过后,组织即可在应用中心获取安装,如下图:
说明:上架到应用中心的应用是对所有组织可见的。第一次上架时如果有未审核的主题和接口权限,上架会给出提示,需要审核通过后才能操作上架。
上架到代理商
上架到代理商的应用是不需要审核的,由对应代理商自己管理,代理商将应用分配到对应项目下,同时添加客户后,只有对应的客户到应用中心才能看到对应应用,即可在应用中心获取安装,如下图:
说明:
1.上架到代理商的应用只有被代理商分配过的客户才可见;
2.上架到代理商时,需先接收邀请成为某一个代理商的isv,才能上架到此代理商。
3. isv可以接受多个代理商的邀请,成为多个代理商的isv。
下架
可以直接在我的应用列表操作下架,也可以管理的应用上架处操作下架,如下图: