Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le pilote ODBC Microsoft pour SQL Server sur Linux et macOS prend en charge l’authentification intégrée Kerberos. Le pilote utilise les bibliothèques Generic Security Service Application Program Interface (GSSAPI) et Kerberos version 5, et supporte le MIT Kerberos Key Distribution Center (KDC).
Cet article décrit les connexions SQL Server qui utilisent Trusted_Connection=yes. Pour l’authentification Microsoft Entra ID, utilisez Authentication=ActiveDirectoryIntegrated avec le pilote 17.6 et les versions ultérieures, y compris le pilote 18. Examinez les exigences relatives aux comptes fédérés et les restrictions de la plateforme, y compris les exigences de bibliothèque Kerberos pour les suffixes de nom principal d’utilisateur alternatif (UPN).
Connectez-vous depuis une application ODBC
Avant de vous connecter, obtenez un ticket Kerberos pour le principal de l’application. Pour SQLDriverConnect, spécifiez Trusted_Connection=yes dans la chaîne de connexion :
Driver={ODBC Driver 18 for SQL Server};Server=<server>;Encrypt=yes;TrustServerCertificate=no;Trusted_Connection=yes;
Remplacez <server> par le nom du serveur. Pour le pilote 17, changez le nom du pilote en ODBC Driver 17 for SQL Server. Configurez la confiance des certificats et le nom attendu du serveur comme décrit dans Configurer les connexions ODBC vers Microsoft SQL.
Pour SQLConnect, configure Trusted_Connection=yes dans l’entrée du nom de la source de données (DSN) dans odbc.ini.
SQLConnect accepte un DSN, pas une chaîne de connexion. Supprimez UID, PWD, et les paramètres incompatibles Authentication de la configuration DSN et de l’application lors de la sélection de l’authentification intégrée Kerberos.
Pour fournir un nom de principal de service (SPN) au lieu du nom généré par le pilote, utilisez ServerSPN. Les versions actuelles du pilote 17 et du pilote 18 supportent ce paramètre sur Linux et macOS. Configurez l’enregistrement du service Kerberos correspondant avant d’utiliser un SPN explicite.
FailoverPartnerSPNreste uniquement sous Windows.
Exécuter une application en tant que service
Configurez Kerberos sur le client et rendez le cache d’identifiants par défaut du principal disponible au processus de service. Obtenez un ticket d’octroi de ticket (TGT) via l’une des méthodes suivantes :
- Exécutez
kinitavec le nom du principal et saisissez le mot de passe à son invite. Ne placez pas le mot de passe dans une ligne de commande. - Exécutez
kinitavec un keytab provisionné pour le principal de service. Restreignez l’accès au keytab comme vous le feriez avec un mot de passe. - Utilisez une connexion configurée avec un module d’authentification branchable Kerberos (PAM) qui obtient le ticket du principal Kerberos.
Les informations d’authentification Kerberos expirent et le pilote ODBC ne les renouvelle pas. Organiser le renouvellement ou la réacquisition des tickets avant l’expiration, par exemple via une tâche de service programmée. Exécutez cette tâche sous l’identité de service et rendez son cache d’identifiants accessible à l’application.
Auditer l’accès à la base de données
Le pilote s’authentifie avec l’identité principale Kerberos par défaut disponible pour le processus. Lorsqu’une application se connecte à un principal de service partagé, la connexion à la base de données identifie ce principal, et non chaque personne utilisant l’application.
Si l’application doit s’exécuter sous les autorisations d’un utilisateur de base de données différent, utilisez EXECUTE AS avec les autorisations d’usurpation d’identité requises. Cela modifie le contexte d’exécution de la base de données ; il n’authentifie pas l’utilisateur de l’application ni n’obtient une nouvelle identité Kerberos. Utilisez REVERT pour restaurer le contexte précédent avant de renvoyer la connexion à un pool.
Lors de l’utilisation du pooling de connexions, isolez les connexions selon l’identité authentifiée requise et réinitialisez l’état de la session avant la réutilisation. Ne partez pas du principe que modifier le cache d’identifiants Kerberos du processus modifie l’identifiant de connexion d’une connexion poolée déjà authentifiée. Pour la configuration du pool, voir pooling de connexion unixODBC.
Utilisez le mécanisme de réinitialisation de connexion pris en charge par le pool plutôt que de traiter un appel à sp_reset_connection comme une nouvelle ouverture de session. Le pilote supporte la requête de réinitialisation ODBC 3.8 Driver Manager via SQL_ATTR_RESET_CONNECTION. Remettre à zéro une session n’acquiert pas d’identifiants ni ne la réauthentifie comme un autre principal. Vérifiez à la fois l’identité de connexion et le contexte d’exécution lors du test de l’accès poolé.
Gérer les identités avec Active Directory
Vous pouvez utiliser Active Directory comme KDC Kerberos pour l’authentification intégrée SQL Server au lieu de maintenir des mots de passe SQL séparés. L’authentification de domaine Active Directory et l’authentification Microsoft Entra ID sont des méthodes de connexion différentes. Pour plus d’informations sur l’authentification de domaine, voir Microsoft Kerberos.
Se connecter à l’aide d’un serveur lié
L’authentification intégrée sur la connexion client ne configure pas automatiquement le transfert des identifiants vers un serveur lié. Choisissez l’identité de chaque saut et configurez les SPN requis, la délégation Kerberos et les mappages de connexion entre serveurs liés :
- L’utilisateur s’authentifie auprès de l’application.
- L’application se connecte à la première instance de SQL Server en utilisant son identité de service ou un identifiant utilisateur qu’elle peut déléguer.
- La première instance se connecte au serveur lié en utilisant le mappage de connexion configuré. Faire passer l’identité de l’utilisateur via ce saut supplémentaire nécessite une configuration appropriée de délégation Kerberos.
Testez quelle identité atteint chaque serveur. Pour les correspondances de connexion et les exigences de délégation, voir Créer des serveurs liés.
Authentification intégrée et sqlcmd
Utilisez l’option -E de sqlcmd pour l’authentification intégrée. Exécutez l’utilitaire avec accès au cache d’identifiants Kerberos du principal prévu. Pour plus d’informations, consultez l’utilitaire sqlcmd.
Authentification intégrée et bcp
Utilisez l’option -T de bcp pour l’authentification intégrée. Exécutez l’utilitaire avec accès au cache d’identifiants Kerberos du principal prévu. Ne pas combiner -T avec -U ou -P. Pour plus d’informations, consultez l’utilitaire bcp.
Spécifier un SPN serveur
Pour les connexions du protocole de contrôle de transmission (TCP), le pilote génère par défaut le SPN suivant :
| Syntaxe | Description |
|---|---|
MSSQLSvc/<fqdn>:<port> |
Remplacez <fqdn> par le nom de domaine pleinement qualifié du serveur et <port> par son port TCP. |
Configurer Kerberos pour Active Directory
Configurez les mappages de royaume et de domaine du client dans krb5.conf, généralement dans /etc. Pour utiliser un autre fichier, définissez KRB5_CONFIG sur son chemin d’accès. L’exemple suivant conserve deux mappages domaine-à-realm ; remplacez les domaines et les realms d’exemple par les valeurs de votre déploiement :
[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
Avec dns_lookup_kdc=true, configurez le client pour utiliser des serveurs DNS (Domain Name System) capables de résoudre les enregistrements KDC du domaine. Obtenez un ticket en kinit utilisant le principal prévu, tel que alias@YYYY.CORP.CONTOSO.COM, et saisissez son mot de passe à l’invite. Les noms de principal sont sensibles à la casse. L’instance SQL Server doit également accorder à l’identité prévue l’accès.
Gardez les horloges client et KDC synchronisées, par exemple via le protocole de temps réseau (NTP). Un ticket avec transfert activé à lui seul n’établit pas que le domaine permet la délégation via chaque serveur d’un chemin de serveur lié.
Si l’authentification Kerberos échoue, le pilote sous Linux et macOS ne revient pas à l’authentification NT LAN Manager (NTLM).
Pour les détails de configuration et de gestion des tickets, consultez la documentation MIT Kerberos.