云数据库 MongoDB 权限策略语法

策略是用户权限集的语法规范,可精确描述被授权的资源集、操作集及授权条件。这里说明 CAM 策略的基本语法,并重点说明云数据库 MongoDB 支持的系统默认策略、可授权操作及自定义策略的编写方法。

相关产品
云数据库 MongoDB 产品页,含版本规格、价格与购买入口。

一、CAM 策略语法

{ "version":"2.0", "statement": [ { "effect":"effect", "action":["action"], "resource":["resource"], "condition": {"key":{"value"}} } ] }

策略语法中各个语句解释如下表所示。

参数名称 子参数 是否必选 参数说明
version 无 是 目前仅允许值为"2.0"。
statement effect 是 描述声明产生的结果是“允许”还是“显式拒绝”。包括 allow(允许)和 deny(显式拒绝)两种情况。
 action 是 用来描述允许或拒绝的操作。操作可以是 API 或者功能集(一组特定的 API ,以 permid 前缀描述)。
 resource 是 描述授权的具体数据。资源是用六段式描述,每款产品的资源定义详情会有所区别。
 condition 是 描述策略生效的约束条件。条件包括操作符、操作键和操作值组成。条件值可包括时间、IP 地址等信息,有些服务允许你在条件中指定其他值。

注意:说明:

注意:statement 用来描述一条或多条权限的详细信息。该元素包括 effect、action、resource、condition 等多个其他元素的权限或权限集合。一条策略有且仅有一个 statement 元素。

二、定义 action

在 CAM 策略语句中,你可以从支持 CAM 的任何服务中指定任意的 API 操作。对于 MongoDB,请使用以 mongodb: 为前缀的 API。例如 mongodb:BackupDBInstance 或 mongodb:CreateAccountUser。
如果你要在单个语句中指定多个操作的时候,请使用逗号将它们隔开,如下所示:

"action":["mongodb:action1","mongodb:action2"]

你也可以使用通配符指定多项操作。例如,你可以指定名字以单词" Describe "开头的所有操作,如下所示:

"action":["mongodb:Describe*"]

如果你要指定 MongoDB 中所有操作,请使用 * 通配符,如下所示:

"action":["mongodb:*"]

三、定义 resource

每个 CAM 策略语句都有适用于自己的资源。资源路径的一般形式如下:

qcs:project_id:service_type:region:account:resource

·project_id:描述项目信息,仅为了兼容 CAM 早期逻辑,无需填写。

·service_type:产品简称,如 mongodb。

·region:地域信息,如 bj。

·account:资源拥有者的主账号信息,如 uin/12345678。

·resource:各产品的具体资源详情,如 instance/instance_id 或者 instance/*。

你可以使用特定实例(cmgo-aw6g1g0z)在语句中指定 resource,示例如下:

"resource":[ "qcs::mongodb:bj:uin/12345678:instance/cmgo-aw6g1g0z"]

你还可以使用 * 通配符指定属于特定账户的所有实例,示例如下:

"resource":[ "qcs::mongodb:bj:uin/12345678:instance/*"]

你要指定所有资源,或者如果特定 API 操作不支持资源级权限,请在 resource 元素中使用 * 通配符,如下所示:

"resource":["*"]

如果你想要在一条指令中同时指定多个资源,请使用英文逗号将它们隔开,如下所示为指定两个资源的例子:

"resource":["resource1","resource2"]

MongoDB 能够使用的资源和对应的资源描述方法,如下表所示。其中,$ 为前缀的单词均为代称,region 指地域,account 指账户 ID。

资源类型 授权策略中的 resource 描述方法
实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
VPC qcs::vpc:$region:$account:vpc/$vpcId
安全组 qcs::cvm:$region:$account:sg/$sgId

四、MongoDB 系统默认权限策略

腾讯云数据库 MongoDB 支持以下系统权限策略。

策略名称 说明
QcloudMongoDBFullAccess 云数据库 MongoDB 的管理权限,被授予该权限的子账户具有等同于腾讯云账号的权限,即控制台和 API 的所有操作权限。
QcloudMongoDBReadOnlyAccess 只读权限,被授予该权限的子账户只具有腾讯云账号所有资源的只读权限,不具有控制台和 API 的操作权限。

系统权限策略 QcloudMongoDFullAccess 策略内容如下:

{ "version": "2.0", "statement": [ { "action": [ "monitor:GetMonitorData", "monitor:DescribeBaseMetrics", "mongodb:*" ], "resource": "*", "effect": "allow" } ]}

系统权限策略 QcloudMongoDBReadOnlyAccess 策略内容如下:

{ "version": "2.0", "statement": [ { "action": [ "monitor:GetMonitorData", "monitor:DescribeBaseMetrics", "mongodb:Describe*" ], "resource": "*", "effect": "allow" } ]}

五、MongoDB 自定义权限策略

当系统默认策略无法满足精细化授权需求时,可创建自定义策略,将权限限定到指定的实例资源或操作集合。

注意:说明:

注意:下表中未列出的云数据库 API 操作,即表示该云数据库 API 操作不支持资源级权限。针对不支持资源级权限的云数据库 API 操作,你仍可以向用户授予使用该操作的权限,但策略语句的资源元素必须指定为 *。

action 名称 权限说明 resource 描述
BackupDBInstance 备份数据库实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
CreateAccountUser 创建账号 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
CreateDBInstance 创建云数据库实例(包年包月) qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
CreateDBInstanceHour 创建云数据库实例(按量计费) qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DeleteAccountUser 删除账号 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeAccountUsers 查询账号的用户信息 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeBackupAccess 获取实例备份下载授权 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeBackupRules 获取云数据库实例备份规则 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeClientConnections 获取客户端连接数 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeDBBackups 查询实例备份列表 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeDBInstances 查询数据库实例列表 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeInstanceDB 查询实例的库表信息 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeSlowLog 获取慢日志信息 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeSlowLogPattern 获取慢日志统计信息 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
DescribeSpecInfo 查询云数据库的售卖规格 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
ExchangeInstance 临时实例替换原实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
IsolateDBInstance 隔离云数据库实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
ModifyDBInstanceSpec 调整云数据库实例配置 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
OfflineIsolatedDBInstance 下线隔离状态的云数据库实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
RemoveCloneInstance 删除临时实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
RenameInstance 重命名实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
RenewInstance 续费云数据库实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
ResizeOplog 调整实例 oplog 大小 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
RestartInstance 重启实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
RestoreDBInstance 恢复数据库实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetAccountUserPrivilege 设置用户权限 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetAutoRenew 设置自动续费 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetBackupRules 设置备份规则 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetInstanceFormal 设置临时实例为正式实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetInstanceMaintenance 设置实例维护时间窗 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetPassword 设置密码 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
SetReadOnlyToNormal 设置只读实例为正式实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
TerminateDBInstance 销毁包年包月实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
TerminateDBInstanceHour 销毁按量计费实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
UpgradeDBInstance 升级包年包月实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId
UpgradeDBInstanceHour 升级按量计费实例 qcs::mongodb:$region:$account:instance/*qcs::mongodb:$region:$account:instance/$instanceId

六、自定义权限策略示例

授权账户对实例 cmgo-aw6g**** 进行 CreateDBInstance 和 CreateAccountUser 的操作权限。示例如下:

{ "version": "2.0", "statement": [ { "effect": "allow", "action": [ "mongodb:CreateDBInstance", "mongodb:CreateAccountUser" ], "resource": [ "qcs::mongodb::uin/100001540306:instanceId/cmgo-aw6g****" ], "condition": { "ip_equal": { "qcs:ip": [ "10.0.0.4" ] } } } ]}

七、创建自定义权限策略

具体操作,请你登录访问管理(CAM)控制台的 策略 页面,参见 创建自定义策略 进行操作。

赞 (0)
上一篇 4天前
下一篇 4天前