Verbinding maken met Azure Synapse Analytics met Microsoft Entra-verificatie

Dit artikel laat zien hoe je Microsoft Entra-authenticatie gebruikt om verbinding te maken met Azure Synapse Analytics.

Note

Microsoft Entra Server Principals zijn momenteel in preview voor Azure Synapse Analytics.

Prerequisites

Om verbinding te maken, moet je Microsoft Entra-authenticatie configureren voor je Azure Synapse-resource.

Om te bevestigen dat de Microsoft Entra-beheerder correct is ingesteld, verbind je met de master database via het Microsoft Entra-beheerdersaccount.

Om een op Microsoft Entra gebaseerde ingesloten databasegebruiker te maken, verbind je met de database via een Microsoft Entra-identiteit met toegang tot de database en ten minste de machtiging ALTER ANY USER.

Verbinding maken met SSMS of SSDT

De volgende procedures laten zien hoe je verbinding maakt met Synapse SQL met een Microsoft Entra-identiteit door gebruik te maken van SQL Server Management Studio (SSMS) of SQL Server Database Tools (SSDT).

Microsoft Entra geïntegreerd

Gebruik deze methode wanneer je wilt inloggen met je Windows-inloggegevens die zijn gefedereerd in Microsoft Entra ID. Zie Naadloze eenmalige aanmelding van Microsoft Entra voor meer informatie.

  1. Start SSMS of SSDT en klik op het tabblad Aanmelden van het dialoogvenster Verbinding maken met server (of verbinding maken met database-engine):

    1. Voer de volledig gekwalificeerde servernaam in voor je SQL-endpoint. Voor eindpuntformaten, zie Verbinding maken met Synapse SQL.
    2. Voor verificatie selecteert u Microsoft Entra Integrated. Je hoeft geen wachtwoord in te voeren omdat je bestaande inloggegevens voor de verbinding worden gebruikt.
    3. Voor Versleuteling selecteer Strict.

  2. Typ op het tabblad Verbindingseigenschappen in het veld Verbinding maken met database de naam van de gebruikersdatabase waarmee u verbinding wilt maken.

Wachtwoord voor Microsoft Entra

Gebruik deze methode bij het verbinden met een Microsoft Entra principal name via het Microsoft Entra beheerde domein. Je kunt het ook gebruiken voor gefedereerde accounts zonder toegang tot het domein, bijvoorbeeld als je op afstand werkt.

Gebruik deze methode om u bij Synapse SQL te verifiëren met Microsoft Entra-cloud-only-gebruikersaccounts of gebruikersaccounts met Microsoft Entra-hybride identiteiten. Deze methode ondersteunt gebruikers die hun Windows-inloggegevens willen gebruiken wanneer hun lokale machine niet aan het domein is gekoppeld, bijvoorbeeld bij externe toegang.

  1. Start SSMS of SSDT en klik op het tabblad Aanmelden van het dialoogvenster Verbinding maken met server (of verbinding maken met database-engine):

    1. Voer de volledig gekwalificeerde servernaam in voor je SQL-endpoint. Voor eindpuntformaten, zie Verbinding maken met Synapse SQL.
    2. Voor verificatie selecteert u Microsoft Entra-wachtwoord.
    3. Typ uw Microsoft Entra-gebruikersnaam in het vak Gebruikersnaam in de notatie username@domain.com. Gebruikersnamen moeten een account zijn van Microsoft Entra ID of een account uit een beheerd of federatief domein met Microsoft Entra-id.
    4. Typ in het vak Wachtwoord uw gebruikerswachtwoord voor het Microsoft Entra-account of het beheerde/federatieve domeinaccount.
    5. Voor Versleuteling, selecteer Strict.

  2. Typ op het tabblad Verbindingseigenschappen in het veld Verbinding maken met database de naam van de gebruikersdatabase waarmee u verbinding wilt maken.

Microsoft Entra MFA

Gebruik deze methode voor interactieve authenticatie met multifactorauthenticatie (MFA), waarbij het wachtwoord interactief wordt opgevraagd. Deze methode kan worden gebruikt om te authenticeren naar Synapse SQL voor Microsoft Entra cloud-only identiteitsgebruikers of gebruikers met Microsoft Entra hybride identiteiten.

De volgende stappen tonen hoe je verbinding kunt maken met multifactorauthenticatie in de nieuwste versie van SSMS.

  1. Om verbinding te maken met MFA, selecteer je in het dialoogvenster Verbinden met Server in SSMS Microsoft Entra MFA.

  2. Vul het vak Servernaam in met de naam van uw server. Vul het vak Gebruikersnaam in met uw Microsoft Entra-referenties, in de indeling user_name@domain.com.

  3. Selecteer Maak verbinding met.

  4. Wanneer het venster 'Inloggen op je account ' verschijnt, wordt het vooraf ingevuld met de gebruikersnaam die je in stap 2 hebt opgegeven. Er is geen wachtwoord vereist als een gebruiker deel uitmaakt van een domein dat is gefedereerd met Microsoft Entra-id.

  5. U wordt gevraagd om te verifiëren met behulp van een van de methoden die zijn geconfigureerd op basis van de MFA-beheerdersinstelling.

  6. Wanneer de verificatie is voltooid, maakt SSMS normaal verbinding, vooropgesteld dat geldige inloggegevens en firewalltoegang aanwezig zijn.

Microsoft Entra-service-principal

Gebruik deze methode om je te authenticeren bij Synapse SQL met Microsoft Entra service principals.

beheerde identiteit Microsoft Entra

Gebruik deze methode om te authenticeren bij Synapse SQL met Microsoft Entra beheerde identiteiten. Voor meer informatie, zie Managed Identities in Microsoft Entra for Azure Synapse Analytics.

Microsoft Entra Default

De standaardauthenticatieoptie met Microsoft Entra ID maakt authenticatie mogelijk via wachtwoordloze en niet-interactieve mechanismen, waaronder beheerde identiteiten.

Verbinding maken vanuit een clienttoepassing

De volgende procedures laten zien hoe je verbinding maakt met Synapse SQL met een Microsoft Entra-identiteit vanuit een clientapplicatie. Deze lijst bevat niet alle authenticatiemethoden. Voor meer informatie, zie Microsoft Entra-authenticatie en SqlClient.

Uw clienttoepassingen configureren

Note

System.Data.SqlClient maakt gebruik van de Azure Active Directory Authentication Library (ADAL), die is afgeschaft. Als u de naamruimte System.Data.SqlClient voor Microsoft Entra-verificatie gebruikt, migreert u toepassingen naar Microsoft.Data.SqlClient en de Microsoft Authentication Library (MSAL). Om de verbindingsmethoden in .NET te begrijpen, zie Microsoft Entra-authenticatie en SqlClient.

Als je ADAL.DLL in je applicaties moet blijven gebruiken, gebruik dan de links in deze sectie om de nieuwste ODBC- of OLE DB-driver te installeren, die de nieuwste ADAL.DLL-bibliotheek bevat.

Op alle clientmachines waarmee je toepassingen of gebruikers verbinding maken met Azure Synapse Analytics via Microsoft Entra-identiteiten, installeer je de volgende software:

U kunt aan deze vereisten voldoen door:

Geïntegreerde Microsoft Entra-verificatie

Om geïntegreerde Windows authentication te gebruiken, moet de Active Directory van je domein gefedereerd zijn met Microsoft Entra ID, of een beheerd domein zijn dat is geconfigureerd voor naadloze single sign-on voor pass-through of wachtwoord-hashauthenticatie. Zie Naadloze eenmalige aanmelding van Microsoft Entra voor meer informatie.

Om verbinding te maken met de database moet een applicatie (of een dienst) draaien op een domein-gekoppelde machine onder de domeinreferenties van een gebruiker.

Om verbinding te maken met een database met geïntegreerde authenticatie en een Microsoft Entra-identiteit, zet u het Authentication trefwoord in de database-verbindingsreeks op Active Directory Integrated. Vervang door <server_name> de naam van de logische server. In het volgende C#-codevoorbeeld wordt ADO .NET gebruikt.

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

Het verbindingsreeks-sleutelwoord Integrated Security=True wordt niet ondersteund voor het verbinden met Synapse SQL. Bij het maken van een ODBC-verbinding verwijder je de ruimtes en stel je authenticatie in op ActiveDirectoryIntegrated.

Wachtwoordverificatie voor Microsoft Entra

Om verbinding te maken met een database met Microsoft Entra cloud-only identiteitsgebruikersaccounts, of gebruikers die Microsoft Entra hybride identiteiten gebruiken, zet je het Authenticatie-sleutelwoord op Active Directory Password. De verbindingsreeks moet trefwoorden en waarden voor gebruikers-id/UID wachtwoord/PWD bevatten. Vervang <server_name>, <email_address> en <password> door de toepasselijke waarden. In het volgende C#-codevoorbeeld wordt ADO .NET gebruikt.

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

Lees meer over Microsoft Entra-authenticatiemethoden door gebruik te maken van de democodevoorbeelden die beschikbaar zijn op Microsoft Entra authentication GitHub Demo.

Microsoft Entra ID-toegangstoken

Deze authenticatiemethode stelt services in de middelste laag in staat om JSON Web Tokens (JWT) van Microsoft Entra ID te verkrijgen om verbinding te maken met Synapse SQL door een token van Microsoft Entra ID te verkrijgen. Deze methode maakt verschillende toepassingsscenario's mogelijk, waaronder service-id's, service-principals en toepassingen met behulp van verificatie op basis van certificaten. U moet vier basisstappen uitvoeren voor het gebruik van Microsoft Entra-tokenverificatie:

  1. Registreer uw toepassing bij Microsoft Entra ID en haal de client-id voor uw code op.
  2. Maak een databasegebruiker die de toepassing vertegenwoordigt (zoals beschreven in de sectie Ingesloten gebruikers maken die zijn toegewezen aan de sectie Microsoft Entra-identiteiten ).)
  3. Maak een certificaat aan op de computer van de client waarop de applicatie draait.
  4. Voeg het certificaat toe als sleutel voor uw toepassing.

Voorbeeldverbindingsreeks. Vervang door <server-name> de naam van uw logische server:

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

Zie Aan de slag met verificatie op basis van certificaten in Microsoft Entra-id voor meer informatie over het toevoegen van een certificaat.

Microsoft Entra meervoudige verificatie

Meervoudige verificatie van Microsoft Entra is een ondersteunde verificatiemethode voor alle SQL-hulpprogramma's. Zie het overzicht van de Microsoft Authentication Library (MSAL) voor informatie over programmatisch verifiëren met Microsoft Entra ID.

sqlcmd

Met de volgende statements wordt verbinding gemaakt via versie 13.1 van sqlcmd. Download Microsoft Command Line Utilities 14.0 voor SQL Server.

Note

sqlcmd met de -G opdracht werkt niet met systeemidentiteiten en vereist een gebruikersaanmelding.

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

Verwante onderwerpen

  • Laatst bijgewerkt om