# 通过IAM角色或策略授予使用DMS for Kafka的权限
如果您需要对您所拥有的DMS for Kafka进行[角色与策略](https://support.huaweicloud.com/productdesc-kafka/ProductDescPrivilegeManagement.html)的权限管理，您可以使用[统一身份认证服务](https://support.huaweicloud.com/usermanual-iam/iam_01_0001.html)（Identity and Access Management，简称IAM），通过IAM，您可以：
- 根据企业的业务组织，在您的华为账号中，给企业中不同职能部门的员工创建IAM用户，让员工拥有唯一安全凭证，并使用DMS for Kafka资源。
- 根据企业用户的职能，设置不同的访问权限，以达到用户之间的权限隔离。
- 将DMS for Kafka资源委托给更专业、高效的其他华为账号或者云服务，这些账号或者云服务可以根据权限进行代运维。
如果华为账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用DMS for Kafka服务的其它功能。
本章节为您介绍使用角色与策略的授权方法，操作流程如[图1]所示。
#### 前提条件
给用户组授权之前，请您了解用户组可以添加的DMS for Kafka权限，并结合实际需求进行选择，DMS for Kafka支持的系统权限，请参见[角色与策略权限管理](https://support.huaweicloud.com/productdesc-kafka/ProductDescPrivilegeManagement.html)。若您需要对除DMS for Kafka之外的其它服务授权，IAM支持服务的所有权限请参见[权限策略](https://support.huaweicloud.com/permissions/iam_01_0001.html?product=kafka)。
**DMS for Kafka的权限与策略基于分布式消息服务DMS，因此在IAM服务中为用户组授予DMS for Kafka权限时，请选择并使用"DMS"的权限与策略。**
#### 示例流程
图1给用户授权DMS for Kafka权限流程   
![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001571888245.png)
1. [创建用户组并授权](https://support.huaweicloud.com/usermanual-iam/iam_03_0001.html)
   在IAM控制台创建用户组，并授予DMS for Kafka的只读权限"DMS ReadOnlyAccess"。
   
2. [创建用户并加入用户组](https://support.huaweicloud.com/usermanual-iam/iam_02_0001.html)
   在IAM控制台创建用户，并将其加入[1]中创建的用户组。
   
3. [用户登录](https://support.huaweicloud.com/usermanual-iam/iam_01_0552.html)并验证权限
   新创建的用户登录到控制台，切换至授权区域，验证权限：
   - 在"服务列表"中选择分布式消息服务Kafka版，进入Kafka实例主界面，单击右上角"购买Kafka实例"，尝试购买Kafka实例，如果无法购买Kafka实例（假设当前权限仅包含DMS ReadOnlyAccess），表示"DMS ReadOnlyAccess"已生效。
   
   - 在"服务列表"中选择云硬盘（假设当前策略仅包含DMS ReadOnlyAccess），若提示权限不足，表示"DMS ReadOnlyAccess"已生效。
   
   - 在"服务列表"中选择分布式消息服务Kafka版（假设当前策略仅包含DMS ReadOnlyAccess），进入Kafka实例主界面，如果能够查看Kafka实例列表，表示"DMS ReadOnlyAccess"已生效。
    
 
#### DMS for Kafka自定义策略样例
如果系统预置的DMS for Kafka权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参考[策略授权参考](https://support.huaweicloud.com/api-kafka/kafka-api-0005.html)。
目前华为云支持以下两种方式创建自定义策略：
- 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
- JSON视图创建自定义策略：可以在选择策略模板后，根据具体需求编辑策略内容；也可以直接在编辑框内编写JSON格式的策略内容。
具体创建步骤请参见：[创建自定义策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0605.html)。下面为您介绍常用的DMS for Kafka自定义策略样例。
- 示例1：授权用户删除实例和重启实例
  ```
  {
      "Version": "1.1",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "dms:instance:modifyStatus",
                  "dms:instance:delete"
              ]
          }
      ]
  }
  ```
  
- 示例2：拒绝用户删除实例 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循**Deny优先原则**。
  如果您给用户授予DMS FullAccess的系统策略，但不希望用户拥有DMS FullAccess中定义的删除实例权限，您可以创建一条拒绝删除实例的自定义策略，然后同时将DMS FullAccess和拒绝策略授予用户，根据Deny优先原则，则用户可以对DMS for Kafka执行除了删除实例外的所有操作。拒绝策略示例如下：
  ```
  {
          "Version": "1.1",
          "Statement": [
                  {
                          "Effect": "Deny",
                          "Action": [
                                  "dms:instance:delete"
                          ]
                  }
          ]
  }
  ```
  
 
#### DMS for Kafka资源
资源是服务中存在的对象。在DMS for Kafka中，资源包括：kafka，您可以在创建自定义策略时，通过指定资源路径来选择特定资源。
表1DMS for Kafka的指定资源与对应路径 
| 指定资源           | 资源名称 | 资源路径                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| kafka          | 实例   | 【格式】 DMS:\*:\*:kafka:*实例ID* 【说明】 对于实例资源，IAM自动生成资源路径前缀**DMS:\*:\*:kafka:** 通过*实例ID*指定具体的资源路径，支持通配符\*。例如： DMS:\*:\*:kafka:\*表示任意Kafka实例。                                   |
| topic        | 主题 | 【格式】 DMS:\*:\*:topic:*实例ID/Topic名称* 【说明】 对于Topic资源，IAM自动生成资源路径前缀**DMS:\*:\*:topic:** 通过*实例ID* */Topic名称*指定具体的资源路径，支持通配符\*。例如： DMS:\*:\*:topic:\*表示任意Topic。                 |
| consumerGroup | 消费组 | 【格式】 DMS:\*:\*:consumerGroup:*实例ID* */消费组名称* 【说明】 对于实例资源，IAM自动生成资源路径前缀**DMS:\*:\*:consumerGroup:** 通过*实例ID/消费组名称*指定具体的资源路径，支持通配符\*。例如： DMS:\*:\*:consumerGroup:\*表示任意消费组。 |
   
#### DMS for Kafka请求条件
您可以在创建自定义策略时，通过添加"请求条件"（Condition元素）来控制策略何时生效。请求条件包括条件键和运算符，条件键表示策略语句的Condition元素，分为全局级条件键和服务级条件键。[全局级条件键](https://support.huaweicloud.com/usermanual-iam/iam_01_0017.html)（前缀为g:）适用于所有操作，服务级条件键（前缀为服务缩写，如dms:）仅适用于对应服务的操作。运算符与条件键一起使用，构成完整的条件判断语句。
DMS for Kafka通过IAM预置了一组条件键，例如，您可以先使用dms:ssl条件键检查Kafka实例是否开启SASL，然后再允许执行操作。下表显示了适用于DMS for Kafka服务特定的条件键。
表2DMS for Kafka请求条件 
| DMS for Kafka条件键 | 运算符    | 描述                    |
|:---|:---|:---|
| dms:connector   | Bool | 是否开启Smart Connect |
| dms:publicIP     | Bool   | 是否开启公网              |
| dms:ssl          | Bool  | 是否开启SSL            |