Ansluta till en Azure AI-resurs med flera tjänster med Service Connector

2025-09-30

Den här sidan innehåller information om autentiseringsmetoder och klienter som stöds. Den innehåller exempelkod som du kan använda för att ansluta beräkningstjänster till Azure AI-resurs för flera tjänster med hjälp av Service Connector. På den här sidan visas även standardnamn och värden för miljövariabler som hämtas när du skapar tjänstanslutningen.

Beräkningstjänster som stöds

Service Connector kan användas för att ansluta följande beräkningstjänster till en Azure AI-resurs med flera tjänster:

Azure App Service
Azure Container Apps
Azure Functions
Azure Kubernetes Service (AKS)
Azure Spring Apps

Autentiseringstyper och klienttyper som stöds

Den här tabellen anger de autentiseringsmetoder och klienter som stöds för att ansluta beräkningstjänsten till en Azure AI-resurs med flera tjänster med hjälp av Service Connector. Ett "Ja" anger att kombinationen stöds, medan ett "Nej" anger att den inte stöds.

Klienttyp	Systemtilldelad hanterad identitet	Användartilldelad hanterad identitet	Hemlighet/anslutningssträng	Tjänstens huvudnamn
.NET	Ja	Ja	Ja	Ja
Java	Ja	Ja	Ja	Ja
Node.js	Ja	Ja	Ja	Ja
Python	Ja	Ja	Ja	Ja
None	Ja	Ja	Ja	Ja

Den här tabellen anger att alla kombinationer av klienttyper och autentiseringsmetoder i tabellen stöds. Alla klienttyper kan använda någon av autentiseringsmetoderna för att ansluta till en Azure AI-resurs med flera tjänster med hjälp av Service Connector.

Standardnamn för miljövariabler eller programegenskaper och exempelkod

Använd följande anslutningsinformation för att ansluta beräkningstjänster till en Azure AI-resurs med flera tjänster. Mer information finns i Namngivningskonvention för konfiguration.

Systemtilldelad hanterad identitet (rekommenderas)

Standardnamn för miljövariabel	beskrivning	Exempelvärde
AZURE_COGNITIVESERVICES_ENDPOINT	Azure Cognitive Services-tokenprovidertjänst	`https://<cognitive-service-name>.cognitiveservices.azure.com/`

Exempelkod

Om du vill ansluta till en Azure AI-resurs med flera tjänster med hjälp av en systemtilldelad hanterad identitet läser du följande steg och kod.

Du kan använda Azure-klientbiblioteket för att få åtkomst till olika kognitiva API:er som en Azure AI-resurs med flera tjänster stöder. Det här exemplet använder Azure AI Text Analytics som exempel. Information om hur du anropar de kognitiva API:erna direkt finns i Autentisera med Microsoft Entra-ID.

Installera följande beroenden. I det här exemplet används Azure.AI.TextAnalytics.
```
dotnet add package Azure.AI.TextAnalytics
dotnet add package Azure.Identity
```

Autentisera med hjälp av Azure Identity-biblioteket och hämta azure AI-resursslutpunkten för flera tjänster från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.

using Azure.AI.TextAnalytics;
using Azure.Identity;

string endpoint = Environment.GetEnvironmentVariable("AZURE_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_COGNITIVESERVICES_CLIENTID");
//     });

// service principal 
// var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

TextAnalyticsClient languageServiceClient = new(
  new Uri(endpoint),
  credential);

Lägg till följande beroenden i din pom.xml-fil . I det här exemplet användsazure-ai-textanalytics.

<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>

Autentisera med hjälp av azure-identity och hämta azure AI-resursslutpunkten för flera tjänster från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.

// 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_COGNITIVESERVICES_CLIENTID"))
//     .build();

// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
//   .clientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
//   .clientSecret(System.getenv("AZURE_COGNITIVESERVICES_CLIENTSECRET"))
//   .tenantId(System.getenv("AZURE_COGNITIVESERVICES_TENANTID"))
//   .build();

String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");

TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();

Installera följande beroenden. I det här exemplet används azure-ai-textanalytics.
```
pip install azure-ai-textanalytics==5.1.0
pip install azure-identity
```

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_COGNITIVESERVICES_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# service principal
# tenant_id = os.getenv('AZURE_COGNITIVESERVICES_TENANTID')
# client_id = os.getenv('AZURE_COGNITIVESERVICES_CLIENTID')
# client_secret = os.getenv('AZURE_COGNITIVESERVICES_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
endpoint = os.getenv('AZURE_COGNITIVESERVICES_ENDPOINT')

language_service_client = TextAnalyticsClient(
  endpoint=endpoint, 
  credential=cred)

Installera följande beroenden. I det här exemplet användsai-text-analytics.
```
npm install @azure/ai-text-analytics@5.1.0
npm install @azure/identity
```

Autentisera med hjälp av @azure/identity och hämta azure AI-resursslutpunkten för flera tjänster från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.

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_COGNITIVESERVICES_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// for service principal
// const tenantId = process.env.AZURE_COGNITIVESERVICES_TENANTID;
// const clientId = process.env.AZURE_COGNITIVESERVICES_CLIENTID;
// const clientSecret = process.env.AZURE_COGNITIVESERVICES_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

const endpoint = process.env.AZURE_COGNITIVESERVICES_ENDPOINT;
const languageClient = new TextAnalyticsClient(endpoint, credential);

Användartilldelad hanterad identitet

Standardnamn för miljövariabel	beskrivning	Exempelvärde
AZURE_COGNITIVESERVICES_ENDPOINT	Azure Cognitive Services-tokenprovidertjänst	`https://<cognitive-service-name>.cognitiveservices.azure.com/`
AZURE_COGNITIVESERVICES_CLIENTID	Ditt klient-ID	`<client-ID>`

Exempelkod

Om du vill ansluta till en Azure AI-resurs med flera tjänster med hjälp av en användartilldelad hanterad identitet läser du följande steg och kod.

Installera följande beroenden. I det här exemplet används Azure.AI.TextAnalytics.
```
dotnet add package Azure.AI.TextAnalytics
dotnet add package Azure.Identity
```

using Azure.AI.TextAnalytics;
using Azure.Identity;

string endpoint = Environment.GetEnvironmentVariable("AZURE_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_COGNITIVESERVICES_CLIENTID");
//     });

// service principal 
// var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

TextAnalyticsClient languageServiceClient = new(
  new Uri(endpoint),
  credential);

Lägg till följande beroenden i din pom.xml-fil . I det här exemplet användsazure-ai-textanalytics.

<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>

// 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_COGNITIVESERVICES_CLIENTID"))
//     .build();

// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
//   .clientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
//   .clientSecret(System.getenv("AZURE_COGNITIVESERVICES_CLIENTSECRET"))
//   .tenantId(System.getenv("AZURE_COGNITIVESERVICES_TENANTID"))
//   .build();

String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");

TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();

Installera följande beroenden. I det här exemplet används azure-ai-textanalytics.
```
pip install azure-ai-textanalytics==5.1.0
pip install azure-identity
```

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_COGNITIVESERVICES_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# service principal
# tenant_id = os.getenv('AZURE_COGNITIVESERVICES_TENANTID')
# client_id = os.getenv('AZURE_COGNITIVESERVICES_CLIENTID')
# client_secret = os.getenv('AZURE_COGNITIVESERVICES_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
endpoint = os.getenv('AZURE_COGNITIVESERVICES_ENDPOINT')

language_service_client = TextAnalyticsClient(
  endpoint=endpoint, 
  credential=cred)

Installera följande beroenden. I det här exemplet användsai-text-analytics.
```
npm install @azure/ai-text-analytics@5.1.0
npm install @azure/identity
```

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_COGNITIVESERVICES_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// for service principal
// const tenantId = process.env.AZURE_COGNITIVESERVICES_TENANTID;
// const clientId = process.env.AZURE_COGNITIVESERVICES_CLIENTID;
// const clientSecret = process.env.AZURE_COGNITIVESERVICES_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

const endpoint = process.env.AZURE_COGNITIVESERVICES_ENDPOINT;
const languageClient = new TextAnalyticsClient(endpoint, credential);

Anslutningssträng

Standardnamn för miljövariabel	beskrivning	Exempelvärde
AZURE_COGNITIVESERVICES_ENDPOINT	Azure Cognitive Services-tokenprovidertjänst	`https://<cognitive-service-name>.cognitiveservices.azure.com/`
AZURE_COGNITIVESERVICES_KEY	API-nyckeln för en Azure AI-resurs med flera tjänster	`<api-key>`

Exempelkod

Om du vill ansluta till en Azure AI-resurs med flera tjänster med hjälp av en anslutningssträng läser du följande steg och kod.

Installera följande beroenden. I det här exemplet används Azure.AI.TextAnalytics.

dotnet add package Azure.AI.TextAnalytics
dotnet add package Azure.Core --version 1.40.0

Hämta azure AI-resursslutpunkten och nyckeln för flera tjänster från miljövariablerna som lagts till av Service Connector.

using Azure.AI.TextAnalytics;

string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT")
string key = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_KEY");

TextAnalyticsClient languageServiceClient = new(
  new Uri(endpoint),
  new AzureKeyCredential(key));

Lägg till följande beroenden i din pom.xml-fil . I det här exemplet används azure-ai-textanalytics.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.49.1</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-textanalytics</artifactId>
    <version>5.1.12</version>
</dependency>

Hämta azure AI-resursslutpunkten och nyckeln för flera tjänster från miljövariablerna som lagts till av Service Connector.

String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");
String key = System.getenv("AZURE_COGNITIVESERVICES_KEY");
TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
    .credential(new AzureKeyCredential(key))
    .endpoint(endpoint)
    .buildClient();

Installera följande beroenden. I det här exemplet används azure-ai-textanalytics.
```
pip install azure-ai-textanalytics==5.1.0
pip install azure-core
```

Hämta azure AI-resursslutpunkten och nyckeln för flera tjänster från miljövariablerna som lagts till av Service Connector.

import os
from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

key = os.environ['AZURE_COGNITIVESERVICES_KEY']
endpoint = os.environ['AZURE_COGNITIVESERVICES_ENDPOINT']
language_service_client = TextAnalyticsClient(
  endpoint=retrieved_endpoint, 
  credential=AzureKeyCredential(key))

Installera följande beroende. I det här exemplet används ai-text-analytics.
```
npm install @azure/ai-text-analytics@5.1.0
```

Hämta azure AI-resursslutpunkten och nyckeln för flera tjänster från miljövariablerna som lagts till av Service Connector.

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");

const endpoint = process.env.AZURE_COGNITIVESERVICES_ENDPOINT;
const credential = new AzureKeyCredential(process.env.AZURE_COGNITIVESERVICES_KEY);

const languageClient = new TextAnalyticsClient(endpoint, credential);

Tjänstens huvudnamn

Standardnamn för miljövariabel	beskrivning	Exempelvärde
AZURE_COGNITIVESERVICES_ENDPOINT	Azure Cognitive Services-tokenprovidertjänst	`https://<cognitive-service-name>.cognitiveservices.azure.com/`
AZURE_COGNITIVESERVICES_CLIENTID	Ditt klient-ID	`<client-ID>`
AZURE_COGNITIVESERVICES_CLIENTSECRET	Din klienthemlighet	`<client-secret>`
AZURE_COGNITIVESERVICES_TENANTID	Ditt klientorganisations-ID	`<tenant-ID>`

Exempelkod

Om du vill ansluta till en Azure AI-resurs för flera tjänster med hjälp av en tjänstprincip, följ dessa steg och kodexempel.

Installera följande beroenden. I det här exemplet används Azure.AI.TextAnalytics.
```
dotnet add package Azure.AI.TextAnalytics
dotnet add package Azure.Identity
```

using Azure.AI.TextAnalytics;
using Azure.Identity;

string endpoint = Environment.GetEnvironmentVariable("AZURE_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_COGNITIVESERVICES_CLIENTID");
//     });

// service principal 
// var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

TextAnalyticsClient languageServiceClient = new(
  new Uri(endpoint),
  credential);

Lägg till följande beroenden i din pom.xml-fil . I det här exemplet användsazure-ai-textanalytics.

<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>

// 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_COGNITIVESERVICES_CLIENTID"))
//     .build();

// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
//   .clientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
//   .clientSecret(System.getenv("AZURE_COGNITIVESERVICES_CLIENTSECRET"))
//   .tenantId(System.getenv("AZURE_COGNITIVESERVICES_TENANTID"))
//   .build();

String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");

TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();

Installera följande beroenden. I det här exemplet används azure-ai-textanalytics.
```
pip install azure-ai-textanalytics==5.1.0
pip install azure-identity
```

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_COGNITIVESERVICES_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# service principal
# tenant_id = os.getenv('AZURE_COGNITIVESERVICES_TENANTID')
# client_id = os.getenv('AZURE_COGNITIVESERVICES_CLIENTID')
# client_secret = os.getenv('AZURE_COGNITIVESERVICES_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
endpoint = os.getenv('AZURE_COGNITIVESERVICES_ENDPOINT')

language_service_client = TextAnalyticsClient(
  endpoint=endpoint, 
  credential=cred)

Installera följande beroenden. I det här exemplet användsai-text-analytics.
```
npm install @azure/ai-text-analytics@5.1.0
npm install @azure/identity
```

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_COGNITIVESERVICES_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// for service principal
// const tenantId = process.env.AZURE_COGNITIVESERVICES_TENANTID;
// const clientId = process.env.AZURE_COGNITIVESERVICES_CLIENTID;
// const clientSecret = process.env.AZURE_COGNITIVESERVICES_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

const endpoint = process.env.AZURE_COGNITIVESERVICES_ENDPOINT;
const languageClient = new TextAnalyticsClient(endpoint, credential);

Feedback

Var den här sidan till hjälp?

Dela via

Ansluta till en Azure AI-resurs med flera tjänster med Service Connector

Beräkningstjänster som stöds

Autentiseringstyper och klienttyper som stöds

Standardnamn för miljövariabler eller programegenskaper och exempelkod

Systemtilldelad hanterad identitet (rekommenderas)

Exempelkod

Användartilldelad hanterad identitet

Exempelkod

Anslutningssträng

Exempelkod

Tjänstens huvudnamn

Exempelkod

Relaterat innehåll

Feedback

Ytterligare resurser