配置应用凭证

配置应用凭证

集成平台文档中心精选NaN-NaN-NaN
产品功能
当飞书集成平台的连接器访问第三方系统时,我们使用“应用凭证”的概念来描述如何建立访问关系,包括:通过什么网络通道、使用什么身份、访问哪个服务端点。由于第三方系统的认证协议各不相同,因此不同的连接器创建凭证时需要填写的参数内容是不一样的。
新建应用凭证
选择 业务集成 模块,前往 应用凭证管理 ,点击 新建应用凭证,选择要连接的服务。
250px|700px|reset
image.png
不同连接器需要填写的表单不同,这里举几个典型的例子:
  • 飞书
通过连接器访问和编辑飞书中的资源时,需要使用企业自建应用,并且为应用开通相应的能力、开通相应的权限、添加需要订阅的事件。
你可以通过应用授权(tenant_access_token)或者用户授权给自建应用(user_access_token)两种方式来创建飞书应用凭证。在新建应用凭证窗口中,你可以选择需要使用的认证类型。
如果选择应用授权(tenant_access_token),可以直接选择一个你有权限的自建应用,或填写真实的 App ID、App Secret,点击 创建并连接 创建一个凭证。
:如果帐密填写错误,应用凭证将无法创建成功。请务必填写真实的帐密信息。
250px|700px|reset
image.png
如果选择用户授权(user_access_token),你也可以直接选择一个你有权限的自建应用,或填写真实的 App ID、App Secret,并将下方的重定向URL复制到开发者后台的安全设置中,点击 创建并连接 创建一个凭证。
:必须先将重定向URL复制到开发者后台的安全设置,才能点击创建,否则会提示错误。
250px|700px|reset
image.png
  • Salesforce
通过连接器访问 Salesforce 中的资源时,需要使用一个用户身份,我们支持通过 用户名密码用户授权给「飞书」用户授权给自建的连接应用 三种方式来指定访问身份。
:由于 Salesforce 侧的约定,如果使用 用户名密码 方式,你仍需要在 saleforce 创建一个自建的连接应用,并且将应用的 client_id、client_secret 也填写到表单中。
250px|700px|reset
image.png
  • 易快报
由于易快报提供了多个平台版本,不同平台版本的访问域名不一样,因此我们在创建易快报的凭证时,除了需要指定接入账号 (appKey) 和接入密码 (appSecurity),还需要指定平台版本,以此确定访问的服务端点。
250px|700px|reset
image.png
在工作流中使用应用凭证
在工作流中,选中一个连接器,在右侧 凭证 标签页中,选择刚才创建的应用凭证,连接器即可正常使用。你也可以点击下拉列表中的 +新建应用凭证,直接快速创建应用凭证并使用。
250px|700px|reset
image.png
针对飞书应用授权凭证,集成平台提供了检测应用是否拥有相关权限&订阅相关事件的能力,如果你的企业自建应用缺少权限或未订阅相关事件,检测面板会给出警告。你可以点击【配置应用凭证】快速为应用添加相关能力,确保该自建应用满足当前工作流的运行条件。
你可以在配置面板中调整应用的通讯录范围,如果你想要从指定部门检索数据或给指定部门的成员发送消息,请,请确保成员&部门在应用可用范围与通讯录范围内
请注意,发布应用申请可能需要管理员审核,在使用这个应用前,请确保应用已通过申请,否则检测面板的警告会一直存在。
250px|700px|reset
image.png
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
联系我们立即试用