山河对象存储通过请求中的 签名串 来验证用户身份。签名串中的 Access Key 需要用户事先从 管理控制台 申请并配置到应用程序中。如果用户发送没有经过签名的请求至山河对象存储，我们称之为匿名用户。

本文主要介绍，通过了用户身份验证后的请求，该如何对其进行访问权限的控制。山河对象存储的访问控制方式有三种：

• Bucket Policy (Bucket 策略)
• Bucket ACL (Bucket 访问控制列表)
• Bucket CORS (Bucket 的跨域资源共享策略)

说明

• 针对每个请求，Bucket Policy 的匹配顺序优先于 Bucket ACL。即：当 Policy 规则匹配了允许或者拒绝后，该 Policy 规则就立刻生效；只有当 Policy 中未匹配到相应规则时，才会继续检查 ACL 的设置。
• 为了安全考虑，Bucket 创建，删除，监控信息等 API 不允许匿名访问。
• 删除 Bucket，ACL，Policy 等设置类 API 只允许 Bucket 拥有者自己调用。
• 获取 Object 列表默认情况下不允许匿名调用 (无论是否设置公开可读)，需要显式配置 Bucket Policy 指定后才可匿名调用。

存储空间策略(Bucket Policy)

功能介绍

Bucket Policy 对于储存于山河对象存储的资源的访问控制粒度介于 Bucket ACL 和 Object ACL (对象访问控制列表，尚未推出) 之间。Bucket Policy 可以通过指定 API 级别的控制，从而实现 Bucket ACL 和 Object ACL 所不能实现的一些功能，比如防盗链。 通过设置 Bucket Policy，可以向其他山河用户赋予相应 Bucket 及其对象的访问权限。

详细操作步骤如下：

操作步骤

1. 进入山河对象存储的主页面，选择待设置 Policy 的 Bucket，点击 右键 > 设置：

2. 进入 Bucket 设置页面，点击 存储空间策略 > 添加规则：

3. 在弹出的 规则设置 对话框内，根据页面提示信息，填写相关参数后，点击 保存 按钮：

说明：

• 操作： 指定该 Bucket 策略支持的 API 操作。
• 资源： 指定该 Bucket 策略生效的资源范围。
  • 缺损时，说明该规则对 Bucket 列表页的所有 Bucket 生效；
  • 以 <bucket-name>/ 为前缀，说明该规则仅对 <bucket-name>/ 所指定的 Bucket 内相应资源生效；
  • 若需针对指定 Bucket 内所有资源生效，需填写 <bucket-name>/*。
• 响应动作： 当策略成功匹配用户的请求时，是允许还是拒绝该请求。
• Referer： 指定请求来源。

4. 成功创建的存储空间策略，列表显示：

相关API

操作	API	说明
设置 Bucket Policy	PUT Bucket Policy	用于设置存储空间策略
获取 Bucket Policy	GET Bucket Policy	用于获取已有的存储空间策略
删除 Bucket Policy	DELETE Bucket Policy	用于删除已经设置的存储空间策略

存储空间访问控制列表(Bucket ACL)

功能介绍

相较于 Bucket Policy 和 Object ACL，Bucket ACL 对山河对象存储的资源访问控制粒度要更大一些。被授权者的权限列表仅可为 可读，可写，或 可读写。使用起来也更加简单。

Bucket 拥有者默认拥有所有权限，另外可配置公开读或公开写(即不附带认证信息的匿名访问)，也可以针对特定山河用户来配置读写权限.

操作步骤

1. 进入山河对象存储的主页面，选择待设置访问控制列表的 Bucket，点击 右键 > 设置：

2. 进入 Bucket 设置页面，点击 访问控制 > 添加用户：

3. 在弹出的 Bucket 访问控制 对话框内，根据需求，填写相关参数后，点击 提交 按钮：

说明：

• 若需将相应的权限开放给所有人，即允许匿名访问，可以选择 所有用户 。
• 若需将相应的权限开放给指定的用户，则在用户输入框输入指定的山河用户 ID 或用户邮箱。

相关API

操作	API	说明
设置 Bucket ACL	PUT Bucket ACL	用于设置存储空间访问控制列表
获取 Bucket ACL	GET Bucket ACL	用于获取已有的存储空间访问控制列表

存储空间的跨域资源共享策略(Bucket CORS)

功能介绍

当您利用 JavaScript AJAX 向山河对象存储发起的请求属于跨源请求时，默认情况下浏览器为了安全考虑，会拒绝该请求。因为浏览器默认不允许调用不同域名下的资源，因为您的网站域名跟 山河对象存储的域名不一样。这种情况下需要为 Bucket 配置 CORS 规则.

Bucket CORS 可以对请求来源的域名和请求头进行控制。详细操作如下：

操作步骤

1. 进入山河对象存储的主页面，选择待设置 CORS 的 Bucket，点击 右键 > 设置：

2. 进入 Bucket 设置页面，点击 CORS > 添加请求源：

3. 在弹出的 添加请求源 对话框内，根据页面提示，填写相关参数后，点击 提交 按钮：

4. 用户也可通过点击 导入请求源，将其他 Bucket 已设置的 CORS 源，导入当前 Bucket 中：

5. 在弹出的 导入请求源 对话框内，选择源 Bucket 与源冲突时的解决方式后，点击 提交 按钮：

相关API

操作	API	说明
获取 Bucket CORS	GET Bucket CORS	用于获取已设置的 Bucket CORS 规则
设置 Bucket CORS	PUT Bucket CORS	用于设置 Bucket CORS 规则
删除 Bucket CORS	DELETE Bucket CORS	用于删除已设置的 Bucket CORS 规则