管理对 API 的 OAuth 密钥访问

所有 Suite：

Team、Growth、Professional、Enterprise 或 Enterprise Plus

Support

Team、Professional 或 Enterprise

已验证人工智能概要 ◀▼

管理用于 API 访问的OAuth令牌。此方法可确保安全的 API 身份验证，而无需存储和使用 API 密钥。创建OAuth客户端以生成令牌、在需要时查看和删除令牌，以及编辑客户端详情。在 Enterprise 服务模式中，查看审核日志以跟踪OAuth客户端活动。

位置：管理中心 > 应用和整合 > API > OAuth 客户端

您可以使用 OAuth 访问密钥对 API 请求进行身份验证。OAuth 为应用程序访问 Zendesk 数据提供了一种安全的方式，无需存储和使用 API 密钥等敏感信息。

您无法像 API 密钥那样直接在管理中心创建 OAuth 访问密钥。您必须先在管理中心创建一个 OAuth 客户端，然后在已定义的 OAuth 授权流程中使用 OAuth 客户端创建 OAuth 访问密钥。

OAuth 访问密钥与 API 密钥不同。请参阅Zendesk 开发者文档中的API 密钥和访问密钥之间的区别。

本文章包含以下部分：

创建 OAuth 客户端
使用 OAuth 客户端创建访问密钥
查看OAuth客户端密钥
查看OAuth客户端密钥的范围
删除OAuth客户端密钥
编辑OAuth客户端
删除OAuth客户端
查看OAuth客户端 (Enterprise) 的审核日志

要使用 OAuth 访问密钥对 API 请求进行身份验证，请参阅 developer.zendesk.com 上的 OAuth 访问密钥。

创建 OAuth 客户端

OAuth 客户端使您可以创建可用于对 API 请求进行身份验证的 OAuth 访问密钥。OAuth 访问密钥与 API 密钥不同。OAuth 访问密钥为应用程序访问 Zendesk API 提供了一种安全的方式，无需存储和使用 Zendesk 用户的密码。

注意：本节介绍了如何为单个 Zendesk 实例创建OAuth客户端。要创建全局OAuth客户端，请参阅设置全局OAuth客户端。

这些本地（非全局） OAuth客户端在 2026 年 4 月 30 日或之后创建时将自动具有默认的访问密钥和刷新密钥过期时间。有关过期限制的信息，请参阅对您的应用程序使用OAuth身份验证。

创建 OAuth 客户端

在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > OAuth 客户端。
随即显示由管理员添加到帐户的OAuth客户端列表。
要创建客户端，单击添加OAuth客户端，然后按照在Zendesk 注册应用程序中的说明进行操作。

使用 OAuth 客户端创建访问密钥

在管理中心创建 OAuth 客户端后，您可以将其与已定义的授权流程结合使用，以创建 OAuth 访问密钥。您还可以将 OAuth 客户端与 API 结合使用，在没有授权流程的情况下创建访问密钥。您可以使用 API 密钥对这些 API 请求进行身份验证。请参阅开发者文档中的通过 API 创建和使用OAuth访问密钥。

查看OAuth客户端密钥

您可以查看为OAuth客户端创建的访问密钥。

查看OAuth客户端的访问令牌

在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > OAuth 客户端。
随即显示OAuth客户端列表。它显示OAuth客户端信息，包括客户端标识符、名称、创建日期、令牌数量和状态。
在列表中找到客户端以查看令牌。
单击选项菜单图标 ( ），然后选择查看令牌。

随即显示OAuth客户端的访问令牌列表。

没有令牌的客户端将看不到“查看令牌”选项。