配置 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® Quality Manager 伺服器
      • My RNDG Server 可識別 Rational DOORS Next Generation 伺服器
      • 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 2.0.0.x 版到 3.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:
        小心: Rational Quality Manager 的應用程式環境定義在 3.0.1 版以及更新版本中已變更。如果您先前已配置與舊版 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 7.1.1 版 (oslc/cqrest) 到 7.1.2 版 (cqweb/oslc) 已有所變更。任何使用 ClearQuest OSLC 「變更管理」URI 的程式碼,都必須更新為使用新的基本 URI,如下所述。如需詳細資料,請參閱「ClearQuest OSLC 變更管理 API 規格」,網址為 https://jazz.net/wiki/bin/view/Main/RcmRestCmApi
      小心: 強烈建議配置 ClearQuest Web 伺服器通訊來使用 SSL,因為當使用者登入時,是以未加密的文字格式來傳送使用者的密碼。
      • ClearQuest 7.1.2 及 7.1.2.1 版:
        小心: 在 ClearQuest 7.1.2 及 7.1.2.1 版中,僅支援在埠 12443 上使用 SSL。使用埠 12443 時,Rich Hover(多樣式浮動說明)就沒有作用。
        • 如果配置 SSL:

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

        • 如果未配置 SSL:

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

      • 若為 ClearQuest 7.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 節點相當於 Jazz 伺服器 rootservices URI 的 ClearQuest Web 伺服器。

      範例

      若為 ClearQuest 7.1.2.2 版,以下是配置為使用 SSL 通訊的 ClearQuest Web 伺服器型 OSLC 服務提供者的「根服務 URI」範例:

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

    3. . 在 OAuth 密碼重新輸入密碼欄位中,輸入與新的 OAuth 消費者金鑰相關的「OAuth 密碼」代碼詞組。
      小心: 在此步驟中,您不是輸入金鑰本身,而是輸入與金鑰相關的較短詞組。
    4. 選用項目:選取授信勾選框。授信消費者能夠與其他授信消費者共用權限,且不需要使用者核准即能存取資料。
      小心: 若為外部產品或網站,最好清除授信勾選框。
    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. 記錄臨時金鑰值。如果您在目標伺服器上具有管理者專用權,則可以登入目標伺服器並自行核准要求。否則,您必須請求目標伺服器管理者來核准您的要求。您可能需要提供臨時金鑰值給目標伺服器管理者。

意見