Connectez-vous à Azure Synapse Analytics avec l’authentification Microsoft Entra

Cet article vous montre comment utiliser l’authentification Microsoft Entra pour vous connecter à Azure Synapse Analytics.

Prerequisites

Pour vous connecter, vous devez configurer l’authentification Microsoft Entra pour votre ressource Azure Synapse.

Pour confirmer que l’administrateur Microsoft Entra est correctement configuré, connectez-vous à la master base de données en utilisant le compte administrateur Microsoft Entra.

Pour créer un utilisateur de base de données contenue basé sur Microsoft Entra, connectez-vous à la base de données en utilisant une identité Microsoft Entra avec accès à la base de données et au moins la ALTER ANY USER permission.

Se connecter avec SSMS ou SSDT

Les procédures suivantes vous montrent comment vous connecter à Synapse SQL avec une identité Microsoft Entra en utilisant SQL Server Management Studio (SSMS) ou SQL Server Database Tools (SSDT).

Microsoft Entra intégré

Utilisez cette méthode lorsque vous souhaitez vous connecter en utilisant vos identifiants Windows qui sont fédérés dans Microsoft Entra ID. Pour plus d’informations, consultez la Authentification unique transparente de Microsoft Entra.

1. Démarrez SSMS ou SSDT et dans l'onglet Connexion de la boîte de dialogue Connexion au serveur (ou Connexion au moteur de base de données) :

   1. Saisissez le nom du serveur entièrement qualifié pour votre endpoint SQL. Pour les formats de point de terminaison, voir Connect to Synapse SQL.
   2. Pour l'authentification, sélectionnez Microsoft Entra Integrated. Vous n’avez pas besoin de saisir de mot de passe car vos identifiants existants sont utilisés pour la connexion.
   3. Pour le chiffrement, sélectionnez Strict.

2. Sous l’onglet Propriétés de connexion, dans le champ Se connecter à la base de données , tapez le nom de la base de données utilisateur à laquelle vous souhaitez vous connecter.

Mot de passe Microsoft Entra

Utilisez cette méthode pour vous connecter avec un nom de principal Microsoft Entra en utilisant le domaine géré Microsoft Entra. Vous pouvez aussi l’utiliser pour des comptes fédérés sans accès au domaine lorsque vous travaillez à distance, par exemple.

Utilisez cette méthode pour vous authentifier à Synapse SQL avec des utilisateurs avec une identité cloud Microsoft Entra uniquement ou des utilisateurs ayant des identités hybrides Microsoft Entra. Cette méthode prend en charge les utilisateurs souhaitant utiliser leurs informations d’identification Windows lorsque leur machine locale n’est pas rattachée au domaine, par exemple en utilisant un accès à distance.

1. Démarrez SSMS ou SSDT et dans l'onglet Connexion de la boîte de dialogue Connexion au serveur (ou Connexion au moteur de base de données) :

   1. Saisissez le nom du serveur entièrement qualifié pour votre endpoint SQL. Pour les formats de point de terminaison, voir Se connecter à Synapse SQL.
   2. Pour l'authentification, sélectionnez Microsoft Entra Password.
   3. Dans la zone Nom d’utilisateur, tapez votre nom d’utilisateur Microsoft Entra au format username@domain.com. Les noms d’utilisateur doivent être un compte issu de Microsoft Entra ID ou d’un compte provenant d’un domaine géré ou fédéré avec Microsoft Entra ID.
   4. Dans la zone Mot de passe, tapez votre mot de passe utilisateur pour le compte Microsoft Entra ou le compte de domaine managé/fédéré.
   5. Pour le chiffrement, sélectionnez Strict.

2. Sous l’onglet Propriétés de connexion, dans le champ Se connecter à la base de données , tapez le nom de la base de données utilisateur à laquelle vous souhaitez vous connecter.

Microsoft Entra MFA

Utilisez cette méthode pour une authentification interactive avec authentification multifacteur (MFA), le mot de passe étant demandé de manière interactive. Cette méthode peut être utilisée pour s’authentifier auprès de Synapse SQL pour les utilisateurs avec une identité Microsoft Entra cloud uniquement ou ceux qui possèdent des identités hybrides Microsoft Entra.

Les étapes suivantes montrent comment se connecter en utilisant l’authentification multifacteur dans la dernière version de SSMS.

1. Pour se connecter en utilisant MFA, dans la boîte de dialogue Connect to Server dans SSMS, sélectionnez Microsoft Entra MFA.

2. Renseignez la zone Nom du serveur avec le nom de votre serveur. Remplissez le champ Nom d’utilisateur avec vos identifiants Microsoft Entra, au format user_name@domain.com.

3. Sélectionnez Se connecter.

4. Lorsque la boîte de dialogue Connexion à votre compte apparaît, elle est préremplie avec le nom d’utilisateur que vous avez fourni à l’étape 2. Aucun mot de passe n’est requis si un utilisateur fait partie d’un domaine fédéré avec Microsoft Entra ID.

5. Vous serez invité à vous authentifier à l’aide de l’une des méthodes configurées en fonction des paramètres définis par l'administrateur pour l'authentification multifacteur.

6. Lorsque la vérification est terminée, SSMS se connecte normalement à condition que les informations d’identification soient valides et qu’un accès au pare-feu soit possible.

Principal de service Microsoft Entra

Utilisez cette méthode pour vous authentifier à Synapse SQL avec les principaux de service Microsoft Entra.

Microsoft Entra - Identité managée

Utilisez cette méthode pour vous authentifier à Synapse SQL avec des identités gérées par Microsoft Entra. Pour plus d’informations, voir Identités managées dans Microsoft Entra pour Azure Synapse Analytics.

Microsoft Entra par défaut

L’option d’authentification par défaut avec Microsoft Entra ID permet l’authentification via des mécanismes sans mot de passe et non interactifs, y compris des identités gérées.

Connexion à partir d'applications clientes

Les procédures suivantes vous montrent comment vous connecter à Synapse SQL avec une identité Microsoft Entra depuis une application client. Cette liste n’inclut pas toutes les méthodes d’authentification. Pour plus d’informations, voir authentification Microsoft Entra et SqlClient.

Configurer vos applications clientes

Sur tous les ordinateurs clients depuis lesquels vos applications ou utilisateurs se connectent à Azure Synapse Analytics en utilisant les identités Microsoft Entra, installez le logiciel suivant :

• .NET Framework 4.6 ou ultérieur.
• Bibliothèque d’authentification Microsoft (MSAL) ou bibliothèque d’authentification Microsoft pour SQL Server (ADAL.DLL). Les liens pour installer les derniers pilotes SSMS, ODBC et OLE DB qui contiennent la bibliothèque ADAL.DLL sont disponibles ici :
  • SQL Server Management Studio
  • ODBC Driver 17 for SQL Server
  • OLE DB Driver 18 for SQL Server

Vous pouvez répondre à ces exigences en procédant comme suit :

• L’installation de la dernière version de SQL Server Management Studio ou SQL Server Data Tools respecte la configuration requise de .NET Framework 4.6.
  • SSMS installe la version x86 de ADAL.DLL.
  • SSDT installe la version amd64 de ADAL.DLL.
  • La dernière version de Visual Studio dans les Téléchargements Visual Studio respecte la configuration requise de .NET Framework 4.6, mais n’installe pas la version amd64 nécessaire de ADAL.DLL.

Authentification intégrée Microsoft Entra

Pour utiliser l’authentification Windows intégrée, l’Active Directory de votre domaine doit être fédéré avec Microsoft Entra ID, ou être un domaine géré configuré pour une authentification unique transparente pour l’authentification directe ou par hachage de mot de passe. Pour plus d’informations, consultez la Authentification unique transparente de Microsoft Entra.

Pour se connecter à la base de données, une application (ou un service) doit s’exécuter sur une machine jointe au domaine sous les identifiants de domaine de l’utilisateur.

Pour se connecter à une base de données en utilisant une authentification intégrée et une identité Microsoft Entra, définissez le Authentication mot-clé dans la chaîne de connexion de la base de données à Active Directory Integrated. Remplacez <server_name> par le nom de votre serveur logique. L’exemple de code C# suivant utilise ADO .NET.

string ConnectionString = @"Data Source=<server-name>.database.windows.net; Authentication=Active Directory Integrated; Initial Catalog=testdb;";
SqlConnection conn = new SqlConnection(ConnectionString);
conn.Open();

Le mot-clé Integrated Security=True chaîne de connexion n'est pas pris en charge pour la connexion à Synapse SQL. Lors de la création d’une connexion ODBC, supprimez les espaces et réglez l’authentification sur ActiveDirectoryIntegrated.

Authentification par mot de passe Microsoft Entra

Pour une connexion à une base de données à l'aide de comptes d'utilisateur d'identité uniquement cloud Microsoft Entra, définissez le mot clé d'authentification sur Active Directory Password. La chaîne de connexion doit contenir les mots-clés et valeurs User ID/UID et Password/PWD. Remplacez <server_name>, <email_address> et <password> par les valeurs appropriées. L’exemple de code C# suivant utilise ADO .NET.

string ConnectionString =
@"Data Source=<server-name>.database.windows.net; Authentication=Active Directory Password; Initial Catalog=testdb; UID=<email_address>; PWD=<password>";
SqlConnection conn = new SqlConnection(ConnectionString);
conn.Open();

En savoir plus sur les méthodes d’authentification Microsoft Entra en utilisant les exemples de code de démonstration disponibles sur Microsoft Entra authentication GitHub Demo.

Jeton d’accès Microsoft Entra ID

Cette méthode d’authentification permet aux services intermédiaires d’obtenir des jetons web JSON (JWT) de Microsoft Entra ID pour se connecter à Synapse SQL en obtenant un jeton de Microsoft Entra ID. Cette méthode autorise divers scénarios d’application incluant des identités de service, des principaux de service et des applications utilisant une authentification basée sur des certificats. Vous devez effectuer quatre étapes de base pour utiliser l’authentification par jeton Microsoft Entra :

1. Inscrivez votre application auprès de Microsoft Entra ID et obtenez l’ID client de votre code.
2. Créez un utilisateur de base de données représentant l'application (comme décrit dans la section Créer des utilisateurs contenus mappés aux identités Microsoft Entra).
3. Créez un certificat sur l’ordinateur client qui exécute l’application.
4. Ajoutez le certificat en tant que clé pour votre application.

Exemple de chaîne de connexion. Remplacez <server-name> par le nom de votre serveur logique  :

string ConnectionString = @"Data Source=<server-name>.database.windows.net; Initial Catalog=testdb;";
SqlConnection conn = new SqlConnection(ConnectionString);
conn.AccessToken = "Your JWT token";
conn.Open();

Pour plus d’informations sur l’ajout de certificat, consultez Bien démarrer avec l’authentification par certificat dans Microsoft Entra ID.

Authentification multi-facteur Microsoft Entra

L’authentification multifacteur Microsoft Entra est une méthode d’authentification prise en charge pour tous les outils SQL. Pour plus d’informations sur l’authentification programmatique auprès de Microsoft Entra ID, consultez la vue d’ensemble de la bibliothèque d’authentification Microsoft (MSAL).

sqlcmd

Les commandes suivantes se connectent à l'aide de la version 13.1 de sqlcmd. Télécharger Utilitaires de ligne de commande Microsoft 14.0 pour SQL Server.

sqlcmd -S <database or datawarehouse name>.<server-name>.database.windows.net -G
sqlcmd -S <database or datawarehouse name>.<server-name>.database.windows.net -U adrian@contoso.com -P <password> -G -l 30

Contenu connexe

• Autoriser l’accès à la base de données pour Azure Synapse Analytics
• Principals
• Rôles de bases de données
• Règles de pare-feu Azure Synapse Analytics