MongoDB身份验证插件嵌入在MongoDB BI Connector ODBC驱动程序 中。如果您的BI工具通过 DSN 使用MongoDB BI Connector ODBC驱动程序进行连接,或直接使用驾驶员进行连接,则无需单独安装身份验证插件。如果您的BI工具不使用 ODBC驾驶员并接受身份验证插件(例如MySQL Shell) ,请安装独立运行身份验证插件。
mongosql_auth插件允许客户端使用以下身份验证机制之一,通过 BI Connector 和在启用身份验证的情况下运行的 MongoDB 部署进行身份验证:
SCRAM-SHA-1SCRAM-SHA-256PLAIN(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 及更高版本不兼容。
安装插件
下载MySQL 5.7.x 安装程序。所需安装的产品取决于您的连接方法:
连接方法所需的 MySQL 组件使用 MySQL Connector/ODBC 驱动程序的DSN(数据源名称)
MySQL Connector/ODBC
MySQL Shell
MySQL Shell
注意
安装适用于您的操作系统的 MySQL 组件版本(64 位或 32 位)。
下载
mongosql_auth插件组件 .msi 安装程序 并安装mongosql_auth插件组件。根据您的 Windows 版本,该插件会安装到以下目录之一:平台默认位置32 位 Windows
C:\Program Files (x86)\MySQL\MySQL Server 5.7\lib\plugin64 位 Windows
C:\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版本的符号链接。
下载MySQL 5.7.x 安装程序并安装MySQL Community Server,其中包括MySQL Shell。
从版本页面下载
mongosql_auth插件库。下载后,将文件
mongosql_auth.so移动到以下任一位置:<mysql-home>/lib/plugin/目录。<mysql-home>的默认位置因平台而异。要查找插件目录的位置,请在命令行中运行以下命令:
mysql_config --plugindir
- 或 -
如果您为MySQL客户端提供
plugin-dir=<your-install-dir>选项,则为您选择的目录。
下载MySQL 5.7.x 安装程序并安装MySQL Community Server,其中包括MySQL Shell。
从版本页面下载
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 驱动程序兼容。 安装目录因安装的版本而异。