Connettiti ad Azure Synapse Analytics con l'autenticazione di Microsoft Entra

Questo articolo ti mostra come utilizzare l'autenticazione Microsoft Entra per connetterti ad Azure Synapse Analytics.

Note

Le entità server di Microsoft Entra sono attualmente in anteprima per Azure Synapse Analytics.

Prerequisites

Per connetterti, devi configurare l'autenticazione Microsoft Entra per la tua risorsa Azure Synapse.

Per confermare che l'amministratore di Microsoft Entra sia configurato correttamente, collegati al master database utilizzando l'account amministratore di Microsoft Entra.

Per creare un utente di database contenuto basato su Microsoft Entra, collegati al database utilizzando un'identità Microsoft Entra con accesso al database e almeno il ALTER ANY USER permesso.

Connettersi con SSMS o SSDT

Le seguenti procedure ti mostrano come connetterti a Synapse SQL con un'identità Microsoft Entra utilizzando SQL Server Management Studio (SSMS) o SQL Server Database Tools (SSDT).

Microsoft Entra Integrato

Usa questo metodo quando vuoi accedere usando le tue credenziali Windows che sono federate in Microsoft Entra ID. Per altre informazioni, vedere Single Sign-On facile di Microsoft Entra.

  1. Avviare SSMS o SSDT e nella scheda Accesso della finestra di dialogo Connetti al server (o Connetti a motore di database):

    1. Inserisci il nome del server completamente qualificato per il tuo endpoint SQL. Per i formati degli endpoint, vedi Connettersi a Synapse SQL.
    2. Come Autenticazione, selezionare Microsoft Entra Integrata. Non è necessario inserire una password perché le tue credenziali esistenti vengono usate per la connessione.
    3. Per Crittografia, seleziona Rigido.

  2. Nel campo Connetti al database della scheda Proprietà connessione digitare il nome del database utente a cui connettersi.

Microsoft Entra Password

Usa questo metodo quando ti connetti con un nome dell'entità di sicurezza Microsoft Entra utilizzando il dominio gestito Microsoft Entra. Puoi anche usarlo per account federati senza accesso al dominio quando, ad esempio, lavori da remoto.

Usa questo metodo per autenticarti a Synapse SQL con utenti con identità solo cloud di Microsoft Entra o utenti che possiedono identità ibride Microsoft Entra. Questo metodo supporta gli utenti che vogliono utilizzare la loro credenziale Windows quando la loro macchina locale non è collegata al dominio, ad esempio quando si utilizza l'accesso remoto.

  1. Avviare SSMS o SSDT e nella scheda Accesso della finestra di dialogo Connetti al server (o Connetti a motore di database):

    1. Inserisci il nome del server completamente qualificato per il tuo endpoint SQL. Per i formati degli endpoint, vedi Collega a Synapse SQL.
    2. Per l'Autenticazione, selezionare Microsoft Entra Password.
    3. Nella casella Nome utente, digitare il nome utente di Microsoft Entra nel formato username@domain.com. I nomi utente devono essere un account di Microsoft Entra ID o un account da un dominio gestito o federato con Microsoft Entra ID.
    4. Nella casella Password, digitare la password utente dell'account Microsoft Entra o dell'account di dominio gestito/federato.
    5. Per Crittografia, seleziona Rigido.

  2. Nel campo Connetti al database della scheda Proprietà connessione digitare il nome del database utente a cui connettersi.

Microsoft Entra MFA

Usa questo metodo per l'autenticazione interattiva con autenticazione multifattore (MFA), richiedendo la password in modo interattivo. Questo metodo può essere utilizzato per autenticarsi a Synapse SQL per utenti con identità solo cloud di Microsoft Entra o utenti che possiedono identità ibride Microsoft Entra.

I passaggi seguenti mostrano come connettersi utilizzando l'autenticazione multifattore nell'ultima versione di SSMS.

  1. Per connettersi tramite MFA, nella finestra di dialogo Collega al Server in SSMS seleziona Microsoft Entra MFA.

  2. Compilare la casella del Nome del server con il nome del server. Compilare la casella Nome utente con le credenziali di Microsoft Entra nel formato user_name@domain.com.

  3. Selezionare Connetti.

  4. Quando appare la finestra di dialogo Accedi al tuo account , viene precompilata con il nome utente che hai fornito nel passo 2. Se l’utente fa parte di un dominio federato con Microsoft Entra ID, non sarà necessario specificare la password.

  5. Verrà richiesto di eseguire l'autenticazione usando uno dei metodi configurati in base all'impostazione dell'amministratore dell’autenticazione a più fattori.

  6. Al termine della procedura di verifica, di norma SSMS stabilisce la connessione quando le credenziali sono valide e il firewall lo consente.

Principale del servizio Microsoft Entra

Usa questo metodo per autenticarti a Synapse SQL con le entità servizio di Microsoft Entra.

Identità gestita Microsoft Entra

Usa questo metodo per autenticarti su Synapse SQL con identità gestite da Microsoft Entra. Per maggiori informazioni, vedi Managed identities in Microsoft Entra for Azure Synapse Analytics.

Impostazione predefinita Microsoft Entra

L'opzione di autenticazione predefinita con Microsoft Entra ID consente l'autenticazione tramite meccanismi senza password e non interattivi, incluse le identità gestite.

Connettersi da un'applicazione client

Le seguenti procedure ti mostrano come connetterti a Synapse SQL con un'identità Microsoft Entra da un'applicazione client. Questa lista non include tutti i metodi di autenticazione. Per ulteriori informazioni, vedi Microsoft Entra authentication e SqlClient.

Configurare le applicazioni client

Note

System.Data.SqlClient usa Active Directory Authentication Library (ADAL) di Azure, che è deprecata. Se si usa lo spazio dei nomi System.Data.SqlClient per l'autenticazione di Microsoft Entra, eseguire la migrazione delle applicazioni a Microsoft.Data.SqlClient e Libreria di Autenticazione Microsoft (MSAL). Per comprendere i metodi di connessione disponibili in .NET, vedi Microsoft Entra authentication e SqlClient.

Se devi continuare a usare ADAL.DLL nelle tue applicazioni, usa i link in questa sezione per installare l'ultimo driver ODBC o OLE DB, che contengono la libreria ADAL.DLL più recente.

Su tutte le macchine client da cui le tue applicazioni o utenti si collegano ad Azure Synapse Analytics utilizzando le identità Microsoft Entra, installa il seguente software:

È possibile soddisfare questi requisiti tramite:

  • Installazione dell'ultima versione di SQL Server Management Studio o SQL Server Data Tools per soddisfare i requisiti di .NET Framework 4.6.
    • SSMS installa la versione x86 di ADAL.DLL.
    • SSDT installa la versione amd64 di ADAL.DLL.
    • L'ultima versione di Visual Studio disponibile nella pagina Download di Visual Studio soddisfa i requisiti di .NET Framework 4.6, ma non installa la versione amd64 di ADAL.DLL richiesta.

Autenticazione integrata di Microsoft Entra

Per utilizzare l'autenticazione di Windows integrata, l'Active Directory del tuo dominio deve essere federato con Microsoft Entra ID, oppure essere un dominio gestito configurato per un single sign-on continuo per l'autenticazione pass-through o tramite hash delle password. Per altre informazioni, vedere Single Sign-On facile di Microsoft Entra.

Per connettersi al database, un'applicazione (o un servizio) deve essere eseguita su un computer membro del dominio con le credenziali di dominio dell'utente.

Per connettersi a un database usando autenticazione integrata e un'identità Microsoft Entra, imposta la Authentication parola chiave nella stringa di connessione al database su Active Directory Integrated. Sostituire <server_name> con il nome del server logico. L'esempio di codice C# seguente usa 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();

La parola chiave Integrated Security=True stringa di connessione non è supportata per la connessione a Synapse SQL. Quando si effettua una connessione ODBC, rimuovere gli spazi e impostare l'autenticazione su ActiveDirectoryIntegrated.

Autenticazione con password di Microsoft Entra

Per connettersi a un database utilizzando account utente con identità cloud solo di Microsoft Entra, o utenti che utilizzano identità ibride Microsoft Entra, imposta la parola chiave Autenticazione su Active Directory Password. La stringa di connessione deve contenere parole chiave e valori id utente/UID password/PWD. Sostituire <server_name>, <email_address> e <password> con i valori appropriati. L'esempio di codice C# seguente usa 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();

Scopri di più sui metodi di autenticazione Microsoft Entra utilizzando gli esempi di codice dimostrativi disponibili su Microsoft Entra authentication GitHub Demo.

Token di accesso di Microsoft Entra ID

Questo metodo di autenticazione consente ai servizi di fascia media di ottenere JSON Web Token (JWT) da Microsoft Entra ID per connettersi a Synapse SQL ottenendo un token da Microsoft Entra ID. Questo metodo consente diversi scenari di applicazione tra cui identità del servizio, entità servizio e applicazioni che usano l'autenticazione basata su certificati. Per usare l'autenticazione tramite token di Microsoft Entra, è necessario completare quattro passaggi fondamentali:

  1. Registrare la propria applicazione in Microsoft Entra ID per ottenere l'ID client per il codice.
  2. Creare un utente di database che rappresenta l'applicazione, come descritto nella sezione Creare utenti indipendenti mappati alle identità di Microsoft Entra.
  3. Crea un certificato sul computer client che esegue l'applicazione.
  4. Aggiungere il certificato come chiave per l'applicazione.

Stringa di connessione di esempio. Sostituire <server-name> con il nome del server logico:

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

Per informazioni sull'aggiunta di un certificato, vedere Introduzione all'autenticazione basata su certificati di Microsoft Entra ID.

Autenticazione multifattoriale di Microsoft Entra

L'autenticazione a più fattori Microsoft Entra è un metodo di autenticazione supportato da tutti gli strumenti SQL. Per informazioni sull'autenticazione a livello di codice con Microsoft Entra ID, vedere le Informazioni generali su Libreria di Autenticazione Microsoft (MSAL).

sqlcmd

Le seguenti istruzioni consentono di connettersi utilizzando la versione 13.1 di sqlcmd. Download di Microsoft Command Line Utilities 14.0 per SQL Server.

Note

sqlcmd con il comando -G non funziona con le identità di sistema e richiede un accesso come entità utente.

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

Contenuti correlati

  • Ultimo aggiornamento: