Connect Azure Data Studio to SQL Server using Kerberos

Azure Data Studio supports connecting to SQL Server by using Kerberos.

To use integrated authentication (Windows Authentication) on macOS or Linux, you need to set up a Kerberos ticket that links your current user to a Windows domain account.


To get started, you need:

Check if SQL Server has a Kerberos setup

Sign in to the host machine of SQL Server. From the Windows command prompt, use setspn -L %COMPUTERNAME% to list all the SPNs for the host. Verify there are entries that begin with MSSQLSvc/ These entries mean that SQL Server has registered an SPN and is ready to accept Kerberos authentication.

If you don't have access to the host of the SQL Server instance, then from any other Windows OS joined to the same Active Directory, you could use the command setspn -L <SQLSERVER_NETBIOS>, where <SQLSERVER_NETBIOS> is the computer name of the host of the SQL Server instance.

Get the Kerberos Key Distribution Center

Find the Kerberos Key Distribution Center (KDC) configuration value. Run the following command on a Windows computer that's joined to your Active Directory domain.

Run nltest from the command line, and replace "DOMAIN.CONTOSO.COM" with your domain's name.

nltest /dsgetdc:DOMAIN.CONTOSO.COM

Output is similar to the following sample:

DC: \\
Address: \\2111:4444:2111:33:1111:ecff:ffff:3333
The command completed successfully

Copy the DC name that's the required KDC configuration value. In this case, it's

Join your OS to the Active Directory domain controller

sudo apt-get install realmd krb5-user software-properties-common python-software-properties packagekit

Edit the /etc/network/interfaces file so that your Active Directory domain controller's IP address is listed as dns-nameserver. For example:

# The primary network interface
auto eth0
iface eth0 inet dhcp
dns-nameservers **<AD domain controller IP address>**
dns-search **<AD domain name>**


The network interface (eth0) might differ for different machines. To find out which one you're using, run ifconfig and copy the interface that has an IP address and transmitted and received bytes.

After editing this file, restart the network service:

sudo ifdown eth0 && sudo ifup eth0

Now check that your /etc/resolv.conf file contains a line like the following one:

nameserver **<AD domain controller IP address>**

Join to the Active Directory domain:

sudo realm join -U 'user@CONTOSO.COM' -v

Here's the expected output:

* Success

Test the ticket granting ticket retrieval

Get a Ticket Granting Ticket (TGT) from KDC.

kinit username@DOMAIN.CONTOSO.COM

View the available tickets by using klist. If the kinit was successful, you should see a ticket.


Here's the expected output:


Connect by using Azure Data Studio

  1. Create a new connection profile.

  2. Select Windows Authentication as the authentication type.

  3. For the Server, enter a fully qualified host name, in the format hostname.DOMAIN.CONTOSO.COM.

  4. Complete the connection profile, and select Connect.

After successfully connecting, your server appears in the SERVERS sidebar.