Microsoft Entra kimlik doğrulamasıyla Azure Synapse Analytics'e bağlanın

Bu makale, Azure Synapse Analytics'e bağlanmak için Microsoft Entra doğrulamasını nasıl kullanacağınızı gösteriyor.

Note

Microsoft Entra sunucu sorumluları şu anda Azure Synapse Analytics için önizleme aşamasındadır.

Prerequisites

Bağlantı kurmak için Azure Synapse kaynağınız için Microsoft Entra kimlik doğrulamasını yapılandırmanız gerekiyor.

Microsoft Entra yöneticisinin doğru kurulduğunu doğrulamak için, Microsoft Entra yönetici hesabını kullanarak veritabanına master bağlanın.

Microsoft Entra tabanlı içeren veritabanı kullanıcısı oluşturmak için, veritabanına erişimi ve en az ALTER ANY USER izni olan bir Microsoft Entra kimliği kullanarak veritabanına bağlanın.

SSMS veya SSDT ile bağlanma

Aşağıdaki prosedürler, SQL Server Management Studio (SSMS) veya SQL Server Database Tools (SSDT) kullanarak Microsoft Entra kimliğiyle Synapse SQL'e nasıl bağlanacağınızı gösterir.

Microsoft Entra Tümleşik

Microsoft Entra ID ile federasyonu yapılmış Windows kimlik bilgilerinizi kullanarak oturum açmak istediğinizde bu yöntemi kullanın. Daha fazla bilgi için bkz. Microsoft Entra sorunsuz çoklu oturum açma.

  1. SSMS veya SSDT'yi başlatın ve Sunucuya Bağlan (veya Veritabanı Altyapısına Bağlan) iletişim kutusunun Oturum Aç sekmesinde:

    1. SQL uç noktanız için tam nitelikli Server adını girin. Uç nokta biçimleri için bkz. Synapse SQL'e bağlanma.
    2. Kimlik Doğrulaması için Microsoft Entra Integrated'i seçin. Şifre girmenize gerek yok çünkü mevcut kimlik bilgileriniz bağlantı için sunuluyor.
    3. Şifreleme için Strict seçeneğini belirleyin.

  2. Bağlantı özellikleri sekmesindeki Veritabanına bağlan alanına bağlanmak istediğiniz kullanıcı veritabanının adını yazın.

Microsoft Entra Parolası

Microsoft Entra yönetilen alan adıyla Microsoft Entra sorumlu adıyla bağlantı kurduğunuzda bu yöntemi kullanın. Ayrıca, örneğin uzaktan çalışırken, etki alanına erişim olmadan da federe hesaplar için kullanabilirsiniz.

Bu yöntemi, yalnızca bulut kimliğine sahip Microsoft Entra kullanıcıları veya Microsoft Entra hibrit kimliklerine sahip kullanıcılar ile Synapse SQL'e kimlik doğrulamak için kullanın. Bu yöntem, yerel makine etki alanına bağlı olmadığında, örneğin uzaktan erişim kullanıldığında, Windows kimlik bilgilerini kullanmak isteyen kullanıcıları destekler.

  1. SSMS veya SSDT'yi başlatın ve Sunucuya Bağlan (veya Veritabanı Altyapısına Bağlan) iletişim kutusunun Oturum Aç sekmesinde:

    1. SQL uç noktanız için tam nitelikli Server adını girin. Uç nokta formatları için bkz. Synapse SQL’e bağlanma.
    2. Kimlik Doğrulaması için Microsoft Entra Password'ı seçin.
    3. Kullanıcı adı kutusuna Microsoft Entra kullanıcı adınızı biçiminde username@domain.comyazın. Kullanıcı adları, Microsoft Entra Kimliği'nden bir hesap veya Microsoft Entra Kimliği ile yönetilen ya da federasyon edilmiş bir etki alanının hesabı olmalıdır.
    4. Parola kutusuna Microsoft Entra hesabı veya yönetilen/federasyon etki alanı hesabı için kullanıcı parolanızı yazın.
    5. Şifreleme için Strict seçin.

  2. Bağlantı özellikleri sekmesindeki Veritabanına bağlan alanına bağlanmak istediğiniz kullanıcı veritabanının adını yazın.

Microsoft Entra MFA (Çok Faktörlü Kimlik Doğrulama)

Bu yöntemi, çok faktörlü kimlik doğrulama (MFA) ile etkileşimli kimlik doğrulama için kullanın; şifre etkileşimli olarak istenir. Bu yöntem, yalnızca bulut kimliğine sahip Microsoft Entra kullanıcıları veya Microsoft Entra hibrit kimliklerine sahip kullanıcılar için Synapse SQL'e kimlik doğrulaması yapmak üzere kullanılabilir.

Aşağıdaki adımlar, SSMS'nin en son sürümünde çok faktörlü kimlik doğrulama kullanılarak nasıl bağlanacağınızı göstermektedir.

  1. MFA kullanarak bağlantı kurmak için, SSMS'deki Sunucuya Bağlantı iletişim kutusunda Microsoft Entra MFAyı seçin.

  2. Sunucu adı kutusunu sunucunuzun adıyla doldurun. Kullanıcı adı kutusunu Microsoft Entra kimlik bilgilerinizle biçiminde user_name@domain.comdoldurun.

  3. Bağlan seçeneğini seçin.

  4. Hesabınıza Giriş iletişim kutusu göründüğünde, adım 2'de verdiğiniz kullanıcı adı ile önceden doldurulur. Kullanıcı, Microsoft Entra Kimliği ile birleştirilmiş bir etki alanının parçasıysa parola gerekmez.

  5. MFA yönetici ayarına göre yapılandırılan yöntemlerden birini kullanarak kimlik doğrulaması yapmanız istenir.

  6. Doğrulama tamamlandığında SSMS, geçerli kimlik bilgileri ve güvenlik duvarı erişimi varsayılarak normal şekilde bağlanır.

Microsoft Entra Hizmet Sorumlusu

Bu yöntemi Microsoft Entra servis prensipleriyle Synapse SQL'ye kimlik doğrulaması için kullanın.

Microsoft Entra Yönetilen Kimlik

Bu yöntemi Microsoft Entra yönetilen kimliklerle Synapse SQL'e kimlik doğrulaması için kullanın. Daha fazla bilgi için bkz. Managed identities in Microsoft Entra for Azure Synapse Analytics.

Microsoft Entra Default

Microsoft Entra ID ile varsayılan kimlik doğrulama seçeneği, yönetilen kimlikler dahil olmak üzere şifresiz ve etkileşimsiz mekanizmalar aracılığıyla kimlik doğrulamayı mümkün kılar.

İstemci uygulamasından bağlanma

Aşağıdaki prosedürler, bir istemci uygulamasından Microsoft Entra kimliğiyle Synapse SQL'e nasıl bağlanacağınızı gösterir. Bu listede tüm kimlik doğrulama yöntemleri yer almıyor. Daha fazla bilgi için Microsoft Entra kimlik doğrulama ve SqlClient sayfasına bakınız.

İstemci uygulamalarınızı yapılandırma

Note

System.Data.SqlClient , kullanım dışı olan Azure Active Directory Kimlik Doğrulama Kitaplığı'nı (ADAL) kullanır. Microsoft Entra kimlik doğrulaması için System.Data.SqlClient ad alanını kullanıyorsanız, uygulamaları Microsoft.Data.SqlClient'a ve Microsoft Authentication Library'ye (MSAL) geçirin. .NET'te mevcut bağlantı yöntemlerini anlamak için Microsoft Entra kimlik doğrulaması ve SqlClient bölümlerine bakınız.

Uygulamalarınızda ADAL.DLL kullanmaya devam etmek zorundaysanız, bu bölümdeki bağlantıları kullanarak en son ADAL.DLL kütüphanesini içeren en son ODBC veya OLE DB sürücüsünü yükleyebilirsiniz.

Uygulamalarınızın veya kullanıcılarınızın Microsoft Entra kimliklerini kullanarak Azure Synapse Analytics'e bağlandığı tüm istemci makinelere aşağıdaki yazılımı yükleyin:

Bu gereksinimleri şu şekilde karşılayabilirsiniz:

Microsoft Entra tümleşik kimlik doğrulaması

Entegre Windows authentication'ı kullanmak için, etki alanınızın Active Directory'si Microsoft Entra ID ile federasyonlu olmalı veya geçiş ya da parola karması doğrulaması için sorunsuz tek oturum açma ile yapılandırılmış yönetilen bir etki alanı olmalıdır. Daha fazla bilgi için bkz. Microsoft Entra sorunsuz çoklu oturum açma.

Veritabanına bağlanmak için, bir uygulama (veya hizmet) kullanıcının etki alanı kimlik bilgileri altında etki alanına katılmış bir makinede çalışmalıdır.

Entegre kimlik doğrulama ve Microsoft Entra kimliği kullanarak bir veritabanına bağlanmak için, veritabanı bağlantı dizesindeki Authentication anahtar sözcüğünü Active Directory Integrated olarak ayarlayın. <server_name> öğesini mantıksal sunucu adınızla değiştirin. Aşağıdaki C# kod örneği ADO .NET kullanır.

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

Synapse SQL'e bağlanmak için Integrated Security=True bağlantı dizesi anahtar sözcüğü desteklenmiyor. ODBC bağlantısı kurarken boşlukları kaldırın ve kimlik doğrulamayı ActiveDirectoryIntegrated olarak ayarlayın.

Microsoft Entra parola kimlik doğrulaması

Microsoft Entra yalnızca bulut kimliğine sahip kullanıcı hesaplarını veya Microsoft Entra hibrit kimliklerini kullanan kullanıcıları kullanarak bir veritabanına bağlanmak için Authentication anahtar kelimesini Active Directory Password olarak ayarlayın. Bağlantı dizesi Kullanıcı Kimliği/UID ve Parola/PWD anahtar sözcüklerini ve değerlerini içermelidir. <server_name>, <email_address> ve <password> değerlerini uygun değerlerle değiştirin. Aşağıdaki C# kod örneği ADO .NET kullanır.

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

Microsoft Entra kimlik doğrulama yöntemleri hakkında daha fazla bilgi edinin; Microsoft Entra kimlik doğrulama GitHub Demo adresinde bulunan demo kod örneklerini kullanın.

Microsoft Entra ID erişim belirteci

Bu kimlik doğrulama yöntemi, orta seviye servislerin Microsoft Entra ID'den JSON Web Tokens (JWT) almasını ve Microsoft Entra ID'den token alarak Synapse SQL'e bağlanmasını sağlar. Bu yöntem, sertifika tabanlı kimlik doğrulaması kullanan hizmet kimlikleri, hizmet sorumluları ve uygulamalar gibi çeşitli uygulama senaryolarını etkinleştirir. Microsoft Entra belirteci kimlik doğrulamasını kullanmak için dört temel adımı tamamlamanız gerekir:

  1. Uygulamanızı Microsoft Entra Id ile kaydedin ve kodunuzun istemci kimliğini alın.
  2. Uygulamayı temsil eden bir veritabanı kullanıcısı oluşturun (Microsoft Entra kimliklerine eşleştirilen sınırlı kullanıcılar oluşturma bölümünde açıklandığı gibi).
  3. Uygulamayı çalıştıran istemci bilgisayarda bir sertifika oluşturun.
  4. Sertifikayı uygulamanız için anahtar olarak ekleyin.

Örnek bağlantı dizesi. <server-name> Mantıksal sunucu adınızla değiştirin

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

Sertifika ekleme hakkında daha fazla bilgi için bkz . Microsoft Entra Id'de sertifika tabanlı kimlik doğrulamasını kullanmaya başlama.

Microsoft Entra çok faktörlü kimlik doğrulaması

Microsoft Entra çok faktörlü kimlik doğrulaması, tüm SQL araçları için desteklenen bir kimlik doğrulama yöntemidir. Microsoft Entra Id ile program aracılığıyla kimlik doğrulaması hakkında bilgi için bkz . Microsoft Kimlik Doğrulama Kitaplığı'na (MSAL) Genel Bakış.

sqlcmd

Aşağıdaki ifadeler sqlcmd'nin 13.1 sürümü kullanılarak bağlantı kurar. SQL Server için Microsoft Komut Satırı Yardımcı Programları 14.0'ı indirin.

Note

sqlcmd -G komutu sistem kimlikleriyle çalışmaz ve kullanıcı asıl oturum açma işlemi gerektirir.

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

İlgili içerik

  • Son güncelleştirme: