大网数据广告活动
数据库与应用安全

使用 Azure Active Directory 与 ODBC 驱动程序 |适用于 SQL Server 的 Microsoft 文档

· 52CE 我爱测

Microsoft ODBC Driver for SQL Server 使用版本 13.1 或更高版本允许 ODBC 应用程序连接到 SQL Azure 的实例使用 Azure Active Directory 中的联合身份标识,使用用户名/密码、 Azure Active Directory 访问令牌或 Windows集成身份验证 (_Windows 驱动程序_)。 ODBC 驱动程序版本 13.1,令牌身份验证的 Azure Active Directory 访问权限_仅 Windows_。 ODBC 驱动程序版本 17 和上面跨所有平台 (Windows、 Linux 和 Mac) 支持此身份验证。 为 Windows,如果在 ODBC 驱动程序版本 17.1 中引入的新…

下载下载 ODBC 驱动程序

用途

Microsoft ODBC Driver for SQL Server 使用版本 13.1 或更高版本允许 ODBC 应用程序连接到 SQL Azure 的实例使用 Azure Active Directory 中的联合身份标识,使用用户名/密码、 Azure Active Directory 访问令牌或 Windows集成身份验证 (Windows 驱动程序)。 ODBC 驱动程序版本 13.1,令牌身份验证的 Azure Active Directory 访问权限_仅 Windows_。 ODBC 驱动程序版本 17 和上面跨所有平台 (Windows、 Linux 和 Mac) 支持此身份验证。 为 Windows,如果在 ODBC 驱动程序版本 17.1 中引入的新 Azure Active Directory 交互式身份验证使用的登录 ID。 所有这些都是通过使用新 DSN 和连接字符串关键字和连接属性完成。

Note: 在 Linux 和 macOS 上 ODBC 驱动程序不支持 Active Directory 联合身份验证服务。 如果使用 Azure Active Directory 用户名/密码身份验证从 Linux 或 macOS 客户端和 Active Directory 配置包括联合身份验证服务,可能会失败身份验证。

新的和/或修改后的 DSN 和连接字符串关键字

Authentication关键字可用于使用 DSN 或连接字符串进行连接时控制身份验证模式。 在连接字符串中设置的值覆盖,在 DSN 中,如果提供。 _预先属性值_的Authentication设置为从连接字符串和 DSN 值计算的值。

“属性” 值 ,则“默认” 描述
Authentication (未设置),(空字符串)、 SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (未设置) 控制身份验证模式。<table><tr><th>ReplTest1<th>描述<tr><td>(未设置)<td>身份验证模式由其他关键字 (现有旧的连接选项。)<tr><td>(空字符串)<td>连接字符串为“{0}”重写和取消设置Authentication值在 DSN 中的设置。<tr><td>SqlPassword<td>直接进行身份验证使用的用户名和密码的 SQL Server 实例。<tr><td>ActiveDirectoryPassword<td>使用 Azure Active Directory 标识使用用户名和密码进行身份验证。<tr><td>ActiveDirectoryIntegrated<td>Windows 驱动程序。 使用 Azure Active Directory 标识使用集成身份验证进行身份验证。<tr><td>ActiveDirectoryInteractive<td>Windows 驱动程序。 使用 Azure Active Directory 标识使用交互式身份验证进行身份验证。</table>
Encrypt (未设置)、Yes``No (请参见说明) 控制连接的加密。 如果预属性值Authentication设置不是_无_在 DSN 或连接字符串中,默认值是Yes。 否则默认值为 No。 如果该属性SQL_COPT_SS_AUTHENTICATION重写的预特性值Authentication、 显式 DSN 或连接字符串或连接属性中设置的加密值。 加密的预属性值是Yes的值设置为如果Yes的 DSN 或连接字符串中。

新的和/或修改连接属性

以下预连接属性已引入或修改,以支持 Azure Active Directory 身份验证的连接。 当连接属性都有相应的连接字符串或 DSN 关键字,并且设置时,连接属性优先。

Attribute 类型 值 ,则“默认” 描述
SQL_COPT_SS_AUTHENTICATION SQL_IS_INTEGER SQL_AU_NONE、SQL_AU_PASSWORD、SQL_AU_AD_INTEGRATED、SQL_AU_AD_PASSWORD、SQL_AU_AD_INTERACTIVE、SQL_AU_RESET (未设置) 请参阅说明Authentication关键字更高版本。 SQL_AU_NONE 若要显式重写一组提供Authentication值在 DSN 和/或连接字符串中,虽然SQL_AU_RESET取消设置该属性,如果它已设置,从而允许为具有更高优先级的 DSN 或连接字符串值。
SQL_COPT_SS_ACCESS_TOKEN SQL_IS_POINTER 指向ACCESSTOKEN或为 NULL NULL 如果非 null,指定 azure Ad 访问令牌来使用。 它是指定的访问令牌,也UID, PWD, Trusted_Connection,或Authentication连接字符串关键字或其等效的属性。 注意: ODBC 驱动程序版本 13.1 才支持此上_Windows_。
SQL_COPT_SS_ENCRYPT SQL_IS_INTEGER SQL_EN_OFF、SQL_EN_ON (请参见说明) 控制连接的加密。 SQL_EN_OFF 和SQL_EN_ON禁用和启用加密,分别。 如果预属性值Authentication设置不是_无_或SQL_COPT_SS_ACCESS_TOKEN设置,并Encrypt未指定的 DSN 或连接字符串中的默认值是SQL_EN_ON。 否则默认值为 SQL_EN_OFF。 如果连接属性SQL_COPT_SS_AUTHENTICATION设置为不_无_,请显式设置SQL_COPT_SS_ENCRYPT为所需值如果Encrypt的 DSN 或连接字符串中未指定。 此属性控制的有效值是否将使用加密连接。
SQL_COPT_SS_OLDPWD - - - 不支持与 Azure Active Directory,因为无法通过 ODBC 连接完成对 AAD 主体的密码更改。 在 SQL Server 2005 中引入了 SQL Server 身份验证密码过期功能。 SQL_COPT_SS_OLDPWD添加了属性,以允许客户端提供连接旧和新密码。 设置此属性时,访问接口对于第一次连接或后续连接将不使用连接池,因为连接字符串将包含现在已更改的“旧密码”。
SQL_COPT_SS_INTEGRATED_SECURITY SQL_IS_INTEGER SQL_IS_OFF、SQL_IS_ON SQL_IS_OFF 已弃用; 使用SQL_COPT_SS_AUTHENTICATION设置为SQL_AU_AD_INTEGRATED相反。 强制使用 Windows 身份验证 (Kerberos Linux 和 macOS 上) 的服务器登录名访问验证。 使用 Windows 身份验证时,该驱动程序将忽略作为的一部分提供的用户标识符和密码值SQLConnect, SQLDriverConnect,或SQLBrowseConnect处理。

Azure Active Directory(仅 Windows 驱动程序)的 UI 新增功能

DSN 设置和连接 Ui 的驱动程序已得到增强和其他选项使用与 Azure AD 身份验证所必需的。

创建和编辑 UI 中的 Dsn

此外,可以使用新的 Azure AD 身份验证选项时创建或编辑现有 DSN 使用驱动程序的安装程序 UI:

Authentication=ActiveDirectoryIntegrated 用于向 SQL Azure 执行 Azure Active Directory 集成身份验证

CreateNewDSN_ADIntegrated.png

Authentication=ActiveDirectoryPassword SQL Azure 到 Azure Active Directory 用户名/密码身份验证

CreateNewDSN_ADPassword.png

Authentication=ActiveDirectoryInteractive 用于针对 SQL Azure 的 Azure Active Directory 交互式身份验证

CreateNewDSN_ADInteractive.png

Authentication=SqlPassword 到 SQL Server 的用户名/密码身份验证 (Azure 或其他方式)

CreateNewDSN_SQLServer.png

Trusted_Connection=Yes 对于 Windows 旧 SSPI 集成身份验证

CreateNewDSN_winSSPI.png

五个选项对应于Trusted_Connection=Yes(现有旧 Windows SSPI 仅集成的身份验证) 和Authentication= ActiveDirectoryIntegrated, SqlPassword, ActiveDirectoryPassword,并ActiveDirectoryInteractive分别。

SQLDriverConnect 提示符 (仅 Windows 驱动程序)

SQLDriverConnect 请求以完成连接所需的信息时显示提示对话框包含三个 Azure AD 身份验证的新选项:

ServerLogin.png

这些选项对应于相同的五个 DSN 设置 UI 更高版本中可用。

连接字符串示例

  1. SQL Server 身份验证 – 旧语法。 不验证服务器证书,并且仅当服务器强制实施它使用加密。 在连接字符串中传递用户名/密码。 server=Server;database=Database;UID=UserName;PWD=Password;
  2. SQL 身份验证 – 新的语法。 客户端请求加密 (默认值Encrypt是true) 和服务器证书获取已验证,而不考虑加密设置 (除非TrustServerCertificate设置为true)。 在连接字符串中传递用户名/密码。 server=Server;database=Database;UID=UserName;PWD=Password;Authentication=SqlPassword;
  3. 集成 Windows 身份验证 (Kerberos Linux 和 macOS 上) 使用 SSPI (到 SQL Server 或 SQL IaaS) – 当前的语法。 不验证服务器证书,除非使用加密。 server=Server;database=Database;Trusted_Connection=yes;
  4. (Windows 驱动程序。)集成 Windows 身份验证使用 SSPI (如果目标数据库位于 SQL Server 或 SQL IaaS) – 新语法。 客户端请求加密 (默认值Encrypt是true) 和服务器证书获取已验证,而不考虑加密设置 (除非TrustServerCertificate设置为true)。 server=Server;database=Database;Authentication=ActiveDirectoryIntegrated;
  5. AAD 用户名/密码身份验证 (如果目标数据库是在 Azure SQL 数据库)。 获取验证服务器证书,而不考虑加密设置 (除非TrustServerCertificate设置为true)。 在连接字符串中传递用户名/密码。 server=Server;database=Database;UID=UserName;PWD=Password;Authentication=ActiveDirectoryPassword;
  6. (Windows 驱动程序。)集成 Windows 身份验证使用 ADAL,需要在兑换 AAD 颁发访问令牌的 Windows 帐户凭据,假设目标数据库为 Azure SQL 数据库中。 获取验证服务器证书,而不考虑加密设置 (除非TrustServerCertificate设置为true)。 server=Server;database=Database;Authentication=ActiveDirectoryIntegrated;
  7. (Windows 驱动程序。)AAD 交互式身份验证使用 Azure 多重身份验证技术建立了连接。 在此模式下,通过提供的登录 ID,Windows Azure 身份验证对话框时触发,允许用户输入密码以完成连接。 用户名传递连接字符串中。 server=Server;database=Database;UID=UserName;Authentication=ActiveDirectoryInteractive;

WindowsAzureAuth.png

Note:

  • 在新的 Active Directory 选项使用 Windows ODBC 驱动程序,确保SQL Server 的 Active Directory 身份验证库已安装。 当使用 Linux 和 macOS 的驱动程序,确保libcurl已安装。 有关驱动程序版本 17.2 及更高版本,这不是显式依赖关系由于不需要其他身份验证方法或 ODBC 操作。
  • 若要使用的 SQL Server 帐户的用户名和密码进行连接,您现在可以使用新SqlPassword选项,因为此选项将启用更安全的连接默认设置为 SQL Azure 建议。
  • 若要使用的 Azure Active Directory 帐户的用户名和密码进行连接,指定Authentication=ActiveDirectoryPassword连接字符串中并UID和PWD关键字,使用用户名和密码分别。
  • 若要使用 Windows 集成或 Active Directory 集成 (仅 Windows 驱动程序) 的身份验证进行连接,请指定Authentication=ActiveDirectoryIntegrated连接字符串中。 该驱动程序将自动选择正确的身份验证模式。 UID 和PWD不能指定。
  • 使用 Active Directory Interactive (仅 Windows 驱动程序) 的身份验证进行连接UID必须指定。

使用访问令牌进行身份验证

SQL_COPT_SS_ACCESS_TOKEN预连接属性允许从 Azure AD 进行身份验证而不是用户名和密码,获取访问令牌使用和也绕过协商和获取访问令牌的驱动程序。 若要使用的访问令牌,将SQL_COPT_SS_ACCESS_TOKEN连接属性设置为一个指向ACCESSTOKEN结构:

typedef struct AccessToken
{
    DWORD dataSize;
    BYTE data[];
} ACCESSTOKEN;

ACCESSTOKEN是一种长度可变的结构由组成的 4 字节_长度_跟_长度_的窗体的访问令牌的不透明数据的字节。 由于 SQL Server 如何处理访问令牌,一个通过获取OAuth 2.0必须展开 JSON 响应,以便每个字节后跟 0 填充字节,类似于包含仅包含 ASCII 字符的 ucs-2 字符串; 但是,该令牌是一个不透明值和指定,以字节为单位,长度不能包含任何 null 终止符。 由于其相当大的长度和格式约束,此身份验证方法是仅可通过以编程方式SQL_COPT_SS_ACCESS_TOKEN连接属性,则没有相应的 DSN 或连接字符串关键字。 连接字符串必须包含UID, PWD, Authentication,或Trusted_Connection关键字。

Note: ODBC 驱动程序版本 13.1 上仅支持此身份验证_Windows_。

Azure Active Directory 身份验证示例代码

下面的示例显示了连接到 SQL Server 所需的代码使用 Azure Active Directory 与连接关键字。 请注意,无需更改应用程序代码,然后重试。连接字符串或如果使用,DSN 是唯一使用 AAD 进行身份验证所需的修改:

    ...
    SQLCHAR connString[] = "Driver={ODBC Driver 13 for SQL Server};Server={server};UID=myuser;PWD=myPass;Authentication=ActiveDirectoryPassword"
    ...
    SQLDriverConnect(hDbc, NULL, connString, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);  
    ...

下面的示例显示了连接到 SQL Server 所需的代码使用访问令牌的身份验证使用 Azure Active Directory。 在这种情况下,有必要修改应用程序代码以处理访问令牌并将关联的连接属性设置。

    SQLCHAR connString[] = "Driver={ODBC Driver 13 for SQL Server};Server={server}"
    SQLCHAR accessToken[] = "eyJ0eXAiOi..."; // In the format extracted from an OAuth JSON response
    ...
    DWORD dataSize = 2 * strlen(accessToken);
    ACCESSTOKEN *pAccToken = malloc(sizeof(ACCESSTOKEN) + dataSize);
    pAccToken->dataSize = dataSize;
    // Expand access token with padding bytes
    for(int i = 0, j = 0; i < dataSize; i += 2, j++) {
        pAccToken->data[i] = accessToken[j];
        pAccToken->data[i+1] = 0;
    }
    ...
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_ACCESS_TOKEN, (SQLPOINTER)pAccToken, SQL_IS_POINTER);
    SQLDriverConnect(hDbc, NULL, connString, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);      
    ...
    free(pAccToken);

下面是一个与 Azure Active Directory 交互式身份验证一起使用的连接字符串示例。 请注意它不包含 PWD 字段,因为将使用 Windows Azure 身份验证屏幕输入的密码。

SQLCHAR connString[] = "Driver={ODBC Driver 17 for SQL Server};Server={server};UID=myuser;Authentication=ActiveDirectoryInteractive"

另请参阅

使用 Azure AD 身份验证的 Azure SQL DB 的基于令牌的身份验证支持

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 MightyPen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 11/08/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。