Anslut till Azure Synapse Analytics med Microsoft Entra-autentisering

Den här artikeln visar dig hur du använder Microsoft Entra-autentisering för att ansluta till Azure Synapse Analytics.

Prerequisites

För att ansluta måste du konfigurera Microsoft Entra-autentisering för din Azure Synapse-resurs.

För att bekräfta att Microsoft Entra-administratören är korrekt inställd, anslut till master-databasen med Microsoft Entra-administratörskontot.

För att skapa en Microsoft Entra-baserad innesluten databasanvändare, anslut till databasen genom att använda en Microsoft Entra-identitet med åtkomst till databasen och minst behörigheten ALTER ANY USER.

Ansluta med SSMS eller SSDT

Följande procedurer visar hur du ansluter till Synapse SQL med en Microsoft Entra-identitet genom att använda SQL Server Management Studio (SSMS) eller SQL Server Database Tools (SSDT).

Microsoft Entra Integrated

Använd denna metod när du vill logga in med dina Windows-uppgifter som är federerade i Microsoft Entra ID. Mer information finns i Sömlös enkel inloggning med Microsoft Entra.

1. Starta SSMS eller SSDT och i dialogrutan Anslut till server (eller Anslut till databasmotor) på fliken Inloggning:

   1. Ange det fullt kvalificerade servernamnet för din SQL-endpoint. För endpoint-format, se Anslut till Synapse SQL.
   2. För Autentisering väljer du Microsoft Entra Integrated. Du behöver inte ange ett lösenord eftersom dina befintliga inloggningsuppgifter används för anslutningen.
   3. För kryptering, välj Strikt.

2. På fliken Anslutningsegenskaper i fältet Anslut till databas skriver du namnet på den användardatabas som du vill ansluta till.

Microsoft Entra-lösenord

Använd denna metod när du ansluter med ett säkerhetsobjektnamn i Microsoft Entra genom att använda den hanterade Microsoft Entra-domänen. Du kan också använda det för federerade konton utan tillgång till domänen när du till exempel arbetar på distans.

Använd denna metod för att autentisera dig mot Synapse SQL för användare med endast Microsoft Entra-molnidentitet eller användare som har hybrida Microsoft Entra-identiteter. Denna metod stödjer användare som vill använda sin Windows-inloggning när deras lokala dator inte är ansluten till domänen, till exempel vid fjärråtkomst.

1. Starta SSMS eller SSDT och på fliken Inloggning i dialogrutan Anslut till server (eller Anslut till databasmotorn):

   1. Ange det fullt kvalificerade servernamnet för din SQL-endpoint. För endpoint-format, se Ansluta till Synapse SQL.
   2. För Autentisering väljer du Microsoft Entra-lösenord.
   3. I rutan Användarnamn skriver du ditt Microsoft Entra-användarnamn i formatet username@domain.com. Användarnamn måste vara ett konto från Microsoft Entra-ID eller ett konto från en hanterad eller federerad domän med Microsoft Entra-ID.
   4. I rutan Lösenord skriver du ditt användarlösenord för Microsoft Entra-kontot eller det hanterade/federerade domänkontot.
   5. För kryptering, välj Strikt.

2. På fliken Anslutningsegenskaper i fältet Anslut till databas skriver du namnet på den användardatabas som du vill ansluta till.

Microsoft Entra MFA (Multifaktorsautentisering)

Använd denna metod för interaktiv autentisering med multifaktorautentisering (MFA), där lösenordet efterfrågas interaktivt. Denna metod kan användas för att autentisera sig mot Synapse SQL för användare med endast molnidentitet i Microsoft Entra eller användare som har hybrida identiteter i Microsoft Entra.

Följande steg visar hur man ansluter genom att använda multifaktorautentisering i den senaste versionen av SSMS.

1. För att ansluta via MFA, välj Microsoft Entra MFA i dialogrutan Anslut till server i SSMS.

2. Fyll i rutan Servernamn med serverns namn. Fyll i rutan Användarnamn med dina Microsoft Entra-autentiseringsuppgifter i formatet user_name@domain.com.

3. Välj Anslut.

4. När dialogrutan Logga in på ditt konto dyker upp fylls den i förväg med användarnamnet du angav i steg 2. Inget lösenord krävs om en användare ingår i en domän federerad med Microsoft Entra-ID.

5. Du uppmanas att autentisera med någon av de metoder som konfigurerats baserat på inställningen MFA-administratör.

6. När verifieringen är klar ansluter SSMS normalt, vilket förutsätter giltiga autentiseringsuppgifter och brandväggsåtkomst.

Microsoft Entra-tjänstens huvudnamn

Använd denna metod för att autentisera dig mot Synapse SQL med Microsoft Entra tjänsteprinciper.

Microsoft Entra Managed Identity

Använd denna metod för att autentisera mot Synapse SQL med Microsoft Entra-hanterade identiteter. För mer information, se Managed identities i Microsoft Entra for Azure Synapse Analytics.

Standard för Microsoft Entra

Standardautentiseringsalternativet med Microsoft Entra ID möjliggör autentisering via lösenordslösa och icke-interaktiva mekanismer, inklusive hanterade identiteter.

Ansluta från ett klientprogram

Följande procedurer visar hur du ansluter till Synapse SQL med en Microsoft Entra-identitet från en klientapplikation. Denna lista inkluderar inte alla autentiseringsmetoder. För mer information, se Microsoft Entra-autentisering och SqlClient.

Konfigurera dina klientprogram

På alla klientmaskiner från vilka dina applikationer eller användare ansluter till Azure Synapse Analytics genom att använda Microsoft Entra-identiteter, installera följande programvara:

• .NET Framework 4.6 eller senare.
• Microsofts autentiseringsbibliotek (MSAL) eller Microsofts autentiseringsbibliotek för SQL Server (ADAL.DLL). Länkar för att installera den senaste SSMS-, ODBC- och OLE DB-drivrutinen som innehåller ADAL.DLL-biblioteket finns här:
  • SQL Server Management Studio
  • ODBC-drivrutin 17 för SQL Server
  • OLE DB-drivrutin 18 för SQL Server

Du kan uppfylla dessa krav genom att:

• Installera den senaste versionen av SQL Server Management Studio eller SQL Server Data Tools för att uppfylla kraven för .NET Framework 4.6.
  • SSMS installerar x86-versionen av ADAL.DLL.
  • SSDT installerar amd64-versionen av ADAL.DLL.
  • Den senaste Visual Studio från Visual Studio Downloads uppfyller kraven för .NET Framework 4.6 men installerar inte den nödvändiga amd64-versionen av ADAL.DLL.

Microsoft Entra-integrerad autentisering

För att använda integrerad Windows authentication måste din domäns služba Active Directory federeras med Microsoft Entra ID, eller vara en hanterad domän som är konfigurerad för sömlös single sign-on för pass-through- eller lösenordshash-autentisering. Mer information finns i Sömlös enkel inloggning med Microsoft Entra.

För att ansluta till databasen måste en applikation (eller en tjänst) köras på en domänansluten maskin med användarens domänuppgifter.

För att ansluta till en databas med integrerad autentisering och en Microsoft Entra-identitet, ställ in Authentication nyckelordet i databasens reťazec pripojenia till služba Active Directory Integrated. Ersätt <server_name> med namnet på den logiska servern. Följande C#-kodexempel använder 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();

Nyckelordet Integrated Security=True reťazec pripojenia stöds inte för att ansluta till Synapse SQL. När du gör en ODBC-anslutning, ta bort mellanslag och ställ in autentiseringen till ActiveDirectoryIntegrated.

Microsoft Entra-lösenordsautentisering

För att ansluta till en databas med användarkonton med endast molnbaserad Microsoft Entra-identitet eller med användare som använder hybrida Microsoft Entra-identiteter ställer du in autentiseringsnyckelordet på služba Active Directory Password. Anslutningssträngen måste innehålla nyckelord och värden för användar-ID/UID lösenord/PWD. Ersätt <server_name>, <email_address> och <password> med lämpliga värden. Följande C#-kodexempel använder 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();

Lär dig mer om Microsoft Entra-autentiseringsmetoder genom att använda demokodsexemplen som finns på Microsoft Entra authentication GitHub Demo.

Åtkomsttoken för Microsoft Entra-ID

Denna autentiseringsmetod gör det möjligt för mellannivåtjänster att erhålla JSON Web Tokens (JWT) från Microsoft Entra ID för att ansluta till Synapse SQL genom att hämta en token från Microsoft Entra ID. Den här metoden möjliggör olika programscenarier, inklusive tjänstidentiteter, tjänstens huvudnamn och program med hjälp av certifikatbaserad autentisering. Du måste utföra fyra grundläggande steg för att använda Microsoft Entra-tokenautentisering:

1. Registrera ditt program med Microsoft Entra-ID och hämta klient-ID:t för din kod.
2. Skapa en databasanvändare som representerar programmet (enligt beskrivningen i avsnittet Skapa inneslutna användare som mappas till Microsoft Entra-identiteter .)
3. Skapa ett certifikat på klientdatorn som kör applikationen.
4. Lägg till certifikatet som en nyckel för ditt program.

Exempel på anslutningssträng. Ersätt <server-name> med namnet på den logiska servern:

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

Information om hur du lägger till ett certifikat finns i Kom igång med certifikatbaserad autentisering i Microsoft Entra-ID.

Microsoft Entra multifaktorautentisering

Microsoft Entra multifaktorautentisering är en autentiseringsmetod som stöds för alla SQL-verktyg. Information om programmässig autentisering med Microsoft Entra-ID finns i Översikt över Microsofts autentiseringsbibliotek (MSAL).

sqlcmd

Följande satser ansluter genom att använda version 13.1 av sqlcmd. Ladda ned Microsoft Command Line Utilities 14.0 för 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

Relaterat innehåll

• Auktorisera databasåtkomst till Azure Synapse Analytics
• Principals
• Databasroller
• Azure Synapse Analytics brandväggsregler