Herstellen einer Verbindung mit Azure KI-Ressource für mehrere Dienste mit Dienstconnector
Artikel
Diese Seite enthält Informationen zu unterstützten Authentifizierungsmethoden und Clients sowie Beispielcode zum Verbinden einer Azure KI Multi-Service-Ressource mit anderen Clouddiensten mithilfe von Service Connector. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen aufgeführt, die beim Erstellen der Dienstverbindung abgerufen werden.
Unterstützte Computedienste
Service Connector kann verwendet werden, um die folgenden Computedienste mit einer Azure KI-Ressource für mehrere Dienste zu verbinden:
Azure App Service
Azure Container Apps
Azure-Funktionen
Azure Kubernetes Service (AKS)
Azure Spring Apps
Unterstützte Authentifizierungstypen und Clienttypen
Die folgende Tabelle zeigt die Authentifizierungsmethoden und Clients für die Verbindung Ihres Computediensts mit einer Azure KI-Ressource für mehrere Dienste mithilfe von Dienstconnector. Ein „Ja“ gibt an, dass die Kombination unterstützt wird, während ein „Nein“ angibt, dass sie nicht unterstützt wird.
Clienttyp
Systemseitig zugewiesene verwaltete Identität
Benutzerseitig zugewiesene verwaltete Identität
Geheimnis/Verbindungszeichenfolge
Dienstprinzipal
.NET
Ja
Ja
Ja
Ja
Java
Ja
Ja
Ja
Ja
Node.js
Ja
Ja
Ja
Ja
Python
Ja
Ja
Ja
Ja
Keine
Ja
Ja
Ja
Ja
In der Tabelle wird angegeben, dass alle Kombinationen von Clienttypen und Authentifizierungsmethoden in der Tabelle unterstützt werden. Alle Clienttypen können jede der Authentifizierungsmethoden verwenden, um mithilfe von Service Connector eine Verbindung mit einer Azure KI-Ressource für mehrere Dienste herzustellen.
Namen von Standard-Umgebungsvariablen oder Anwendungseigenschaften und Beispielcode
Verwenden Sie die nachstehenden Verbindungsdetails, um Computedienste mit einer Azure KI-Ressource für mehrere Dienste zu verbinden. Weitere Informationen zu Benennungskonventionen finden Sie im Artikel Besonderheiten des Dienstconnectors.
Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit einer Azure KI-Ressource für mehrere Dienste mithilfe einer systemseitig zugewiesenen verwalteten Identität herzustellen.
Sie können die Azure-Clientbibliothek verwenden, um auf verschiedene kognitive APIs zuzugreifen, die eine Azure KI-Ressource für mehrere Dienste unterstützen. Wir verwenden die Azure KI-Textanalyse als Beispiel in diesem Beispiel. Lesen Sie den Artikel Authentifizieren von Anforderungen an Azure KI Services, um die kognitiven APIs direkt aufzurufen.
Authentifizieren Sie sich mithilfe der Azure Identity-Bibliothek, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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);
Fügen Sie der Datei pom.xml die folgenden Abhängigkeiten hinzu. Wir verwenden azure-ai-textanalytics als Beispiel.
Authentifizieren Sie sich mithilfe von azure-identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
// 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();
Installieren Sie die folgenden Abhängigkeiten. Wir verwenden azure-ai-textanalytics als Beispiel.
Authentifizieren Sie sich mithilfe von azure-identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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)
Installieren Sie die folgenden Abhängigkeiten. Wir verwenden ai-text-analytics als Beispiel.
Authentifizieren Sie sich mithilfe von @azure/identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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);
Für andere Sprachen können Sie die Verbindungsinformationen verwenden, die Service Connector für die Umgebungsvariablen zur Verbindung mit einer Azure KI-Ressource für mehrere Dienste festlegt. Weitere Informationen zu Umgebungsvariablen finden Sie unter Integrieren einer Azure KI-Ressource für mehrere Dienste mit Service Connector.
Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit einer Azure KI-Ressource für mehrere Dienste mithilfe einer benutzerseitig zugewiesenen verwalteten Identität herzustellen.
Sie können die Azure-Clientbibliothek verwenden, um auf verschiedene kognitive APIs zuzugreifen, die eine Azure KI-Ressource für mehrere Dienste unterstützen. Wir verwenden die Azure KI-Textanalyse als Beispiel in diesem Beispiel. Lesen Sie den Artikel Authentifizieren von Anforderungen an Azure KI Services, um die kognitiven APIs direkt aufzurufen.
Authentifizieren Sie sich mithilfe der Azure Identity-Bibliothek, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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);
Fügen Sie der Datei pom.xml die folgenden Abhängigkeiten hinzu. Wir verwenden azure-ai-textanalytics als Beispiel.
Authentifizieren Sie sich mithilfe von azure-identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
// 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();
Installieren Sie die folgenden Abhängigkeiten. Wir verwenden azure-ai-textanalytics als Beispiel.
Authentifizieren Sie sich mithilfe von azure-identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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)
Installieren Sie die folgenden Abhängigkeiten. Wir verwenden ai-text-analytics als Beispiel.
Authentifizieren Sie sich mithilfe von @azure/identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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);
Für andere Sprachen können Sie die Verbindungsinformationen verwenden, die Service Connector für die Umgebungsvariablen zur Verbindung mit einer Azure KI-Ressource für mehrere Dienste festlegt. Weitere Informationen zu Umgebungsvariablen finden Sie unter Integrieren einer Azure KI-Ressource für mehrere Dienste mit Service Connector.
API-Schlüssel einer Azure KI-Ressource für mehrere Dienste
<api-key>
Beispielcode
Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit einer Azure KI-Ressource für mehrere Dienste mithilfe einer Verbindungszeichenfolge herzustellen.
Sie können die Azure-Clientbibliothek verwenden, um auf verschiedene kognitive APIs zuzugreifen, die eine Azure KI-Ressource für mehrere Dienste unterstützen. Wir verwenden die Azure KI-Textanalyse als Beispiel in diesem Beispiel. Lesen Sie den Artikel Authentifizieren von Anforderungen an Azure KI Services, um die kognitiven APIs direkt aufzurufen.
Für andere Sprachen können Sie die Verbindungsinformationen verwenden, die Service Connector für die Umgebungsvariablen zur Verbindung mit einer Azure KI-Ressource für mehrere Dienste festlegt. Weitere Informationen zu Umgebungsvariablen finden Sie unter Integrieren einer Azure KI-Ressource für mehrere Dienste mit Service Connector.
Lesen Sie die Schritte und den folgenden Code, um eine Verbindung mit einer Azure KI-Ressource für mehrere Dienste mithilfe eines Dienstprinzipals herzustellen.
Sie können die Azure-Clientbibliothek verwenden, um auf verschiedene kognitive APIs zuzugreifen, die eine Azure KI-Ressource für mehrere Dienste unterstützen. Wir verwenden die Azure KI-Textanalyse als Beispiel in diesem Beispiel. Lesen Sie den Artikel Authentifizieren von Anforderungen an Azure KI Services, um die kognitiven APIs direkt aufzurufen.
Authentifizieren Sie sich mithilfe der Azure Identity-Bibliothek, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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);
Fügen Sie der Datei pom.xml die folgenden Abhängigkeiten hinzu. Wir verwenden azure-ai-textanalytics als Beispiel.
Authentifizieren Sie sich mithilfe von azure-identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
// 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();
Installieren Sie die folgenden Abhängigkeiten. Wir verwenden azure-ai-textanalytics als Beispiel.
Authentifizieren Sie sich mithilfe von azure-identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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)
Installieren Sie die folgenden Abhängigkeiten. Wir verwenden ai-text-analytics als Beispiel.
Authentifizieren Sie sich mithilfe von @azure/identity, und rufen Sie den Endpunkt der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.
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);
Für andere Sprachen können Sie die Verbindungsinformationen verwenden, die Service Connector für die Umgebungsvariablen zur Verbindung mit einer Azure KI-Ressource für mehrere Dienste festlegt. Weitere Informationen zu Umgebungsvariablen finden Sie unter Integrieren einer Azure KI-Ressource für mehrere Dienste mit Service Connector.