入门

本文引导您完成设置 Citrix ITSM Adapter 服务的过程。

准备工作

要设置 ITSM Adapter 服务，请确保准备好以下内容：

• 对您的 ServiceNow 实例具有系统管理员权限的帐户

  设置服务后，您可以对其实施基于角色的访问控制。有关更多信息，请参阅 访问管理。

• Citrix DaaS 的有效订阅

  您也可以注册免费试用。有关详细信息，请参阅 验证您是否已订阅 Citrix DaaS。

• 具有完全访问权限的 Citrix Cloud 管理员帐户

• 您的 ServiceNow 实例与 Citrix Cloud 帐户所在区域的 IP 地址之间的连接

  Citrix Cloud 区域	IP 地址
  美国	52.158.218.132/30
  欧盟	20.54.214.12/30
  亚太地区	20.195.2.68/30

验证您是否已订阅 Citrix DaaS

登录 Citrix Cloud 或注册一个新帐户。

如果您拥有 Citrix DaaS 的有效订阅或注册了免费试用版，则 ITSM Adapter 服务将显示在“我的服务”列表中。否则，请咨询您的 Citrix 代表。

提示：

仅当您的组织拥有 Citrix DaaS 高级版的有效订阅时， 管理 按钮才可用。在此之前，将显示“请求演示”。

步骤 1：在 ServiceNow 中安装 Citrix ITSM 连接器插件

在您的 ServiceNow 实例上安装 Citrix ITSM 连接器插件。

1. 使用分配给 system administrator 角色的帐户登录您的 ServiceNow 服务管理门户。

2. 验证您已激活 ServiceNow 编排插件。

   如果您的 ServiceNow 实例上缺少任何依赖项，系统将提示您进行安装。

   

3. 为您的 ServiceNow 实例安装 Citrix IT Service Management Connector 插件：

   1. 在左窗格中，选择“所有可用应用程序”>“全部”。要快速找到菜单，请在 筛选器导航器 字段中键入 应用程序 。

   2. 在显示 的所有应用程序 页面上，在搜索栏中搜索 Citrix 。

      

   3. 在搜索结果中，找到 Citrix IT Service Management Connector，然后单击 安装。

   4. 按照屏幕上的说明完成安装。

   注意：

   要验证是否下载了最新版本的 Citrix ITSM 连接器插件，请单击 其他应用程序版本。

步骤 2：配置 Citrix ITSM 连接器插件

配置插件以设置其与 Citrix Cloud 的连接。

步骤：

1. 在 Citrix Cloud 中创建身份验证凭据。
2. 将身份验证凭据添加到插件中。

从 ITSM Adapter 服务版本 22.3.0 开始，单个 ServiceNow 实例可以管理多个 Citrix Cloud 帐户中的应用程序和桌面。

在 Citrix Cloud 中创建身份验证凭据

要与 Citrix Cloud 进行通信，Citrix ITSM 连接器插件必须具有 Citrix Cloud 生成的身份验证凭据。

在要管理的每个 Citrix Cloud 帐户中创建身份验证凭据。

步骤：

1. 登录 Citrix Cloud，然后选择要管理的 Citrix Cloud 帐户。

2. 为 Citrix ITSM 连接器插件创建安全客户端。有关更多信息，请参阅 开始使用 Citrix Cloud API。

   

3. 将安全客户端 ID 和密钥存储在安全的地方。

4. 如果您有更多要管理的 Citrix Cloud 帐户，请为每个帐户重复步骤 1-3。

将身份验证凭据添加到插件中

在 Citrix Cloud 帐户中创建身份验证凭据后，将其添加到 ITSM 连接器插件中。该插件使用凭据来设置与 Citrix Cloud 的连接。

1. 登录您的 ServiceNow 服务管理门户。

2. 在左窗格中，选择 Citrix IT Service Management Connector > 主页。

3. 在出现 的 Citrix Cloud 集成入门 页面上，单击 连接。

   

4. 在出现的 Citrix Cloud 身份验证对话框中，键入您在 Citrix Cloud 帐户中创建的安全客户端 ID 和密钥对。有关更多信息，请参阅 在 Citrix Cloud 中创建身份验证凭据。

5. 单击 测试以测试 与您的 Citrix Cloud 帐户的连接。

6. 保存配置。

   此时将显示来自 ServiceNow 的确认消息，表示连接已启动并正在运行。

   

7. 如果您有更多要管理的 Citrix Cloud 帐户，请针对每个帐户执行以下步骤：

   1. 点击 添加客户。
   2. 重复步骤 4—6。

配置完成后，ServiceNow 实例使用提供的身份验证凭据自动连接到 Citrix Cloud。当您登录 Citrix Cloud 并转到适用于 ServiceNow 的 ITSM Adapter > 管理页面时，您可以看到所有与 Citrix Cloud 建立连接的实例。

这些实例处于未注册状态，这表明 Citrix Cloud 尚未向其注册。

停用 Citrix 帐户

要从 ServiceNow 实例中停用 Citrix Cloud 帐户，请在 主页 上单击省略号，然后单击 停用。

注意：

要完全删除 Citrix Cloud 帐户的 Citrix ITSM 数据，请停用该帐户。手动删除或编辑帐户可能会在您的环境中留下残留数据。

步骤 3：向您的 ServiceNow 实例中注册 Citrix Cloud

要使 Citrix Cloud 能够向您的 ServiceNow 实例发送警报和通知，请通过提供以下详细信息在您的 ServiceNow 实例中注册 Citrix Cloud：

• 您的 ServiceNow 实例的 URL

• 您的 ServiceNow 实例生成的身份验证凭据

从 ITSM Adapter 服务版本 22.3.0 开始，单个 ServiceNow 实例可以管理多个 Citrix Cloud 帐户。如果您有多个 Citrix Cloud 帐户需要管理，请将您的 ServiceNow 信息添加到每个帐户中。

步骤：

1. 登录 Citrix Cloud，然后选择要管理的 Citrix Cloud 帐户。

2. 在适用于 ServiceNow 的 ITSM Adapter 磁贴上，单击管理。此时将显示 IT Service Management Adapter 页面。

3. 单击 管理 选项卡。将显示与 Citrix Cloud 建立连接的所有实例。

4. 找到要注册的 ServiceNow 实例，然后从省略号菜单中选择“注册”。将出现以下页面，其中自动填充了 ServiceNow 实例的 URL。

   

   或者，您可以单击“添加 ServiceNow 实例”以开始注册。

5. 按照屏幕上的说明让 ServiceNow 为 Citrix Cloud 帐户生成 OAuth 端点：

   1. 复制说明中提供的重定向 URL。
   2. 在浏览器中打开一个新选项卡以访问您的 ServiceNow 服务管理门户。
   3. 在门户中，为 Citrix Cloud 帐户创建一个 OAuth 端点。创建端点时，必须输入在步骤 a 中复制的重定向 URL。有关更多信息，请参阅为 Citrix Cloud 帐户创建 OAuth 终端节点。

6. 返回打开“在 Citrix Cloud 中添加 ServiceNow 实例”对话框的选项卡，然后输入所需的 OAuth 凭据：

   • （可选）输入 ServiceNow 实例的描述性名称。
   • 输入在步骤 5 中生成的 OAuth 端点详细信息（客户端 ID 和客户端密钥）。

   • 要使用 ServiceNow 服务帐户进行 ServiceNow 登录和注册授权，请打开“使用 ServiceNow 服务帐户”，输入该服务帐户的用户 ID 和密码，然后单击“验证”以验证服务帐户凭据。

     注意：

     您可以使用为 x_cion_citrix_it_s.ctx_itsm_admin 角色分配的 ServiceNow 服务帐户来完成验证。要使 ServiceNow 能够为来自 Citrix Cloud 的警报和通知生成事件，请确保还为该服务帐户分配了必要的 incident_manager 角色。

     

   • 要使用 ServiceNow 用户帐户进行 ServiceNow 登录和注册授权，请保持关闭使用 ServiceNow 服务帐户并完成以下步骤：

     注意：

     要完成此任务，您可以使用为 x_cion_citrix_it_s.ctx_itsm_admin 角色分配的 ServiceNow 用户帐户。要使 ServiceNow 能够为来自 Citrix Cloud 的警报和通知生成事件，请确保还为该用户帐户分配了必要的 incident_manager 角色。

     1. 单击连接。此时将显示您的 ServiceNow 实例登录页面。

     2. 键入 ServiceNow 用户帐户的用户名和密码，然后单击“登录”。将出现一个页面，请求您允许 ITSM Adapter 服务连接到您的 ServiceNow 实例中的此 ServiceNow 帐户。

        

     3. 单击 Allow（允许）。您将返回到“在 Citrix Cloud 中添加 ServiceNow 实例”对话框。

        

   注意：

   通过 OAuth 端点身份验证渠道从 Citrix DaaS 发送到 ServiceNow 的数据存储在 ServiceNow 数据库中。相应的数据库记录清楚地表明它们是由您用于 ServiceNow 登录和注册授权的帐户创建的。

7. 单击保存实例。ITSM Adapter 服务开始测试与 Citrix ITSM 连接器的连接。如果测试成功完成，则实例的状态将更改为已注册。

   

   提示：

   如果实例状态显示为 ServiceNow 实例未授权，请检查过期的 OAuth 凭据，并在需要时从省略号菜单中选择“重新身份验证”来重新进行身份验证。

8. 如果您有更多 Citrix Cloud 帐户需要管理，请对每个帐户重复步骤 1—7。

成功完成上述步骤后，IT 技术支持和最终用户现在可以访问 Citrix ITSM 服务。

注册不同的 ServiceNow 实例

一个 Citrix Cloud 帐户只能注册一个 ServiceNow 实例。要将其注册到不同的 ServiceNow 实例，请先取消注册现有实例。

1. 在 ITSM Adapter 服务的管理页面上，单击现有 ServiceNow 实例旁边的省略号。
2. 选择“取消注册”。
3. 要将 Citrix Cloud 注册到不同的 ServiceNow 服务实例，请找到该实例记录，然后从省略号中选择注册。
4. 按照屏幕上的说明完成程序。

为 Citrix Cloud 帐户创建 OAuth 终端节点

在您的 ServiceNow 实例中，为 Citrix Cloud 帐户创建 OAuth 终端节点（包括客户端 ID 和客户端密钥）。

步骤：

1. 登录您的 ServiceNow 服务管理门户。

2. 在左窗格中，选择 系统 OAuth > 应用程序注册表。要快速找到菜单，请在 筛选器导航器 字段中键入 oauth 。

3. 在 应用程序注册表 页面上，单击 应用程序注册表 旁边 的新建。

   

4. 在显示的 OAuth 应用程序 页面上，选择 为外部客户端创建 OAuth API 端点。

5. 在出现的 应用程序注册表新记录 页面上，创建一个 OAuth 端点：

   1. 键入 OAuth 端点的名称。
   2. 单击 重定向 URL 字段旁边的锁定 图标，然后键入在 Citrix Cloud 中添加 ServiceNow 实例对话框中 提示的重定向 URL。
   3. 单击 Submit（提交）。

6. 在显示的 应用程序注册表 页面上，找到您创建的 OAuth 终端节点。

7. 单击 OAuth 终端节点名称以打开其详细信息页面。

   

8. 存储客户端 ID 和客户端密钥。

9. 返回 Citrix Cloud 控制台继续执行剩余步骤。

步骤 4：（可选）将本地站点添加到 Citrix Cloud 进行管理

如果您有本地站点并希望使用 ServiceNow ITSM 工作流程管理其资源（例如会话和计算机），请按照以下步骤操作：

1. 登录 Citrix Cloud 并选择您的 Citrix Cloud 帐户。

2. 为您的本地站点创建资源位置，并按照屏幕上的说明在每个位置安装 Cloud Connector。

   有关更多信息，请参阅 Cloud Connector 安装。

3. 完成以下步骤，将这些本地站点添加到 ITSM Adapter 服务中：

   1. 在适用于 ServiceNow 的 ITSM Adapter 磁贴上，单击管理。将出现 ITSM Adapter 页面。

      

   2. 在“管理”选项卡上，打开“启用本地站点”选项。

   3. 单击“添加站点”。将出现“添加站点”页面。

      

   4. 为要管理的网站输入以下信息：

      • 选择此站点所在的资源位置。
      • 在此站点中键入 Delivery Controller 的 FQDN。
      • 键入具有完全管理员角色的站点管理员的凭据，包括用户名、密码和域名。

   5. 单击“测试”。连接测试开始。成功完成后，将显示选定资源位置中的 Cloud Connector。

      

   6. 重复步骤 c—e 以添加剩余的本地站点。