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 废弃。
JDBC 驱动程序配置
MongoDB JDBC 驱动程序支持 MongoDB 支持的所有身份验证机制。要了解更多信息,请参阅身份验证机制。如果配置了它,驱动程序也支持 TLS/SSL 连接。要了解更多,请参阅 TLS/SSL 配置。
以下部分介绍了针对509 JDBC 驱动程序的连接属性,这些属性用于配置 X. 、Kerberos (GSSAPI) 和 OIDC 身份验证。这些属性适用于 Atlas 和自管理的 MongoDB Enterprise 部署。
X.509 身份验证
MongoDB JDBC 驱动程序支持 X.509 客户端证书身份验证。以下属性控制驱动程序如何配置客户端证书和 CA 信任:
属性 | 用途 |
|---|---|
| 包含客户端证书和私钥的 PEM 文件的路径。适用于未加密或已加密的 PKCS #1 和 PKCS #8 密钥。 |
| 可选。包含一个或多个可信的 X.509 证书的 PEM 文件的路径。设置后,驱动程序仅接受由这些 CA 签名的证书。 |
| 起着不同的作用,具体取决于您是否设置了 |
配置 X.509 身份验证时,请考虑以下行为:
如果设置
x509pempath,则其优先于password属性中的任何 PEM 内容。如果未设置
tlscafile,则驱动程序将使用默认 Java虚拟机(JVM) 信任库。PEM 内容必须同时包含客户端证书及其对应的私钥,无论是通过
x509pempath提供,还是在password属性中提供。
Kerberos (GSSAPI) 身份验证
MongoDB JDBC 驱动程序支持 GSSAPI,用于基于 Kerberos 的身份验证。该机制要求您在驱动程序外配置 Kerberos 和 JAAS 设置。以下属性控制驱动程序使用该配置的方式:
属性 | 说明 |
|---|---|
| JAAS 配置文件的路径,例如 |
| 指定在 JAAS 配置中定义的登录上下文名称。 |
| 当设置为 |
| 控制驱动程序是否使用原生 GSSAPI 库。接受 |
OIDC 身份验证
MongoDB JDBC 驱动程序根据您设置的身份验证机制属性,区分人工启动和机器自动化的 OIDC 流:
人流:默认行为。需要通过浏览器登录进行用户交互。
机器流程:用于自动化环境,例如 GCP 工作负载身份、Azure 托管身份和 Kubernetes。要启用机器流程,请设置
ENVIRONMENT和TOKEN_RESOURCE参数。
安全考虑因素
为SQL接口配置身份验证时,请考虑以下安全最佳实践:
使用强大的身份验证机制:在可能的情况下,优先使用 X.509、OIDC 或 Kerberos,而不是基于密码的身份验证。
启用 TLS加密:始终使用 TLS 保护传输中的凭证和数据。
遵循最小权限原则:仅授予用户执行任务所需的最低权限。
安全档案存储:切勿在连接字符串中对凭证进行硬编码。使用环境变量、凭证文件或安全凭证管理系统。
定期凭证轮换:实现定期轮换密码和证书。
监控身份验证事件:启用Atlas 审核记录以追踪身份验证尝试和失败。