如何使用智能卡通过Python连接Microsoft SQL Server

1. 安装支持智能卡认证的ODBC驱动 #

Debian 11需安装Microsoft ODBC Driver 17及以上版本（该版本开始支持Linux下的智能卡认证），执行以下命令：

# 导入微软签名密钥
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
# 添加ODBC驱动源
curl https://packages.microsoft.com/config/debian/11/prod.list > /etc/apt/sources.list.d/mssql-release.list
# 更新并安装驱动
apt-get update
ACCEPT_EULA=Y apt-get install -y msodbcsql17

2. 配置智能卡运行环境 #

确保系统能识别并读取智能卡，安装PCSC工具链：

apt-get install -y pcscd libpcsclite1
# 启动并设置开机自启服务
systemctl start pcscd
systemctl enable pcscd

同时需确保智能卡对应的PKCS#11驱动已正确安装，可通过pkcs11-tool --list-slots命令验证智能卡是否被识别。

3. 编写pyodbc连接代码 #

连接字符串需指定Authentication='ActiveDirectorySmartCard'参数，无需密码，示例代码如下：

import pyodbc

# 替换为实际的服务器、数据库和域用户名
conn_str = (
    "DRIVER={ODBC Driver 17 for SQL Server};"
    "SERVER=your-sql-server:1433;"
    "DATABASE=your-target-db;"
    "UID=your-domain-username;"
    "Authentication=ActiveDirectorySmartCard;"
)

try:
    conn = pyodbc.connect(conn_str)
    print("智能卡认证连接成功")
    # 在此执行数据库操作
    conn.close()
except pyodbc.Error as e:
    print(f"连接失败: {str(e)}")

关键注意事项 #

• 确认SQL Server已配置支持AD智能卡认证，且你的域账号已绑定智能卡证书。
• 若出现证书找不到的错误，可通过SQLCOPT_SS_CERTIFICATE连接属性指定证书指纹，或检查系统证书存储对智能卡证书的访问权限。
• 可先用isql工具验证ODBC连接有效性：

isql -v -k "DRIVER={ODBC Driver 17 for SQL Server};SERVER=your-server;UID=your-username;Authentication=ActiveDirectorySmartCard"

内容的提问来源于stack exchange，提问作者mrkskwsnck