SFI 299863

Author: eric-urban

articles/ai-services/speech-service/how-to-configure-azure-ad-auth.md

@@ -2,14 +2,13 @@
 title: How to configure Microsoft Entra authentication
 titleSuffix: Azure AI services
 description: Learn how to authenticate using Microsoft Entra authentication
-author: rhurey
+author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 1/18/2024
-ms.author: rhurey
+ms.date: 9/9/2024
+ms.author: eur
 zone_pivot_groups: programming-languages-set-two
-ms.devlang: cpp
 ms.custom: devx-track-azurepowershell, devx-track-extended-java, devx-track-python, devx-track-azurecli
 ---
 
@@ -186,10 +185,10 @@ For ```SpeechRecognizer```, ```SpeechSynthesizer```, ```IntentRecognizer```, ```
 ::: zone pivot="programming-language-csharp"
 ```C#
 string resourceId = "Your Resource ID";
-string aadToken = "Your Azure AD access token";
+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 AAD access token.
+// 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);
 ```
@@ -198,10 +197,10 @@ var speechConfig = SpeechConfig.FromAuthorizationToken(authorizationToken, regio
 ::: zone pivot="programming-language-cpp"
 ```C++
 std::string resourceId = "Your Resource ID";
-std::string aadToken = "Your Azure AD access token";
+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 AAD access token.
+// 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);
 ```
@@ -212,7 +211,7 @@ auto speechConfig = SpeechConfig::FromAuthorizationToken(authorizationToken, reg
 String resourceId = "Your Resource ID";
 String region = "Your Region";
 
-// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
+// 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);
 ```
@@ -222,7 +221,7 @@ SpeechConfig speechConfig = SpeechConfig.fromAuthorizationToken(authorizationTok
 ```Python
 resourceId = "Your Resource ID"
 region = "Your Region"
-# You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
+# 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)
 ```
@@ -235,10 +234,10 @@ For the ```TranslationRecognizer```, build the authorization token from the reso
 ::: zone pivot="programming-language-csharp"
 ```C#
 string resourceId = "Your Resource ID";
-string aadToken = "Your Azure AD access token";
+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 AAD access token.
+// 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 = SpeechTranslationConfig.FromAuthorizationToken(authorizationToken, region);
 ```
@@ -247,10 +246,10 @@ var speechConfig = SpeechTranslationConfig.FromAuthorizationToken(authorizationT
 ::: zone pivot="programming-language-cpp"
 ```cpp
 std::string resourceId = "Your Resource ID";
-std::string aadToken = "Your Azure AD access token";
+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 AAD access token.
+// 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);
 ```
@@ -261,7 +260,7 @@ auto speechConfig = SpeechTranslationConfig::FromAuthorizationToken(authorizatio
 String resourceId = "Your Resource ID";
 String region = "Your Region";
 
-// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
+// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
 String authorizationToken = "aad#" + resourceId + "#" + token;
 SpeechTranslationConfig translationConfig = SpeechTranslationConfig.fromAuthorizationToken(authorizationToken, region);
 ```
@@ -272,70 +271,24 @@ SpeechTranslationConfig translationConfig = SpeechTranslationConfig.fromAuthoriz
 resourceId = "Your Resource ID"
 region = "Your Region"
 
-# You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
+# You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and Microsoft Entra access token.
 authorizationToken = "aad#" + resourceId + "#" + aadToken.token
 translationConfig = SpeechTranslationConfig(auth_token=authorizationToken, region=region)
 ```
 ::: zone-end
 
-### DialogServiceConnector
-
-For the ```DialogServiceConnection``` object, build the authorization token from the resource ID and the Microsoft Entra access token and then use it to create a ```CustomCommandsConfig``` or a ```BotFrameworkConfig``` object.
-
-::: zone pivot="programming-language-csharp"
-```C#
-string resourceId = "Your Resource ID";
-string aadToken = "Your Azure AD access token";
-string region =  "Your Speech Region";
-string appId = "Your app ID";
-
-// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
-var authorizationToken = $"aad#{resourceId}#{aadToken}";
-var customCommandsConfig = CustomCommandsConfig.FromAuthorizationToken(appId, authorizationToken, region);
-```
-::: zone-end
-
-::: zone pivot="programming-language-cpp"
-```cpp
-std::string resourceId = "Your Resource ID";
-std::string aadToken = "Your Azure AD access token";
-std::string region = "Your Speech Region";
-std::string appId = "Your app Id";
-
-// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
-auto authorizationToken = "aad#" + resourceId + "#" + aadToken;
-auto customCommandsConfig = CustomCommandsConfig::FromAuthorizationToken(appId, authorizationToken, region);
-```
-::: zone-end
-
-::: zone pivot="programming-language-java"
-```Java
-String resourceId = "Your Resource ID";
-String region = "Your Region";
-String appId = "Your AppId";
-
-// You need to include the "aad#" prefix and the "#" (hash) separator between resource ID and AAD access token.
-String authorizationToken = "aad#" + resourceId + "#" + token;
-CustomCommandsConfig dialogServiceConfig = CustomCommandsConfig.fromAuthorizationToken(appId, authorizationToken, region);
-```
-::: zone-end
-
-::: zone pivot="programming-language-python"
-The DialogServiceConnector is not currently supported in Python
-::: zone-end
-
 ### VoiceProfileClient
 To use the ```VoiceProfileClient``` with Microsoft Entra authentication, use the custom domain name created above.
 
 ::: zone pivot="programming-language-csharp"
 ```C#
 string customDomainName = "Your Custom Name";
 string hostName = $"https://{customDomainName}.cognitiveservices.azure.com/";
-string token = "Your Azure AD access token";
+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 AAD access token.
+// 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;
 ```
@@ -344,24 +297,24 @@ config.AuthorizationToken = authorizationToken;
 ::: zone pivot="programming-language-cpp"
 ```cpp
 std::string customDomainName = "Your Custom Name";
-std::string aadToken = "Your Azure AD access token";
+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 AAD access token.
+// 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);
 ```
 ::: zone-end
 
 ::: zone pivot="programming-language-java"
 ```Java
-String aadToken = "Your Azure AD access token";
+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 AAD access token.
+// 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);