code-ai-services-microsoft-entra-id.md

author	ms.service	ms.topic	ms.date	ms.author
wchigit	service-connector	include	10/20/2023	wchi

You can use the Azure client library to access various cognitive APIs that Azure AI Services support. We use Azure AI Text Analytics as an example in this sample. Refer to Authenticate requests to Azure AI services to call the cognitive APIs directly.

.NET

1. Install the following dependencies. We use Azure.AI.TextAnalytics as an example.

   dotnet add package Azure.AI.TextAnalytics
   dotnet add package Azure.Identity

2. Authenticate using the Azure Identity library and get the Azure AI Services endpoint from the environment variables added by Service Connector. When using the code below, uncomment the part of the code snippet for the authentication type you want to use.

   using Azure.AI.TextAnalytics;
   using Azure.Identity;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // system-assigned managed identity
   // var credential = new DefaultAzureCredential();
   
   // user-assigned managed identity
   // var credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   //     });
   
   // service principal 
   // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
   // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTSECRET");
   // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   TextAnalyticsClient languageServiceClient = new(
     new Uri(endpoint),
     credential);

Java

1. Add the following dependencies in your pom.xml file. We use azure-ai-textanalytics as an example.

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-ai-textanalytics</artifactId>
       <version>5.1.12</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.11.4</version>
   </dependency>

2. Authenticate using azure-identity and get the Azure AI Services endpoint from the environment variables added by Service Connector. When using the code below, uncomment the part of the code snippet for the authentication type you want to use.

   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //   .clientSecret(System.getenv("AZURE_AISERVICES_CLIENTSECRET"))
   //   .tenantId(System.getenv("AZURE_AISERVICES_TENANTID"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
       .credential(credential)
       .endpoint(endpoint)
       .buildClient();

Python

1. Install the following dependencies. We use azure-ai-textanalytics as an example.

   pip install azure-ai-textanalytics==5.1.0
   pip install azure-identity

2. Authenticate using azure-identity and get the Azure AI Services endpoint from the environment variables added by Service Connector. When using the code below, uncomment the part of the code snippet for the authentication type you want to use.

   import os
   from azure.ai.textanalytics import TextAnalyticsClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_AISERVICES_TENANTID')
   # client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # client_secret = os.getenv('AZURE_AISERVICES_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   endpoint = os.getenv('AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT')
   
   language_service_client = TextAnalyticsClient(
     endpoint=endpoint, 
     credential=cred)

NodeJS

1. Install the following dependencies. We use ai-text-analytics as an example.

   npm install @azure/[email protected]
   npm install @azure/identity

2. Authenticate using @azure/identity and get the Azure AI Services endpoint from the environment variables added by Service Connector. When using the code below, uncomment the part of the code snippet for the authentication type you want to use.

   import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
   const { TextAnalyticsClient } = require("@azure/ai-text-analytics");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-assigned managed identity
   // const credential = new DefaultAzureCredential();
   
   // for user-assigned managed identity
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // for service principal
   // const tenantId = process.env.AZURE_AISERVICES_TENANTID;
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const clientSecret = process.env.AZURE_AISERVICES_CLIENTSECRET;
   // const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   const endpoint = process.env.AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT;
   const languageClient = new TextAnalyticsClient(endpoint, credential);

Other

For other languages, you can use the connection information that Service Connector sets to the environment variables to connect to Azure AI Services. For environment variable details, see Integrate Azure AI services with Service Connector.