认证

每个已配置的 用户都可以选择使用 authtoken 或 OAuth 2.0 对系统 API 进行认证。有关配置用户和用户角色的更多信息，请参阅用户管理和角色。

​

使用身份认证令牌

authtoken 可以通过多种方式在 API 请求中使用：

• 在 HTTP 请求中包含 x-cdata-authtoken 头部，并将值设置为相应用户的 authtoken
• 将用户和 authtoken 作为 HTTP 基本认证的用户名/密码组合
• 在请求 URL 中将 authtoken 作为查询参数

要在请求 URL 中包含 authtoken，请按照以下步骤操作：

1. 打开设置页面。
2. 选择系统 API 选项卡。
3. 在其他设置部分，选择允许在 URL 中使用 Authtoken。

authtoken 查询参数的语法为 @authtoken=myAuthTokenValue。

​

使用 OAuth 2.0

OAuth 2.0 为需要管理令牌生命周期或与外部应用程序集成的客户端提供结构化认证流程。 要启用 OAuth 2.0，请按照以下步骤操作：

1. 点击导航栏上的设置图标。
2. 点击添加用户以添加新用户，或点击现有用户名称上的链接来编辑用户。
3. 点击 API 访问选项卡，然后勾选启用 OAuth 访问。填写以下字段：

   字段	描述
   Grant Type	用于确定客户端应用程序如何获取访问令牌的 OAuth 2.0 授权类型。目前唯一的选项是 Client Credentials。
   Client Id	系统生成的客户端 Id 令牌。
   Client Secret	系统生成的客户端密钥。请确保在保存用户之前将其复制到安全位置，因为之后将不再显示。
   Access URL	客户端应用程序使用配置的凭据请求访问令牌的端点 URL。