Freigeben über


Herstellen einer Verbindung mit Azure KI-Ressource für mehrere Dienste mit Dienstconnector

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.

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-Tokenanbieterdienst https://<cognitive-service-name>.cognitiveservices.azure.com/

Beispielcode

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.

  1. Installieren Sie die folgenden Abhängigkeiten. Wir verwenden Azure.AI.TextAnalytics als Beispiel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. 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);
    

Benutzerseitig zugewiesene verwaltete Identität

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-Tokenanbieterdienst https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Ihre Client-ID <client-ID>

Beispielcode

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.

  1. Installieren Sie die folgenden Abhängigkeiten. Wir verwenden Azure.AI.TextAnalytics als Beispiel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. 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);
    

Connection string

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-Tokenanbieterdienst https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_KEY 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.

  1. Installieren Sie die folgenden Abhängigkeiten. Wir verwenden Azure.AI.TextAnalytics als Beispiel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Rufen Sie den Endpunkt und den Schlüssel der Azure KI-Ressource für mehrere Dienste aus den von Service Connector hinzugefügten Umgebungsvariablen ab.

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

Dienstprinzipal

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-Tokenanbieterdienst https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Ihre Client-ID <client-ID>
AZURE_COGNITIVESERVICES_CLIENTSECRET Ihr geheimer Clientschlüssel <client-secret>
AZURE_COGNITIVESERVICES_TENANTID Ihre Mandanten-ID <tenant-ID>

Beispielcode

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.

  1. Installieren Sie die folgenden Abhängigkeiten. Wir verwenden Azure.AI.TextAnalytics als Beispiel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. 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);