
# 通过IAM身份策略授予使用APIG的权限
如果您需要对您所拥有的APIG服务进行[身份策略](https://support.huaweicloud.com/productdesc-apig/apig-pd-190529006.html)的权限管理，您可以使用[统一身份认证服务](https://support.huaweicloud.com/usermanual-iam5/iam_01_1141.html)（Identity and Access Management，简称IAM），通过IAM，您可以：
- 根据企业的业务组织，在您的华为云账号中，给企业中不同职能部门的员工创建用户或用户组，让员工拥有唯一安全凭证，并使用APIG资源。
- 根据企业用户的职能，设置不同的访问权限，以达到用户之间的权限隔离。
- 将APIG资源委托给更专业、高效的其他华为云账号或者云服务，这些账号或者云服务可以根据权限进行代运维。
如果华为云账号已经能满足您的要求，您可以跳过本章节，不影响您使用APIG服务的其它功能。
本章节为您介绍使用身份策略的授权方法，操作流程如[图1]所示。
#### 前提条件
在授权操作前，请您了解可以添加的APIG权限，并结合实际需求进行选择。APIG支持的系统策略，请参见[身份策略权限管理](https://support.huaweicloud.com/productdesc-apig/apig-pd-190529006.html)。如果您需要对除APIG之外的其它服务授权，IAM支持服务的所有权限请参见[系统权限](https://support.huaweicloud.com/permissions/iam_01_0001.html?product=iam5)。
#### 示例流程
图1给用户授予APIG权限流程   
![](https://support.huaweicloud.com/usermanual-apig/zh-cn_image_0000002624859987.png "点击放大")
1. [创建用户](https://support.huaweicloud.com/usermanual-iam5/iam_01_1144.html)或[创建用户组](https://support.huaweicloud.com/usermanual-iam5/iam_01_1153.html)
   在IAM控制台创建用户或用户组。
   
2. [将系统身份策略附加至用户或用户组](https://support.huaweicloud.com/usermanual-iam5/iam_01_0912.html)
   为用户或用户组授予APIG只读权限的系统策略"APIGReadOnlyPolicy"，或将策略附加至用户或用户组。
   
3. [用户登录](https://support.huaweicloud.com/usermanual-iam5/iam_01_1146.html)并验证权限
   使用已授权的用户登录控制台，验证权限：
   - 在"服务列表"中选择APIG，进入APIG主界面，单击右上角"购买专享版示例"，如果无法购买（假设当前权限仅包含APIGReadOnlyPolicy），表示"APIGReadOnlyPolicy"已生效。
   
   - 在"服务列表"中选择除APIG外（假设当前策略仅包含APIGReadOnlyPolicy）的任一服务，如果提示权限不足，表示"APIGReadOnlyPolicy"已生效。
    
 
#### APIG自定义身份策略样例
如果系统预置的APIG系统策略，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参考"《API网关接口文档》\> 权限和授权项 \> 身份策略授权参考"章节。
目前华为云支持以下两种方式创建自定义策略：
- 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
- JSON视图创建自定义策略：可以在选择策略模板后，根据具体需求编辑策略内容；也可以直接在编辑框内编写JSON格式的策略内容。
具体创建步骤请参见：[创建自定义策略并附加至主体](https://support.huaweicloud.com/usermanual-iam5/iam_01_0917.html)。
下面为您介绍常用的APIG自定义策略样例。
- 示例1：授权创建和发布API
  ```
  {
      "Version": "5.0",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "apig:api:create",
                  "apig:api:delete"
              ]
          }
      ]
  }
  ```
  
- 示例2：多个授权项策略
  一个自定义策略中可以包含多个授权项，且除了可以包含本服务的授权项外，还可以包含其他服务的授权项。比如以下为创建APIG专享版实例所依赖的权限：
  ```
  {
      "Version": "5.0",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "apig:instance:create"
              ]
          },
          {
              "Effect": "Allow",
              "Action": [
                  "vpc:securityGroups:get",
                  "vpc:ports:create",
                  "vpc:ports:update",
                  "vpc:vpcs:get",
                  "vpc:subnets:get",
                  "vpc:ports:get",
                  "vpc:ports:delete",
              ]
          },
          {
              "Effect": "Allow",
              "Action": [
                  "eip:publicIps:get",
                  "eip:publicIps:associateInstance",
                  "eip:publicIps:disassociateInstance"
              ]
          },
          {
              "Effect": "Allow",
              "Action": [
                  "eps:enterpriseProjects:list"
              ]
          }
      ]
  }
  ```
  
 
