本页尚未翻译,当前显示英文版本。
访问控制
每个 Entity 都规定谁可以读、谁可以写,每个 Function 都规定谁可以运行。 访问权限按调用方设置:游戏客户端、你的服务器和云函数。对于 Player 拥有的 Entity,所有权会进一步把客户端限制在自己的 Record 上。Entity 的访问权限在 Schema 的 Entity 编辑器中设置;Function 的访问权限在 Function 的 manifest 中设置。
调用方
| 调用方 | 身份 |
|---|---|
| Client | 你的游戏,使用客户端密钥(pk_…)以匿名或已登录 Player 的身份登录。 |
| Server | 你自己的服务器和工具,使用服务器密钥(sk_…)。 |
| Backend | 你的云函数,以自己的身份回调平台。 |
Backoffice 本身不受这些设置约束。
Read 与 Write
每个 Entity 针对每类调用方都有一个 Read 开关和一个 Write 开关。 Write 涵盖所有变更:创建、更新和删除 Record 都算在内。没有单独的删除权限。
| 调用方 | Read | Write |
|---|---|---|
| Client | 关 | 关 |
| Server | 开 | 开 |
| Backend | 开 | 开 |
这是新建 Entity 的默认值:对客户端关闭,对你的服务器和 Function 开放。在你允许之前,客户端既不能读也不能写新的 Entity。
访问权限按固定顺序判定:先看调用方是否可以读或写该 Entity;如果是客户端访问 Player 拥有的 Entity,再看它可以操作哪些 Record。
在 Backoffice 中设置访问权限
打开 Entity 编辑器
在 Schema 中选择该 Entity,点击其名称旁的铅笔图标。新建 Entity 时,同样的设置位于 New ▾ → Entity 中。
设置 Read 和 Write
在 Access control 下,为每类调用方勾选 Read 和 Write。
暂存并应用
点击 Apply changes 暂存修改,然后审阅并应用迁移。访问权限的变更随迁移一起上线。
共享 Entity 上的客户端 Write 让任何 Player 都能修改任何 Record
在不属于 Player 的 Entity 上,客户端 Write 不受任何限制:每个 Player 都能修改或删除每一条 Record。只对本来就要共享的数据开放它,每个 Player 自己的数据请使用 Player 拥有的 Entity。
通过代码设置访问权限
在 Unity 项目中定义的 Entity,通过 [PlayServSchema] 特性设置访问权限,SDK 的 schema 工具会把它与 schema 一起推送。每个开关的取值为 Default、Allow 或 Deny:
using Playserv.Schema;
[PlayServSchema("Pilots",
OwnedBy = PlayServSchemaOwner.Player,
Read = PlayServSchemaReadPolicy.Owner,
OnPlayerDelete = PlayServPlayerDeletePolicy.Anonymise,
ClientRead = PlayServSchemaAccess.Allow,
ClientWrite = PlayServSchemaAccess.Allow)]
public class Pilots
{
public string Callsign;
public int Level;
}
ServerRead、ServerWrite、BackendRead 和 BackendWrite 以同样的方式设置其他调用方。通过代码设置的访问权限与在 Backoffice 中设置的,存储和执行方式完全相同。从代码推送的 Entity 在 Backoffice 中只读,访问权限也不例外:请在代码中修改。
Player 拥有的 Entity
在 Player 拥有的 Entity 上,Read 和 Write 仍然决定客户端能否访问它,而所有权决定能访问哪些 Record。
| 客户端…… | Read access 为 Owner | Read access 为 Public |
|---|---|---|
| 读取 | 只能读取自己的 Record。没有已登录的 Player 时会被拒绝。 | 所有 Record。 |
| 创建 | 创建归其 Player 所有的 Record。没有已登录的 Player 时会被拒绝。 | 同左。 |
| 更新或删除 | 只能操作自己的 Record。 | 只能操作自己的 Record。 |
服务器和 backend 的调用不受限制:它们可以读取、更新和删除任意 Record。要在 Player 拥有的 Entity 中创建 Record,它们需要代表某个 Player 操作,该 Player 即成为 Record 的所有者。
对客户端来说,属于其他 Player 的 Record 是不可见的,而不是被禁止访问:读取、更新或删除它都会返回 404,与不存在的 Record 完全一样。客户端代码无法区分这两种情况,这是有意为之。
游戏客户端中的检查
最终决定权始终在平台。Unity SDK 也会在发送请求前检查访问权限:当它知道某个 Entity 对客户端关闭时,会刷新一次本地缓存的访问设置;如果该 Entity 仍然关闭,就直接在本地以 access-denied 错误让调用失败,而不再发送请求。