Add Entra ID OAuthe2 token support (#29032)

* Add AAD OAuthe2 token support

* EntraIdToken

* Update specification/ai/HealthInsights/HealthInsights.OpenAPI/service.tsp

Co-authored-by: catalinaperalta <[email protected]>

* remove suppression

* update spec after merge

---------

Co-authored-by: koen-mertens <[email protected]>
Co-authored-by: catalinaperalta <[email protected]>

Author: 3 people

specification/ai/HealthInsights/HealthInsights.OpenAPI/service.tsp

@@ -16,13 +16,18 @@ using TypeSpec.Versioning;
     endpoint: url,
   }
 )
-@useAuth(AzureKey)
+@useAuth(AzureKey | EntraIdToken)
 namespace AzureHealthInsights;
 
 @doc("The secret key for your Azure Cognitive Services subscription.")
 model AzureKey
   is ApiKeyAuth<ApiKeyLocation.header, "Ocp-Apim-Subscription-Key">;
 
+@doc("The Microsoft Entra Id Flow")
+model EntraIdToken
+  is Azure.Core.AadOauth2Auth<["https://cognitiveservices.azure.com/.default"]>;
+
+#suppress "@azure-tools/typespec-azure-core/documentation-required" "https://github.com/Azure/typespec-azure/issues/3107"
 enum ApiVersion {
   @useDependency(Azure.Core.Versions.v1_0_Preview_2)
   v2024_04_01: "2024-04-01",

specification/ai/data-plane/HealthInsights/stable/2024-04-01/openapi.json

@@ -37,6 +37,11 @@
   "security": [
     {
       "AzureKey": []
+    },
+    {
+      "EntraIdToken": [
+        "https://cognitiveservices.azure.com/.default"
+      ]
     }
   ],
   "securityDefinitions": {
@@ -45,6 +50,16 @@
       "description": "The secret key for your Azure Cognitive Services subscription.",
       "name": "Ocp-Apim-Subscription-Key",
       "in": "header"
+    },
+    "EntraIdToken": {
+      "type": "oauth2",
+      "description": "The Microsoft Entra Id Flow",
+      "flow": "accessCode",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "https://cognitiveservices.azure.com/.default": ""
+      },
+      "tokenUrl": "https://login.microsoftonline.com/common/oauth2/token"
     }
   },
   "tags": [