Partager via


Intégrer Azure SQL Database avec Service Connector

Cette page présente les méthodes d’authentification et les clients pris en charge, et fournit des exemples de code que vous pouvez utiliser pour connecter des services de calcul à Azure SQL Database à l’aide d’un connecteur de services. Vous pouvez toujours vous connecter à Azure SQL Database à l’aide d’autres méthodes. Cette page indique également les noms et les valeurs des variables d'environnement par défaut que vous obtenez lorsque vous créez la connexion du service.

Service de calcul pris en charge

Le connecteur de services peut être utilisé pour connecter les services de calcul suivants à Azure SQL Database :

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

Types d’authentification et clients pris en charge

Le tableau ci-dessous montre les combinaisons méthodes d’authentification/clients prises en charge pour connecter votre service de calcul à Azure SQL Database à 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
Go Non Non Oui Non
Java Oui Oui Oui Oui
Java - Spring Boot Oui Oui Oui Oui
Node.js Oui Oui Oui Oui
PHP Non Non Oui Non
Python Oui Oui Oui Oui
Python - Django Non Non Oui Non
Ruby Non Non Oui Non
Aucun Oui Oui Oui Oui

Ce tableau indique que la méthode Secret/chaîne de connexion est prise en charge pour tous les types de clients. Les méthodes Identité managée affectée par le système, Identité managée affectée par l’utilisateur et Principal de service sont prises en charge pour les types de clients .NET, Java, Java - Spring Boot, Node.js, Python et None. Ces méthodes ne sont pas prises en charge pour les types de client Go, PHP, Django et Ruby.

Remarque

L’Identité managée affectée par le système, l’Identité managée affectée par l’utilisateur et le Principal de service sont uniquement pris en charge sur Azure CLI.

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

Utilisez les informations de connexion ci-dessous pour connecter des services de calcul à Azure SQL Database. Pour chaque exemple ci-dessous, remplacez les textes d’espace réservé <sql-server>, <sql-database>, <sql-username> et <sql-password> par le nom de votre propre serveur, le nom de la base de données, l’ID d’utilisateur et le mot de passe. Pour plus d’informations sur les conventions d’affectation de noms, consultez l’article Services internes du connecteur de services.

Identité managée affectée par le système

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_SQL_CONNECTIONSTRING Chaîne de connexion Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Authentication=ActiveDirectoryManagedIdentity

Exemple de code

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

  1. Installez des dépendances.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenez la chaîne de connexion Azure SQL Database à partir de la variable d’environnement ajoutée par le connecteur de services.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Pour plus d’informations, consultez Utilisation de l’authentification d’identité managée Active Directory.

Pour plus d’informations, consultez Page d’accueil pour la programmation client sur Microsoft SQL Server.

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

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_SQL_CONNECTIONSTRING Chaîne de connexion Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<identity-client-ID>;Authentication=ActiveDirectoryManagedIdentity

Exemple de code

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

  1. Installez des dépendances.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenez la chaîne de connexion Azure SQL Database à partir de la variable d’environnement ajoutée par le connecteur de services.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Pour plus d’informations, consultez Utilisation de l’authentification d’identité managée Active Directory.

Pour plus d’informations, consultez Page d’accueil pour la programmation client sur Microsoft SQL Server.

Chaîne de connexion

Avertissement

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d'authentification décrit dans cette procédure demande un degré de confiance très élevé dans l'application et comporte des risques qui ne sont pas présents dans d'autres flux. Vous ne devez utiliser ce flux que si d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_SQL_CONNECTIONSTRING Chaîne de connexion Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Password=<sql-password>

Exemple de code

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

  1. Installez des dépendances.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenez la chaîne de connexion Azure SQL Database à partir de la variable d’environnement ajoutée par le connecteur de services.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

Pour plus d’informations, consultez Page d’accueil pour la programmation client sur Microsoft SQL Server.

Principal du service

Nom de variable d’environnement par défaut Description Exemple de valeur
AZURE_SQL_CLIENTID Votre ID client <client-ID>
AZURE_SQL_CLIENTSECRET Votre clé secrète client <client-secret>
AZURE_SQL_TENANTID Votre ID d’abonné <tenant-ID>
AZURE_SQL_CONNECTIONSTRING Chaîne de connexion Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<client-Id>;Password=<client-secret>;Authentication=ActiveDirectoryServicePrincipal

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure SQL Database à l’aide d’un principal de service.

  1. Installez des dépendances.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenez la chaîne de connexion Azure SQL Database à partir de la variable d’environnement ajoutée par le connecteur de services.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Pour plus d’informations, consultez Utilisation de l’authentification d’identité managée Active Directory.

Pour plus d’informations, consultez Page d’accueil pour la programmation client sur Microsoft SQL Server.

Étapes suivantes

Suivez le tutoriel ci-dessous pour en savoir plus sur Service Connector.