# 令牌管理

US3 令牌功能可以根据用户的需求灵活的开放存储空间和文件管理权限。

一个令牌由一对特殊的公私钥组成。其中包括了：允许操作的存储空间列表、允许操作的文件前缀列表、操作权限和令牌过期时间等属性。

用户可以按需申请不同令牌来完成不同权限的管控。

用户可以通过以下方式管理 US3 令牌：

1. 登陆 DezaiCloud 官方控制台，进入 [US3 - 令牌管理](https://console.dezai.com/ufile/token)。


## 创建/编辑令牌

<!-- image-todo -->

1. 令牌名称：用于标识令牌，用户自定义。

2. 有效时长：令牌生效的时间，首次设置完成后，可通过编辑令牌操作重新设置过期时间。

3. 授权的存储空间：存储空间可选一个或多个，表示该令牌只能操作这些存储空间。一个令牌不能存在多个地区的存储空间，比如只能选择北京或者上海的存储空间，不能同时选择两个地区。

4. 黑名单：可设置一个或多个IP黑名单，限制IP黑名单中的IP列表访问。

5. 白名单：可设置一个或多个IP白名单，授权IP白名单中的IP列表访问，如未设置白名单，则默认不对IP进行白名单控制，仅限制黑名单的IP地址访问。当前UHost内网由于采用IPv6网络，白名单暂时无法识别内网的IPv4的虚拟IP地址，故白名单暂时还不支持控制UHost主机的内部访问权限。

6. 授权文件：可选择授权所有文件，也可设置一个或多个文件前缀，表示该令牌只能访问这些前缀的文件。

7. 令牌权限：令牌的操作权限有上传、下载、删除、文件列表、图片处理，可多选或者不选。

8. 高级权限：当设置的令牌具有上传权限时，可设置禁止覆盖权限，禁止用户上传时覆盖同名文件。

> 注意：编辑令牌的生效等待时间约5分钟，请以实际生效时间为准。

## 示例

一个完整的令牌的例子如下所示：

```

公钥：TOKEN_da044c8a-20bc-42a1-8b04-850535c75330

私钥：6318b15a-faf3-4577-890d-79855313dfd9

过期时间：2019-04-19 00:00:00

授权存储空间：test, test1, test2

授权文件前缀：file_prefix, file_prefix1, file_prefix2

访问白名单：

访问黑名单：

文件管理权限：上传，下载，删除，文件列表，图片处理

高级权限：

```