互动白板
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 互动白板 > 控制台指南 > 访问管理 > 自定义策略

自定义策略

最近更新时间：2023-08-10 08:56:21

我的收藏

本页目录：

注意
本文档主要介绍 互动白板 TIW 访问管理功能的相关内容，其他产品访问管理相关内容请参见 支持 CAM 的产品。
在 TIW 访问管理中使用 预设策略 来实现授权虽然方便，但权限控制粒度较粗，不能细化到 TIW 应用和 云 API 粒度。如果开发者要求精细的权限控制能力，则需要创建自定义策略。

自定义策略创建方法

自定义策略有多种创建方法，下方表格展示各种方法的对比，具体操作流程请参考下文。
创建入口
创建方法
效力（Effect）
资源（Resource）
操作（Action）
灵活性
难度
策略生成器
手动选择
语法描述
手动选择
中
中
策略语法
语法描述
语法描述
语法描述
高
高
语法描述
语法描述
语法描述
高
高
说明
TIW 不支持按产品功能或项目来创建自定义策略。
手动选择指用户在控制台所展示的候选项列表中选择对象。
语法描述指通过授权策略语法来描述对象。

授权策略语法

资源语法描述

如上文所述，TIW 权限管理的资源粒度是应用。应用的策略语法描述方式遵循 CAM 资源描述方式。在下文的示例中，开发者的主账号 ID 是12345678，开发者创建了三个应用：SDKAppID 分别是1400000000、1400000001和1400000002。
互动白板 TIW 所有应用的策略语法描述
"resource": [
"qcs::tiw::uin/12345678:sdkappid/*"
]
单个应用的策略语法描述
"resource": [
"qcs::tiw::uin/12345678:sdkappid/1400000001"
]
多个应用的策略语法描述
"resource": [
"qcs::tiw::uin/12345678:sdkappid/1400000000",
"qcs::tiw::uin/12345678:sdkappid/1400000001"
]

操作语法描述

如上文所述，实时音视频权限管理的操作粒度是云 API，详情请参见 可授权的资源及操作。在下文的示例中，以DescribeApplicationInfos（查询白板应用列表）、DescribeWhiteboardApplicationConfig（查询白板应用任务相关配置）等云 API 为例。
互动白板 TIW 所有云 API 的策略语法描述
"action": [
"name/tiw:*"
]
单个云 API 操作的策略语法描述
"action": [
"name/tiw:DescribeApplicationInfos"
]
多个云 API 操作的策略语法描述
"action": [
"name/tiw:DescribeApplicationInfos",
"name/tiw:DescribeWhiteboardApplicationConfig"
]

自定义策略使用示例

使用策略生成器

在下文示例中，我们将创建一个自定义策略。该策略允许对1400000001这个互动白板 TIW 应用进行任何操作。
1. 以腾讯云 主账号 的身份访问 CAM 控制台的 策略，单击新建自定义策略。
2. 选择 按策略生成器创建，进入策略创建页面。
3. 选择服务和操作。
效果(Effect) 配置项选择允许。
服务(Service) 配置项选择互动白板 TIW。
操作(Action) 配置项勾选所有项。
资源(Resource) 配置项按照 资源语法描述 说明填写qcs::tiw::uin/12345678:sdkappid/1400000001。
条件(Condition) 配置项无需配置。
4. 在同个页面中继续添加另一条声明。
效果(Effect)配置项选择拒绝。
服务(Service) 配置项选择互动白板 TIW。
操作(Action) 配置项勾选ModifyWhiteboardApplicationConfig（可通过搜索功能快速查找）。
资源(Resource) 配置项勾选特定资源，然后单击添加资源六段式，左侧会显示资源六段式的编辑页面，在资源的输入框里输入对应的 sdkappid。
条件(Condition) 配置项无需配置。
5. 单击下一步，按需修改策略名称（也可以不修改）。
6. 单击完成完成自定义策略的创建。
后续将该策略授予其他子账号的方法同 将 TIW 全读写访问权限授予已存在的子账号。

使用策略语法

在下文示例中，我们将创建一个自定义策略。该策略允许对1400000001和1400000002这两个互动白板 TIW 应用进行任何操作。
1. 以腾讯云 主账号 的身份访问 CAM 控制台的策略，单击新建自定义策略。
2. 选择 按策略语法创建，进入策略创建页面。
3. 在 选择模板类型 框下选择 空白模板 。
说明
策略模板指新策略是现有策略（预置策略或自定义策略）的一个拷贝，然后在此基础上做调整。在实际使用中，开发者可以根据情况选择合适的策略模板，降低编写策略内容的难度和工作量。
4. 单击下一步，按需修改策略名称（也可以不修改）。
5. 在编辑策略内容编辑框中填写策略内容。本示例的策略内容为：
{
 "version": "2.0",
 "statement": [
  {
      "effect": "allow",
      "action": [
          "name/tiw:*"
      ],
      "resource": [
          "qcs::tiw::uin/12345678:sdkappid/1400000001",
          "qcs::tiw::uin/12345678:sdkappid/1400000002"
      ]
  },
  {
      "effect": "deny",
      "action": [
          "name/tiw:ModifyWhiteboardApplicationConfig"
      ],
      "resource": [
          "qcs::tiw::uin/12345678:sdkappid/1400000001"
      ]
  }
 ]
}
说明
策略内容需遵循 CAM 策略语法逻辑，其中资源和操作两个元素的语法请参见上文 资源语法描述 和 操作语法描述 所述。
6. 单击完成实现自定义策略的创建。 后续将该策略授予其他子账号的方法同 将 TIW 全读写访问权限授予已存在的子账号。

使用 CAM 提供的服务端 API

对于大多数开发者来说，在控制台完成权限管理操作已经能满足业务需求。但如果需要将权限管理能力自动化和系统化，则可以基于服务端 API 来实现。 策略相关的服务端 API 属于 CAM，具体请参见 CAM 官网文档。此处仅列出几个主要接口：
创建策略
删除策略
绑定策略到用户
解除绑定到用户的策略
中国站


http://www.vxiaotou.com