» 首页 » 管理员配置（新界面） » 开发者空间 » 自定义小部件 » 为组织定义业务规则

连接

连接用于对 ServiceDesk Plus 与外部application的集成进行身份验证。

 

要设置连接，请先将第三方application在 ServiceDesk Plus 中注册为服务。连接支持三种身份验证模式：API 密钥、基本身份验证和 OAuth 2.0。

 

所需角色：SDAdmin

优势

  • 安全的身份验证机制，可防止某个用户的身份验证令牌暴露给application中的其他用户。
  • 支持 OAuth 的动态令牌生成（刷新令牌）。

设置连接 

转到管理 > 开发者空间 > 连接。

 

步骤 1：将第三方application详细信息保存为服务。

 

在连接窗格下，选择自定义服务并单击创建服务。根据以下说明填写表单。

 

字段名称

说明

服务名称

为该服务提供一个显示名称。

服务链接名称

提供一个唯一的链接名称以标识该自定义服务。链接名称只能包含采用 snake_case 格式的字母数字字符。

身份验证类型

根据第三方服务的 API 文档选择一种身份验证类型。

API 密钥

  • 将参数类型指定为查询字符串、表单数据或请求头。
  • 输入参数以及该参数的显示名称。
  • 单击 添加多个参数。您也可以通过单击 删除参数。

基本身份验证

参数类型会自动填充为 Header，且不可编辑。该服务将使用用户名和密码进行身份验证。

OAuth2 

指定身份提供者详细信息。请确保回调 URL 为：{sdp_base_URL}/integration/oauth/callback，且域名为在管理 > 常规设置 > 高级门户设置下配置的别名 URL。

  • 参数类型默认选择为Header。
  • 授权类型默认选择为Authorization Code。
  • 复制资源所有者提供的客户端 ID。
  • 从资源所有者处复制映射到 ServiceDesk Plus 的客户端密钥。
  • 输入资源登录页面的授权 URL，ServiceDesk Plus 可通过该 URL 在资源服务器上完成身份验证。
  • 提供资源网站上的访问令牌 URL。
  • 提供刷新令牌 URL，以便 ServiceDesk Plus 能重新授权访问。您可以从资源网站获取此 URL。
  • 提供 ServiceDesk Plus 所需的访问权限作为 scope，并输入 scope 的显示名称。

 

 

  • 单击创建服务。

 

 

步骤 2：创建连接

对通过连接集成的服务进行身份验证。在连接窗格下，选择我的连接并单击创建连接。您也可以从服务详细信息页面创建连接。

  1. 选择需要为其创建连接的服务。您也可以创建新服务。
  2. 为该连接提供一个显示名称。
  3. 提供一个唯一的链接名称以标识该连接。链接名称只能包含采用 snake_case 格式的字母数字字符。
  4. 对于通过 OAuth2 进行身份验证的服务，请选择相关权限。
  5. 单击创建并连接。
  6. 提供相关的身份验证详细信息和权限。

对于现有连接，请在连接详细信息页面单击连接以连接到外部服务。

 

 

管理服务和连接

在连接/服务详细信息页面上，

  • 单击 编辑或删除连接/服务
  • 在连接详细信息页面上，您可以发起或撤销连接。

 

 

在连接/服务列表视图页面上，

  • 单击 通过连接器显示名称或链接名称进行搜索。
  • 单击 筛选所列出的连接。
  • 将鼠标悬停在服务或连接上以编辑/删除/连接/撤销。

 

 

具有现有连接的服务不能被删除或编辑，但服务名称字段和分隔符字段（如果配置了 OAuth2）除外。 
您可以编辑或删除由您创建的任何连接。SDAdmin 可以连接（验证）任何可用连接。 
在自定义小组件中使用的连接无法删除。 
连接只能由已通过身份验证的用户或创建该连接的用户撤销。