可授权的资源及操作
注意:本文档主要介绍 实时音视频 TRTC 访问管理功能的相关内容,其他产品访问管理相关内容请参见 支持 CAM 的产品。
访问管理的核心功能可以表达为:允许或禁止某账号对某些资源进行某些操作。TRTC 访问管理支持 资源级授权,资源的粒度是 TRTC 应用,操作的粒度是 云 API,包括 服务端 API 以及访问 TRTC 控制台时可能会用到的 API。
如有 TRTC 访问管理需求,请登录腾讯云 主账号 使用 预设策略 或 自定义策略 完成具体授权操作。
可授权的资源类型
TRTC 访问管理可授权的资源类型为 应用。
支持资源级授权的 API
除了部分 不支持资源级授权的 API ,本小节列出的所有 API 操作均支持资源级授权。 授权策略语法 中对这些 API 操作的资源语法描述均相同,具体为:
- 授权所有应用访问权限:
qcs::trtc::uin/${uin}:sdkappid/*
。 - 授权单个应用访问权限:
qcs::trtc::uin/${uin}:sdkappid/${SdkAppId}
。
服务端 API 操作
接口名称 | 接口分类 | 功能描述 |
---|---|---|
DismissRoom | 房间管理 | 解散房间 |
RemoveUser | 房间管理 | 移出用户 |
RemoveUserByStrRoomId | 房间管理 | 移出用户(字符串房间号) |
DismissRoomByStrRoomId | 房间管理 | 解散房间(字符串房间号) |
StartMCUMixTranscode | 混流转码 | 启动云端混流 |
StopMCUMixTranscode | 混流转码 | 结束云端混流转码 |
StartMCUMixTranscodeByStrRoomId | 混流转码 | 启动云端混流(字符串房间号) |
StopMCUMixTranscodeByStrRoomId | 混流转码 | 结束云端混流(字符串房间号) |
CreateTroubleInfo | 通话质量监控 | 创建异常信息 |
DescribeAbnormalEvent | 通话质量监控 | 查询异常体验事件 |
DescribeCallDetail | 通话质量监控 | 查询用户列表与通话指标 |
DescribeHistoryScale | 通话质量监控 | 查询历史房间和用户数 |
DescribeRoomInformation | 通话质量监控 | 查询房间列表 |
DescribeUserInformation | 通话质量监控 | 查询历史用户列表 |
控制台 API 操作
接口名称 | 使用模块 | 功能描述 |
---|---|---|
DescribeAppStatList | TRTC 控制台 | 获取应用列表 |
DescribeSdkAppInfo | TRTC 控制台 应用管理 > 应用信息 | 获取应用信息 |
ModifyAppInfo | TRTC 控制台 应用管理 > 应用信息 | 编辑应用信息 |
ChangeSecretKeyFlag | TRTC 控制台 应用管理 > 应用信息 | 修改权限密钥状态 |
CreateWatermark | TRTC 控制台 应用管理 > 素材管理 | 上传图片 |
DeleteWatermark | TRTC 控制台 应用管理 > 素材管理 | 删除图片 |
ModifyWatermark | TRTC 控制台 应用管理 > 素材管理 | 编辑图片 |
DescribeWatermark | TRTC 控制台 应用管理 > 素材管理 | 查找图片 |
CreateSecret | TRTC 控制台 应用管理 > 快速上手 | 创建对称式加密密钥 |
ToggleSecretVersion | TRTC 控制台应用管理 > 快速上手 | 切换密钥版本(公私钥/对称式加密密钥) |
DescribeSecret | TRTC 控制台 | 获取对称式加密密钥 |
DescribeTrtcAppAndAccountInfo | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 获取应用及账号信息来获取公私钥 |
CreateSecretUserSig | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 使用对称式加密密钥生成 UserSig |
DescribeSig | TRTC 控制台 | 获取使用旧版公私钥生成的UserSig |
VerifySecretUserSig | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 对称式加密密钥生成的 UserSig 校验 |
VerifySig | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 公私钥生成的 UserSig 校验 |
CreateSpearConf | TRTC 控制台 应用管理 > 画面设定 | 新增画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
DeleteSpearConf | TRTC 控制台 应用管理 > 画面设定 | 删除画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
ModifySpearConf | TRTC 控制台 应用管理 > 画面设定 | 修改画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
DescribeSpearConf | TRTC 控制台 应用管理 > 画面设定 | 获取画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
ToggleSpearScheme | TRTC 控制台 应用管理 > 画面设定 | 切换画面设定场景。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
不支持资源级授权的 API
由于特殊限制,下述 API 不支持资源级授权:
服务端 API 操作
接口名称 | 接口分类 | 功能描述 | 特殊限制说明 |
---|---|---|---|
DescribeDetailEvent | 通话质量监控 | 获取详细事件 | 输入参数无 SDKAppID ,无法进行资源级授权。 |
DescribeRecordStatistic | 其他接口 | 查询云端录制计费时长 | 业务原因,暂不支持资源级授权 |
DescribeTrtcInteractiveTime | 其他接口 | 查询音视频互动计费时长 | 业务原因,暂不支持资源级授权 |
DescribeTrtcMcuTranscodeTime | 其他接口 | 查询旁路转码计费时长 | 业务原因,暂不支持资源级授权 |
控制台 API 操作
接口名称 | 使用模块 | 功能描述 | 特殊限制说明 |
---|---|---|---|
DescribeTrtcStatistic | TRTC 控制台 | 获取计费时长用量统计数据 | 该接口包含返回全量 SDKAppID 的统计数据,限制非全量 SDKAppID 将返回错误。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
DescribeDurationPackages | TRTC 控制台 | 获取预付费套餐包列表 | 预付费套餐包为单个腾讯云账号下的所有 TRTC 应用共享,套餐包信息中无 SDKAppID 参数,无法进行资源级授权 |
GetUserList | TRTC 控制台 监控仪表盘 | 获取用户列表 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
GetUserInfo | TRTC 控制台 监控仪表盘 | 获取用户信息 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
GetCommState | TRTC 控制台 监控仪表盘 | 获取通话状态 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
GetElasticSearchData | TRTC 控制台 监控仪表盘 | 查询 ES 数据 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
CreateTrtcApp | TRTC 控制台 | 创建 TRTC 应用 | 输入参数无 SDKAppID,无法进行资源级授权。SDKAppID 是 TRTC 应用的唯一标识,创建应用之后才有 SDKAppID 信息 |
HardDescribeMixConf | TRTC 控制台 应用管理 > 功能配置 | 查询自动旁路推流状态 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
ModifyMixConf | TRTC 控制台 应用管理 > 功能配置 | 开启/关闭自动旁路推流 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
RemindBalance | TRTC 控制台 套餐包管理 | 获取预付费套餐包余额告警信息 | 预付费套餐包为单个腾讯云账号下的所有 TRTC 应用共享,套餐包信息中无 SDKAppID 参数,无法进行资源级授权 |
注意:针对不支持资源级授权的 API 操作,您仍然可以通过 自定义策略 向用户授予使用该操作的权限,但是策略语句的资源元素必须指定为
*
。