-
Notifications
You must be signed in to change notification settings - Fork 376
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #20 from Tencent/mobile_dev
Mobile dev
- Loading branch information
Showing
53 changed files
with
886 additions
and
519 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,68 @@ | ||
# 移动端部署 | ||
标准运维移动端需要通过企业微信进行访问,所以需要绑定企业微信的应用访问链接到你部署的蓝鲸社区版平台。 | ||
|
||
## 企业微信管理端配置 | ||
|
||
### 登录企业微信管理后台 | ||
打开浏览器访问链接 `https://work.weixin.qq.com/`,使用企业微信扫码登录,注意需要使用有管理员权限的用户。 | ||
|
||
### 企业微信新建应用 | ||
点击导航中"应用管理",在自建应用中点击"新建应用",应用logo请上传标准运维SaaS的logo,应用名称填写"标准运维",应用介绍可以选填,可见范围 | ||
根据企业内需求配置,如果希望企业内所有人都可以访问,请选择组织架构中的根节点。 | ||
|
||
### 企业微信应用管理 | ||
- 点击上一步新建的标准运维应用,在"功能"中找到"工作台应用主页",应用主页配置为 `http[https]://{BK_PAAS_HOST}/o/bk_sops/weixin/`, | ||
并勾选"在微工作台中始终进入主页"。 | ||
|
||
- 在"开发者接口"中找到"网页授权及JS-SDK",并设置可信域名为 {BK_PAAS_OUTER_HOST}。 | ||
![](../resource/img/mobile_work_weixin_config.png) | ||
|
||
- 在"开发者接口"中找到"企业微信授权登录",并设置授权回调域为 {BK_PAAS_OUTER_HOST}。 | ||
其中,{BK_PAAS_OUTER_HOST} 为你部署的蓝鲸外网域名,如果是 HTTPS 协议,"企业微信授权登录"中授权回调域请添加端口号 443, | ||
即 `{BK_PAAS_HOST}:443`。 | ||
![](../resource/img/mobile_auth_domain.png) | ||
|
||
|
||
## 蓝鲸消息通知渠道配置 | ||
以蓝鲸管理员身份访问蓝鲸开发者中心,进入"API网关"的"通道管理",选择"[CMSI]蓝鲸消息管理",编辑"[CMSI]发送微信消息",在"组件配置" | ||
中修改配置,具体方法参考"API网关"的"使用指南"中"微信消息组件"章节,注意: | ||
|
||
- wx_type 选择"企业微信" | ||
- wx_qy_corpid 填写企业微信后台管理中"我的企业"页面的"企业ID" | ||
- wx_qy_agentid 填写企业微信后台的应用管理中标准运维应用的 AgentId,该应用会作为默认微信消息通知渠道 | ||
- wx_qy_corpsecret 填写企业微信后台的应用管理中标准运维应用的 Secret | ||
|
||
![](../resource/img/mobile_agentid.png) | ||
|
||
|
||
## 标准运维部署 | ||
|
||
### 环境变量配置 | ||
标准运维首次部署默认不开启移动端,如果需要开启移动端,需要在蓝鲸"开发者中心"配置标准运维应用的环境变量,如下图所示,其中, | ||
BKAPP_USE_WEIXIN(是否开启移动端)值设置为 1,BKAPP_IS_QY_WEIXIN(是否使用企业微信)值设置为 1,BKAPP_WEIXIN_APP_ID(企业ID) 的值 | ||
设置为企业微信后台管理中"我的企业"页面的"企业ID",BKAPP_WEIXIN_APP_SECRET(企业应用Secret) 的值设置为企业微信后台的应用管理中标准 | ||
运维应用的 Secret,BKAPP_WEIXIN_APP_EXTERNAL_HOST(蓝鲸外网域名) 的值设置为你部署的蓝鲸外网域名 {BK_PAAS_OUTER_HOST}。 | ||
|
||
### 重新部署 | ||
设置标准运维应用运行时的环境变量后,需要重新部署才能生效. | ||
|
||
## 移动端用户绑定企业微信 | ||
已授权的移动端用户首次使用标准运维前,需要在蓝鲸桌面绑定企业微信。在蓝鲸的"个人中心"中点击头像(企业版点击"绑定微信"),通过企业微信扫描二维码绑定。在完成 | ||
企业微信绑定后,请再次访问标准运维SaaS以便同步企业微信账号信息,然后就可以在企业微信的"工作台"访问标准运维移动版了。 | ||
|
||
## FAQ | ||
|
||
### 蓝鲸个人中心找不到绑定企业微信入口 | ||
可能是蓝鲸消息通知渠道配置错误,请确认按照上述教程配置并保证变量值正确。 | ||
|
||
### 移动端打开后报错"redirect_uri需使用可信域名" | ||
<img src="../resource/img/mobile_error_redirect_uri.png" height = "400" align=center /> | ||
可能是企业微信后台管理中"网页授权及JS-SDK"配置错误,请设置可信域名为你部署的蓝鲸外网域名。 | ||
|
||
### 移动端打开后报错"网页发生错误" | ||
<img src="../resource/img/mobile_error_web.png" height = "400" align=center /> | ||
可能是标准运维SaaS的环境变量配置错误,请检查BKAPP_WEIXIN_APP_ID(企业ID)、BKAPP_WEIXIN_APP_SECRET(企业应用Secret)、 | ||
BKAPP_WEIXIN_APP_EXTERNAL_HOST(蓝鲸外网域名)配置是否正确。 | ||
|
||
### 移动端打开后业务列表为空 | ||
请在蓝鲸"个人中心"绑定企业微信后,先访问一次 PC 端标准运维SaaS,并确保能访问业务数据,然后再访问移动端。 |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.