LDAP

Metabase 支持使用轻型目录访问协议 (LDAP) 进行身份验证。

您可以在管理设置 > 设置 > 身份验证下找到 SSO 选项。

必需的 LDAP 属性

您需要使用以下属性设置 LDAP 目录

  • 电子邮件(默认为 mail 属性)
  • 名字(默认为 givenName 属性)
  • 姓氏(默认为 sn 属性)。

如果您的 LDAP 设置对这些使用其他属性,您可以在表单的“属性”部分下编辑此设置。

Attributes

您的 LDAP 目录必须为每个将成为 Metabase 用户的条目填充电子邮件字段,否则 Metabase 将无法创建帐户,该人员也无法登录。如果缺少名字或姓氏字段,Metabase 将使用默认值“未知”,并且该人员可以在其账户设置中更改其姓名。

启用 LDAP 身份验证

管理设置 > 设置 > 身份验证选项卡中,转到 LDAP 部分,然后单击设置。单击表单顶部的切换按钮以启用 LDAP,然后使用相关详细信息填写表单。

用户配置

当人员通过 LDAP 登录时,Metabase 可以自动为他们创建一个 Metabase 账户(如果他们还没有 Metabase 账户)。

服务器设置

  • LDAP 主机。您的服务器名称。例如,ldap.yourdomain.org
  • LDAP 端口。服务器端口,如果使用 SSL,通常为 389 或 636。
  • LDAP 安全设置。选项为“无”、“SSL”或“StarTLS”。
  • LDAP 管理员用户名。要绑定为的专有名称(如果有)。此用户将用于查找有关其他用户的信息。
  • LDAP 管理员密码。

然后保存您的更改。Metabase 将自动从您的 LDAP 目录中拉取必需的属性

用户架构

此同一页面上的用户架构部分是您可以调整与 Metabase 如何连接到 LDAP 服务器以验证用户身份相关的设置的位置。

用户搜索库

应使用 LDAP 服务器中作为搜索用户起点的条目的专有名称 (DN) 填写用户搜索库字段。

例如,假设您正在为您的公司 WidgetCo 配置 LDAP,其中您的基本 DN 是 dc=widgetco,dc=com。如果员工的条目都存储在 LDAP 服务器中名为 People 的组织单元中,您将需要为用户搜索库字段提供 DN ou=People,dc=widgetco,dc=com。这告诉 Metabase 开始在该位置内的 LDAP 服务器中搜索匹配的条目。

用户筛选器

您将在用户筛选器字段中看到以下灰显的默认值

(&(objectClass=inetOrgPerson)(|(uid={login})(mail={login})))

当人员登录 Metabase 时,此命令确认他们提供的登录名与 LDAP 服务器中的 UID 电子邮件字段匹配,并且匹配的条目的 objectClass 为 inetOrgPerson

此默认命令适用于大多数 LDAP 服务器,因为 inetOrgPerson 是一种广泛采用的 objectClass。但是,例如,如果您的公司使用不同的 objectClass 对员工进行分类,则此字段是您可以设置不同命令的位置,以指示 Metabase 在人员登录时如何查找和验证 LDAP 条目。

LDAP 组映射

在人员通过 SSO 登录后,手动将人员分配到 Metabase 中的可能会很繁琐。相反,您可以通过启用组映射来利用 LDAP 目录中已存在的组。

滚动到同一 LDAP 设置页面上的组架构,然后单击切换按钮以启用组映射。选择编辑映射将弹出一个模态框,您可以在其中创建和编辑映射,指定哪个 LDAP 组对应于哪个 Metabase 组。

如下所示,如果您在 LDAP 服务器和 Metabase 实例中都有一个 Accounting 组,您只需提供 LDAP 服务器中的专有名称(在本例中为 cn=Accounting,ou=Groups,dc=widgetco,dc=com),然后从现有 Metabase 组的下拉列表中选择其匹配项。

Group Mapping

关于组映射,需要记住以下几点

  • 管理员组的工作方式与任何其他组相同。
  • 基于 LDAP 映射对人员的组成员身份进行的更新不是即时的;更改仅在人员重新登录才会生效。
  • 人员只会添加到或从映射组中删除;同步对 Metabase 中没有 LDAP 映射的组没有影响。

LDAP 组成员身份筛选器

LDAP 高级功能仅在 Pro企业版 计划(自托管和 Metabase 云上)中可用。

组成员身份查找筛选器。占位符 {dn} 和 {uid} 将分别替换为用户的专有名称和 UID。

将用户属性与 LDAP 同步

LDAP 高级功能仅在 Pro企业版 计划(自托管和 Metabase 云上)中可用。

您可以从 LDAP 目录管理用户属性,例如姓名、电子邮件和角色。当您设置数据沙盒时,您的 LDAP 目录将能够将这些属性传递到 Metabase。

登录问题故障排除

延伸阅读

阅读其他 Metabase 版本的文档。