驱动程序兼容性

MongoDB 兼容性

以下兼容性表指定了与特定版本的 MongoDB 一起使用的 MongoDB Ruby 驱动程序的推荐版本。除非另有说明，否则指定的驱动程序版本会公开或利用相应服务器版本中添加的功能。

MongoDB 服务器版本通常向后兼容，这意味着特定版本的驱动程序通常可与较新版本的服务器配合使用，但可能无法利用较新版本服务器中发布的功能。

第一列列出了驱动程序版本。其他列中的“D”表示已弃用对该 MongoDB 版本的支持，并将在未来的驱动程序版本中删除。

此驱动程序不支持早期版本的 MongoDB。

Ruby 兼容性

以下兼容性表指定了各个版本的 MongoDB Ruby 驱动程序支持的 Ruby 版本。

第一列列出了驱动程序版本。 列中的“D”表示已弃用对该 Ruby 版本的支持。

该驱动程序不支持旧版本的 Ruby。

Rails/ActiveSupport 兼容性

Ruby 驱动程序不依赖于 ActiveSupport。但是，当应用程序使用 ActiveSupport 或 Ruby on Rails 时，必须加载驱动程序的 ActiveSupport 兼容性代码才能确保时间序列化等行为的正确性：

require 'mongo'
require 'mongo/active_support'

使用 Mongoid 7的应用程序。 0 。 6或更新版本不需要显式加载驱动程序的 ActiveSupport 代码，因为 Mongoid 会自动执行此操作。

TLS/SSL 兼容性

驱动程序将利用底层 Ruby openssl扩展支持的协议。 反过来， openssl扩展通常会公开操作系统的 OpenSSL 库中存在的功能。

行业最佳实践和某些法规要求使用 TLS 1.1或更高版本。 某些操作系统或版本可能无法提供足够新的 OpenSSL 版本，无法支持这些 TLS 版本。

早于10.13 (High Sierra) 的 macOS 用户需要从 RVM 安装 Ruby , 自制程序 , macports ，或其他类似来源。请参阅 ruby-lang.org 上的安装信息 了解更多选项。

Linux 或其他非 macOS Unix 的用户可以按以下方式检查其 OpenSSL 版本：

openssl version

如果版本号小于1 。 0 。 1对 TLS 的支持1 . 1或更高版本不可用。请联系您的操作系统供应商以获取解决方案或升级到较新的发行版。

您可以通过执行以下命令来检查 Ruby 解释器：

ruby -e "require 'net/http'; require 'json'; puts JSON.parse(Net::HTTP.get(URI('https://www.howsmyssl.com/a/check')))['tls_version']"

您应该会看到“TLS 1 .X”，其中 X >= 1 。

您可以 在此处 详细了解 TLS 版本及其安全隐患 。

Atlas 兼容性

驱动程序版本2.6.1 使用 MongoDB Atlas 时，建议使用 MongoDB Atlas 或更高版本，因为此版本在使用 TLS 连接时具有显着的性能改进，并且所有 Atlas 连接都使用 TLS。

在 JRuby 上运行并连接到 Atlas 免费套餐时， 驱动程序版本为 或更高版本以及 2.6.4Java8 或更高版本。

mongo_kerberos 兼容性

以下兼容性表指定了与特定版本的驱动程序一起使用的 mongo_kerberos 库的版本。

JRuby 和 Kerberos 身份验证

如果mongo_kerberos gem 用于通过 JRuby 进行 Kerberos 身份验证，则 JVM 系统属性 "sun.security.jgss.native" 将设置为 "true"，以便于使用 TGT 的系统缓存（例如 通过kinit获得的 TGT）。 JGSS 库的任何其他使用也会受此设置的影响，这意味着系统缓存中的任何 TGT 也可用于获取 Kerberos 档案。

JRuby 和 TLS 连接

由于 JRuby 限制：

• 不支持 ECDSA 服务器证书。

• 不执行 OCSP 端点检查。