文档首页/ API网关 APIG/ 用户指南/ 创建用户并授权使用APIG
更新时间:2024-12-02 GMT+08:00

创建用户并授权使用APIG

如果您需要对您所拥有的API网关服务进行权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以:

  • 根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建IAM用户,让员工拥有唯一安全凭证,并使用API网关服务资源。
  • 根据企业用户的职能,设置不同的访问权限,以达到用户之间的权限隔离。
  • 将API网关服务资源委托给更专业、高效的其他账号或者云服务,这些账号或者云服务可以根据权限进行代运维。

如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用API网关服务的功能。

本章节为您介绍对用户授权的方法,操作流程如图1所示。

前提条件

给用户组授权之前,请您了解用户组可以添加的表1,并结合实际需求进行选择。如果您需要对除API网关服务之外的其它服务授权,IAM支持服务的所有策略请参见权限策略
表1 API网关的系统角色或策略

系统角色/策略名称

描述

类别

依赖关系

APIG Administrator

API网关服务的管理员权限。拥有该权限的用户可以使用API网关服务的所有功能。

系统角色

如果在操作过程中涉及其他服务资源的创建、删除、变更等,则还需要在同项目中勾选对应服务的Administrator权限。

APIG FullAccess

API网关服务所有权限。拥有该权限的用户可以使用API网关服务的所有功能。

系统策略

无。

APIG ReadOnlyAccess

API网关服务的只读访问权限。拥有该权限的用户只能查看API网关服务的各类信息。

系统策略

无。

示例流程

图1 给用户授权API网关服务权限流程

  1. 创建用户组并授权

    在IAM控制台创建用户组,并授予API网关服务的权限“APIG Administrator”或“APIG FullAccess”。

  2. 创建用户并加入用户组

    在IAM控制台创建用户,并将其加入1中创建的用户组。

  3. 用户登录并验证权限

    新创建的用户登录控制台,验证API网关服务的权限。

APIG自定义策略

如果系统预置的API网关权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参考细粒度策略支持的授权项

目前华为云支持以下两种方式创建自定义策略:

  • 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容,可自动生成策略。
  • JSON视图创建自定义策略:可以在选择策略模板后,根据具体需求编辑策略内容;也可以直接在编辑框内编写JSON格式的策略内容。

具体创建步骤请参见:创建自定义策略。本章为您介绍常用的API网关自定义策略样例。

APIG自定义策略样例

  • 示例1:授权用户创建API、调试API的权限
    {
        "Version": "1.1",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "
                         apig:apis:create
                         apig:apis:debug
                     "
                ]
            }
        ]
    }
  • 示例2:拒绝用户创建API分组

    拒绝策略需要同时配合其他策略使用,否则没有实际作用。用户被授予的策略中,一个授权项的作用如果同时存在Allow和Deny,则遵循Deny优先。

    如果您给用户授予APIG FullAccess的系统策略,但不希望用户拥有APIG FullAccess中定义的创建API分组权限,您可以创建一条拒绝创建API分组的自定义策略,然后同时将APIG FullAccess和拒绝策略授予用户,根据Deny优先原则,则用户可以执行除创建API分组外的所有操作。拒绝策略示例如下:

    {
        "Version": "1.1",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "
                         apig:apis:create
                         apig:apis:debug
                     "
                ]
            }
        ]
    }