Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Amikor a Speech SDK-t használja a Speech szolgáltatás eléréséhez, három hitelesítési módszer érhető el: szolgáltatáskulcsok, kulcsalapú jogkivonat és Microsoft Entra-azonosító. Ez a cikk bemutatja, hogyan konfigurálhat AI Foundry-erőforrást a Speechhez, és hogyan hozhat létre Speech SDK konfigurációs objektumot a Microsoft Entra ID hitelesítéshez való használatához.
Ez a cikk bemutatja, hogyan használható a Microsoft Entra-hitelesítés a Speech SDK-val. Az alábbiak végrehajtásának módját ismerheti meg:
- AI Foundry-erőforrás létrehozása a Speechhez
- A Speech-erőforrás konfigurálása a Microsoft Entra-hitelesítéshez
- Microsoft Entra hozzáférési token beszerzése
- Hozza létre a megfelelő SDK-konfigurációs objektumot.
Ha többet szeretne megtudni a Microsoft Entra hozzáférési jogkivonatairól, beleértve a jogkivonatok élettartamát, látogasson el az Access-jogkivonatokra a Microsoft Identitásplatform.
AI Foundry-erőforrás létrehozása a Speechhez
Ha AI Foundry-erőforrást szeretne létrehozni a Speechhez az Azure Portalon, tekintse meg ezt a rövid útmutatót.
A Speech-erőforrás konfigurálása a Microsoft Entra-hitelesítéshez
A Speech-erőforrás Microsoft Entra-hitelesítéshez való konfigurálásához hozzon létre egy egyéni tartománynevet, és rendeljen hozzá szerepköröket.
Egyéni tartománynév létrehozása
Az alábbi lépéseket követve egyéni altartománynevet hozhat létre az Azure AI-szolgáltatásokhoz a Speech-erőforráshoz.
Figyelemfelhívás
Egyéni tartománynév bekapcsolásakor a művelet nem vonható vissza. A regionális névre csak úgy lehet visszatérni, ha létrehozunk egy új Speech-erőforrást.
Ha a Speech-erőforrás számos társított egyéni modellel és projekttel rendelkezik a Speech Studióban, javasoljuk, hogy tesztelje a konfigurációt egy teszterőforrással, mielőtt módosítaná az éles környezetben használt erőforrást.
Ha egyéni tartománynevet szeretne létrehozni az Azure Portalon, kövesse az alábbi lépéseket:
Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.
Válassza ki a szükséges Speech-erőforrást.
A bal oldali panel Erőforrás-kezelés csoportjában válassza a Hálózatkezelés lehetőséget.
A Tűzfalak és virtuális hálózatok lapon válassza az Egyéni tartománynév létrehozása lehetőséget. Megjelenik egy új jobb oldali panel, amely útmutatást tartalmaz az erőforrás egyedi egyéni altartományának létrehozásához.
Az Egyéni tartománynév létrehozása panelen adjon meg egy egyéni tartománynevet. A teljes egyéni tartomány a következőképpen fog kinézni:
https://{your custom name}.cognitiveservices.azure.com
.Ne feledje, hogy az egyéni tartománynév létrehozása után az nem módosítható.
Miután megadta az egyéni tartománynevet, válassza a Mentés lehetőséget.
A művelet befejezése után az Erőforrás-kezelés csoportban válassza a Kulcsok és végpont lehetőséget. Győződjön meg arról, hogy az erőforrás új végpontneve a következő módon indul el:
https://{your custom name}.cognitiveservices.azure.com
.
Szerepkörök hozzárendelése
A Speech-erőforrásokkal végzett Microsoft Entra-hitelesítéshez a Cognitive Services Beszéd-közreműködő vagy a Cognitive Services Speech User szerepkört kell hozzárendelnie.
Szerepköröket rendelhet a felhasználóhoz vagy az alkalmazáshoz az Azure Portal vagy a PowerShell használatával.
Microsoft Entra hozzáférési token beszerzése
A Microsoft Entra hozzáférési jogkivonat C#-ban való lekéréséhez használja az Azure Identity Ügyfélkódtárat.
Íme egy példa a Microsoft Entra hozzáférési jogkivonat interaktív böngészőből való lekérésére az Azure Identity használatával:
TokenRequestContext context = new Azure.Core.TokenRequestContext(new string[] { "https://cognitiveservices.azure.com/.default" });
InteractiveBrowserCredential browserCredential = new InteractiveBrowserCredential();
var browserToken = browserCredential.GetToken(context);
string aadToken = browserToken.Token;
Feljegyzés
A jogkivonat-környezetnek ";"https://cognitiveservices.azure.com/.default" értékre kell állítania.
A Microsoft Entra hozzáférési jogkivonat C++-ban való lekéréséhez használja az Azure Identity Ügyfélkódtárat.
Íme egy példa arra, hogy az Azure Identity használatával lekérhet egy Microsoft Entra hozzáférési jogkivonatot a bérlőazonosítójával, ügyfél-azonosítójával és titkos ügyféltitkos hitelesítő adataival:
const std::string tokenContext = "https://cognitiveservices.azure.com/.default";
Azure::Identity::DefaultAzureCredential();
Azure::Core::Credentials::TokenRequestContext context;
context.Scopes.push_back(tokenContext);
auto token = cred.GetToken(context, Azure::Core::Context());
Feljegyzés
A jogkivonat-környezetnek ";"https://cognitiveservices.azure.com/.default" értékre kell állítania.
A Microsoft Entra hozzáférési jogkivonat javai beszerzéséhez használja az Azure Identity Ügyfélkódtárat.
Íme egy példa arra, hogy az Azure Identity használatával lekérhet egy Microsoft Entra hozzáférési jogkivonatot egy böngészőből:
TokenRequestContext context = new TokenRequestContext();
context.addScopes("https://cognitiveservices.azure.com/.default");
InteractiveBrowserCredentialBuilder builder = new InteractiveBrowserCredentialBuilder();
InteractiveBrowserCredential browserCredential = builder.build();
AccessToken browserToken = browserCredential.getToken(context).block();
String token = browserToken.getToken();
Feljegyzés
A jogkivonat-környezetnek ";"https://cognitiveservices.azure.com/.default" értékre kell állítania.
Ha Microsoft Entra hozzáférési jogkivonatot szeretne lekérni a Pythonban, használja az Azure Identity Ügyfélkódtárat.
Íme egy példa a Microsoft Entra hozzáférési jogkivonat interaktív böngészőből való lekérésére az Azure Identity használatával:
from azure.identity import InteractiveBrowserCredential
ibc = InteractiveBrowserCredential()
aadToken = ibc.get_token("https://cognitiveservices.azure.com/.default")
További példák
Microsoft Entra hozzáférési jogkivonatot lekérő minták keresése Microsoft Identitásplatform kódmintákban.
Olyan programozási nyelvek esetén, amelyekben nem érhető el Microsoft Identitásplatform ügyfélkódtár, közvetlenül kérhet hozzáférési jogkivonatot.
A Speech erőforrás-azonosítójának lekérése
A Speech erőforrás-azonosítójára szüksége van ahhoz, hogy SDK-hívásokat kezdeményezhet Microsoft Entra-hitelesítéssel olyan helyzetekben, amelyek még nem támogatják közvetlenül az Entra-azonosítót.
Az erőforrás-azonosító lekérése az Azure Portalon:
- Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.
- Válasszon egy AI Foundry-erőforrást a Speechhez.
- A bal oldali panel Erőforrás-kezelés csoportjában válassza a Tulajdonságok lehetőséget.
- Az erőforrás-azonosító másolása
A Speech SDK konfigurációs objektumának létrehozása
A Microsoft Entra hozzáférési jogkivonatával mostantól létrehozhat egy Speech SDK konfigurációs objektumot.
A jogkivonat megadásának módja és a megfelelő Speech SDK-objektum Config
létrehozásának módja a használt objektumtól függően változik.
Beszédfelismerő, Forrásnyelv Felismerő, Beszélgetés Átirat készítő
Objektumok, mint például SpeechRecognizer
, SourceLanguageRecognizer
, ConversationTranscriber
esetén, használja a TokenCredential megfelelő példányát a hitelesítéshez, valamint egy olyan végpontot, amely tartalmazza az egyéni tartományt, hogy létrehozhasson egy SpeechConfig
objektumot.
TokenCredential browserCredential = new InteractiveBrowserCredential();
// Define the custom domain endpoint for your Speech resource.
var endpoint = "https://{your custom name}.cognitiveservices.azure.com/";
// Create the SpeechConfig object using the custom domain endpoint and TokenCredential.
var speechConfig = SpeechConfig.FromEndpoint(new Uri(endpoint), browserCredential);
Fordítás Felismerő
A TranslationRecognizer
objektumhoz használjon egy megfelelő TokenCredential példányt hitelesítéshez, és egy olyan végponttal, ami az ön egyéni tartományát tartalmazza, hozzon létre egy SpeechTranslationConfig
objektumot.
TokenCredential browserCredential = new InteractiveBrowserCredential();
// Define the custom domain endpoint for your Speech resource
var endpoint = "https://{your custom name}.cognitiveservices.azure.com/";
// Create the SpeechTranslationConfig object using the custom domain endpoint and TokenCredential.
var speechConfig = SpeechTranslationConfig.FromEndpoint(new Uri(endpoint), browserCredential);
Beszédszintetizátor, Szándékfelismerő
SpeechSynthesizer
és IntentRecognizer
objektumok esetében építse fel az engedélyezési jogkivonatot az erőforrás-azonosítóból és a Microsoft Entra hozzáférési jogkivonatból, majd használja fel egy SpeechConfig
objektum létrehozásához.
string resourceId = "Your Resource ID";
string aadToken = "Your Microsoft Entra access token";
string region = "Your Speech Region";
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
var authorizationToken = $"aad#{resourceId}#{aadToken}";
var speechConfig = SpeechConfig.FromAuthorizationToken(authorizationToken, region);
Beszédfelismerő, Beszédszintetizátor, Szándékfelismerő, Beszélgetésleíró
Objektumokhoz SpeechRecognizer
hozza létre az engedélyezési jogkivonatot az erőforrás-azonosítóból és a Microsoft Entra hozzáférési jogkivonatból, majd használja egy objektum létrehozásáhozSpeechSynthesizer
. IntentRecognizer
ConversationTranscriber
SpeechConfig
std::string resourceId = "Your Resource ID";
std::string aadToken = "Your Microsoft Entra access token";
std::string region = "Your Speech Region";
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
auto authorizationToken = "aad#" + resourceId + "#" + aadToken;
auto speechConfig = SpeechConfig::FromAuthorizationToken(authorizationToken, region);
Fordítás Felismerő
TranslationRecognizer
Ehhez hozza létre az engedélyezési jogkivonatot az erőforrás-azonosítóból és a Microsoft Entra hozzáférési jogkivonatból, majd hozzon létre egy objektumotSpeechTranslationConfig
.
std::string resourceId = "Your Resource ID";
std::string aadToken = "Your Microsoft Entra access token";
std::string region = "Your Speech Region";
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
auto authorizationToken = "aad#" + resourceId + "#" + aadToken;
auto speechConfig = SpeechTranslationConfig::FromAuthorizationToken(authorizationToken, region);
Beszédfelismerő, Párbeszéd-átíró
SpeechRecognizer
és ConversationTranscriber
objektumok esetén használja a hitelesítéshez a TokenCredential megfelelő példányát, valamint az egyéni tartományt tartalmazó végpontot egy SpeechConfig
objektum létrehozásához.
TokenCredential browserCredential = new InteractiveBrowserCredentialBuilder().build();
// Define the custom domain endpoint for your Speech resource.
String endpoint = "https://{your custom name}.cognitiveservices.azure.com/";
// Create the SpeechConfig object using the custom domain endpoint and TokenCredential.
SpeechConfig speechConfig = SpeechConfig.fromEndpoint(new java.net.URI(endpoint), browserCredential);
Fordítás Felismerő
A TranslationRecognizer
objektumhoz használjon egy megfelelő TokenCredential példányt hitelesítéshez, és egy olyan végponttal, ami az ön egyéni tartományát tartalmazza, hozzon létre egy SpeechTranslationConfig
objektumot.
TokenCredential browserCredential = new InteractiveBrowserCredentialBuilder().build();
// Define the custom domain endpoint for your Speech resource
String endpoint = "https://{your custom name}.cognitiveservices.azure.com/";
// Create the SpeechTranslationConfig object using the custom domain endpoint and TokenCredential.
SpeechConfig speechConfig = SpeechTranslationConfig.fromEndpoint(new java.net.URI(endpoint), browserCredential);
Beszédszintetizátor, Szándékfelismerő
SpeechSynthesizer
és IntentRecognizer
objektumok esetében építse fel az engedélyezési jogkivonatot az erőforrás-azonosítóból és a Microsoft Entra hozzáférési jogkivonatból, majd használja fel egy SpeechConfig
objektum létrehozásához.
String resourceId = "Your Resource ID";
String region = "Your Region";
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
String authorizationToken = "aad#" + resourceId + "#" + token;
SpeechConfig speechConfig = SpeechConfig.fromAuthorizationToken(authorizationToken, region);
SpeechRecognizer, Beszélgetés-átíró
A SpeechRecognizer
, ConversationTranscriber
objektumokhoz használja a TokenCredential megfelelő példányát a hitelesítéshez, valamint az egyéni tartományt tartalmazó végpontot, egy SpeechConfig
objektum létrehozásához.
browserCredential = InteractiveBrowserCredential()
// Define the custom domain endpoint for your Speech resource.
custom_endpoint = "https://{your custom name}.cognitiveservices.azure.com/"
// Create the SpeechConfig object using the custom domain endpoint and TokenCredential.
speechConfig = SpeechConfig(token_credential=credential, endpoint=custom_endpoint)
Fordítás Felismerő
A TranslationRecognizer
objektumhoz használjon egy megfelelő TokenCredential példányt hitelesítéshez, és egy olyan végponttal, ami az ön egyéni tartományát tartalmazza, hozzon létre egy SpeechTranslationConfig
objektumot.
browserCredential = InteractiveBrowserCredential()
// Define the custom domain endpoint for your Speech resource
custom_endpoint = "https://{your custom name}.cognitiveservices.azure.com/"
// Create the SpeechTranslationConfig object using the custom domain endpoint and TokenCredential.
speechTranslationConfig = SpeechTranslationConfig(token_credential=credential, endpoint=custom_endpoint)
Beszédszintetizátor, Szándékfelismerő
SpeechSynthesizer
és IntentRecognizer
objektumok esetében építse fel az engedélyezési jogkivonatot az erőforrás-azonosítóból és a Microsoft Entra hozzáférési jogkivonatból, majd használja fel egy SpeechConfig
objektum létrehozásához.
resourceId = "Your Resource ID"
region = "Your Region"
# You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
authorizationToken = "aad#" + resourceId + "#" + aadToken.token
speechConfig = SpeechConfig(auth_token=authorizationToken, region=region)
VoiceProfileClient
A Microsoft Entra-hitelesítés használatához VoiceProfileClient
használja a fent létrehozott egyéni tartománynevet.
string customDomainName = "Your Custom Name";
string hostName = $"https://{customDomainName}.cognitiveservices.azure.com/";
string token = "Your Microsoft Entra access token";
var config = SpeechConfig.FromHost(new Uri(hostName));
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
var authorizationToken = $"aad#{resourceId}#{aadToken}";
config.AuthorizationToken = authorizationToken;
std::string customDomainName = "Your Custom Name";
std::string aadToken = "Your Microsoft Entra access token";
auto speechConfig = SpeechConfig::FromHost("https://" + customDomainName + ".cognitiveservices.azure.com/");
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
auto authorizationToken = "aad#" + resourceId + "#" + aadToken;
speechConfig->SetAuthorizationToken(authorizationToken);
String aadToken = "Your Microsoft Entra access token";
String customDomainName = "Your Custom Name";
String hostName = "https://" + customDomainName + ".cognitiveservices.azure.com/";
SpeechConfig speechConfig = SpeechConfig.fromHost(new URI(hostName));
// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
String authorizationToken = "aad#" + resourceId + "#" + token;
speechConfig.setAuthorizationToken(authorizationToken);
Ez VoiceProfileClient
nem érhető el a PythonHoz készült Speech SDK-val.
Feljegyzés
Ez ConversationTranslator
nem támogatja a Microsoft Entra-hitelesítést.