整合生成器支持标准授权类型，包括 API 密钥、不记名令牌、用户名和密码，以及OAuth 2.0。但是，根据您组织的需求和工作流程，标准授权可能还不够。因此，整合生成器还支持自定义的仅限身份验证整合类型，可与您组织的身份验证和授权解决方案配合使用。
本文章包含以下主题：
关于自定义授权
自定义的仅限身份验证整合先请求密钥及其有效期，然后将其传递给数据或主整合以进行授权，然后再请求数据。
总体而言，自定义授权流程如下：
- 授权请求。已配置的仅限身份验证整合将发送请求到服务器，请求授予权限以检索访问密钥。如果服务器通过了请求（来自人工智能专员）的身份验证，则授权检索访问密钥及其过期时间（如可用）。
- 处理密钥。在服务器使用访问密钥进行响应后，整合会存储两个关键信息：密钥参数本身及其 ExploresIn 参数，该参数确定密钥的有效时间。
- 将密钥传递给数据整合。这两个参数（token 和 ExploresIn）将传递到下一步，即数据整合。该密钥用于对数据整合发出的后续请求进行身份验证。此密钥在内部设置和处理，不会暴露在会话或对话数据中。
- 数据的自定义授权请求。获取访问密钥后，即授权数据整合检索必要数据以扩充对话。
以下流程图说明了自定义授权流程。
配置自定义授权
您可以在整合生成器中配置自定义授权，这是正常创建整合流程的一部分。
注意：请勿一次使用多个环境进行自定义授权。如果您想拆分为生产、沙盒环境环境等，请将它们拆分为单独的授权整合。
在整合生成器中配置自定义授权
- 在主菜单中，单击API 整合。
- 单击右上角的添加整合。
- 在添加整合窗口中：
- 在整合名称字段中，为您的整合指定一个描述性名称。
- （可选）在描述字段中，输入整合的描述，以便记住该整合的用途。
- 选择设置为“仅限身份验证”整合。
- 单击保存。
- 在左侧栏中的场景下，将鼠标悬停在失败上，选择选项菜单 (
），然后选择删除。对于自定义授权，您只需要成功的场景。回退方案无法删除。
- 在成功场景页面上，使用以下详情创建两个会话参数（通过单击+按钮）：
- 密钥
- Key：密钥（必须与此完全相同）
- 查询：输入一个定义密钥的值。例如：data.access_token
- 过期于
- 键： expiresIn （必须与此完全一样）
-
查询：输入一个定义密钥过期的值。例如：data.expires_in
密钥过期可能不是数据响应的一部分。在这种情况下，您可以硬编码一个您选择的值（以秒为单位）。例如：3600
我们强烈建议设置密钥过期时间。如果您在测试时遇到错误，这是为您颁发新密钥之前需要等待的时间。如果密钥没有过期时间，则设置为无限期，这意味着在故障排除期间您将无法颁发新的密钥。
- 密钥
- 单击保存。
创建数据整合
接下来，创建一个数据整合，该整合将使用您在上述步骤中创建的“仅限身份验证”整合。就像创建新整合时一样。如需帮助，请参阅整合生成器说明。
创建数据整合
- 在左侧栏中的环境下，选择一个环境（例如生产）。
- 在授权标签的授权类型下拉字段中，选择自定义。
- 在API 授权整合下拉字段中，选择您在上面创建的自定义仅限身份验证整合。
- 选择标头标签，然后单击添加标头。
- 填写以下字段：
- 键值：授权
-
值：不记名{{apiToken}}（必须与此完全一致）
- 单击保存。
测试自定义授权
我们建议您在配置自定义的仅限身份验证整合后对其进行测试。如需帮助，请参阅测试功能。
故障排除 statusCode：null
此外，在测试整合时，您可能会遇到如下图所示的消息“statuscode: null”：
首先，仔细检查您的自定义仅限身份验证整合是否已根据上述步骤正确配置。
接下来，记下发生错误的位置。如果是在身份验证整合中，则可能存在某些配置不正确，或者您发出请求的 URL 可能有误。在这种情况下，建议咨询您的工程师，他们也许可以提供更多关于故障原因的信息。
如果您已完成上述步骤，但仍然遇到此错误，请等到密钥过期再重试。
如果您已尝试所有这些故障排除步骤，但整合仍然无法工作，请联系您的客户服务经理以获得更多帮助。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。