Partager via


Se connecter à une ressource multiservice Azure AI avec le connecteur de service

Cette page présente les méthodes d’authentification et les clients pris en charge, ainsi que des exemples de code permettant de connecter une ressource multiservice Azure AI à d’autres services cloud en utilisant le connecteur de services. Cette page liste également les noms et les valeurs des variables d’environnement par défaut obtenues lors de la création de la connexion du service.

Service de calcul pris en charge

Le connecteur de service peut être utilisé pour connecter les services de calcul suivants à une ressource multiservices d’Azure AI :

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

Types d’authentification et de clients pris en charge

Le tableau ci-dessous indique les méthodes d’authentification et les clients pris en charge pour connecter votre service de calcul à une ressource multiservice Azure AI à l’aide du connecteur de services. « Oui » indique que la combinaison est prise en charge, tandis que « Non » indique qu’elle n’est pas prise en charge.

Type de client Identité managée affectée par le système Identité managée affectée par l’utilisateur Secret/chaîne de connexion Principal du service
.NET Oui Oui Oui Oui
Java Oui Oui Oui Oui
Node.js Oui Oui Oui Oui
Python Oui Oui Oui Oui
Aucun Oui Oui Oui Oui

Ce tableau indique que toutes les combinaisons de types client et de méthodes d’authentification dans la table sont prises en charge. Tous les types de client peuvent utiliser l’une des méthodes d’authentification pour se connecter à la ressource multiservices d’Azure AI à l’aide du connecteur de services.

Noms des variables d’environnement par défaut ou propriétés de l’application et exemple de code

Utilisez les détails de connexion ci-dessous pour connecter des services de calcul à une ressource multiservices d’Azure AI. Pour plus d’informations sur les conventions d’affectation de noms, consultez l’article Éléments internes du connecteur de services.

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_COGNITIVESERVICES_ENDPOINT Service de fournisseur de jetons Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à la ressource multiservices d’Azure AI à l’aide d’une identité managée affectée par le système.

Vous pouvez utiliser la bibliothèque cliente Azure pour accéder à différentes API cognitives qu’une ressource multiservices d’Azure AI prend en charge. Nous utilisons l’Analyse de texte d’Azure AI comme exemple dans cet exemple. Reportez-vous aux demandes d’authentification auprès des services Azure AI pour appeler directement les API cognitives.

  1. Installez les dépendances suivantes. Nous allons utiliser Azure.AI.TextAnalytics dans cet exemple.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Authentifiez-vous à l’aide de la bibliothèque d’identités Azure et obtenez le point de terminaison de la ressource de multiservices d’Azure AI à partir des variables d’environnement ajoutées par le Connecteur de services. Lorsque vous utilisez le code ci-dessous, supprimez les marques de commentaire de la partie de l’extrait de code pour le type d’authentification que vous souhaitez utiliser.

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

Identité managée affectée par l’utilisateur

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_COGNITIVESERVICES_ENDPOINT Service de fournisseur de jetons Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Votre ID client <client-ID>

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure AI Service à l’aide d’une identité managée affectée par l’utilisateur.

Vous pouvez utiliser la bibliothèque cliente Azure pour accéder à différentes API cognitives qu’une ressource multiservices d’Azure AI prend en charge. Nous utilisons l’Analyse de texte d’Azure AI comme exemple dans cet exemple. Reportez-vous aux demandes d’authentification auprès des services Azure AI pour appeler directement les API cognitives.

  1. Installez les dépendances suivantes. Nous allons utiliser Azure.AI.TextAnalytics dans cet exemple.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Authentifiez-vous à l’aide de la bibliothèque d’identités Azure et obtenez le point de terminaison de la ressource de multiservices d’Azure AI à partir des variables d’environnement ajoutées par le Connecteur de services. Lorsque vous utilisez le code ci-dessous, supprimez les marques de commentaire de la partie de l’extrait de code pour le type d’authentification que vous souhaitez utiliser.

    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

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_COGNITIVESERVICES_ENDPOINT Service de fournisseur de jetons Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_KEY Clé API d’une ressource multiservices d’Azure AI <api-key>

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à une ressource multiservices d’Azure AI à l’aide d’une chaîne de connexion.

Vous pouvez utiliser la bibliothèque cliente Azure pour accéder à différentes API cognitives qu’une ressource multiservices d’Azure AI prend en charge. Nous utilisons l’Analyse de texte d’Azure AI comme exemple dans cet exemple. Reportez-vous aux demandes d’authentification auprès des services Azure AI pour appeler directement les API cognitives.

  1. Installez les dépendances suivantes. Nous allons utiliser Azure.AI.TextAnalytics dans cet exemple.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Obtenez le point de terminaison de ressource multiservices d’Azure AI et la clé à partir des variables d’environnement ajoutées par le connecteur de services.

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

Principal du service

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_COGNITIVESERVICES_ENDPOINT Service de fournisseur de jetons Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Votre ID client <client-ID>
AZURE_COGNITIVESERVICES_CLIENTSECRET Votre clé secrète client <client-secret>
AZURE_COGNITIVESERVICES_TENANTID Votre ID d’abonné <tenant-ID>

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à une ressource multiservices d’Azure AI à l’aide d’un principal de service

Vous pouvez utiliser la bibliothèque cliente Azure pour accéder à différentes API cognitives qu’une ressource multiservices d’Azure AI prend en charge. Nous utilisons l’Analyse de texte d’Azure AI comme exemple dans cet exemple. Reportez-vous aux demandes d’authentification auprès des services Azure AI pour appeler directement les API cognitives.

  1. Installez les dépendances suivantes. Nous allons utiliser Azure.AI.TextAnalytics dans cet exemple.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Authentifiez-vous à l’aide de la bibliothèque d’identités Azure et obtenez le point de terminaison de la ressource de multiservices d’Azure AI à partir des variables d’environnement ajoutées par le Connecteur de services. Lorsque vous utilisez le code ci-dessous, supprimez les marques de commentaire de la partie de l’extrait de code pour le type d’authentification que vous souhaitez utiliser.

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