Compartilhar via


Usando a autenticação NTLM para se conectar ao SQL Server

Baixar o JDBC Driver

O Microsoft JDBC Driver para SQL Server permite que um aplicativo use a propriedade de conexão authenticationScheme para indicar que ele deseja se conectar a um banco de dados usando a Autenticação NTLM v2.

As seguintes propriedades também são usadas para autenticação NTLM:

  • domínio = domainName (opcional)
  • usuário = userName
  • senha = password
  • integratedSecurity = true

Além do domínio, as outras propriedades são obrigatórias, o driver gerará um erro se alguma delas estiver ausente quando a propriedade authenticationScheme do NTLM for usada.

Para obter mais informações sobre as propriedades de conexão, confira Configuração das propriedades de conexão. Para obter mais informações sobre o protocolo de autenticação NTLM da Microsoft, confira Microsoft NTLM.

Comentários

Procure em Segurança de rede: nível de autenticação do LAN Manager a descrição das configurações do SQL Server que controlam o comportamento da autenticação NTLM.

Registro em log

Um novo agente foi adicionado para dar suporte à autenticação NTLM: com.microsoft.sqlserver.jdbc.internals.NTLMAuthentication. Para obter mais informações, veja Rastreamento de operação do driver.

DataSource

Ao usar uma fonte de fontes para criar conexões, as propriedades NTLM podem ser definidas de forma programática usando setAuthenticationScheme, setdomain e (opcionalmente) setServerSpn.

SQLServerDataSource ds = new SQLServerDataSource();
ds.setServerName("<server>");
ds.setPortNumber(1433); // change if necessary
ds.setIntegratedSecurity(true);
ds.setAuthenticationScheme("NTLM");
ds.setDomain("<domainName>");
ds.setUser("<userName>");
ds.setPassword("<password>");
ds.setDatabaseName("<database>");
ds.setServerSpn("<serverSpn");

try (Connection c = ds.getConnection(); Statement s = c.createStatement();
        ResultSet rs = s.executeQuery("select auth_scheme from sys.dm_exec_connections where session_id=@@spid")) {
    while (rs.next()) {
        System.out.println("Authentication Scheme: " + rs.getString(1));
    }
}

Nomes de entidades de serviço

Um SPN (nome da entidade de serviço) é o nome pelo qual um cliente identifica exclusivamente uma instância de um serviço.

Você pode especificar o SPN usando a propriedade de conexão serverSpn ou deixar que o driver o crie para você (o padrão). Essa propriedade está no formato: "MSSQLSvc/fqdn:port@REALM", em que fqdn é o nome de domínio totalmente qualificado, port é o número da porta e REALM é o realm do SQL Server em letras maiúsculas. A parte do realm dessa propriedade é opcional, pois o realm padrão é o mesmo que o do servidor.

Por exemplo, o SPN pode ser: "MSSQLSvc/some-server.zzz.corp.contoso.com:1433"

Para obter mais informações sobre SPNs (nomes de entidade de serviço), consulte:

Observação

O atributo de conexão serverSpn é compatível somente com os Microsoft JDBC Drivers 4.2 e superiores.

Antes da versão 6.2 do driver JDBC, você precisa definir explicitamente o serverSpn. Começando com a versão 6.2, o driver poderia criar o serverSpn por padrão, embora seja possível usar o serverSpn explicitamente também.

Riscos à segurança

O protocolo NTLM é um protocolo de autenticação antigo com várias vulnerabilidades, que representam um risco de segurança. Ele é baseado em um esquema de criptografia fraco e é vulnerável a ataques. O NTLM foi substituído pelo Kerberos, que é muito mais seguro e recomendado. A autenticação NTLM deve ser usada apenas em um ambiente confiável seguro ou quando o Kerberos não pode ser usado.

O Microsoft JDBC Driver para SQL Server é compatível apenas com NTLM v2, que tem alguns aprimoramentos de segurança em relação ao protocolo v1 original. Também recomendamos habilitar a Proteção Estendida ou usar a Criptografia TLS para aumentar a segurança.

Para obter mais informações sobre como habilitar a Proteção Estendida, confira:

Para obter mais informações sobre a conexão com a criptografia, confira:

Observação

Para a versão 7,4, não suporte para a habilitação da proteção estendida e da criptografia.

Confira também

Conectando ao SQL Server com o JDBC Driver