Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
156a6dee
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
156a6dee
编写于
10月 26, 2022
作者:
雪洛
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: update secure network
上级
1b2d2ec2
变更
3
显示空白变更内容
内联
并排
Showing
3 changed file
with
56 addition
and
24 deletion
+56
-24
docs/uniCloud/client-sdk.md
docs/uniCloud/client-sdk.md
+40
-0
docs/uniCloud/secure-network.md
docs/uniCloud/secure-network.md
+7
-24
docs/uniCloud/uni-id-pages.md
docs/uniCloud/uni-id-pages.md
+9
-0
未找到文件。
docs/uniCloud/client-sdk.md
浏览文件 @
156a6dee
...
...
@@ -26,6 +26,7 @@ uniCloud分为客户端和云端两部分,有些接口名称相同,参数也
|uniCloud.offNeedLogin() |移除监听需要登录事件
[
详情
](
#off-need-login
)
|
|uniCloud.onRefreshToken() |监听token更新事件
[
详情
](
#on-refresh-token
)
|
|uniCloud.offRefreshToken() |移除监听token更新事件
[
详情
](
#off-refresh-token
)
|
|uniCloud.initSecureNetworkByWeixin() |在微信小程序安全网络请求发送之前与云函数握手
[
详情
](
#init-secure-network-by-weixin
)
|
### 获取当前用户信息getCurrentUserInfo@client-getcurrentuserinfo
...
...
@@ -415,6 +416,45 @@ uniCloud.onNeedLogin(log)
uniCloud
.
offNeedLogin
(
log
)
```
### 微信小程序安全网络初始化@init-secure-network-by-weixin
> 新增于 3.6.8
安全网络相关文档请参考:
[
安全网络
](
secure-network.md
)
**参数**
|参数 |类型 |必填 |默认值 |说明 |
|--- |--- |--- |--- |--- |
|callLoginByWeixin|boolean|否 |false |是否在安全网络初始化同时执行一次uni-id-co的微信登录|
**示例**
```
js
// App.vue
<
script
>
export
default
{
onLaunch
:
async
function
()
{
// #ifdef MP-WEIXIN
const
res
=
await
uniCloud
.
initSecureNetworkByWeixin
({
callLoginByWeixin
:
true
})
// #endif
console
.
log
(
'
initSecureNetworkByWeixin
'
,
res
);
console
.
log
(
'
App Launch
'
)
}
}
<
/script
>
<
style
>
<
/style>
```
**注意**
-
发送安全网络请求前uniCloud客户端sdk会判断是否完成初始化,如未完成会等待完成后再发送安全网络请求。
-
需要确保安全网络请求在此方法调用后执行
## 属性
### 获取当前uniCloud实例的服务商
...
...
docs/uniCloud/secure-network.md
浏览文件 @
156a6dee
...
...
@@ -82,7 +82,7 @@ App和微信小程序略有区别,但大体都要经过如下流程:
3.
工程中导入uni-id-pages
-
`uni-id`
[
文档
](
uni-id-summary.md#save-user-token
)
-
`uni-id-
co`
[
插件下载地址
](
https://ext.dcloud.net.cn/plugin?id=8577
)
-
`uni-id-
pages`
[
插件下载地址
](
https://ext.dcloud.net.cn/plugin?id=8577
)
,需要
`uni-id-pages 1.0.27`
及以上版本
`uni-id-pages`
这个插件是云端一体的登录插件,其实安全网络只需要其中的
`uni-id-co`
云对象。插件中前端登录页面是否使用由开发者自己根据业务决定。
...
...
@@ -135,45 +135,27 @@ App和微信小程序略有区别,但大体都要经过如下流程:
如果项目之前已经使用过uni-id-pages和uni-open-bridge,则上述步骤可省略。
6.
在应用的生命周期
`onLaunch`
中检查微信登陆状态,如果过期需要登陆
注意:
[
uni.checkSession
](
https://uniapp.dcloud.net.cn/api/plugins/login.html#uni-checksession
)
有调用次数限制警告,一个
`pv`
可调用
`2`
次
6.
在应用的生命周期
`onLaunch`
调用
`uniCloud.initSecureNetworkByWeixin()`
,进行安全网络请求前的握手操作,关于此接口详细描述见:
[
uniCloud.initSecureNetworkByWeixin
](
client-sdk.md#init-secure-network-by-weixin
)
App.vue页面需要补充如下代码:
```
js
<
script
>
function
checkUserSession
()
{
uni
.
checkSession
({
fail
:
(
err
)
=>
{
uni
.
login
({
success
:
async
({
code
})
=>
{
const
uniIdCo
=
uniCloud
.
importObject
(
'
uni-id-co
'
)
// uniCloud云对象 uni-id-co
await
uniIdCo
.
loginByWeixin
({
code
})
}
})
}
})
}
export
default
{
onLaunch
:
function
()
{
console
.
log
(
'
App Launch
'
)
onLaunch
:
async
function
()
{
// #ifdef MP-WEIXIN
checkUserSession
();
await
uniCloud
.
initSecureNetworkByWeixin
()
// #endif
}
}
<
/script>
```
在此方法内部会调用一次微信小程序的login,然后使用返回的code调用
`uni-id-co`
的
`secureNetworkHandshakeByWeixin`
方法(新增于uni-id-pages 1.0.27)
7.
在项目根目录manifest.json文件内为微信小程序平台开启
`云端一体安全网络模块`
!
[
微信小程序云端一体安全网络模块
](
https://f184e7c3-1912-41b2-b81f-435d1b37c7b4.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/ab96f1f7-af14-4f08-8b1c-699ecfce3381.jpg
)
**注意**
-
发送安全网络请求前如果检测到客户端storage内不存在
`uni_id_token`
(即用户未登录),则会自动调用一次
`uni-id-co`
的
`loginByWeixin`
方法进行一次登录
## 客户端验证@verify-client
> 新增于 HBuilderX 3.6.8
...
...
@@ -215,6 +197,7 @@ App.vue页面需要补充如下代码:
**注意**
-
如果修改客户端验证配置需要重新打包做出修改的客户端。
-
如需对clientDB请求验真需要使用
`uni-clientDB`
作为云函数名
## 数据加密传输@encrypt-data
...
...
docs/uniCloud/uni-id-pages.md
浏览文件 @
156a6dee
...
...
@@ -1495,6 +1495,15 @@ await uniIdCo.setPushCid({
|
|
-
token |string |token |
|
|
-
tokenExpired|string |token过期时间 |
#### 微信安全网络握手@secure-network-handshake-by-weixin
此接口用于微信小程序端安全网络的握手,安全网络相关文档请参考:
[
安全网络
](
secure-network.md
)
一般无需通过uniCloud.importObject方式调用,在客户端调用
`uniCloud.initSecureNetworkByWeixin()`
时会通过此接口获取会话相关信息。
此接口会将会话信息存储在
`opendb-open-data`
表内,如果在
`initSecureNetworkByWeixin`
方法内传递了
`callLoginByWeixin: true`
会在存储会话信息的同时执行一次uni-id-co的
`loginByWeixin`
方法
### 管理接口@admin
#### 管理员新增用户@add-user
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录