Skip to content

Latest commit

 

History

History
64 lines (44 loc) · 2.27 KB

authentication.md

File metadata and controls

64 lines (44 loc) · 2.27 KB
Raw

授权认证

鉴权方式

用户管理后台 API 采用的 Cookie-base 的授权方式来实现用户身份的授权。

运营后台需要知晓云管理后台的管理员身份进行操作，因此，运营后台不需要关心用户的登录注册流程，只需要保证用户在访问运营后台之前登录了知晓云后台即可。

授权接入

开发者需要将以下代码片段放入用户管理后台的 .html 文件中，来完成用户身份的验证:

<!-- 其中 client_id 需替换为您应用的 ClientID，envID 替换为开发环境 ID，如果是生产环境，则不需要填写 -->
<script src="https://cloud.minapp.com/custom-userdash/auth/<client_id>/?env_id=<envID>"></script>

生产环境示例：

<html>
  <head>
    <script src="https://cloud.minapp.com/custom-userdash/auth/[[client_id]]/"></script>
  </head>
  <body>
  </body>
</html>

开发环境示例：

<html>
  <head>
    <script src="https://cloud.minapp.com/custom-userdash/auth/[[client_id]]/?env_id={{envID}}"></script>
  </head>
  <body>
  </body>
</html>

info 上述代码会自动检查用户是否登入知晓云，若未登录则引导其登录。

用户管理后台可能会存在多个管理页面，需要保证每个管理页面的 head 都加入上述代码片段，以确保页面的登录状态。

用户管理后台开发与调试

用户管理后台允许开发者进行本地调试开发。流程如下：

  1. 下载我们准备的一个包含 index.html 文件的 zip 包。（点此下载）

  2. 打开知晓云管理后台 - 设置模块（cloud.minapp.com/dashboard/#/app/settings/info/），点击一键部署后台，将上一步下载的 zip 包上传部署，开启部署功能。

  3. 启动静态服务器，如 nginx、apache、react 脚手架、vue 脚手架等，使得本地可以通过 localhost、127.0.0.1 访问页面。

  4. 在登录了知晓云管理后台（cloud.minapp.com/dashboard/）的浏览器，访问对应的开发页面地址。

  5. 即可开始开发和调试。

info 项目中对静态资源的引用，请使用相对路径，如：./style.css

单页应用的路由请使用 hash 路由，如：http://test.com/#index