Skip to content

Commit f903dd7

Browse files
authored
Update role-based-access-control.md
1 parent e9794a4 commit f903dd7

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

articles/ai-services/speech-service/role-based-access-control.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: eric-urban
66
manager: nitinme
77
ms.service: azure-ai-speech
88
ms.topic: conceptual
9-
ms.date: 9/23/2024
9+
ms.date: 11/19/2024
1010
ms.author: eur
1111
# Customer intent: As a developer, I want to learn how to assign access roles for a Speech resource.
1212
---
@@ -46,23 +46,23 @@ For finer-grained resource access control, you can [add or remove roles](/azure/
4646

4747
The [roles](#roles-for-speech-resources) define what permissions you have. Authentication is required to use the Speech resource.
4848

49-
To authenticate with Speech resource keys, all you need is the key and region. To authenticate with a Microsoft Entra token, the Speech resource must have a [custom subdomain](speech-services-private-link.md#create-a-custom-domain-name) and use a [private endpoint](speech-services-private-link.md#turn-on-private-endpoints). The Speech service uses custom subdomains with private endpoints only.
49+
o authenticate with Speech resource keys, all you need is the key and region. To authenticate with a Microsoft Entra token, the Speech resource must have a [custom subdomain](speech-services-private-link.md#create-a-custom-domain-name).
5050

5151
### Speech SDK authentication
5252

5353
For the SDK, you configure whether to authenticate with a Speech resource key or Microsoft Entra token. For details, see [Microsoft Entra authentication with the Speech SDK](how-to-configure-azure-ad-auth.md).
5454

5555
### Speech Studio authentication
5656

57-
Once you're signed into [Speech Studio](speech-studio-overview.md), you select a subscription and Speech resource. You don't choose whether to authenticate with a Speech resource key or Microsoft Entra token. Speech Studio gets the key or token automatically from the Speech resource. If one of the assigned [roles](#roles-for-speech-resources) has permission to list resource keys, Speech Studio authenticates with the key. Otherwise, Speech Studio authenticates with the Microsoft Entra token.
57+
Once you're signed into [Speech Studio](speech-studio-overview.md), you select a subscription and Speech resource. You don't choose whether to authenticate with a Speech resource key or Microsoft Entra token. Speech Studio gets the key or token automatically from the Speech resource. If one of the assigned [roles](#roles-for-speech-resources) has permission to list resource keys and the key authentication is not disabled, Speech Studio authenticates with the key. Otherwise, Speech Studio authenticates with the Microsoft Entra token.
5858

59-
If Speech Studio uses your Microsoft Entra token, but the Speech resource doesn't have a custom subdomain and private endpoint, then you can't use some features in Speech Studio. In this case, for example, the Speech resource can be used to train a custom speech model, but you can't use a custom speech model to transcribe audio files.
59+
If Speech Studio uses your Microsoft Entra token, but the Speech resource doesn't have a custom subdomain, then you can't use any features in Speech Studio. If you don't have necessary role permissions for a feature in Speech Studio, you can't use it, and you will see a permission warning banner on the page.
6060

61-
| Authentication credential | Feature availability |
62-
| ---| ---|
63-
|Speech resource key|Full access. Role configuration is ignored if resource key is used.|
64-
|Microsoft Entra token with custom subdomain and private endpoint|Full access limited only by the assigned role permissions.|
65-
|Microsoft Entra token without custom subdomain and private endpoint (not recommended)|Features are limited. For example, the Speech resource can be used to train a custom speech model or custom neural voice. But you can't use a custom speech model or custom neural voice.|
61+
| Authentication credential | Feature availability |
62+
| ---------------------------------------------- | ------------------------------------------------------------------- |
63+
| Speech resource key | Full access. Role configuration is ignored if resource key is used. |
64+
| Microsoft Entra token with custom subdomain | Full access limited only by the assigned role permissions. |
65+
| Microsoft Entra token without custom subdomain | No access. |
6666

6767
## Next steps
6868

0 commit comments

Comments
 (0)