Dela via


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

Den här sidan innehåller information om autentiseringsmetoder och klienter som stöds, tillsammans med exempelkod för att ansluta en Azure AI-resurs med flera tjänster till andra molntjä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

Tabellen nedan visar 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 anslutningsinformationen nedan för att ansluta beräkningstjänster till en Azure AI-resurs med flera tjänster. Mer information om namngivningskonventioner finns i artikeln Interna serviceanslutningsprogram .

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

Exempelkod

Se stegen och koden nedan för att ansluta till en Azure AI-resurs med flera tjänster med hjälp av en systemtilldelad hanterad identitet.

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. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

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

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

Se stegen och koden nedan för att ansluta till en Azure AI-resurs med flera tjänster med hjälp av en användartilldelad hanterad identitet.

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. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

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

Connection string

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

Se stegen och koden nedan för att ansluta till en Azure AI-resurs med flera tjänster med hjälp av en anslutningssträng.

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. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

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

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

Se stegen och koden nedan för att ansluta till en Azure AI-resurs med flera tjänster med hjälp av en tjänst principaL.

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. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

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