消息
日历
会议
通讯录
邮箱
文档
钉盘
AI 表格
AI 听记
考勤
审批
宜搭
管理控制台
如果当钉钉官方连接器无法满足你的需求，但又急需打通钉钉应用、自建系统或者第三方应用系统时，你可以通过宜搭连接器工厂进行自定义连接器。
步骤一：新建连接器
按钮，进入平台管理页面。
1
参考以下信息配置连接器的基本信息，配置完成后单击 下一步
2
参考以下内容，配置 身份验证类型
| 身份验证类型 | 说明 |
|---|---|
| 无身份验证 | 无身份验证就是不需要任何验证信息，直接调用的接口，通常用于访问一些公开的接口。 |
| 基本身份验证 | 基本身份验证是指基于的 HTTP请求中 Authorization 请求头的验证。请求消息头含有服务端用于验证用户代理身份的凭证。 • 格式为： Authorization: Basic <密文>。例如：你可以在 Header 中加入 Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l 的Base64 编码后账号密码信息。你只需要配置账号密码的提示标签，用于提示使用者在注册鉴权信息知道填写什么内容。 例如： • username 标签 • password 标签 |
| API 密钥 | 即 APIKey 鉴权方式，该APIKey长期有效（请开发者妥善保管），访问者在待访问的系统中创建生成秘钥，开发者可直接通过此凭证调用支持此类鉴权的公开 API。 • 参数标签：用于配置鉴权信息时提示。 • 参数名称：系统需要的 apiKey 名称。 • 参数位置：可以选择把鉴权信息附加在查询参数或者 header 里，根据请求的系统需要选择。 |
| 阿里云 API 网关 | 即连接器创建完成之后添加鉴权模板时，模板填写 App Code 后可调用对应的阿里云API。 更多内容请参考，使用认证 App Code 方式调用API。  |
| 钉钉开放平台验证 | 创建完连接器后添加鉴权模板，模板填写 App Key 、App Secret 后可调用钉钉开放平台API（含宜搭部分API）。添加鉴权模板后宜搭会通过鉴权自动生成鉴权参数 access_token ，在请求时添加到 Header 参数 x-acs-dingtalk-access-token 中，无需再次生成。更多内容，请参考钉钉应用开发流程。 |
| 钉钉零信任网关 | 如何使用钉钉零信任网关，可参考钉钉开放平台-零信任网关鉴权。 |
步骤二：创建执行动作
在执行动作页面，单击新增执行动作，然后根据以下信息进行配置。
步骤三：鉴权配置
所有的自定义连接器都需要建立对应的请求鉴权方案，即使是「无身份验证」也需要创建。- 新建账号
- 输入 账号显示名称 、 App Key 、 App Secret 等信息，然后 单击 确认 。
步骤四：测试连接器
1
在连接器详情页，单击右上角 测试 按钮
2
选择使用的鉴权，配置测试的参数
3
单击 测试 ，出现预期结果即为配置成功
