Azure DevOps 模組

在 Adobe Workfront Fusion 情境中,您可以將使用 Azure DevOps 的工作流程自動化,以及將其連接至多個第三方應用程式和服務。

關於建立情境的說明,請參閱建立情境:文章索引之下的文章。

關於模組的資訊,請參閱模組:文章索引之下的文章。

存取權要求

展開以檢視這篇文章中所述功能的存取權要求。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront 封裝

任何 Adobe Workfront Workflow 封裝及任何 Adobe Workfront Automation and Integration 封裝

Workfront Ultimate

Workfront Prime 和 Select 封裝,以及額外購買的 Workfront Fusion。

Adobe Workfront 授權

標準

工作或更高層級

Adobe Workfront Fusion 授權

作業型:適用於擁有作業型授權的組織

連接器型 (舊版):Workfront Fusion for Work Automation and Integration

產品 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。

若要詳細了解此表格中的資訊,請參閱🔗文件中的存取權要求。

關於 Adobe Workfront Fusion 授權的資訊,請參閱 Adobe Workfront Fusion 授權。

先決條件

若要使用Azure DevOps模組,您必須有Azure DevOps帳戶。

Azure DevOps API資訊

Azure DevOps聯結器使用下列專案:

API 版本
v5.1
API 標記
v1.29.33

將 Azure DevOps 連接至 Workfront Fusion connect-azure-devops-to-workfront-fusion

使用同盟連線將Azure DevOps連線至Adobe Workfront Fusion

同盟連線的運作方式與服務主體連線類似,只是它不使用使用者端密碼。

與其儲存秘密,不如告訴Microsoft Entra ID信任Workfront Fusion針對某個特定連線所發行的權杖。 連線執行時,Fusion會提供短暫的身分證明,且Microsoft Entra ID會傳回存取權杖。 因為沒有使用者端密碼,所以沒有到期的專案,也沒有要輪換或儲存的密碼。

展開以檢視使用同盟連線將Azure DevOps連線至Adobe Workfront Fusion的說明。
note
NOTE
  • 設定此連線需要造訪Microsoft Entra管理中心兩次。 您先註冊應用程式,然後在Workfront Fusion中建立連線,然後傳回Microsoft Entra ID以新增同盟認證。 這是因為同盟認證識別了一個特定連線,而該識別碼在建立連線之前並不存在。
  • 此連線的限制與服務主體連線相同。 少數管理員層級的動作(例如管理使用者授權)仍需要個人帳戶連線。

使用同盟連線將Azure DevOps連線至Workfront Fusion的必要條件

若要建立此連線,您需要下列專案:

  • Microsoft Entra ID中的全域管理員或應用程式管理員存取權,可註冊應用程式並新增同盟認證。 如果您沒有此存取權,請要求您IT或身分團隊中的某人為您完成這些步驟。
  • 您Azure DevOps組織中的專案集合管理員存取權,以將服務主體新增為成員。 管理Microsoft Entra ID的人通常不是這個人。
  • Azure DevOps組織的名稱。 您可以在Azure DevOps URL中找到此專案: dev.azure.com/<your organization name>。

在Microsoft Entra ID (同盟連線)中建立應用程式註冊

  1. 登入Microsoft Entra管理中心。
  2. 前往「應用程式註冊>新註冊」。
  3. 為應用程式提供一個清晰且可辨識的名稱。 例如 Workfront Fusion Azure DevOps Integration。
  4. 將重新導向URI保留空白。 此連線不涉及透過瀏覽器登入。
  5. 選取「註冊」。
  6. 請勿建立使用者端密碼。 同盟連線不使用。
  7. 繼續收集您的連線詳細資料。

收集您的連線詳細資料(同盟連線)

  1. 從應用程式註冊的「概觀」頁面,請注意下列值。 在模組中建立連線時,請輸入這些連線。

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    租使用者ID 在概觀頁面上,標示為目錄(租使用者) ID。
    用戶端 ID 在概觀頁面上,標示為應用程式(使用者端) ID。
    組織 您的Azure DevOps組織名稱。 例如,若您的URL為dev.azure.com/yourorg,請輸入yourorg。
  2. 繼續在Workfront Fusion中建立連線。

note
NOTE
與服務主要連線一樣,您可以略過應用程式註冊的API許可權區域。 在下一個程式中,Azure DevOps的存取權會在Azure DevOps中授予。

在Workfront Fusion (同盟連線)中建立連線

  1. 在模組的連線設定畫面中,選取同盟連線型別。

  2. 輸入下列:

    • 租使用者ID
    • 用戶端 ID
    • 組織
  3. 選取「建立」。

    Workfront Fusion會顯示三個值。 請保持此頁面開啟,因為您稍後在建立連線的過程中會需要這些值。

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
    Issuer https://oidc.automations.adobe.com.
    主旨 這會識別此連線。 它看起來像fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964。 您建立的每個連線都不同。
    對象 api://AzureADTokenExchange.
    note important
    IMPORTANT
    請勿關閉面板或選取「取消」。 連線要等到您完成其餘程式後才會完成。 如果關閉面板,您必須刪除連線並重新開始,因為新的連線會收到新的主旨。
  4. 複製​ 主旨 ​值。

  5. 繼續在Microsoft Entra ID中新增Federated認證。

在Microsoft Entra ID中新增Federated認證

此程式會取代使用者端密碼。 它會通知Microsoft Entra ID接受Workfront Fusion針對這個連線所發行的代號。

  1. 在新的瀏覽器標籤中,返回Microsoft Entra管理中心並開啟您的應用程式註冊。

  2. 前往「憑證和密碼>同盟認證」。

  3. 選取「新增認證」。

  4. 在「同盟認證」案例中,選取「其他簽發者」。

  5. 輸入下列:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Issuer https://oidc.automations.adobe.com
    主體識別碼 您從Workfront Fusion複製的主體。 完全貼上,不新增空格。
    名稱 可識別此連線的名稱,以便您稍後尋找。 例如 workfront-fusion-connection-28964。
    對象 api://AzureADTokenExchange. 這通常會為您填入。 保留預設值。
  6. 按一下​新增。

  7. 繼續驗證連線。

note
NOTE
Microsoft Entra ID在單一應用程式註冊中最多可允許20個同盟認證,且主體識別碼必須完全相符。 不支援萬用字元。 由於每個Workfront Fusion連線都有自己的主旨,因此每個連線都需要有自己的同盟認證。 如果您需要超過20個連線,請註冊多個應用程式並在這些應用程式之間分配連線。

驗證連線(同盟連線)

  1. 返回Workfront Fusion瀏覽器索引標籤,其中連線面板仍處於開啟狀態。

  2. 按一下「儲存」。

    • 如果所有專案皆已正確設定,連線將會成功驗證,您可以繼續設定模組。
    • 如果驗證失敗,面板會保持開啟並顯示錯誤。 請更正Microsoft Entra ID或Azure DevOps中的問題,然後再次選取「儲存」。 您不需要重新建立連線,而且主旨不會變更。
note
NOTE
您在Microsoft Entra ID中新增的Federated Credential可能需要很短時間才會生效。 如果您在新增認證後驗證立即失敗,請稍候片刻,然後再次選取[儲存],以進一步調查。

疑難排解

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
連線驗證失敗,發生無效的使用者端或無效的請求錯誤 Microsoft Entra ID無法比對權杖與同盟認證。 檢查簽發者是否剛好是https://oidc.automations.adobe.com,沒有結尾斜線,而且主旨識別碼與Workfront Fusion中顯示的主旨完全相同(字元對字元)。 從不同連線複製的主體是最常見的原因。
連線會驗證,但模組從Azure DevOps傳回401或403 此身分值得信任,但無法存取您的Azure DevOps資料。 確認您已完成將服務主體新增至您的Azure DevOps組織,且服務主體已指派給模組使用的特定專案。
您無法新增其他同盟認證 您已達到該應用程式註冊的20個同盟認證限制。 註冊其他應用程式並針對其建立進一步的連線。

使用EntraApp將Azure DevOps連線至Workfront Fusion

您可以使用EntraApp將Azure DevOps連線至Workfront Fusion。

展開以檢視使用EntraApp將Azure DevOps連線至Workfront Fusion的說明
  1. 將Azure DevOps模組新增至您的情境。

  2. 按一下連線欄位旁的​新增。

  3. 在連線型別欄位中,選取您要使用的連線型別。

    note
    NOTE
    Azure DevOps (EntraApp)可讓您要求連線的所有領域。
  4. 填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    連線名稱 輸入您正在建立的連線名稱。
    組織 輸入您建立Azure DevOps應用程式的組織名稱。
    應用程式ID 輸入您要連線的DevOps應用程式ID。
    用戶端密碼 輸入您要連線之DevOps應用程式的使用者端密碼。
    要求所有範圍 如果您使用Azure DevOps (EntraApp)連線型別,請啟用此選項以要求連線的所有範圍。
  5. 若要輸入Azure DevOps應用程式ID或使用者端密碼,請按一下[顯示進階設定] ,然後在開啟的欄位中輸入這些設定。

    . 按一下​ 繼續 ​完成連線的設定並繼續建立您的情境。

*### 使用服務主體將Azure DevOps連線至Workfront Fusion您可以建立使用服務主體(應用程式API連線)而不是個人帳戶的連線。 如果您希望連線以應用程式或服務身分而非特定人員的身分執行,這會很有用。 這可能會很有用,舉例來說,若某人離開公司或變更密碼,整合就不會中斷。此連線型別適用於所有Azure DevOps模組。展開以檢視使用服務主體將Azure DevOps連線至Adobe Workfront Fusion的說明。 NOTE服務主體驗證不支援所有Azure DevOps功能。 少數管理員層級的動作(例如管理使用者授權)仍需要個人帳戶連線。 如果您只需要工作專案、面板、存放庫或管道的驗證,請使用服務主體驗證。 使用服務主體將Azure DevOps連線至Workfront Fusion的先決條件

  1. 移至​應用程式註冊 > 新註冊。

  2. 為應用程式提供一個清晰且可辨識的名稱。 例如 Workfront Fusion Azure DevOps Integration。

  3. 將​ 重新導向URI ​保留空白。 此連線不涉及透過瀏覽器登入。

  4. 選取​註冊。

  5. 繼續建立使用者端密碼。#### 建立使用者端密碼1) 在您的新應用程式註冊中,移至​憑證與密碼。

  6. 選取​新增使用者端密碼、新增說明,並選擇到期期間。

  7. 選取​新增。

  8. 立即複製密碼的​值。 它只會顯示一次。 如果您在複製它之前瀏覽離開,則必須建立一個新的專案。

  9. 繼續收集您的連線詳細資料。#### 收集您的連線詳細資料(服務主體)1) 從應用程式註冊的​ 總覽 ​頁面,請注意下列值。 在模組中建立連線時,請輸入這些連線。

    租使用者ID

    在概觀頁面上,標示為目錄(租使用者) ID。

    用戶端 ID

    在概觀頁面上,標示為應用程式(使用者端) ID。

    用戶端密碼

    您在中複製的值建立使用者端密碼。

    組織

    您的Azure DevOps組織名稱。 例如,若您的URL為dev.azure.com/yourorg,請輸入yourorg。

    NOTE

    您可以略過應用程式註冊的​ API許可權 ​區域。 如果您在那裡新增Azure DevOps,則只有​ 委派許可權 ​可用。 應用程式許可權​顯示為灰色。 這是預期中的情形,因為Azure DevOps不支援以這種方式授與存取權。 取而代之的是,存取權會在下一部分直接在Azure DevOps中授予。

  10. 繼續將服務主體新增至您的Azure DevOps組織。#### 將服務主體新增至您的Azure DevOps組織在Microsoft Entra ID中註冊應用程式只會建立其身分識別。 應用程式尚未取得您Azure DevOps資料的任何存取權。 此程式會授予該存取權。1) 在dev.azure.com/<your organization name>登入您的Azure DevOps組織。

  11. 選取左下方的​組織設定,然後選取​使用者。

  12. 選取​新增使用者。

  13. 在搜尋方塊中,依應用程式的顯示名稱(您在註冊應用程式時提供的名稱)進行搜尋。 請勿依據使用者端ID進行搜尋。

  14. 選取存取層級:

    • Basic​通常足以讀取和寫入工作專案、展示板和存放庫。
    • 如果您的工作流程需要在設定過程中瀏覽可用的程式,例如,敏捷、Scrum或自訂範本,請改為將服務主體新增到​ 專案集合管理員 ​群組。 這是更廣的存取層級,因此僅在您需要該功能時授與它。
  15. 按照您組織的一般存取實務,將服務主體指派給所需的特定專案。

  16. 選取​新增。

  17. 繼續在Workfront Fusion中建立連線。#### 在Workfront Fusion (服務主體)中建立連線1) 在模組的連線設定畫面中,選取​ 服務主體 ​連線型別。

  18. 輸入下列:

    • 租使用者識別碼
    • 使用者端識別碼
    • 使用者端密碼
    • 組織
  19. 儲存連線。

    如果一切設定正確,連線都會成功驗證。## Azure DevOps模組及其欄位當您設定 Azure DevOps 模組時,Workfront Fusion 會顯示下列欄位。 除了這些欄位以外,也可能因為其他因素,例如您在應用程式或服務中的存取層級,而顯示其他 Azure DevOps 欄位。 在模組中,粗體標題表示那是必要欄位。若在欄位或函式上方看到對應按鈕,可以使用按鈕設定該欄位的變數和函式。 如需詳細資訊,請參閱將資訊從一個模組對應到另一個模組。 對應切換 * 觸發程序

recommendation-more-help
workfront-fusion-help-workfront-fusion