C 身份验证插件
在此页面上
MongoDB身份验证插件嵌入在 MongoDB BI Connector ODBC驱动程序 中 。如果您的BI工具使用 MongoDB BI Connector ODBC驱动程序 进行连接 直接通过 DSN 或驾驶员进行身份验证,无需单独安装身份验证插件。如果您的BI 工具不使用 ODBC驾驶员并接受身份验证插件(例如MySQLshell ),请安装独立运行身份验证插件。
mongosql_auth
插件允许客户端使用以下身份验证机制之一,通过 BI Connector 和在启用身份验证的情况下运行的 MongoDB 部署进行身份验证:
SCRAM-SHA-1
SCRAM-SHA-256
PLAIN
(LDAP)GSSAPI
(Kerberos)
注意
SCRAM-SHA-1
和SCRAM-SHA-256
机制对客户端插件中的密码进行哈希处理;但是,所有其他数据均为明文形式。 如果可能,请与加密连接一起使用。PLAIN
机制以明文形式发送密码。 通过PLAIN
机制使用加密连接。
支持的平台
该插件在以下平台上构建和测试:
Windows 2008 R2(32 位和 64 位)
macOS 10.12(64 位)
Ubuntu 14.04(64 位)
RHEL 7.0(64 位)
重要
测试环境
C 身份验证插件是针对 MySQL 5.7.X 社区版(64 位)开发的,并使用 MySQL 5.7.X 社区版和最新版本的 MongoDB Connector for BI 进行了测试。该插件与 MySQL 服务器或 Connector/ODBC 驱动程序版本 8 及更高版本不兼容。
安装插件
下载 MySQL5.7 .x 安装程序 。所需安装的产品取决于您的连接方法:
连接方法所需的 MySQL 组件使用 MySQL Connector/ODBC 驱动程序的DSN(数据源名称)MySQL Connector/ODBCMySQL ShellMySQL Shell注意
安装适用于您的操作系统的 MySQL 组件版本(64 位或 32 位)。
mongosql_auth
下载 插件组件 .msi 安装程序 并安装mongosql_auth
插件组件。根据您的 Windows 版本,该插件会安装到以下目录之一:平台默认位置32 位 WindowsC:\Program Files (x86)\MySQL\MySQL Server 5.7\lib\plugin
64 位 WindowsC:\Program Files\MySQL\MySQL Server 5.7\lib\plugin
注意
macOS Catalina 用户:
C 身份验证插件使用 OpenSSL v 1.0 。 如果安装了 OpenSSL v 1.1或更高版本,则必须降级到 v 1.0才能使用 C 身份验证插件。 您可以使用以下命令执行此操作:
brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/30fd2b68feb458656c2da2b91e577960b11c42f4/Formula/openssl.rb
如果您同时安装了 OpenSSL 的1.0和1.1版本,请创建从/usr/local/opt/openssl
指向1.0版本的符号链接,并删除指向1.1版本的符号链接。
MySQL5.7下载 .x 安装程序 并安装 MySQLCommunityMongoDB Server ,其中包括MySQLshell 。
从 版本页面 下载
mongosql_auth
插件库 。下载后,将文件
mongosql_auth.so
移动到以下任一位置:<mysql-home>/lib/plugin/
目录。<mysql-home>
的默认位置因平台而异。要查找插件目录的位置,请在命令行中运行以下命令:
mysql_config --plugindir
- 或 -
如果您为MySQL客户端提供
plugin-dir=<your-install-dir>
选项,则为您选择的目录。
MySQL5.7下载 .x 安装程序 并安装 MySQLCommunityMongoDB Server ,其中包括MySQLshell 。
从 版本页面 下载
mongosql_auth
插件库 。下载后,将文件
mongosql_auth.so
移动到以下任一位置:<mysql-home>/lib/plugin/
目录。<mysql-home>
的默认位置因平台而异。要查找插件目录的位置,请在命令行中运行以下命令:
mysql_config --plugindir
- 或 -
如果您为MySQL客户端提供
plugin-dir=<your-install-dir>
选项,则为您选择的目录。
使用插件进行身份验证
在使用身份验证插件之前,必须为 MongoDB 设置经过身份验证的用户。 有关创建经过身份验证的用户的更多信息,请参阅启用身份验证。 如果您使用的是 Atlas 托管的 BI Connector,请参阅配置数据库用户。
使用 C 身份验证插件库的过程因 SQL 客户端而异。 可以通过以下方法之一使用 C 身份验证插件:
使用 MySQL Connector/ODBC 驱动程序的DSN(数据源名称) 。 有关详细信息,请参阅创建系统 DSN。
MySQL Shell 的
--default-auth
选项。 有关更多信息,请参阅从 MySQL 客户端连接。
该插件可与 32 位或 64 位版本的 MySQL Shell 和 MySQL Connector/ODBC 驱动程序兼容。 安装目录因安装的版本而异。