ACL 访问控制实践

2025-11-21   访问量:0


ACL 概述

访问控制列表(ACL)是基于资源的访问策略选项之一 ,可用来管理对存储桶和对象的访问。使用 ACL 可向其他主账号、子账号和用户组,授予基本的读、写权限。更多介绍请参见 ACL

与访问策略有所不同的是,ACL 的管理权限有以下限制:

仅支持对腾讯云的账户赋予权限

仅支持读对象、写对象、读 ACL、写 ACL 和全部权限等五个操作组

不支持赋予生效条件

不支持显式拒绝效力

ACL 支持的控制粒度:

存储桶(Bucket)

对象键前缀(Prefix)

对象(Object)

ACL 的控制元素

当创建存储桶或对象时,其资源所属的主账号将具备对资源的全部权限,且不可修改或删除。您可以使用 ACL 赋予其他腾讯云账户的访问权限。 如下提供了一个存储桶的 ACL 示例(API 请求体)。ACL 包含了识别该存储桶所有者的 Owner 元素,该存储桶所有者具备该存储桶的全部权限。其中100000000001表示存储桶所有者的主账号,100000000002表示被授权的主账号且授予了 WRITE 权限。同时 Grant 元素授予了全局用户组 AllUsers 拥有读取权限,其表述形式为http://cam.qcloud.com/groups/global/AllUsers的 READ 权限。

<AccessControlPolicy>    <Owner>        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>    </Owner>    <AccessControlList>        <Grant>            <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">                <URI>http://cam.qcloud.com/groups/global/AllUsers</URI>            </Grantee>            <Permission>READ</Permission>        </Grant>        <Grant>            <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">                <ID>qcs::cam::uin/100000000002:uin/100000000002</ID>            </Grantee>            <Permission>WRITE</Permission>        </Grant>    </AccessControlList></AccessControlPolicy>

权限被授予者

主账号您可以对其他主账号授予用户访问权限,使用 CAM 中对委托人(principal)的定义进行授权。描述为:

qcs::cam::uin/100000000002:uin/100000000002

子账号您可以对您的主账号下的子账号(如100000000011),或其他主账号下的子账号授权,使用 CAM 中对委托人(principal)的定义进行授权。描述为:

qcs::cam::uin/100000000001:uin/100000000011

匿名用户您可以对匿名用户授予访问权限,使用 CAM 中对委托人(principal)的定义进行授权。描述为:

http://cam.qcloud.com/groups/global/AllUsers

权限操作组

以下表格提供了 ACL 支持的权限操作组。

操作组

授予存储桶

授予前缀

授予对象

READ

列出和读取存储桶中的对象

列出和读取目录下的对象

读取对象

WRITE

创建、覆盖和删除存储桶中的任意对象

创建、覆盖和删除目录下的任意对象

不支持

READ_ACP

读取存储桶的 ACL

读取目录下的 ACL

读取对象的 ACL

WRITE_ACP

修改存储桶的 ACL

修改目录下的 ACL

修改对象的 ACL

FULL_CONTROL

对存储桶和对象的任何操作

对目录下的对象做任何操作

对对象执行任何操作

标准 ACL 描述

COS 支持一系列的预定义授权,称之为标准 ACL,下表列出了标准 ACL 的授权含义。

注意:

由于主账号始终拥有 FULL_CONTROL 权限,以下表格中不再对此特别说明。

标准 ACL

含义

(空)

此为默认策略,其他人无权限,资源继承上级权限

private

其他人没有权限

public-read

匿名用户组具备 READ 权限

public-read-write

匿名用户组具备 READ 和 WRITE 权限,通常不建议在存储桶赋予此权限

使用方法

使用控制台操作 ACL

对存储桶设置 ACL以下示例表示允许另一个主账号对某个存储桶有读取权限,具体操作指引请参见 设置存储桶访问权限







对对象设置 ACL以下示例表示允许另一个主账号对某个对象有读取权限,具体操作指引请参见 设置对象的访问权限





注意:

如使用子账号访问存储桶或对象出现无权限访问的提示,请先通过主账号为子账号授权以便能够正常访问存储桶,操作步骤请参见 子账号访问存储桶列表

使用 API 操作 ACL

存储桶 ACL

API

操作名

操作描述

PUT Bucket acl

设置存储桶 ACL

设置指定存储桶访问权限控制列表

GET Bucket acl

查询存储桶 ACL

查询存储桶的访问控制列表

对象 ACL

API

操作名

操作描述

PUT Object acl

设置对象 ACL

设置存储桶中某个对象的访问控制列表

GET Object acl

查询对象 ACL

查询对象的访问控制列表


热门文章
更多>