使用验证和TLS / SSL从Tableau Desktop连接_MonogDB 中文网

MongoDB 工具

MongoDB工具 >MongoDB BI连接器 >从Tableau Desktop连接 > 使用验证和TLS / SSL从Tableau Desktop连接

在本页面

先决条件
程序

前提条件¶

Windows
macOs

将Tableau 连接到BI的MongoDB连接器需要执行以下操作：

Tableau 10.3版或更高版本
正在运行的mongod实例
正在运行的mongosqld实例

将Tableau 连接到BI的MongoDB连接器需要执行以下操作：

Tableau 10.4版或更高版本
正在运行的mongod实例
正在运行的mongosqld实例

程序¶

使用TLS / SSL将Tableau连接到BI的MongoDB连接器：

Windows
macOs

1个

下载并安装MongoDB ODBC驱动程序。¶

下载用于BI Connector的MongoDB ODBC驱动程序，然后运行Windows安装程序（.msi）。

2

创建系统DSN。¶

要将Tableau安全连接到BI连接器，需要配置为使用MongoDB ODBC驱动程序的系统 DSN。要创建系统DSN，请按照以下步骤操作：

1个

启动Microsoft ODBC数据源程序。¶

选择适合您的系统和ODBC驱动程序版本的程序版本（64位或32位）。

2

选择标签。¶`System DSN`

3

点击`Add`按钮。¶

Windows ODBC Administrator应用程序的屏幕快照

4

从可用驱动程序列表中选择一个MongoDB ODBC驱动程序。¶

选择MongoDB ODBC 1.1.0 ANSI驱动程序或 MongoDB ODBC 1.1.0 Unicode驱动程序，然后单击“ 确定”。

注意

ANSI ODBC驱动程序可提供最佳性能，但字符集有限。Unicode ODBC驱动程序支持较宽的字符集，但结果可能会稍微降低性能。

5

填写必要的表单字段。¶

单击详细信息按钮以显示表单的下半部分。

需要以下表单字段：

栏位名称	描述
资料来源名称	您选择的名称。
TCP / IP服务器	`mongosqld`运行进程的服务器的地址。如果您在MongoDB Atlas上启用了BI Connector ，则可以`mongosqld`在集群的连接信息中找到正在运行的服务器的主机名。
港口	您的`mongosqld` 进程的端口号。
数据库	要连接的数据库的名称，例如`test`。

6

填写身份验证表单字段。¶

在--auth启用时运行或连接到Atlas实例的BI Connector 时，以下字段必填。

栏位名称描述

用户

经过验证可以使用您的目标数据库的MongoDB用户的用户名。

您可以在用户名后指定以下身份验证选项作为URI样式的查询参数：

连接选项	描述
`source`	指定存储用户凭据的数据库的名称。如果未指定此选项，则BI的MongoDB连接器将默认为与MySQL连接关联的当前数据库。对于将凭据存储委派给其他服务的身份验证机制，例如`PLAIN`（LDAP）或 `GSSAPI`（Kerberos），请将`source`值设置为`$external`。如果`defaultSource`在MongoDB Connector for BI 配置文件中设置了，则不需要。
`mechanism`	指定用于BI的MongoDB连接器用于验证连接的机制。可接受的值包括： SCRAM-SHA-1（默认） SCRAM-SHA-256 普通（LDAP SASL） GSSAPI（Kerberos） LDAP和Kerberos需要MongoDB Enterprise。`$external`使用LDAP或Kerberos时将源设置为。如果`defaultMechanism`在MongoDB Connector for BI 配置文件中设置了，则不需要。注意不支持X.509。

用户名和密码
LDAP
的Kerberos

例

要grace使用admin 数据库以及质询和响应（SCRAM-SHA-1）身份验证机制以用户身份进行身份验证，请以以下格式编写用户名：

grace?source=admin

例

要grace使用LDAP （PLAIN）身份验证机制以用户身份进行身份验证，请以以下格式编写用户名：

grace?mechanism=PLAIN&source=$external

例

要使用Kerberos身份验证机制grace以EXAMPLE.COM Kerberos领域的用户身份进行身份验证，请以以下格式编写用户名：

grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external

有关Kerberos配置的更多信息，请参见为BI Connector配置Kerberos。

密码经过身份验证的用户密码。

认证方式

默认身份验证方法。当将 MongoDB ODBC驱动程序用于BI Connector时，此字段不是必需的。

要将身份验证插件与另一个ODBC驱动程序一起使用，请在此字段中输入字符串mongosql_auth。

7

填写SSL表单字段。¶

通过单击详细信息>>，然后单击SSL选项卡来访问TLS / SSL表单字段。以下参数可用，并且可能是必需的，具体取决于您的 TLS / SSL配置：

栏位名称	描述
SSL密钥	客户端/服务器密钥文件的位置。
SSL证书	客户端/服务器证书文件的位置。
SSL CA文件	包含受信任证书颁发机构列表的文件位置。
SSL密码	包含允许密码列表的文件位置。
SSL模式	设置为`REQUIRED`需要加密通道。如果未提供加密通道，则连接失败。
RSA公钥	包含RSA公钥的PEM文件的位置。

注意

用于Atlas的BI连接器使用TLS / SSL，但不需要在系统DSN中配置任何TLS / SSL设置。

8

单击`Test`按钮以测试ODBC连接。¶

如果连接成功，请单击“ 确定”以添加 DSN。如果连接失败，请检查以确保对连接中命名的数据库的MongoDB用户进行了正确的身份验证。

3

启动Tableau。¶

启动Tableau Desktop应用程序，或者如果它已经在运行，请重新启动它。

4

使用Tableau连接。¶

在“ 到服务器”下的左侧导航中，单击“ 更多…”，然后单击“ 其他数据库（ODBC）”。
在“ 其他数据库（ODBC）”对话框中，从下拉列表中选择您的DSN，然后单击“ 连接”。
连接测试完成后，点击登录。

1个

下载并安装MongoDB ODBC驱动程序。¶

下载用于BI Connector的MongoDB ODBC驱动程序，然后运行macOS安装程序（.dmg）。

2

创建系统DSN。¶

要将Tableau安全连接到BI连接器，需要配置为使用MongoDB ODBC驱动程序的系统 DSN。要创建系统DSN，请按照以下步骤操作：

1个

启动ODBC管理器。¶

注意

ODBC管理器包含在MongoDB ODBC驱动程序中。

重要

MongoDB ODBC驱动程序附带的ODBC管理器1.0.16版本与macOS Catalina不兼容。如果您在Catalina上，请下载并安装最新版本（1.0.19）的ODBC管理器。

2

单击系统DSN，然后单击添加。¶

ODBC管理器DSN配置

3

从可用驱动程序列表中选择一个MongoDB ODBC驱动程序。¶

选择MongoDB ANSI ODBC驱动程序或 MongoDB Unicode ODBC驱动程序，然后单击OK。

注意

ANSI ODBC驱动程序可提供最佳性能，但字符集有限。Unicode ODBC驱动程序支持较宽的字符集，但结果可能会稍微降低性能。

4

输入数据源名称（DSN）。¶

（可选）输入描述。

注意

不要关闭设置窗口。继续进行下一步。

5

添加必要的关键字。¶

通过单击“ 添加”按钮添加关键字值对。
双击修改关键字，输入所需的关键字，然后按Enter。
双击值，输入所需的关键字，然后按Enter，以修改值。

使用上述过程，添加以下关键字：

关键词	值
服务器	MongoDB Connector for BI主机的主机名或IP地址。重要用于`127.0.0.1`通过TCP连接到localhost。指定IP地址以外的其他值将尝试通过Unix套接字进行连接。
港口	MongoDB Connector for BI 的IANA 端口号。默认值为`3307`。
数据库	连接后要使用的数据库。注意与Microsoft Excel连接时必需。

有关ODBC参数的完整列表，请参见连接器/ ODBC连接参数。

例如，您的用户DSN配置应类似于以下内容：

ODBC管理器DSN配置

注意

不要关闭设置窗口。继续进行下一步。

6

添加身份验证关键字。¶

通过单击“ 添加”按钮添加关键字值对。
双击修改关键字，输入所需的关键字，然后按Enter。
双击值，输入所需的关键字，然后按Enter，以修改值。

使用上述过程，添加以下关键字：

关键词值

UID

可以访问活动的MongoDB Connector for BI数据库的用户的用户名。

您可以在用户名后指定以下身份验证选项作为URI样式的查询参数：

连接选项	描述
`source`	指定存储用户凭据的数据库的名称。如果未指定此选项，则BI的MongoDB连接器将默认为与MySQL连接关联的当前数据库。对于将凭据存储委派给其他服务的身份验证机制，例如`PLAIN`（LDAP）或 `GSSAPI`（Kerberos），请将`source`值设置为`$external`。如果`defaultSource`在MongoDB Connector for BI 配置文件中设置了，则不需要。
`mechanism`	指定用于BI的MongoDB连接器用于验证连接的机制。可接受的值包括： SCRAM-SHA-1（默认） SCRAM-SHA-256 普通（LDAP SASL） GSSAPI（Kerberos） LDAP和Kerberos需要MongoDB Enterprise。`$external`使用LDAP或Kerberos时将源设置为。如果`defaultMechanism`在MongoDB Connector for BI 配置文件中设置了，则不需要。注意不支持X.509。

用户名和密码
LDAP
的Kerberos

例

要grace使用admin 数据库以及质询和响应（SCRAM-SHA-1）身份验证机制以用户身份进行身份验证，请以以下格式编写用户名：

grace?source=admin

例

要grace使用LDAP （PLAIN）身份验证机制以用户身份进行身份验证，请以以下格式编写用户名：

grace?mechanism=PLAIN&source=$external

例

要使用Kerberos身份验证机制grace以EXAMPLE.COM Kerberos领域的用户身份进行身份验证，请以以下格式编写用户名：

grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external

有关Kerberos配置的更多信息，请参见为BI Connector配置Kerberos。

残障人士 与UID关联的密码。

有关ODBC参数的完整列表，请参见连接器/ ODBC连接参数。

例如，您的用户DSN配置应类似于以下内容：

ODBC管理器DSN配置

7

添加SSL关键字。¶

通过单击“ 添加”按钮添加关键字值对。
双击修改关键字，输入所需的关键字，然后按Enter。
双击值，输入所需的关键字，然后按Enter，以修改值。

注意

用于Atlas的BI连接器使用TLS / SSL，但不需要在系统DSN中配置任何TLS / SSL设置。

使用上述步骤，根据您的TLS / SSL配置添加以下关键字：

关键词	值
`SSLKEY`	.pem密钥文件的路径。
`SSLCERT`	SSL证书的路径。
`SSLMODE`	设为`REQUIRED`。
`SSLCA`	SSL证书颁发机构文件的路径。
`SSLCIPHER`	包含允许密码列表的文件路径。
`RSAKEY`	包含RSA公钥的PEM文件的路径。
`ENABLE_CLEARTEXT_PLUGIN`	设置为`1`启用明文身份验证。

注意

如果要连接Microsoft Excel，则证书必须位于/Library/ODBC/目录中。

有关ODBC参数的完整列表，请参见连接器/ ODBC连接参数。

例如，您的用户DSN配置应类似于以下内容：

ODBC管理器DSN配置

8

单击“ 确定”完成创建DSN。¶

3

启动Tableau。¶

启动Tableau Desktop应用程序，或者如果它已经在运行，请重新启动它。

4

使用Tableau连接。¶

在“ 到服务器”下的左侧导航中，单击“ 更多…”，然后单击“ 其他数据库（ODBC）”。
在“ 其他数据库（ODBC）”对话框中，从下拉列表中选择您的DSN，然后单击“ 连接”。
连接测试完成后，点击登录。