连接

连接

连接用于验证 ServiceDesk Plus 与外部应用程序的集成。


要建立连接，请在 ServiceDesk Plus 中将第三方应用程序注册为服务。连接具有三种身份验证模式--API 密钥、基本身份验证和 OAuth 2.0。

 

需要的角色：SDAdmin

优点

  • 安全认证机制，可防止用户的认证令牌暴露给应用程序中的其他用户。
  • 为 OAuth 生成动态令牌（刷新令牌）。

设置连接

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

 

步骤 1：将第三方应用程序的详细信息存储为服务。

 

在连接窗格下，选择自定义服务，然后单击创建服务。 使用下面的指引填写表格。

 

字段名称

描述

服务名称

提供服务的显示名称。

服务链接名称

提供一个唯一的链接名称来标识自定义服务。 链接名称必须只包含字母数字字符（snake_case）。

认证类型

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

API 密钥


  • 将参数类型指定为查询字符串、表单数据或标题。
  • 输入参数和参数显示名称。
  • 单击 添加多个参数。单击 删除参数。

基本认证

参数类型自动填充为 "页眉"，不可编辑。

OAuth2 

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

  • 参数类型默认选为标题。
  • 授权类型默认选为授权码。
  • 复制资源所有者提供的客户 ID。
  • 复制资源所有者中映射到 ServiceDesk Plus 的客户机密钥。
  • 输入资源登录页面的授权 URL，ServiceDesk Plus 可通过该 URL 与资源服务器进行身份验证。
  • 提供资源网站的访问令牌 URL。
  • 提供刷新令牌 URL 以允许 ServiceDesk Plus 重新授权访问。您可以从资源网站获取此 URL。
  • 提供 ServiceDesk Plus 所需的访问权限作为作用域，并输入作用域显示名称。

 

 

  • 单击创建服务。


 

步骤 2：创建连接

通过连接验证集成的服务。 在 "连接 "窗格下，选择 "我的连接"，然后单击 "创建连接"。 您也可以从服务详细信息页面创建连接。

  1. 选择必须创建连接的服务。您也可以创建一个新服务。
  2. 提供连接的显示名称。
  3. 提供一个唯一的链接名称来标识连接。链接名称必须只包含小写字母数字字符。
  4. 对于通过 OAuth2 验证的服务，请选择相关权限。
  5. 单击创建并连接。
  6. 提供相关的验证详细信息和权限。

对于现有连接，单击连接详细信息页面上的连接即可连接到外部服务。

 


 

管理服务和连接

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

  • 点击编辑或删除连接/服务。
  • 在连接详情页面，您可以启动或撤销连接。

 


 

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

  • 点击 使用连接器显示名称或链接名称进行搜索。
  • 点击 来过滤列出的连接。
  • 将鼠标悬停在服务或连接上，可对其进行编辑/删除/连接/撤销。

 


 

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