Szerepköralapú hozzáférés-vezérlés a Speech-erőforrásokhoz

A Speech-erőforrásokhoz való hozzáférést és engedélyeket azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) kezelheti. A hozzárendelt szerepkörök különbözőek lehetnek a Speech-erőforrások között.

Hozzárendelhet például egy szerepkört egy AI Speech-erőforráshoz, amely csak egyéni beszédmodell betanítása céljából használható. Hozzárendelhet egy másik szerepkört egy AI Speech-erőforráshoz, amely hangfájlok átírására szolgál.

Attól függően, hogy ki férhet hozzá az egyes Speech-erőforrásokhoz, alkalmazásonként vagy felhasználónként hatékonyan állíthat be egy másik hozzáférési szintet. Az Azure RBAC-vel kapcsolatos további információkért tekintse meg az Azure RBAC dokumentációját.

Feljegyzés

Ez a cikk bemutatja, hogyan rendelhet hozzáférési szerepköröket egy AI Speech-erőforráshoz. A Hozzáférési szerepkörök Microsoft Foundry-erőforrásokhoz való hozzárendeléséről a Microsoft Foundry dokumentációjában olvashat.

Speech-erőforrások szerepkörei

A szerepkör-definíció engedélyek gyűjteménye. Az AI Speech-erőforrások több szerepkört is örökölhetnek vagy hozzárendelhetnek. Az erőforráshoz való hozzáférés végső szintje az összes szerepkör-engedély kombinációja. AI Speech-erőforrás létrehozásakor az alábbi táblázatban szereplő beépített szerepkörök érhetők el hozzárendelésre.

Szerepkör Listázhatja az erőforráskulcsokat Hozzáférés az adatokhoz, modellekhez és végpontokhoz egyéni projektekben Hozzáférés a beszédátíráshoz és a szintézis API-khoz
Tulajdonos Igen Egyik sem Nem
Közreműködő Igen Egyik sem Nem
Cognitive Services-közreműködő Igen Egyik sem Nem
Cognitive Services-felhasználó Igen Megtekintés, létrehozás, szerkesztés és törlés Igen
Cognitive Services Speech-közreműködő Nem Megtekintés, létrehozás, szerkesztés és törlés Igen
Cognitive Services Beszédfelhasználó Nem Csak megtekintés Igen
Cognitive Services-adatolvasó (előzetes verzió) Nem Csak megtekintés Igen

Ha a Speech-erőforrás teljes olvasási és írási hozzáféréssel rendelkezik a projektekhez, tartsa meg a beépített szerepköröket.

A részletesebb erőforrás-hozzáférés-vezérlés érdekében szerepköröket vehet fel vagy távolíthat el az Azure Portalon. Létrehozhat például egy egyéni szerepkört egyéni beszédadatkészletek feltöltésére vonatkozó engedéllyel, de anélkül, hogy az egyéni beszédmodellt üzembe helyezhetné egy végponton.

A Speech-erőforrások különleges szempontjai

Fontos

A beszédszolgáltatás architektúrája eltér a többi Foundry-eszköztől az Azure vezérlősíkjának és adatsíkjának használatában.

A Speech Service széles körben használja az adatsíkot más Foundry-eszközökhöz képest, és ehhez eltérő beállításokra van szükség a szerepkörökhöz. Emiatt egyes általános "Cognitive Services" szerepkörök tényleges hozzáférési jogosultságokkal rendelkeznek, amelyek nem felelnek meg pontosan a nevüknek a Speech Services-forgatókönyvben való használatkor.

Például a Cognitive Services felhasználója gyakorlatilag biztosítja a közreműködői jogokat, míg a Cognitive Services közreműködője egyáltalán nem biztosít hozzáférést. Ugyanez érvényes az általános tulajdonosi és közreműködői szerepkörökre is, amelyek nem rendelkeznek adatsík-jogosultságokkal, ezért nem biztosítanak hozzáférést a Speech-erőforráshoz.

A konzisztencia megőrzése érdekében javasoljuk, hogy a nevükben Speech-et tartalmazó szerepköröket használja. Ezek a szerepkörök a Cognitive Services Speech User és a Cognitive Services Speech Közreműködői. A hozzáférési jogosultsági csoportokat kifejezetten a Speech szolgáltatáshoz tervezték.

Hitelesítés kulcsokkal és jogkivonatokkal

A szerepkörök határozzák meg, hogy milyen engedélyekkel rendelkezik. A Speech-erőforrás használatához hitelesítés szükséges.

A Speech erőforráskulcsokkal való hitelesítéshez mindössze a kulcsra és a régióra van szüksége. A Microsoft Entra-jogkivonattal való hitelesítéshez a Speech-erőforrásnak egyéni altartományral kell rendelkeznie.

Az alábbiakban bemutatjuk, hogyan hozhat létre új Speech-erőforrást egy egyéni altartomány használatával. Meglévő erőforrást is használhat, de egyéni altartományt kell használnia. Az egyéni altartományok létrehozásáról további információt az Egyéni tartománynév létrehozása című témakörben talál.

resourceGroupName=my-speech-rg
location=eastus
AIServicesResourceName=my-aiservices-$location

# create an AIServices resource for Speech and other Foundry Tools
az cognitiveservices account create --name $AIServicesResourceName --resource-group $resourceGroupName --kind AIServices --sku S0 --location $location --custom-domain $AIServicesResourceName

# get the resource id
speechResourceId=$(az cognitiveservices account show --name $AIServicesResourceName --resource-group $resourceGroupName --query id -o tsv)
# assign Cognitive Services User role to the app id
appId=$(az ad signed-in-user show --query id -o tsv)
az role assignment create --role "Cognitive Services User" --assignee $appId --scope $speechResourceId
# assign Cognitive Services Speech User role to the app id
az role assignment create --role "Cognitive Services Speech User" --assignee $appId --scope $speechResourceId

# get an access token
accessToken=$(az account get-access-token --scope "https://cognitiveservices.azure.com/.default" --query accessToken -o tsv)
echo $accessToken

A visszaadott accessToken Microsoft Entra-jogkivonat api-kulcsok nélküli hitelesítésre használható. A token élettartama korlátozott.

Most már használhatja a accessToken hitelesítést az Foundry-erőforrással. Használhatja például a jogkivonatot a fast transcription REST API-val:

uri="https://$AIServicesResourceName.cognitiveservices.azure.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15"

curl -v "$uri" \
    --header 'Content-Type: multipart/form-data' \
    --form 'definition={"locales": ["en-US"]}' \
    --form 'audio=@Call1_separated_16k_health_insurance.wav' \
    --header "Authorization: Bearer $accessToken" 

Speech SDK-hitelesítés

Az SDK esetében konfigurálja, hogy API-kulccsal vagy Microsoft Entra-jogkivonattal hitelesít-e. További információ: Microsoft Entra authentication with the Speech SDK. |