Zimbra 云应用

您可以使用安全断言标记语言 (SAML) 2.0 标准为多款云应用配置单点登录 (SSO)。您设置单点登录后,用户可以使用自己的 Google Workspace 凭据通过单点登录功能登录应用。

使用 SAML 为 Zimbra 设置单点登录

您必须以超级用户身份登录,才能执行此任务。

第 1 步:将 Google 设置为 SAML 身份提供方

  1. 在 Google 管理控制台中,依次点击“菜单”图标 然后 应用然后Web 应用和移动应用

    您必须以超级用户身份登录,才能执行此任务。

  2. 依次点击添加应用然后搜索应用
  3. 在“输入应用名称”中,输入 Zimbra
  4. 在搜索结果中,将光标指向 Zimbra,然后点击选择
  5. Google 身份提供方详细信息窗口中,对于方法 2:复制单点登录网址、实体 ID 和证书
    1. 点击 SSO 网址旁边的“复制”图标 并保存网址。
    2. 点击实体 ID 旁边的“复制”图标 并保存网址。
    3. 点击证书旁边的“复制”图标 并保存证书。

    您需要这些详细信息才能完成 Zimbra 中的设置。

  6. 点击继续
  7. 服务提供商详细信息页面上,对于 ACS 网址实体 ID,将 {your-hostname} 替换为您用来访问 Zimbra 实例的网址。
  8. 点击继续
  9. (可选)如需将 Google 目录属性映射到相应的应用属性,请在属性映射窗口中执行以下操作:
    1. 点击添加映射
    2. 点击选择字段然后 选择一个 Google 目录属性。
    3. 应用属性部分,输入相应的应用属性。
  10. (可选)如需输入与此应用相关的群组名称,请执行以下操作:
    1. 对于群组成员资格(可选),点击搜索群组,输入群组名称的一个或多个字母,然后选择群组名称。
    2. 根据需要添加其他群组(最多 75 个群组)。
    3. 对于应用属性,输入服务提供商的相应群组属性名称。

    无论您输入多少个群组名称,SAML 回复都仅包含用户所属(直接或间接)的群组。如需了解详情,请参阅群组成员资格映射简介

  11. 点击完成

第 2 步:将 Zimbra 设置为 SAML 2.0 服务提供商

  1. 使用 root 权限登录 Zimbra 服务器控制台,并输入以下命令:
    • mkdir /opt/zimbra/lib/ext/saml
    • cp /opt/zimbra/extensions-network-extra/saml/samlextn.jar /opt/zimbra/lib/ext/saml/
  2. 退出登录,然后以 zimbra 用户身份重新登录 Zimbra 服务器。
  3. 在以下证书中,将 {domain-name} 替换为您的 Google 域名,将 {certificate} 替换为您在第 1 步下载的证书内容:

    zmprov md {domain-name} zimbraMyoneloginSamlSigningCert "{certificate}"

  4. (可选)如需更新登录和退出网址,请在以下证书中将 {domain-name} 替换为您的 Google 域名,并将 {SSO-网址} 替换为您在第 1 步下载的 SSO 网址。
    • zmprov md {domain-name} zimbraWebClientLoginURL {SSO-URL}
    • zmprov md {domain-name} zimbraWebClientLogoutURL {SSO-URL}
  5. 输入以下命令:
    • zmprov mcf zimbraCsrfRefererCheckEnabled FALSE
    • service zimbra restart
  6. (可选)如需确认您的设置,请输入以下命令,将 {domain-name} 替换为您的 Google 域名:
    • zmprov gd {domain-name} zimbraMyoneloginSamlSigningCert
    • zmprov gd {domain-name} zimbraWebClientLogin网址
    • zmprov gd {domain-name} zimbraWebClientLogout网址
    • zmprov gcf zimbraCsrfRefererCheckEnabled

第 3 步:为用户启用应用

准备工作:如要为特定用户启用或停用服务,请将其账号添加到某个组织部门(按部门控制访问权限)或某个访问权限群组(跨部门或在部门内控制访问权限)。
  1. 在 Google 管理控制台中,依次点击“菜单”图标 然后 应用然后Web 应用和移动应用

    您必须以超级用户身份登录,才能执行此任务。

  2. 点击 Zimbra
  3. 点击用户访问权限
  4. 如要为组织中所有人启用或停用某项服务,请点击对所有人启用对所有人停用,然后点击保存

  5. (可选)如要为某个组织部门启用或停用服务,请执行以下操作:
    1. 在左侧,选择所需组织部门。
    2. 如要更改服务状态,请选择启用停用
    3. 根据需要选择相应操作:
      • 如果“服务状态”被设为已继承,而您想保留更新后的设置(即使在上级组织的设置发生变化时也保留该设置),请点击覆盖
      • 如果服务状态被设为已覆盖,您可以点击继承以恢复为与上级组织相同的设置,也可以点击保存以保留新设置,而不受上级组织的设置变更所影响。
        详细了解组织结构
  6. (可选)如要为一个或多个组织部门内的一组用户启用某项服务,请选择一个访问权限群组。如需了解详情,请参阅通过访问权限群组自定义服务访问权限
  7. 确保您的 Zimbra 用户账号电子邮件域名与贵组织受管理的 Google 账号的主域名一致。

第 4 步:确认单点登录是否正常运行

Zimbra 同时支持由身份提供方发起和由服务提供商发起的单点登录。

验证由身份提供方发起的单点登录

  1. 在 Google 管理控制台中,依次点击“菜单”图标 然后 应用然后Web 应用和移动应用

    您必须以超级用户身份登录,才能执行此任务。

  2. 点击 Zimbra
  3. Zimbra 部分,点击测试 SAML 登录

    系统应该会在另一标签页中打开该应用。如果未打开,请根据错误消息进行问题排查,然后重试。 如需详细了解问题排查,请参阅 SAML 应用错误消息

验证由服务提供商发起的单点登录

  1. 关闭所有浏览器窗口。
  2. 前往您的 Zimbra 实例。

    系统应该会将您重定向至 Google 登录页面。

  3. 输入您的 Google Workspace 用户名和密码。

您的凭据通过身份验证后,该应用应该会打开。


Google、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。