本页面介绍了如何在创建 Zendesk 数据存储区之前设置身份验证和权限。
启用令牌访问权限
如需允许 Zendesk 进行身份验证并与您的 Zendesk 实例互动,您必须启用令牌访问权限。请按以下步骤启用令牌访问权限:
- 前往您的 Zendesk 实例,然后使用管理员账号登录。
- 在导航菜单中,展开应用和集成,然后从 API 中选择 API 配置。
- 选中允许 API 令牌访问复选框。
- 点击保存。
设置身份验证和权限
如需使用 OAuth 2.0 进行安全集成,您必须在 Zendesk 中注册应用,以获取必要的客户端 ID 和客户端密钥。
创建 OAuth 客户端并获取身份验证凭据
如需在 Zendesk 中创建 OAuth 客户端并获取身份验证凭证,请按以下步骤操作:
前往您的 Zendesk 实例,然后使用管理员账号登录。
点击 Zendesk 产品图标,然后选择管理中心。
Zendesk 管理中心 在导航菜单中,展开应用和集成,然后从 API 中选择 OAuth 客户端。
点击添加 OAuth 客户端。
输入以下客户详细信息:
- 名称:为您的应用输入一个描述性名称。
- 可选:说明:输入简短说明。
- 可选:公司:输入您的公司名称。
- 可选:徽标:提供徽标,该徽标会显示在意见征求屏幕上。
- 唯一标识符(客户端 ID):为您的客户端提供一个唯一的名称。您可以修改初始建议,但必须确保其唯一性。
- 客户端类型:对于在浏览器或移动设备中运行的应用,请选择公开;对于在安全服务器上运行的应用,请选择机密。
- 重定向网址(必需):输入
https://vertexaisearch.cloud.google.com/oauth-redirect。这是 Zendesk 在授权后重定向到的网址,用于接收授权代码。
点击保存以获取客户端密钥。
- 客户端 ID:“唯一标识符”字段中的值。
- 客户端密钥:系统会显示新的密钥字段。复制此密钥并立即将其保存在安全的位置。出于安全考虑,完整密钥仅显示一次。如果丢失,您必须重新生成该密钥。
生成的客户端凭据 再次点击保存以最终确定更改。
设置权限
如需设置所需权限,请按以下步骤操作:
- 前往您的 Zendesk 实例,然后使用管理员账号登录。
- 点击 Zendesk 产品图标,然后选择管理中心。
- 在导航菜单中,展开应用和集成,然后从连接中选择 OAuth 客户端。
- 点击添加客户端。
输入以下客户详细信息:
- 名称:输入一个描述性名称。此区域无法更改。
- 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 子网域。
添加范围 - 范围:根据您的连接模式,输入以下范围(以空格分隔):
连接模式 范围 用途 需要管理员同意 联合搜索 read,users:read允许搜索 Zendesk 数据。 否 点击保存。