ACL权限控制

ACL权限控制适用于如下场景。

使用ACL权限控制方案前，请您确认已记录好如下信息：

• 被授权人的账号或角色名称，且账号或角色已添加至MaxCompute项目。阿里云账号格式为ALIYUN$<account_name>，RAM用户账号格式为RAM$[<account_name>:]<RAM用户名称> ，RAM角色账号格式为`RAM$<account_name>:role/<RAM角色名称>`。

  您可以通过MaxCompute客户端执行list users;或list roles;命令获取账号或角色信息。

  如果需要新增用户或角色，请参见用户规划与管理或角色规划。

• 授权对象类型、对象名称及操作。

  更多对象类型及操作信息，请参见MaxCompute权限。

ACL权限控制功能的使用限制如下：

• ACL权限控制只支持对已存在的对象、被授权人进行授权，可以避免删除并重建同名对象所带来的安全风险。

• ACL权限控制不支持通过[with grant option]子句授权。例如当用户A授权用户B可以访问某个对象时，用户B无法将权限进一步授权给用户C。

• ACL授权为白名单（Allow）授权，不支持黑名单（Deny）授权。

使用ACL权限控制功能的注意事项如下：

• 如果删除了对象，MaxCompute会自动撤销与该对象关联的所有ACL授权信息。

• 当一个用户被移除后，与该用户有关的授权仍然会被保留。一旦该用户以后被再次添加到该项目时，该用户的历史授权访问权限将被重新激活。如果需要彻底清除用户的权限信息，请参见彻底清除被删除用户遗留的权限信息。

ACL权限控制命令格式如下：

• ACL授权

  grant <actions> on <object_type> <object_name> 
  [(<column_list>)] to <subject_type> <subject_name> 
  [privilegeproperties("conditions" = "<conditions>", "expires"="<days>")];

• 撤销ACL授权

  revoke <actions> on <object_type> <object_name> 
  [(<column_list>)] from <subject_type> <subject_name>;

• 列级别权限控制

  grant <actions> on table <table_name> (<column_list>) to <subject_type> <subject_name>;
  revoke <actions> on table <table_name> (<column_list>) from <subject_type> <subject_name>;

参数说明如下。

假设Bob@aliyun.com是test_project_a的项目所有者，Allen、Alice、Tom是隶属于Bob@aliyun.com的RAM用户。以MaxCompute客户端操作为例，授权示例如下：

• 示例一：为用户授权

  在项目test_project_a中创建表sale_detail，并为用户Allen授予表的读取元数据（Describe）和读取表数据（Select）权限。命令示例如下。

  --Bob进入项目test_project_a。
  use test_project_a; 
  --创建一张分区表sale_detail。
  create table if not exists sale_detail
  (
  shop_name     string,
  customer_id   string,
  total_price   double
  )
  partitioned by (sale_date string, region string);
  --将用户Allen添加为项目成员。
  add user RAM$Bob@aliyun.com:Allen;
  --为Allen授予权限。
  grant Describe, Select on table sale_detail to USER RAM$Bob@aliyun.com:Allen;
  --查看用户Allen的授权结果。
  show grants for RAM$Bob@aliyun.com:Allen; 
  --授权结果如下。
  Authorization Type: ACL
  [user/RAM$Bob@aliyun.com:Allen]
  A       projects/test_project_a/tables/sale_detail: Describe | Select

• 示例二：为用户授权

  在示例一中创建的表sale_detail基础上，为用户Alice授予表sale_detail中shop_name和customer_id两列的所有操作权限。命令示例如下。

  --Bob进入项目test_project_a。
  use test_project_a; 
  --将用户Alice添加为项目成员。
  add user RAM$Bob@aliyun.com:Alice;
  --为Alice授予列级别控制权限。
  grant All on table sale_detail (shop_name, customer_id) to USER RAM$Bob@aliyun.com:Alice;
  --查看用户Alice的授权结果。
  show grants for RAM$Bob@aliyun.com:Alice; 
  --授权结果如下。
  Authorization Type: ACL
  [user/RAM$Bob@aliyun.com:Alice]
  A       projects/test_project_a/tables/sale_detail/customer_id: All
  A       projects/test_project_a/tables/sale_detail/shop_name: All

• 示例三：为用户撤销授权

  基于示例一、二，撤销对用户Allen、Alice的授权。命令示例如下。

  --Bob进入项目test_project_a。
  use test_project_a; 
  --撤销Allen授权。
  revoke Describe, Select on table sale_detail (shop_name, customer_id) from USER RAM$Bob@aliyun.com:Allen;
  --撤销Alice授权。
  revoke All on table sale_detail (shop_name, customer_id) from USER RAM$Bob@aliyun.com:Alice;
  --查看用户Allen的撤销授权结果。权限列表无Describe, Select权限信息。
  show grants for RAM$Bob@aliyun.com:Allen; 
  --查看用户Alice的撤销授权结果。权限列表无All权限信息。
  show grants for RAM$Bob@aliyun.com:Alice; 

• 示例四：基于角色为多个用户授予相同权限

  为Alice、Tom及另一阿里云账号Lily@aliyun.com授予在项目test_project_a中创建实例、创建资源、创建函数、创建表以及查看项目所有对象类型的权限。命令示例如下。

  --Bob进入项目test_project_a。
  use test_project_a; 
  --将用户Alice、Tom、Lily@aliyun.com添加为项目成员。
  add user RAM$Bob@aliyun.com:Alice;
  add user RAM$Bob@aliyun.com:Tom;
  add user ALIYUN$Lily@aliyun.com;
  --创建角色Worker。
  create role Worker; 
  --为用户绑定角色Worker。
  grant Worker TO RAM$Bob@aliyun.com:Alice; 
  grant Worker TO RAM$Bob@aliyun.com:Tom; 
  grant Worker TO ALIYUN$Lily@aliyun.com; 
  --为角色Worker授予在项目test_project_a中创建实例、创建资源、创建函数、创建表以及查看项目所有对象类型的权限。
  grant CreateInstance, CreateResource, CreateFunction, CreateTable, List on project test_project_a TO ROLE Worker;
  --查看用户Lily的授权结果。
  show grants for ALIYUN$Lily@aliyun.com; 
  --授权结果如下。表明用户Lily已经具备上述权限。
  [roles]
  worker
  
  Authorization Type: ACL
  [role/worker]
  A       projects/test_project_a: CreateTable | CreateResource | CreateInstance | CreateFunction | List

• 示例五：为多个用户撤销基于角色授予的相同权限

  基于示例三，撤销对用户Alice、Tom、Lily@aliyun.com的授权。命令示例如下。

  --Bob进入项目test_project_a。
  use test_project_a; 
  --收回用户Alice、Tom、Lily@aliyun.com绑定的角色Worker。
  revoke Worker from RAM$Bob@aliyun.com:Alice;
  revoke Worker from RAM$Bob@aliyun.com:Tom;
  revoke Worker from ALIYUN$Lily@aliyun.com;
  --查看用户Lily的撤销授权结果。权限列表无Worker信息。
  show grants for ALIYUN$Lily@aliyun.com; 

了解ACL授权机制后，您可以根据实际业务需要执行授权相关操作：

• 项目级别角色授权

• 通过命令管理用户权限

• 查询用户、角色或对象的权限信息