Zendesk 配置

本页面介绍了如何在创建 Zendesk 数据存储区之前设置身份验证和权限。

启用令牌访问权限

如需允许 Zendesk 进行身份验证并与您的 Zendesk 实例互动,您必须启用令牌访问权限。请按以下步骤启用令牌访问权限:

  1. 前往您的 Zendesk 实例,然后使用管理员账号登录。
  2. 在导航菜单中,展开应用和集成,然后从 API 中选择 API 配置
  3. 选中允许 API 令牌访问复选框。
  4. 点击保存

设置身份验证和权限

如需使用 OAuth 2.0 进行安全集成,您必须在 Zendesk 中注册应用,以获取必要的客户端 ID 和客户端密钥。

创建 OAuth 客户端并获取身份验证凭据

如需在 Zendesk 中创建 OAuth 客户端并获取身份验证凭证,请按以下步骤操作:

  1. 前往您的 Zendesk 实例,然后使用管理员账号登录。

  2. 点击 Zendesk 产品图标,然后选择管理中心

    Zendesk 管理中心界面。
    Zendesk 管理中心
  3. 在导航菜单中,展开应用和集成,然后从 API 中选择 OAuth 客户端

  4. 点击添加 OAuth 客户端

  5. 输入以下客户详细信息:

    • 名称:为您的应用输入一个描述性名称。
    • 可选:说明:输入简短说明。
    • 可选:公司:输入您的公司名称。
    • 可选:徽标:提供徽标,该徽标会显示在意见征求屏幕上。
    • 唯一标识符(客户端 ID):为您的客户端提供一个唯一的名称。您可以修改初始建议,但必须确保其唯一性。
    • 客户端类型:对于在浏览器或移动设备中运行的应用,请选择公开;对于在安全服务器上运行的应用,请选择机密
    • 重定向网址(必需):输入 https://vertexaisearch.cloud.google.com/oauth-redirect。这是 Zendesk 在授权后重定向到的网址,用于接收授权代码。
  6. 点击保存以获取客户端密钥。

    • 客户端 ID:“唯一标识符”字段中的值。
    • 客户端密钥:系统会显示新的密钥字段。复制此密钥并立即将其保存在安全的位置。出于安全考虑,完整密钥仅显示一次。如果丢失,您必须重新生成该密钥。
    界面中显示生成的客户端密钥。
    生成的客户端凭据
  7. 再次点击保存以最终确定更改。

设置权限

如需设置所需权限,请按以下步骤操作:

  1. 前往您的 Zendesk 实例,然后使用管理员账号登录。
  2. 点击 Zendesk 产品图标,然后选择管理中心
  3. 在导航菜单中,展开应用和集成,然后从连接中选择 OAuth 客户端
  4. 点击添加客户端
  5. 输入以下客户详细信息:

    • 名称:输入一个描述性名称。此区域无法更改。
    • OAuth 授权类型:选择授权代码
    • 客户端 ID:输入从在 Zendesk 中创建 OAuth 客户端部分获得的客户端 ID。
    • 客户端密钥:输入从在 Zendesk 中创建 OAuth 客户端部分获得的客户端密钥值。
    • 授权网址:授权端点通常采用 https://<var>your-subdomain</var>.zendesk.com/oauth/authorize 格式。将 <var>your-subdomain</var> 替换为您的实际 Zendesk 子网域。
    • 令牌网址:令牌端点通常采用 https://<var>your-subdomain</var>.zendesk.com/oauth/token 格式。将 <var>your-subdomain</var> 替换为您的实际 Zendesk 子网域。
      用于在 Zendesk 管理中心内输入 API 范围的字段。
      添加范围
    • 范围:根据您的连接模式,输入以下范围(以空格分隔):
    连接模式 范围 用途 需要管理员同意
    联合搜索 readusers:read 允许搜索 Zendesk 数据。
  6. 点击保存