Use autenticação integrada

Descarregar o driver ODBC

O driver Microsoft ODBC para SQL Server em Linux e macOS suporta autenticação integrada Kerberos. O driver utiliza as bibliotecas Generic Security Service Application Program Interface (GSSAPI) e Kerberos versão 5, e suporta o MIT Kerberos Key Distribution Center (KDC).

Este artigo descreve ligações ao SQL Server que utilizam Trusted_Connection=yes. Para autenticação Microsoft Entra ID, utilize Authentication=ActiveDirectoryIntegrated com o Driver 17.6 e versões posteriores, incluindo o Driver 18. Revise os requisitos de contas federadas e as restrições da plataforma, incluindo os requisitos da biblioteca Kerberos para sufixos de nome principal de utilizador alternativo (UPN).

Ligar a partir de uma aplicação ODBC

Antes de estabelecer ligação, obtenha um ticket Kerberos para o principal da aplicação. Para SQLDriverConnect, especifique Trusted_Connection=yes na cadeia de ligação:

Driver={ODBC Driver 18 for SQL Server};Server=<server>;Encrypt=yes;TrustServerCertificate=no;Trusted_Connection=yes;

Substitua <server> pelo nome do servidor. Para o Driver 17, altere o nome do driver para ODBC Driver 17 for SQL Server. Configure a confiança de certificados e o nome esperado do servidor conforme descrito em Configurar ligações ODBC para Microsoft SQL.

Para SQLConnect, configure Trusted_Connection=yes na entrada do nome da fonte de dados (DSN) em odbc.ini. SQLConnectaceita um DSN, não uma cadeia de ligação. Remova UID, PWD, e definições incompatíveis Authentication da configuração DSN e da aplicação ao selecionar autenticação integrada Kerberos.

Para fornecer um nome principal de serviço (SPN) em vez do nome que o driver gera, utilize ServerSPN. As versões atuais do Driver 17 e do Driver 18 suportam esta configuração no Linux e macOS. Configure o registo de serviço Kerberos correspondente antes de utilizar um SPN explícito. FailoverPartnerSPNpermanece apenas para Windows.

Executar uma aplicação como serviço

Configure o Kerberos no cliente e disponibilize a cache de credenciais predefinida do principal predefinido ao processo de serviço. Obtenha um ticket de concessão de tickets (TGT) através de um destes métodos:

  • Execute kinit com o nome principal e introduza a palavra-passe na sua linha de comandos. Não coloque a palavra-passe numa linha de comandos.
  • Execute kinit com um keytab provisionado para o principal de serviço. Restringa o acesso ao keytab como faria com uma palavra-passe.
  • Utilize um login configurado com um módulo de autenticação plugável Kerberos (PAM) que obtém o ticket do principal.

As credenciais Kerberos expiram e o driver ODBC não as renova. Providencie a renovação ou reaquisição de tickets antes da expiração, por exemplo através de uma tarefa de serviço agendada. Execute essa tarefa sob a identidade do serviço e disponibilize a sua cache de credenciais à aplicação.

Acesso à base de dados de auditoria

O driver autentica-se com a identidade principal Kerberos predefinida disponível para o processo. Quando uma aplicação se liga a um principal de serviço partilhado, o login da base de dados identifica esse principal, não todas as pessoas que utilizam a aplicação.

Se a aplicação precisar de ser executada sob as permissões de um utilizador de base de dados diferente, use EXECUTE AS com as permissões de representação necessárias. Isto altera o contexto de execução da base de dados; não autentica o utilizador da aplicação nem obtém uma nova identidade Kerberos. Use REVERT para restaurar o contexto anterior antes de devolver a ligação a um pool.

Ao utilizar o agrupamento de ligações, isole as ligações pela identidade autenticada requerida e redefina o estado da sessão antes de a reutilizar. Não presuma que alterar a cache de credenciais Kerberos do processo altera o login de uma ligação pooled já autenticada. Para a configuração do pool, consulte agrupamento de conexões unixODBC.

Utilize o mecanismo de redefinição de ligação suportado pelo pool em vez de tratar uma chamada a sp_reset_connection como um novo login. O driver suporta o pedido de reset do ODBC 3.8 Driver Manager através de SQL_ATTR_RESET_CONNECTION. Reiniciar uma sessão não adquire credenciais nem a reautentica como outro principal. Verifique tanto a identidade de login como o contexto de execução ao testar o acesso agrupado.

Gerir identidades com o Active Directory

Pode usar o Active Directory como o KDC Kerberos para autenticação integrada do SQL Server em vez de manter palavras-passe SQL separadas. A autenticação de domínio Active Directory e a autenticação Microsoft Entra ID são métodos de ligação diferentes. Para mais informações sobre autenticação de domínio, consulte Microsoft Kerberos.

Ligue-se através de um servidor vinculado

A autenticação integrada na ligação do cliente não configura automaticamente o encaminhamento de credenciais para um servidor vinculado. Escolha a identidade para cada salto e configure os SPNs necessários, delegação Kerberos e mapeamentos de login de servidores vinculados:

  1. O utilizador autentica-se na aplicação.
  2. A aplicação liga-se à primeira instância do SQL Server utilizando a sua identidade de serviço ou uma identidade de utilizador que possa delegar.
  3. A primeira instância liga-se ao servidor vinculado usando o mapeamento de início de sessão configurado. Passar a identidade do utilizador através deste salto adicional requer uma configuração adequada de delegação Kerberos.

Teste qual identidade chega a cada servidor. Para mapeamentos de login e requisitos de delegação, consulte Criar servidores vinculados.

Autenticação integrada e sqlcmd

Use a opção -E do sqlcmd para autenticação integrada. Execute a utilidade com acesso à cache de credenciais Kerberos do principal pretendido. Para mais informações, veja utilidade sqlcmd.

Autenticação integrada e bcp

Use a opção -T de bcp para autenticação integrada. Execute a utilidade com acesso à cache de credenciais Kerberos do principal pretendido. Não combine -T com -U ou -P. Para mais informações, consulte a utilidade BCP.

Especifique um SPN do servidor

Para ligações ao Protocolo de Controlo de Transmissão (TCP), o driver gera o seguinte SPN por predefinição:

Sintaxe Description
MSSQLSvc/<fqdn>:<port> Substitua <fqdn> pelo nome de domínio totalmente qualificado do servidor e <port> pela sua porta TCP.

Configurar o Kerberos para Active Directory

Configure os mapeamentos entre realm e domínio do cliente em krb5.conf, normalmente em /etc. Para usar outro ficheiro, defina KRB5_CONFIG para o caminho do ficheiro. O exemplo seguinte mantém dois mapeamentos domain-to-realm; substitua os domínios e realms de exemplo pelos valores da sua implementação:

[libdefaults]
default_realm = YYYY.CORP.CONTOSO.COM
dns_lookup_realm = false
dns_lookup_kdc = true
ticket_lifetime = 24h
forwardable = yes

[domain_realm]
.yyyy.corp.contoso.com = YYYY.CORP.CONTOSO.COM
.zzzz.corp.contoso.com = ZZZZ.CORP.CONTOSO.COM

Com dns_lookup_kdc=true, configure o cliente para utilizar servidores do Sistema de Nomes de Domínio (DNS) que consigam resolver os registos KDC do reino. Obtenha um ticket com kinit usando o principal pretendido, como alias@YYYY.CORP.CONTOSO.COM, e introduza a sua palavra-passe no prompt. Os nomes de principal distinguem maiúsculas de minúsculas. A instância do SQL Server deve também conceder acesso à identidade pretendida.

Mantenha os relógios do cliente e do KDC sincronizados, por exemplo através do Protocolo de Tempo de Rede (NTP). Um ticket com encaminhamento habilitado por si só não estabelece que o domínio permite delegação através de todos os servidores num caminho de servidor ligado.

Se a autenticação Kerberos falhar, o driver no Linux e macOS não recorre à autenticação NT LAN Manager (NTLM).

Para detalhes de configuração e gestão de tickets, consulte a documentação do MIT Kerberos.