配置 ClearQuest Web 服务器,以进行跨服务器通信

使用“站点配置”界面的“跨服务器通信”窗口,指定要用来建立服务器到服务器通信的目标 OSLC 服务提供程序。

关于此任务

输入目标服务器的位置信息和代码口令,用作 OAuth 私钥。然后请求访问该服务器以创建 OAuth 使用者密钥,并将该信息存储在好友列表中。 另一个服务器授权 OAuth 密钥之后, ClearQuest® Web 服务器可以与目标服务器交互。

过程

  1. 以“超级用户”用户身份登录 ClearQuest Web。
  2. 单击 ClearQuest Web 工具栏上的 站点管理 > 跨服务器通信选项。 这样会打开跨服务器通信窗口。
  3. 指定请求的有关要用来建立通信的目标服务器的信息:
    1. 标题字段,输入一个标题来标识目标服务器。例如:
      • 输入 My RTC Server 来标识 Rational Team Concert™ 服务器
      • 输入 My RQM Server 来标识 Rational® QualityManager 服务器
      • 输入 My RRC Server 来标识 Rational Requirements Composer 服务器
      • 输入 My CQWeb Server2 以标识另一个 ClearQuest Web 服务器
    2. 根服务 URI 字段中, 使用以下格式,输入要将其添作友元的应用程序目标根服务的 URI:
      对于基于 Jazz™ 服务器的产品:
      https://friend-server:port-number/context/rootservices
      其中变量的含义如下:
      friend-server
      友机服务器的主机名。
      注意: 确保使用标准域名的公共 URL 指定主机名。请勿指定 IP 地址。
      port-number
      可以用来访问服务器的端口号。
      context
      应用程序上下文。此参数是配置参数。以下是缺省值:
      • Rational Team Concert
        注意: Rational Team Concert 应用程序上下文已经从 V2.0.0.x 更改为 V3.0 以及更高版本。如果先前配置了与 Rational Team Concert 2.0.0.x 的跨服务器通信,并且现在要配置与 Rational Team Concert 3.0 以及更高版本的通信,那么您必须更新站点管理 > 跨服务器通信窗口中的根服务 URI
        • 在 Rational Team Concert 2.0.0.x 中:jazz
        • 在 Rational Team Concert 3.0 以及更高版本中:ccm
      • Rational Quality Manager:
        注意: 在 V3.0.1 以及更高版本中,Rational Quality Manager 应用程序上下文已变更。如果先前配置了与较早版本 Rational Quality Manager 的跨服务器通信,那么必须更新站点管理 > 跨服务器通信窗口中的“根服务 URI”。
        • Rational Quality Manager 3.0:jazz
        • Rational Quality Manager 3.0.1:qm
      • Rational Requirements Composer:
        • Rational Requirements Composer 3.0.1:rm
        注意: 如果将 Rational Requirements Composer 2.x 项目更新至 3.0.1,那么必须保留 rdm 应用程序上下文,请勿使用 rm 上下文。请参阅下列主题以了解详细信息:

      示例

      这里有几个基于 Jazz 服务器 OSLC 服务提供程序的“根服务 URI”示例:

      https://jazz1.bldg1.india.mycompany.com:9443/ccm/rootservices

      https://jazz4.bldg5.japan.mycompany.com:9443/qm/rootservices

      https://jazz4.bldg5.spain.mycompany.com:9443/rm/rootservices

      ClearQuest Web 服务器:
      注意: ClearQuest Web 服务器的应用程序上下文已经从 Rational ClearQuest V7.1.1 (oslc/cqrest) 变更为 V7.1.2 (cqweb/oslc)。要使用接下来描述的新的基本 URI,必须更新 任何使用 ClearQuest OSLC 变更管理 URI 的代码。有关详细信息,请参阅 https://jazz.net/wiki/bin/view/Main/RcmRestCmApi 中的 ClearQuest OSLC 变更管理 API 规范。
      注意: 最好配置 ClearQuest Web 服务器通信以使用 SSL, 因为用户登录时所用的用户密码是以没有加密的文本格式发送。
      • 对于ClearQuest V7.1.2 和 V7.1.2.1:
        注意: 对于 ClearQuest V7.1.2 和 V7.1.2.1,仅在端口 12443 上支持 SSL。使用端口 12443 时,富悬浮框不可用。
        • 如果已配置 SSL:

          https://hostname:12443/context/oslc/repo/dbset/discovery

        • 如果没有配置 SSL:

          http://hostname/context/oslc/repo/dbset/discovery

      • ClearQuest V7.1.2.2:
        • 如果已配置 SSL:

          https://hostname/context/oslc/repo/dbset/discovery

        • 如果没有配置 SSL:

          http://hostname/context/oslc/repo/dbset/discovery

      其中变量的含义如下:
      hostname
      友机服务器的主机名。
      注意: 确保使用标准域名的公共 URL 指定主机名。请勿指定 IP 地址。
      context
      应用程序上下文。示例:ClearQuest Web 服务器 cqweb
      dbset
      存储库(数据库集)名称。

      URI 中的 discovery 节点是 ClearQuest Web 服务器, 该服务器等同于 Jazz 服务器 rootservices URI。

      示例

      对于 ClearQuest V7.1.2.2, 这里有一个根服务 URI 的示例,它用于配置基于 ClearQuest Web 服务器 OSLC 服务提供程序,以便使用 SSL 通信:

      https://cqweb4.bldg4.china.mycompany.com/cqweb/oslc/repo/mydbset/discovery

    3. . 在 OAuth 私钥重新输入私钥字段中, 输入 OAuth 私钥代码口令以与新的 OAuth 使用者密钥关联。
      注意: 在这一步中, 请勿输入密钥本身,而是输入一个与该密钥关联的较短口令。
    4. 可选:选择可信复选框。 可信使用者可与其他可信使用者共享授权,并且无需用户核准便可访问数据。
      注意: 对于外部产品或 Web 站点,最好清除可信复选框。
    5. 单击请求访问权。向目标服务器请求临时密钥,访问信息已添加到页面的“服务器友机列表”部分。新条目已添加到“授权临时密钥”部分。
    6. 授权临时 OAuth 使用者密钥。
      这种情况下,目标服务器将不授权访问请求。使用以下方法核准请求:
      1. 如果该链接显示在“授权临时密钥”部分,并且您有目标服务器的管理员特权(基于 Jazz 服务器 JazzAdmins 组中的成员),那么单击授权访问临时密匙
        • 如果目标服务器是基于 Jazz 的服务器,有关授权临时密匙的指示信息,请参阅 Rational Team Concert 帮助。
        • 如果目标服务器是另一个 ClearQuest Web 服务器,请参阅核准 OAuth 使用者密匙
        注: 如果 OAuth 提供程序没有提供授权 URI,那么授权访问临时密匙链接不会显示。Rational ClearQuest和 Rational Team Concert 可能提供该链接;但 Rational Quality Manager 不会提供。如果“授权临时密钥”部分中没有显示授权访问临时密匙链接, 或您没有目标服务器的管理员特权,那么必须选择下面的选项 ii。
      2. 记录临时密匙值。如果您有目标服务器的管理员特权,可以登录目标服务器,亲自核准请求。否则,必须请求目标服务器管理员来核准您的请求。您可能需要向目标服务器管理员提供临时密匙。

反馈