你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
用于语音资源的基于角色的访问控制
可以使用 Azure 基于角色的访问控制 (Azure RBAC) 来管理语音资源的访问和权限。 分配的角色可能因语音资源而异。 例如，可以将一个角色分配给只应该用于训练自定义语音识别模型的语音资源。 可以将另一个角色分配给用于转录音频文件的语音资源。 根据谁可以访问每个语音资源，可以有效地对每个应用程序或用户设置不同的访问级别。 有关 Azure RBAC 的详细信息，请参阅 Azure RBAC 文档。
注意
一个语音资源可以继承或分配有多个角色。 对此资源的最终访问级别是所有角色权限的组合。
语音资源的角色
角色定义是权限的集合。 创建语音资源时，可分配下表中的内置角色。
警告
语音服务体系结构与其他 Azure AI 服务不同之处在于，前者使用 Azure 控制平面和数据平面。 与其他 Azure AI 服务相比，语音服务广泛使用数据平面，这需要对角色进行不同的设置。 因此，一些常规认知服务角色的实际访问权限集在语音服务方案中使用时与其名称不完全匹配。 例如，“认知服务用户”提供“参与者”权限，而“认知服务参与者”完全不提供任何访问权限。 常规“所有者”和“参与者”角色也是如此，这些角色没有数据平面权限，因此不提供对语音资源的访问权限。 为了保持一致性，建议使用名称中包含“语音”的角色。 这些角色为“认知服务语音用户”和“认知服务语音参与者”。 其访问权限集专为语音服务设计。 若要使用一般认知服务角色和 Azure 常规角色，请认真研究以下访问权限表。
| 角色 | 可以列出资源密钥 | 访问自定义项目中的数据、模型和终结点 | 访问语音听录和合成 API |
|---|---|---|---|
| 所有者 | 是 | 无 | 否 |
| 参与者 | 是 | 无 | 否 |
| 认知服务参与者 | 是 | 无 | 否 |
| 认知服务用户 | 是 | 查看、创建、编辑和删除 | 是 |
| 认知服务语音参与者 | 否 | 查看、创建、编辑和删除 | 是 |
| 认知服务语音用户 | 否 | 仅查看 | 是 |
| 认知服务数据读取者（预览版） | 否 | 仅查看 | 是 |
重要
角色是否可以列出资源密钥对于 Speech Studio 身份验证十分重要。 若要列出资源密钥，角色必须具有运行 Microsoft.CognitiveServices/accounts/listKeys/action 操作的权限。 请注意，如果在 Azure 门户中禁用密钥身份验证，则任何角色都无法列出密钥。
如果语音资源可以对项目具有完全读取和写入访问权限，请保留内置角色。
若要进行精细资源访问控制，可以使用Azure 门户添加或移除角色。 例如，你可以创建一个有权上传自定义语音数据集但无权将自定义语音识别模型部署到终结点的自定义角色。
使用密钥和令牌进行身份验证
角色定义你拥有的权限。 使用语音资源需要进行身份验证。
若要使用语音资源密钥进行身份验证，只需提供密钥和区域。 若要使用 Microsoft Entra 令牌进行身份验证，语音资源必须具有自定义子域并使用专用终结点。 语音服务只使用具有专用终结点的自定义子域。
语音 SDK 身份验证
对于 SDK，可配置是使用语音资源密钥还是 Microsoft Entra 令牌进行身份验证。 有关详细信息，请参阅使用语音 SDK 的 Microsoft Entra 身份验证。
Speech Studio 身份验证
登录 Speech Studio 后，可选择订阅和语音资源。 不选择是使用语音资源密钥还是 Microsoft Entra 令牌进行身份验证。 Speech Studio 会从语音资源自动获取密钥或令牌。 如果其中一个已分配角色有权列出资源密钥，则 Speech Studio 会使用密钥进行身份验证。 否则，Speech Studio 会使用 Microsoft Entra 令牌进行身份验证。
如果 Speech Studio 使用 Microsoft Entra 令牌，但语音资源没有自定义子域和专用终结点，则你无法在 Speech Studio 中使用某些功能。 例如，在这种情况下，语音资源可用于训练自定义语音识别模型，但不能使用自定义语音识别模型转录音频文件。
| 身份验证凭据 | 功能可用性 |
|---|---|
| 语音资源密钥 | 完全访问权限。 如果使用了资源密钥，则会忽略角色配置。 |
| 具有自定义子域和专用终结点的 Microsoft Entra 令牌 | 完全访问权限仅受分配的角色权限限制。 |
| 没有自定义子域和专用终结点的 Microsoft Entra 令牌（不推荐） | 功能受限。 例如，语音资源可用于训练自定义语音识别模型或神经网络定制声音。 但你不能使用自定义语音识别模型或神经网络定制声音。 |