对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

SQL接口身份验证

SQL 接口支持多种身份验证机制,以连接到您的 MongoDB 部署。对于 Atlas 专用集群、Atlas 联合数据库实例和自管理的 MongoDB Enterprise 部署,此页面包括支持的身份验证方法、组件兼容性和部署可用性。

下表显示了每个SQL接口组件支持的身份验证机制:

组件
SCRAM
x.509
LDAP
GSSAPI
AWS IAM
OIDC

MongoDB SQL模式构建器

是

是

是

是

是

是

ODBC 驱动程序

是

是

是

是

是

是

JDBC 驱动程序

是

是

是

是

是

是

Power BI Desktop

是

是

是

是

是

是

Power BI网关

是

No

No

No

No

No

Tableau Desktop

是

是

是

是

是

是

Tableau Server

是

是

No

No

No

No

Tableau Cloud

是

No

No

No

No

No

注意

不是所有第三方 BI 工具都支持这些身份验证选项,即使 MongoDB 驱动程序支持这些选项。测试您想要使用的功能,以确认它们可以与您的特定 BI 工具一起使用。

下表显示了每种MongoDB 部署类型可用的身份验证机制:

身份验证机制
专用集群
联合数据库实例

SCRAM

是

是

是

x.509

是

是

是

LDAP

是

No

是

Kerberos (GSSAPI)

No

No

是

AWS IAM

是

是

No

OIDC

是

是

是

重要

从 MongoDB 8.0 开始,LDAP 身份验证和授权已弃用。LDAP 仍可用,并在整个 MongoDB 8 中继续运行而无需更改,但未来的主要版本将删除它。考虑迁移到 OIDC 或其他支持的身份验证机制。有关详细信息,请参阅 LDAP 废弃。

MongoDB JDBC 驱动程序支持 MongoDB 支持的所有身份验证机制。要了解更多信息,请参阅身份验证机制。如果配置了它,驱动程序也支持 TLS/SSL 连接。要了解更多,请参阅 TLS/SSL 配置。

以下部分介绍了针对509 JDBC 驱动程序的连接属性,这些属性用于配置 X. 、Kerberos (GSSAPI) 和 OIDC 身份验证。这些属性适用于 Atlas 和自管理的 MongoDB Enterprise 部署。

MongoDB JDBC 驱动程序支持 X.509 客户端证书身份验证。以下属性控制驱动程序如何配置客户端证书和 CA 信任:

属性
用途

x509pempath

包含客户端证书和私钥的 PEM 文件的路径。适用于未加密或已加密的 PKCS #1 和 PKCS #8 密钥。

tlscafile

可选。包含一个或多个可信的 X.509 证书的 PEM 文件的路径。设置后,驱动程序仅接受由这些 CA 签名的证书。

password

起着不同的作用,具体取决于您是否设置了 x509pempath。当您设置 x509pempath 时,password 是加密 PEM 文件的密码。当您未设置 x509pempath 时,password 可以包含由未加密证书和私钥组成的原始 PEM 内容,或用于加密 PEM 数据的形式为 {"pem": "...", "passphrase": "..."} 的 JSON 对象。

配置 X.509 身份验证时,请考虑以下行为:

  • 如果设置 x509pempath,则其优先于 password 属性中的任何 PEM 内容。

  • 如果未设置 tlscafile,则驱动程序将使用默认 Java虚拟机(JVM) 信任库。

  • PEM 内容必须同时包含客户端证书及其对应的私钥,无论是通过 x509pempath 提供,还是在 password 属性中提供。

MongoDB JDBC 驱动程序支持 GSSAPI,用于基于 Kerberos 的身份验证。该机制要求您在驱动程序外配置 Kerberos 和 JAAS 设置。以下属性控制驱动程序使用该配置的方式:

属性
说明

jaasconfigpath

JAAS 配置文件的路径,例如 jaas.config。如果您未设置此属性,驱动程序将使用默认的 Java 虚拟机(JVM) JAAS 配置。

gssapilogincontextname

指定在 JAAS 配置中定义的登录上下文名称。

gssapiserverauth

当设置为 true 时,在 SASL 协商过程中启用服务器身份验证。

gssnativemode

控制驱动程序是否使用原生 GSSAPI 库。接受 true 或 false。

MongoDB JDBC 驱动程序根据您设置的身份验证机制属性,区分人工启动和机器自动化的 OIDC 流:

  • 人流:默认行为。需要通过浏览器登录进行用户交互。

  • 机器流程:用于自动化环境,例如 GCP 工作负载身份、Azure 托管身份和 Kubernetes。要启用机器流程,请设置 ENVIRONMENT 和 TOKEN_RESOURCE 参数。

为SQL接口配置身份验证时,请考虑以下安全最佳实践:

  • 使用强大的身份验证机制:在可能的情况下,优先使用 X.509、OIDC 或 Kerberos,而不是基于密码的身份验证。

  • 启用 TLS加密:始终使用 TLS 保护传输中的凭证和数据。

  • 遵循最小权限原则:仅授予用户执行任务所需的最低权限。

  • 安全档案存储:切勿在连接字符串中对凭证进行硬编码。使用环境变量、凭证文件或安全凭证管理系统。

  • 定期凭证轮换:实现定期轮换密码和证书。

  • 监控身份验证事件:启用Atlas 审核记录以追踪身份验证尝试和失败。