Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
kinitcom o nome principal e introduza a palavra-passe na sua linha de comandos. Não coloque a palavra-passe numa linha de comandos. - Execute
kinitcom 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:
- O utilizador autentica-se na aplicação.
- 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.
- 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.