Usa l'autenticazione integrata

Scarica il driver ODBC

Il driver Microsoft ODBC per SQL Server in Linux e macOS supporta l'autenticazione integrata Kerberos. Il driver utilizza le librerie Generic Security Service Application Program Interface (GSSAPI) e Kerberos versione 5, e supporta il MIT Kerberos Key Distribution Center (KDC).

Questo articolo descrive le connessioni di SQL Server che utilizzano Trusted_Connection=yes. Per l'autenticazione Microsoft Entra ID, utilizzare Authentication=ActiveDirectoryIntegrated con il Driver 17.6 e versioni successive, incluso il Driver 18. Esaminare i requisiti per gli account federati e le restrizioni della piattaforma, inclusi i requisiti della libreria Kerberos per i suffissi alternativi del nome principale utente (UPN).

Connettiti da un'applicazione ODBC

Prima di connettersi, ottieni un ticket Kerberos per il principal dell'applicazione. Per SQLDriverConnect, specifica Trusted_Connection=yes nella stringa di connessione:

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

Sostituisci <server> con il nome del server. Per il Driver 17, cambia il nome del driver in ODBC Driver 17 for SQL Server. Configura la fiducia dei certificati e il nome del server atteso come descritto in Configura connessioni ODBC a Microsoft SQL.

Per SQLConnect, configura Trusted_Connection=yes nella voce nome della fonte dati (DSN) in odbc.ini. SQLConnectaccetta un DSN, non una stringa di connessione. Rimuovere UID, PWD, e le impostazioni incompatibili Authentication dalla configurazione DSN e dell'applicazione quando si seleziona l'autenticazione integrata Kerberos.

Per fornire un nome principale di servizio (SPN) invece del nome generato dal driver, usa ServerSPN. Le versioni attuali del driver 17 e del driver 18 supportano questa impostazione su Linux e macOS. Configura la registrazione del servizio Kerberos corrispondente prima di utilizzare uno SPN esplicito. FailoverPartnerSPN rimane solo per Windows.

Esegui un'applicazione come servizio

Configura Kerberos sul client e rendi disponibile la cache delle credenziali del principal predefinito al processo di servizio. Ottieni un Ticket-Granting Ticket (TGT) tramite uno di questi metodi:

  • Esegui kinit con il nome principal e inserisci la password al prompt. Non inserire la password in una riga di comando.
  • Esegui kinit con una keytab fornita per il principal del servizio. Restringi l'accesso alla keytab come faresti con una password.
  • Utilizza un login configurato con un modulo di autenticazione pluggable Kerberos (PAM) che ottiene il ticket del principal.

Le credenziali Kerberos scadono e il driver ODBC non le rinnova. Organizza il rinnovo o la riacquisizione dei ticket prima della scadenza, ad esempio tramite un'attività di servizio pianificata. Esegui tale attività sotto l'identità del servizio e rendi disponibile la sua cache di credenziali all'applicazione.

Controllare l'accesso al database

Il driver si autentica con il principal Kerberos predefinito disponibile per il processo. Quando un'applicazione si connette con un service principal condiviso, il login del database identifica quel principal, non ogni persona che utilizza l'applicazione.

Se l'applicazione deve essere eseguita con i permessi di un utente di database diverso, utilizzare EXECUTE AS con le autorizzazioni di impersonificazione richieste. Questo modifica il contesto di esecuzione del database; non autentica l'utente dell'applicazione né ottiene una nuova identità Kerberos. Usa REVERT per ripristinare il contesto precedente prima di restituire la connessione a un pool.

Quando si utilizza il pool di connessioni, isola le connessioni tramite l'identità autenticata richiesta e resetta lo stato della sessione prima del riutilizzo. Non dare per scontato che modificare la cache credenziale Kerberos del processo modifichi il login di una connessione pooled già autenticata. Per la configurazione del pool, vedi unixODBC connection pooling.

Utilizza il meccanismo di reset di connessione supportato dal pool invece di trattare una chiamata a sp_reset_connection come un nuovo login. Il driver supporta la richiesta di reset di ODBC 3.8 Driver Manager tramite SQL_ATTR_RESET_CONNECTION. Reimpostare una sessione non acquisisce credenziali né la riautentica come un'altra identità. Verifica sia l'identità di login sia il contesto di esecuzione durante il test dell'accesso poolato.

Gestisci le identità con Active Directory

Puoi usare Active Directory come KDC Kerberos per l'autenticazione integrata di SQL Server invece di mantenere password SQL separate. L'autenticazione del dominio Active Directory e l'autenticazione Microsoft Entra ID sono metodi di connessione diversi. Per maggiori informazioni sull'autenticazione del dominio, consulta Microsoft Kerberos.

Connettiti tramite un server collegato

L'autenticazione integrata sulla connessione client non configura automaticamente l'inoltro delle credenziali a un server collegato. Scegli l'identità per ogni salto e configura gli SPN richiesti, la delega Kerberos e le mappature di login del server collegato:

  1. L'utente si autentica all'applicazione.
  2. L'applicazione si collega alla prima istanza di SQL Server utilizzando la sua identità di servizio o un'identità utente che può delegare.
  3. La prima istanza si collega al server collegato utilizzando la mappatura di login configurata. Passare l'identità dell'utente attraverso questo salto aggiuntivo richiede una configurazione di delega Kerberos appropriata.

Verifica quale identità raggiunge ciascun server. Per le mappature di login e i requisiti di delega, vedi Creare server collegati.

Autenticazione integrata e sqlcmd

Usa l'opzione -E di sqlcmd per l'autenticazione integrata. Esegui l'utilità con accesso alla cache di credenziali Kerberos del principal previsto. Per altre informazioni, vedere Utilità sqlcmd.

Autenticazione integrata e bcp

Usa l'opzione -T di bcp per l'autenticazione integrata. Esegui l'utilità con accesso alla cache di credenziali Kerberos del principal previsto. Non combinare -T con -U o -P. Per altre informazioni, vedere utilità bcp.

Specifica un server SPN

Per le connessioni Transmission Control Protocol (TCP), il driver genera di default il seguente SPN:

Sintassi Descrizione
MSSQLSvc/<fqdn>:<port> Sostituisci <fqdn> con il nome di dominio completamente qualificato del server e <port> con la sua porta TCP.

Configura Kerberos per Active Directory

Configura le mappature di realm e dominio del client in krb5.conf, di solito in /etc. Per usare un altro file, imposta KRB5_CONFIG sul suo percorso. Il seguente esempio mantiene due mappature dominio-reamme; sostituisci i domini e i reami di esempio con i valori della tua implementazione:

[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

Con dns_lookup_kdc=true, configura il client per utilizzare server Domain Name System (DNS) che possono risolvere i record KDC del realm. Ottieni un ticket con kinit usando il principal previsto, come alias@YYYY.CORP.CONTOSO.COM, e inserisci la password al prompt. I nomi principal sono sensibili alle maiuscole e minuscole. L'istanza di SQL Server deve inoltre concedere l'accesso all'identità prevista.

Mantieni sincronizzati gli orologi client e KDC, ad esempio tramite Network Time Protocol (NTP). Un ticket abilitato al forwarding da solo non dimostra che il dominio consente la delega attraverso ogni server in un percorso server collegato.

Se l'autenticazione Kerberos fallisce, il driver su Linux e macOS non torna all'autenticazione NT LAN Manager (NTLM).

Per dettagli sulla configurazione e sulla gestione dei ticket, consulta la documentazione MIT Kerberos.