为帮助中心设置SAML单点登录

为帮助中心设置SAML单点登录

安全断言置标语言 (SAML) 是一种用于在应用程序之间，特别是身份提供者（IdP）如OneLogin、Okta、PingIdentity和服务提供者（如Zoho Desk），来交换认证和授权数据的机制。您可以为终端用户配置基于SAML的单点登录（SSO），以便他们可以访问您的帮助中心，而不会被提示输入单独的登录凭证。

注意: 
  • SAML单点登录不可用于免费版。
  • 只有管理员角色的用户能够管理SAML设置。 
  • SAML认证只会应用于终端用户账户，而非您客服人员的账户。
  • 您可以设置远程认证或者SAML单点登录，但不可二者同时。 
  • 在启用了SAML的帮助中心，终端用户无法自行注册或者更改他们的账户密码。

SAML如何工作 
SAML单点登录认证涉及服务提供商，在本例中为Zoho Desk和身份提供商。启用SAML后，终端用户管理和认证将通过您公司的身份提供商（IDP）进行处理。请求访问Zoho Desk帮助中心的终端用户将被重定向到您的身份提供商进行身份验证。身份提供者对终端用户进行身份验证，然后生成身份验证断言，该断言表示用户已经过身份验证。收到断言后，终端户将重定向回您的帮助中心，然后无缝登录。作为您的可信身份提供商进行的单点身份验证，SAML可确保您的终端用户凭据在公司的防火墙边界内是安全的。

设置SAML SSO 
第三方身份提供商会提供SAML的配置详细信息。请注意，您必须使用管理员身份登录之后才能在Zoho Desk中设置SAML单点登录。 
  1. 点击顶部栏内的设置图标 (  ) 。
  2. 点击渠道 菜单下的帮助中心。
  3. 选择要在其中使用SAML对用户进行身份验证的帮助中心。
  4. 点击帮助中心 子菜单下的用户身份认证。
  5. 在帮助中心SAML 页面，提供以下详细信息: 
    • 远程登录URL : 输入您IDP的远程登录URL，进而，当您的终端用户登录到帮助中心时，Zoho Desk会将他们重定向到那里。
    • 远程退出URL : 输入您IDP的远程退出URL，进而，当您的终端用户尝试退出帮助中心时，Zoho Desk会将他们重定向。
    • 重置密码URL : 输入您IDP的重置密码URL，进而，当您的终端用户尝试更改帮助中心密码时，Zoho Desk会将他们重定向到那里。 
    • 公开密钥 : 以文本格式上传公开的X.509证书。我们将使用证书中包含的公开密钥来验证您的身份提供商是否已提交所有收到的SAML身份验证请求。
    • 算法 : 在RSA和DSA之间选择一种算法，您的IDP将会使用其生成公开密钥和证书。
  6. 点击保存。 
在点击保存之前，您会看见新字段(如帮助中心SAML请求URL等) 和列出的值。将那些值复制到您的身份提供商，以确保您的IDP能够与启用SAML的Zoho Desk进行通信。

禁用SAML SSO 
通过禁用SAML配置，您可以返回使用Zoho Desk的内置身份验证，或切换到其他身份提供程序（IdP）。禁用SAML后，终端用户将需要Zoho Desk帐户密码才能登录帮助中心。在禁用SAML单点登录时，请记住以下含义: 
  • 在启用SAML单点登录之前，拥有您帮助中心账户密码的终端用户能够登录。 
  • 在启用SAML单点登录之后，已注册您帮助中心的终端用户在下次登录时需要重置密码。

禁用SAML单点登录: 
  1. 点击顶部栏内的设置图标 (  ) 。
  2. 点击渠道 菜单下的帮助中心。 
  3. 选择要在其中禁用SAML单点登录的帮助中心。
  4. 点击帮助中心 子菜单下的用户身份认证。
  5. 在帮助中心SAML 页面，点击屏幕右上角的禁用。 
  6. 点击继续以确认您的操作。 

配置身份提供程序 
查找此处列出的特定于提供程序的说明，或使用您使用的身份提供程序查找说明。  

此部分介绍如何配置Zoho Vault以为您的Zoho Desk帮助中心提供单点登录（SSO）。
  1. 登录您的Zoho Vault账户。 
  2. 转至应用程序  >>  管理应用程序。 
  3. 点击添加自定义应用程序
  4. 在应用程序设置标签 ，提供以下详情 : 
    • 应用程序名称 : 提供应用程序的名称。例如，Zoho Desk。 
    • 声明客户服务URL -  粘贴您从Zoho Desk内帮助中心SAML屏幕所复制的SAML响应URL的值。
    • 受众URI (SP Entity ID) - 输入您Zoho Desk帮助中心实例URL ( https://support.mycompany.com/ 模式)。 
  5. 点击下一步。 
  6. 现在您需要提供Zoho Vault (IdP)的详细信息给 Zoho Desk (SP)。
  7. 在IdP详情标签，做如下操作 : 

    • 复制身份提供程序单点登录URL并粘贴到Zoho Desk帮助中心SAML页面内的远程登录URL字段。
    • 复制身份提供程序单点退出URL并粘贴到Zoho Desk帮助中心SAML页面内的远程退出URL字段。
    • 复制身份提供程序发行机构并粘贴到Zoho Desk帮助中心SAML页面内的重置密码URL字段。
    • 复制身份提供程序证书并保存至.txt文件。接着，将该文件上传至Zoho Desk帮助中心SAML页面内的公开密钥字段。 
  8. 点击下一步。
  9. 在管理应用程序访问标签，选择您想要给予其访问权限的用户列表，以授予其访问启用了SAML的帮助中心的权限。
  10. 点击保存。

此部分介绍如何配置Okta以为您的Zoho Desk帮助中心提供单点登录（SSO）。 
  1. 以管理员身份登录您的Okta账号。
  2. 点击应用程序页签。 
  3. 点击添加应用程序，接着点击创建新的应用程序。 
  4. 在弹出窗口上，选择SAML 2.0选项，接着点击创建。
  5. 在常规设置页面，提供应用程序的名称。例如，Zoho Desk。
  6. 点击下一步以继续。 
  7. 在配置SAML页面，做如下操作 : 
    • 单点登录URL  - 粘贴您从Zoho Desk内帮助中心SAML屏幕所复制的SAML响应URL的值。
    • 受众URI (SP Entity ID) - 将SAML响应URL的值也粘贴到此处。 
    • 默认中继状态 - 粘贴您从Zoho Desk内帮助中心SAML屏幕所复制的默认中继状态的值。
    • 名称ID格式 - 指定为邮箱地址 。 
  8. 点击下一步以继续。 
  9. 在反馈页面，选择我是添加内部应用程序的Okta客户，并勾选这是我们已经创建的内部应用程序选项。
  10. 点击完成。
    您新创建的应用程序的登录部分会出现。
  11. 点击登录 页签上的查看设置说明。它会打开一个新的IdP设置窗口。
  12. 在IdP设置窗口，做如下操作 : 
    • 复制身份提供程序单点登录URL并粘贴到Zoho Desk帮助中心SAML页面内的远程登录URL字段。
    • 复制身份提供程序单点退出URL并粘贴到Zoho Desk帮助中心SAML页面内的远程退出URL字段。
    • 复制身份提供程序发行机构并粘贴到Zoho Desk帮助中心SAML页面内的重置密码URL字段。
    • 复制X.509证书并保存至.txt文件。接着，将该文件上传至Zoho Desk帮助中心SAML页面内的公开密钥字段。
  13. 点击保存。 
  14. 现在您必须选择用户，以授予其访问启用了SAML的帮助中心的权限。要想实现: 
    • 点击应用程序页签，然后在Okta上选择您新创建的应用程序。
    • 点击应用程序的分配。
    • 点击分配 ，然后选择分配给人员。 
    • 在弹出窗口内，将您的用户名输入到搜索框，然后点击您用户名旁边的分配。 
      重复此步骤以添加更多用户。
  15. 点击完成以退出分配向导。
  16. 返回Zoho Desk，勾选帮助中心SAML页面上的启用注册选项，以允许新用户首次登录，然后点击保存。  

此部分介绍如何配置OneLogin以为您的Zoho Desk帮助中心提供单点登录（SSO）。
  1. 登录您的OneLogin账户。 
  2. 在OneLogin管理员仪表板内，访问应用程序 >> 添加应用程序。 
  3. 搜索' SAML测试连接器 '，然后选择搜索结果中的首个结果。 
    它应该是    SAML测试连接器 (IdP) 。
  4. 当配置 标签出现，请提供应用程序的名称。例如，Zoho Desk.
  5. 点击保存。 
    现在，其它的标签会出现，您会落在    信息标签。
  6. 点击配置标签，然后输入以下详细信息: 
    • 中继状态 - 粘贴您从Zoho Desk内帮助中心SAML屏幕所复制的默认中继状态的值。 
    • 收件人 - 粘贴您从Zoho Desk内帮助中心SAML屏幕所复制的SAML响应URL的值。
    • ACS (客户) URL验证器 - 将SAML响应URL的值也粘贴到此处。
    • ACS (客户) URL - 将SAML响应URL的值也粘贴到此处。 
  7. 一旦完成，则点击SSO标签并做如下操作 : 
    • 复制SAML 2.0 Endpoint (HTTP) URL并粘贴到Zoho Desk帮助中心SAML页面内的远程登录URL字段。 
    • 复制SAML 2.0 Endpoint (HTTP) URL并粘贴到Zoho Desk帮助中心SAML页面内的重置密码URL字段。
    • 复制SLO Endpoint (HTTP) URL并粘贴到Zoho Desk帮助中心SAML页面内的远程退出URL字段。
    • 在X.509 Certificate字段，点击查看详情，然后保存内容到.txt文件。接着将该文件上传至Zoho Desk帮助中心SAML页面内的公开密钥字段。
  8. 现在您必须选择用户，以授予其访问启用了SAML的帮助中心的权限。要想实现 : 
    点击    用户标签，然后点击所有用户以添加应用程序到单独的用户账户。
  9. 点击保存。 
  10. 返回Zoho Desk，勾选帮助中心SAML页面上的启用注册选项，以允许新用户首次登录，然后点击保存。 

此部分介绍如何配置Auth0以为您的Zoho Desk帮助中心提供单点登录（SSO）。
  1. 登录您的Auth0账户。 
  2. 访问仪表板 >> 应用程序。
  3. 点击右方的 + 创建应用程序按钮。
  4. 在名称 字段，输入应用程序的名称。例如，Zoho Desk。
  5. 选择您想要创建的应用程序类型。
  6. 点击保存。
  7. 返回到仪表板 >> 应用程序。
  8. 找到您刚刚在步骤4所创建的应用程序，然后点击它旁边的齿轮图标。
  9. 向下滚动页面，然后点击高级设置链接。 
  10. 在展开的窗口内，点击证书 部分下的下载证书按钮。
    下载的证书将会是一个    .pem文件。您需要将该证书转换为.txt格式。
  11. 现在，倒退滚动并点击附加组件标签。然后启用SAML2网络应用程序选项。 
    您会看见一个屏幕，让您提供其它的一些配置信息。
  12. 在屏幕的设置 部分，输入以下详情 : 
  13. 在附加组件 SAML2网络应用程序 弹窗内，点击使用方法标签并做如下操作 :
    • 复制身份提供程序登录URL并粘贴至Zoho Desk帮助中心SAML页面内的远程登录URL、远程退出URL以及重置密码URL字段。
    • 将您在步骤10所保存的证书上传到Zoho Desk帮助中心SAML页面内的公开密钥字段。
  14. 完成后，点击Zoho Desk内的保存。 
    现在，当您的终端用户登录帮助中心时将会被重定向到Auth0的登录页面。

Microsoft Azure AD

本节描述如何配置Microsoft Azure Active Directory来为您的Zoho Desk帮助中心提供SSO。
  1. 以管理员账户登录您的 Azure AD 门户。
  2. 在 Azure 门户，左侧导航面板，点击 Azure Active Directory。
  3. 选择 企业应用程序 ，接着全部应用程序。
  4. 点击新建应用程序按钮。
  5. 在搜索框内，键入 SAML SSO, 选择解锁面板内的 Confluence SAML SSO by Microsoft ，接着点击添加以添加应用程序到您的门户。
  6. 导航回 企业应用程序  ，接着点击Confluence SAML SSO by Microsoft 应用。
  7. 点击单点登录，接着选择SAML模式。
  8. 在 设置SAML单点登录 页面，点击编辑图标以打开 基本SAML配置对话框。
  9. 在 基本SAML配置  部分，做如下操作:
    1. 在标识符 文本框中，输入 zoho.com.cn
      注意(1): 如果IdP不支持重复标识符，您可以在Zoho Desk中编辑实体ID字段，以选择替代选项并输入相同的标识符。
      注意(2): 如果您是使用 .eu 域，则输入 zoho.eu。同样的, 如果您是使用.in域，则输入 zoho.in。
    2. 在 回复 URL 文本框内，粘贴您自Zoho Desk内的SAML屏幕所复制的SAML响应URL值。
    3. 在 登录URL 文本框内，再次粘贴 SAML响应URL值。
    4. 在中继状态 文本框内，粘贴您自Zoho Desk内的SAML屏幕所复制的默认中继状态值。
    5. 为输入的值勾选单选框。
    6. 单击页面顶部的保存。
  10. 在 设置SAML单点登录  页面，点击编辑按钮以打开用户属性和声明对话框。
  11. 在用户属性和声明 对话框的用户属性部分，做如下操作:
    1. 点击编辑图标以打开 管理用户声明对话框。
    2. 从源属性 列表中选择属性值 user.mail
    3. 点击 保存。
  12. 转至 SAML 签名证书 菜单，做如下操作:
    1. 在签名选项  下拉列表内，选择 签名SAML响应。
      这会弃用 Azure AD 以使用应用程序的X.509证书签署SAML响应。
    2. 点击 保存以应用新的SAML签名证书设置。
    3. 通过点击证书(PEM)来下载证书。
  13. 转至设置Confluence SAML SSO by Microsoft 菜单，做如下操作:
    1. 复制登录URL并粘贴到Zoho Desk SAML页面内的远程登录URL 和重置密码URL字段。
    2. 复制退出URL 并粘贴到Zoho Desk SAML页面内的远程退出URL。
    3. 上传您在步骤12保存的证书到Zoho Desk SAML页面内的公钥字段。
  14. 点击 保存。
  15. 返回Zoho Desk, 勾选SAML页面上的启用注册 选项，以允许新用户首次登录，接着点击 保存。

    • Related Articles

    • 管理帮助中心用户

      帮助中心用户是喜欢通过阅读您的知识库文章或社区帖子来找到解决方案的用户。当他们无法找到答案时，他们可以通过提交一张工单来从您的客服人员处寻求解决方案。用户还可以在不离开帮助中心的情况下进行对话交流和跟踪他们工单的状态。 您可以向您的帮助中心添加用户，有3种不同的方式: 手动添加用户 用户自注册 需审核的自注册  自动邀请用户 手动添加用户 您的客户访问您的帮助中心的一种方式是手动邀请他们。当您邀请用户时，系统将发送一封包含链接的邮件给注册者。他们必须访问链接来创建他们的密码以登录到帮助中心。 ...

    • 邀请客户到帮助中心

      虽然您的客户可以通过各种渠道提交工单，但只有当他们有权访问您的帮助中心时，他们才能跟踪自己的状态。 您的客户可以通过两种方式访问帮助中心: 通过自行注册，创建他们自己的用户账户 客服人员可以自联系人模块邀请客户 客户自行注册是一项需要由您的支持经理启用的功能。您可以通过两种方式邀请联系人成为帮助中心用户：您可以向所有联系人发送批量邀请，也可以单独选择联系人。 单独邀请联系人: 点击客户模块。 在联系人模块，打开联系人以查看其详细信息。  点击顶部面板内的更多操作图标 (  ) 。 ...

    • 自定义帮助中心主页

      使用简单的拖放方法，来自定义Zoho Desk中帮助中心内容的组织方式。您可以添加自定义的窗口小部件，显示或者隐藏页签并定制它们的外观，以正确的内容和在正确的地方吸引您的客户。 窗口小部件 窗口小部件是与帮助中心的不同页面相关联的附加组件。您可以使用Zoho Desk中提供的默认窗口小部件，也可以创建自己的自定义小部件。Zoho Desk内置的默认小部件如下： 公告 社区分类 知识库分类 模块 最热门话题 参与者 热门文章 热门话题 最近的文章 最近的话题 相关的文章 置顶帖子 杰出贡献者 ...

    • 重命名帮助中心子域

      对于老牌公司来说，更名后重新开始并不罕见。事实上，有很多很好的理由。例如，名字不再代表他们的作为;这个品牌已经停滞不前;或用于商标和法律目的。通常，战略重塑品牌还包括从重命名Zoho Desk帮助中心的子域名开始的品牌身份更新。 但是，这也带来了以下问题： 如果终端用户访问旧域，会发生什么情况？ 是否有可能将链接转到新域？ 没有可能保留旧域名的SEO排名？ 我们也有办法解决这个问题。引入主域和次域。这是一种新的方式，用户可以将他们的帮助中心从一个子域迁移到另一个子域，同时保留链接和排名。 ...

    • 管理帮助中心的权限

      当您设置帮助中心时, 必须确定谁可以访问它。您可以允许任何人，也可以是只有注册了该服务的人员才能够访问 "帮助中心"。提供一个开放的帮助中心对于那些只选择阅读文章或社区帖子的合法客户来说，是省力的。然而, 它可能会导致在您的Zoho Desk内收到垃圾邮件或不相关的工单。 另一方面, 客户在注册帮助中心时将会受益。它允许您的客户: 跟踪工单状态。 无需提供邮箱地址(预填充)即可提交工单。 在‘我的区域’部分，查看他们最近的帮助台活动。 ...