口语评测 授权策略语法

一、策略语法

CAM 策略：

·版本 version：必填，目前仅允许值为"2.0"。

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

·操作 action：必填，描述允许或拒绝的操作。操作可以是 API（以 name 前缀描述）或者功能集（一组特定的 API，以 permid 前缀描述）。

·资源 resource：必填，描述授权的具体数据。资源是用六段式描述。每款产品的资源定义详情会有所区别。有关如何指定资源的信息，请参阅你编写的资源声明所对应的产品文档。

·生效条件 condition：非必填，描述策略生效的约束条件。条件由操作符、操作键和操作值组成。条件值可以是客户端 IP 地址。

·影响 effect：必填，描述声明产生的结果是“允许”还是“显式拒绝”，即 allow（允许）和 deny（显式拒绝）两种情况。

在 CAM 策略语句中，你可以从支持 CAM 的任何服务中指定任意的 API 操作。对于 SOE，请使用以 name/soe: 为前缀的 API。例如：name/soe:CreateModel 或者 name/soe:CreateAsrVocab。

·如果你要在单个语句中指定多个操作的时候，请使用逗号将它们隔开，如下所示：

"action":["name/soe:action1","name/soe:action2"]

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

"action":["name/soe:Describe*"]

如果你要指定 SOE 中所有操作，请使用 * 通配符，如下所示：

"action"：["name/soe:*"]

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

qcs:project_id:service_type:region:account:resource

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

·service_type：产品简称，填写 SOE。

·region：地域信息，SOE 无需填写。

·account：资源拥有者的根账号信息，如 uin/164256472。

·resource：各产品的具体资源详情，如 subUin/1234567 或者 subUin/*。

例如，如果你想要限制某些子账号只可以访问自己创建的资源，你可以这样设置 resource，其中164256472代表主账号，123456代表子账号(subUin)，如下所示：

"resource":[ "qcs::soe::uin/164256472:subUin/123456"]

如果你想要限制某些子账号可以访问主账号下的所有资源，你可以这样设置 resource：

"resource":[ "qcs::soe::uin/164256472:subUin/*"]

下表描述了 SOE 能够使用的资源和对应的资源描述方法。在下表中，以$为前缀的单词均为代称。其中，account 指代的是账户 ID。