借助访问控制 RAM 的 RAM 用户(子账号),您可以实现权限分割的目的,按需为 RAM 用户赋予不同权限,并避免因暴露阿里云账号(主账号)密钥造成的安全风险。

注意 消息队列 Kafka 版授权策略升级,支持更细粒度的自定义授权策略,并兼容老版的 Pub/Sub 权限策略。旧版 RAM 主子账号授权,请参见 RAM 主子账号授权(作废)

使用场景

某企业开通了消息队列 Kafka 版服务,该企业需要员工操作消息队列 Kafka 版服务所涉及的资源由于每个员工的工作职责不一样,需要的权限也不一样。该企业的需求:

  • 出于安全或信任的考虑,不希望将云账号密钥直接透露给员工,而希望能给员工创建相应的用户账号。
  • 用户账号只能在授权的前提下操作资源,不需要对用户账号进行独立的计量计费,所有开销都计入企业账号名下。
  • 随时可以撤销用户账号的权限,也可以随时删除其创建的用户账号。

使用说明

在使用 RAM 授权前,需要注意以下事项:

RAM 主子账号授权只针对控制台和 OpenAPI 的操作,利用 SDK 收发消息跟 RAM 是否授权无关。

SDK 收发消息与开源客户端行为一致,VPC 内访问无需鉴权,公网访问利用 SASL 进行身份验证。如果想控制 SDK 收发的范围,可以在消息队列 Kafka 版控制台的实例详情页设置 IP 白名单。

步骤一:创建 RAM 用户

首先需要使用阿里云账号(主账号)登录 RAM 控制台并创建 RAM 用户。

  1. 登录 RAM 控制台
  2. 在左侧导航栏,选择人员管理 > 用户
  3. 用户页面,单击新建用户
  4. 新建用户页面的用户账号信息区域,输入登录名称显示名称
  5. (可选)如需一次创建多个用户,则单击添加用户,并重复上一步。
  6. 访问方式区域中,勾选控制台密码登录编程访问,并单击确定
    说明 为提高安全性,请仅勾选一种访问方式。
    • 如果勾选控制台密码登录,则完成进一步设置,包括自动生成默认密码或自定义登录密码、登录时是否要求重置密码,以及是否开启 MFA 认证。
    • 如果勾选编程访问,则 RAM 会自动为 RAM 用户创建 AccessKey(API 访问密钥)。
    注意 出于安全考虑,RAM 控制台只提供一次查看或下载 AccessKeySecret 的机会,即创建 AccessKey 时,因此请务必将 AccessKeySecret 记录到安全的地方。
  7. 手机验证对话框,单击获取验证码,输入收到的手机验证码,然后单击确定

步骤二:为 RAM 用户添加权限

在使用 RAM 用户之前,需要为其添加相应权限。

  1. 登录 RAM 控制台
  2. 左侧导航栏,选择人员管理 > 用户
  3. 用户页面,找到需要授权的用户,单击操作列中的添加权限
  4. 添加权限页面的选择权限区域,选择权限策略类型 ,在文本框中输入要添加的权限策略,单击搜索到的权限策略,然后单击确定
    • 系统权限策略

      消息队列 Kafka 版目前支持两种粗粒度的系统权限策略:

      权限策略名称 说明
      AliyunKafkaFullAccess 管理消息队列 Kafka 版的权限,等同于主账号的权限,被授予该权限的 RAM 用户具有所有消息收发权限且有控制台所有功能操作权限。
      AliyunKafkaReadOnlyAccess 消息队列 Kafka 版的只读权限,被授予该权限的 RAM 用户具有主账号所有资源的只读权限。
      说明 建议给运维人员授予 AliyunKafkaFullAccess 权限策略,由运维人员去创建和删除资源。给开发人员授予 AliyunKafkaReadOnlyAccess 权限策略,可以查看这些资源,但是不能删除和创建。 如果想更细粒度地控制开发人员的权限,您可使用以下自定义权限策略。
    • 自定义权限策略

      如果您需要更细粒度地授权,您可以通过创建自定义策略来进行访问控制。

      创建自定义策略的具体步骤,请参见创建自定义策略

      为了方便您自定义 RAM 权限策略,本文提供了消息队列 Kafka 版的授权映射表。

      表 1. 消息队列 Kafka 版自定义授权映射
      Action 名称 权限说明 是否为只读类权限
      ReadOnly 所有资源的只读权限,复合型权限
      ListInstance 查看实例
      StartInstance 部署实例
      UpdateInstance 更新实例配置
      ReleaseInstance 释放实例
      ListTopic 查看 Topic
      CreateTopic 创建 Topic
      UpdateTopic 更新 Topic 配置
      DeleteTopic 删除 Topic
      ListGroup 查看 ConsumerGroup
      CreateGroup 创建 ConsumerGroup
      UpdateGroup 更新 ConsumerGroup 配置
      DeleteGroup 删除 ConsumerGroup
      QueryMessage 查询消息
      SendMessage 发送消息
      DownloadMessage 下载消息

      示例一:授予子账号对实例 alikafka_post-cn-xxx 的只读权限

      {
          "Version": "1",
          "Statement": [
              {
                  "Action": [
                    "alikafka:ReadOnly"
                             ],
                  "Resource": "acs:alikafka:*:*:alikafka_post-cn-xxx",
                  "Effect": "Allow"
              }
          ]
      }

      示例二:授予子账号对实例 alikafka_post-cn-xxx 的查看实例、查看 Topic、查看 Consumer Group、查询消息、下载消息的权限

      {
          "Version": "1",
          "Statement": [
              {
                  "Action": [
                    "alikafka:ListInstance",
                    "alikafka:ListTopic",
                    "alikafka:ListGroup",
                    "alikafka:QueryMessage",
                    "alikafka:DownloadMessage"
                             ],
                  "Resource": "acs:alikafka:*:*:alikafka_post-cn-xxx",
                  "Effect": "Allow"
              }
          ]
      }

      示例三:授予子账号对实例 alikafka_post-cn-xxx 的所有权限

      {
          "Version": "1",
          "Statement": [
              {
                  "Action": [
                    "alikafka:*Instance",
                    "alikafka:*Topic",
                    "alikafka:*Group",
                    "alikafka:*Message"
                             ],
                  "Resource": "acs:alikafka:*:*:alikafka_post-cn-xxx",
                  "Effect": "Allow"
              }
          ]
      }
  5. 添加权限授权结果页面上,查看授权信息摘要,并单击完成

后续步骤

使用阿里云账号(主账号)创建好 RAM 用户后,即可将 RAM 用户的登录名称及密码或者 AccessKey 信息分发给其他用户。其他用户可以按照以下步骤使用 RAM 用户登录控制台或调用 API。

  • 登录控制台
    1. 打开 RAM 用户登录页面。
    2. RAM 用户登录页面,输入 RAM 用户登录名称,单击下一步,并输入 RAM 用户密码,然后单击登录
      说明 RAM 用户登录名称的格式为 <$username>@<$AccountAlias><$username>@<$AccountAlias>.onaliyun.com<$AccountAlias> 为账号别名,如果没有设置账号别名,则默认值为阿里云账号(主账号)的 ID。
    3. 子用户用户中心页面上单击有权限的产品,即可访问控制台。
  • 调用 API

    使用 RAM 用户的 AccessKey 调用 API。

    在代码中使用 RAM 用户的 AccessKeyId 和 AccessKeySecret 即可。

更多信息