Delen via


Verbinding maken met een Azure AI-resource met meerdere services met Service Connector

Deze pagina bevat informatie over ondersteunde verificatiemethoden en -clients, samen met voorbeeldcode voor het verbinden van een Azure AI-resource voor meerdere services met andere cloudservices met behulp van Service Connector. Op deze pagina worden ook de standaardnamen en waarden van omgevingsvariabelen vermeld die zijn verkregen bij het maken van de serviceverbinding.

Ondersteunde rekenservices

Serviceconnector kan worden gebruikt om de volgende rekenservices te verbinden met een Azure AI-resource voor meerdere services:

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

Ondersteunde verificatietypen en clienttypen

De onderstaande tabel geeft de verificatiemethoden en clients aan die worden ondersteund voor het verbinden van uw rekenservice met een Azure AI-resource voor meerdere services met behulp van serviceconnector. Een 'Ja' geeft aan dat de combinatie wordt ondersteund, terwijl een 'Nee' aangeeft dat deze niet wordt ondersteund.

Client-type Door het systeem toegewezen beheerde identiteit Door de gebruiker toegewezen beheerde identiteit Geheim/verbindingsreeks Service-principal
.NET Ja Ja Ja Ja
Java Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
Python Ja Ja Ja Ja
Geen Ja Ja Ja Ja

Deze tabel geeft aan dat alle combinaties van clienttypen en verificatiemethoden in de tabel worden ondersteund. Alle clienttypen kunnen elk van de verificatiemethoden gebruiken om verbinding te maken met een Azure AI-resource voor meerdere services met behulp van serviceconnector.

Namen van standaardomgevingsvariabelen of toepassingseigenschappen en voorbeeldcode

Gebruik de onderstaande verbindingsgegevens om rekenservices te verbinden met een Azure AI-resource voor meerdere services. Raadpleeg het artikel interne naamgeving van serviceconnector voor meer informatie over naamconventies .

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<cognitive-service-name>.cognitiveservices.azure.com/

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met een Azure AI-resource voor meerdere services met behulp van een door het systeem toegewezen beheerde identiteit.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door een Azure AI-resource met meerdere services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure AI-resource-eindpunt met meerdere services op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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

Door de gebruiker toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Uw client-id <client-ID>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met een Azure AI-resource voor meerdere services met behulp van een door de gebruiker toegewezen beheerde identiteit.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door een Azure AI-resource met meerdere services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure AI-resource-eindpunt met meerdere services op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

    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

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_KEY API-sleutel van een Azure AI-resource met meerdere services <api-key>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met een Azure AI-resource voor meerdere services met behulp van een verbindingsreeks.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door een Azure AI-resource met meerdere services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Haal het Azure AI-resource-eindpunt en de sleutel voor meerdere services op uit de omgevingsvariabelen die zijn toegevoegd door 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));
    

Service-principal

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Uw client-id <client-ID>
AZURE_COGNITIVESERVICES_CLIENTSECRET Uw clientgeheim <client-secret>
AZURE_COGNITIVESERVICES_TENANTID Uw tenant-id <tenant-ID>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met een Azure AI-resource voor meerdere services met behulp van een service-principaL.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door een Azure AI-resource met meerdere services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure AI-resource-eindpunt met meerdere services op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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