入门指南

您可以从空白画布或 API 规范创建自定义连接器。

在创建连接器之前，请先熟悉可用的身份验证类型。

身份验证类型

本节介绍了连接器生成器中最常见的身份验证类型。 它包括在用例、身份验证流程和安全性方面对三种身份验证类型进行了比较。 有关更多详细信息，请参阅身份验证类型。

OAuth 2.0 授权代码流程

• 适用于需要代表用户访问用户数据的应用程序。
• 高安全性：访问令牌永远不会公开给用户代理，而是在服务器之间进行交换。

流程:

1. 用户授权：用户将被重定向到授权服务器以授予访问权限。
2. 授权代码：如果用户授予访问权限，则系统会将授权代码返回给客户端。
3. 令牌交换：客户端在令牌端点处用授权代码交换访问令牌。

OAuth 2.0 客户端凭据代码流程

• 适用于不涉及用户交互的服务器到服务器交互。
• 中等安全性：它依赖于确保客户端凭据的安全。

流程:

1. 直接令牌请求：客户端使用其客户端凭据直接向授权服务器请求访问令牌。
2. 访问令牌：授权服务器返回访问令牌

API 密钥

• 实施简单快捷，通常用于公共 API。
• 低安全性：API 密钥可以轻松共享或公开。

流程:

“API 密钥用法”：用户在每个请求中包含 API 密钥以进行身份验证。

选择身份验证流程

在示例 A：使用个人访问令牌在空白画布构建连接器中，我们使用“个人访问令牌”(PAT) 身份验证类型。 生成图像 API 示例遵循将“授权”标头与 API 密钥的持有者方案一起使用的标准实践，尤其是对于 OAuth 2.0 令牌。

某些 API（例如 SAP S4 ODataV2 资源）使用自定义标头（如 API 密钥）来对应用程序进行身份验证。 这在示例 B：使用 API 密钥身份验证在空白画布上构建连接器中使用。

示例 C：根据具有 OAuth 2.0 的 API 规范构建连接器客户端凭据身份验证使用 OAuth 2.0 客户端凭据流和 OAuth 2.0 应用程序。