连接器

将第三方应用程序与 Zoho Mail 集成时，连接器用作身份验证机制。这些连接器可用于为 eWidget 创建扩展。这些扩展程序是为了调用第三方应用程序的 REST API 而构建的。为此，Zoho Mail 需要获得授权才能从外部应用程序访问 API 和数据。

您可以在 Zoho Mail 中创建连接器来执行此授权过程。创建扩展程序时，插件清单中会使用用于连接器的 serviceName。这将负责必要的身份验证。

支持的验证方法

身份验证模式可能会有所不同，具体取决于您要集成到 eWidget 中的应用程序。确定第三方应用程序使用的身份验证方法，然后选择 Zoho Mail 中连接器支持的以下方法之一：

• API 密钥
• OAuth 1.0 
• OAuth 2.0

配置连接器

您可以使用以下步骤为在“开发人员空间”中构建的扩展程序创建连接器：

1. 登录到 Zoho Mail
2. 导航到设置 >> 集成 >> 开发人员空间
3. 从左侧菜单中选择连接器
4. 单击创建连接开始配置
5. 在“新建自定义连接”屏幕中，输入以下内容：
   • 服务名称 - 输入您将在插件清单中使用的 serviceName。
   • 显示名称 - 输入方便您辨识的显示名称。
   • 令牌类型 - 访问令牌的类型。类型定义了其构造方式。（例如：承载令牌、MAC 令牌等）
   • 身份验证类型 - 您可以从 API 密钥、OAuth 1.0 或 OAuth 2.0 中进行选择。根据您选择的方法，将要求您输入所需的身份验证详细信息。
6. 单击保存

此连接器现在已在您的 Zoho Mail 帐户中创建。

使用连接器

测试连接器

为了测试您创建的连接器，您需要对连接器进行身份验证。

1. 导航到连接器列表。
2. 将鼠标悬停在要进行身份验证的连接器上。 
3. 单击连接。
4. 完成身份验证步骤，授予 Zoho Mail 访问第三方应用程序数据的权限。

现在您可以测试您的连接器了。

在扩展程序中执行连接器

使用调用 URL 命令时，您需要使用创建连接器时使用的 serviceName。当任何用户安装您创建的扩展程序时，他们必须完成身份验证步骤才能授予 Zoho Mail 访问第三方应用程序数据的权限。这些步骤由后台的连接器处理。