使用Brand Portal將AEM Assets設定為Cloud Service

設定Adobe Experience Manager Assets Brand Portal可讓您將已核准的品牌資產以Cloud Service例項的形式發佈至Brand Portal,並分發給Brand Portal使用者。

使用Cloud Manager啟用Brand Portal

Cloud Manager使用者會為AEM Assets啟用Brand Portal作為Cloud Service例項。 啟動工作流程會在後端建立必要的設定(授權Token、IMS設定和Brand Portal雲端服務),並反映Cloud Manager中Brand Portal租用戶的狀態。 啟用Brand Portal可讓AEM Assets使用者將資產發佈至Brand Portal,並分發給Brand Portal使用者。

必備條件

您需要下列項目,才能以Cloud Service例項形式在您的AEM Assets上啟用Brand Portal:

  • 以Cloud Service例項形式啟動且執行的AEM Assets。
  • 有權存取Cloud Manager的使用者,已指派給Cloud Manager產品的設定檔。 如需詳細資訊,請參閱存取Cloud Manager
注意

作為Cloud Service例項的AEM Assets只有權與一個Brand Portal租用戶連線。 您的AEM Assets可以有多個環境(開發、生產和預備),作為Cloud Service例項,其中Brand Portal會在一個環境中啟動。

啟動Brand Portal的步驟

您可以在將AEM Assets建立為Cloud Service例項時啟用Brand Portal,或個別啟用。 假設環境已建立,您現在必須啟用Brand Portal。

  1. 登入AdobeCloud Manager並導覽至​Environments

    環境​頁面會顯示所有現有環境的清單。

  2. 從清單中選取環境(逐一)以檢視環境詳細資訊。

    Brand Portal有權使用其中一個可用環境,並會反映在​環境資訊​下。

    找到與Brand Portal相關聯的環境後,按一下​啟動Brand Portal​按鈕以開始啟動工作流程。

    啟用Brand Portal

  3. 啟動工作流程會在後端建立必要的設定時,啟動Brand Portal租用戶需要幾分鐘的時間。 啟動Brand Portal租用戶後,狀態會變更為「已啟動」。

    檢視狀態

注意

Brand Portal必須在與AEM Assets相同的IMS組織上啟動,如同Cloud Service例項。

如果您有適用於IMS組織(org1-existing)的現有Brand Portal雲端設定(使用Adobe開發人員控制台手動設定),且您的AEM Assets為Cloud Service例項已針對其他IMS組織(org2-new)設定,則從Cloud manager啟用Brand Portal會將Brand Portal IMS組織重設為org2-new。 雖然在org1-existing上手動設定的雲端設定會顯示在AEM Assets製作例項中,但從Cloud Manager啟動Brand Portal後,將不再使用。

如果現有的Brand Portal雲端設定和AEM Assets作為Cloud Service例項使用相同的IMS組織(org1),您只需從Cloud Manager啟用Brand Portal即可。

另請參閱:

登入您的Brand Portal租用戶:

在Cloud Manager中啟用Brand Portal租用戶後,您可以從Admin Console或直接使用租用戶URL登入Brand Portal。

Brand Portal租用戶的預設URL為:https://<tenant-id>.brand-portal.adobe.com/

其中,租用戶ID為IMS組織。

如果您不確定Brand Portal URL,請執行下列步驟:

  1. 登入Admin Console並導覽至​Products

  2. 從左側邊欄,選取​Adobe Experience Manager Brand Portal - Brand Portal

  3. 按一下​前往Brand Portal​直接在瀏覽器中開啟Brand Portal。

    或從​前往Brand Portal​連結複製Brand Portal租用戶URL,並貼到您的瀏覽器以開啟Brand Portal介面。

    存取Brand Portal

測試連接

執行下列步驟來驗證您作為Cloud Service例項的AEM Assets與Brand Portal租用戶之間的連線:

  1. 登入AEM Assets。

  2. 從​工具​面板,導覽至​部署 > 分發

    在​發佈至Brand Portal​下建立Brand Portal發佈代理程式(bpdistributionagent0)。

  3. 按一下​發佈至Brand Portal​以開啟發佈代理程式。

    您可以在​Status​標籤下看到分發隊列。

    發佈代理程式包含兩個佇列:

    • processing-queue:將資產分配給Brand Portal。

    • error-queue:針對發佈失敗的資產。

    注意

    建議定期檢查故障並清除​error-queue

  4. 若要驗證作為Cloud Service的AEM Assets與Brand Portal之間的連線,請按一下​測試連線​圖示。

    出現一條消息,表明​測試包已成功傳送

    注意

    請避免停用發佈代理程式,因為可能導致在佇列中執行的資產發佈失敗。

若要驗證您作為Cloud Service例項的AEM Assets與Brand Portal租用戶之間的連線,請從AEM Assets發佈資產至Brand Portal。 如果連線成功,已發佈的資產會顯示在Brand Portal介面中。

您現在可以:

如需詳細資訊,請參閱Brand Portal檔案

發佈記錄檔

您可以監視資產發佈工作流程的發佈代理程式記錄檔。

現在讓我們將資產從AEM Assets發佈至Brand Portal並查看日誌。

  1. 請依照​測試連線​區段中所示步驟(從1到4)操作,並導覽至發佈代理程式頁面。

  2. 按一下​記錄​以檢視處理和錯誤記錄。

發佈代理程式已產生下列記錄檔:

  • 資訊:這是系統產生的記錄檔,會在成功設定發佈代理時觸發。
  • DSTRQ1(請求1):測試連線時觸發。

發佈資產時,會產生下列請求和回應記錄檔:

發佈代理程式請求

  • DSTRQ2 (請求 2):觸發資產發佈請求。
  • DSTRQ3(請求3):系統會觸發另一個請求以發佈AEM Assets資料夾(資產存在其中)並複製Brand Portal中的資料夾。

發佈代理程式回應

  • queue-bpdistributionagent0 (DSTRQ2):資產已發佈至 Brand Portal。
  • queue-bpdistributionagent0(DSTRQ3):系統會複製Brand Portal中的AEM Assets資料夾(包含資產)。

在上述範例中,會觸發其他請求和回應。 系統在Brand Portal中找不到父資料夾(新增路徑),因為資產是首次發佈,因此會觸發其他請求,在發佈資產的Brand Portal中建立同名的父資料夾。

注意

如果父資料夾不存在於Brand Portal中或已在AEM Assets中修改,則會產生其他請求。

除了在AEM Assets上以Cloud Service啟動Brand Portal的自動化工作流程之外,還有其他方法可使用Adobe開發人員控制台(不建議再使用),以Brand Portal手動將AEM Assets設為Cloud Service。

注意

如果您在啟用Brand Portal租用戶時遇到任何問題,請聯絡Adobe支援。

使用Adobe開發人員控制台手動配置

以下章節說明如何使用「Adobe開發人員控制台」,以手動方式將AEM Assets設為Cloud Service搭配Brand Portal。

過去,AEM Assets as a Cloud Service是透過Brand Portal開發人員控制台手動設定,這會擷取AdobeIdentity Management服務(IMS)帳戶代號,以授權Brand Portal租用戶。 這需要在AEM Assets和Adobe開發人員控制台中進行設定。

  1. 在AEM Assets中,建立IMS帳戶並產生公開金鑰(憑證)。
  2. 在Adobe開發人員控制台中,為您的Brand Portal租用戶(組織)建立專案。
  3. 在專案下,使用公開金鑰設定API以建立服務帳戶連線。
  4. 取得服務帳戶認證和JSON網頁代號(JWT)裝載資訊。
  5. 在AEM Assets中,使用服務帳戶憑證和JWT裝載來設定IMS帳戶。
  6. 在AEM Assets中,使用IMS帳戶和Brand Portal端點(組織URL)來設定Brand Portal雲端服務。
  7. 將資產從AEM Assets發佈至Brand Portal,以測試您的設定。
注意

AEM Assets作為Cloud Service例項時,只能設定一個Brand Portal租用戶。

必備條件

您需要下列項目才能使用 Brand Portal 設定 AEM Assets:

  • 啟動並執行AEM Assets作為Cloud Service例項
  • Brand Portal租用戶URL
  • 在Brand Portal租用戶的IMS組織上具有系統管理員權限的使用者

建立設定

以指定順序執行下列步驟,使用Brand Portal設定AEM Assets。

  1. 取得公開憑證
  2. 建立服務帳戶(JWT)連線
  3. 設定IMS帳戶
  4. 設定雲端服務

建立 IMS 設定

IMS設定會以Brand Portal租戶驗證您的AEM Assets作為Cloud Service例項。

IMS 設定包括兩個步驟:

取得公開憑證

公開金鑰(憑證)會在Adobe開發人員控制台中驗證您的設定檔。

  1. 登入AEM Assets。

  2. 從​工具​面板,導覽至​安全性 > AdobeIMS設定

  3. 在「AdobeIMS設定」頁面中,按一下「建立」。 它會重新導向至​AdobeIMS技術帳戶設定​頁面。 依預設,會開啟​Certificate​標籤。

  4. 在​雲解決方案​下拉式清單中,選取​AdobeBrand Portal

  5. 選中「建立新證書​」複選框,並為公鑰指定​別名​​別名用作公鑰的名稱。

  6. 按一下​建立憑證。然後,按一下​OK​以產生公開金鑰。

    建立憑證

  7. 按一下​下載公開密鑰​表徵圖並將公開密鑰(CRT)檔案保存在電腦上。

    公開金鑰稍後會用來設定Brand Portal租用戶的API,以及在Adobe開發人員控制台中產生服務帳戶憑證。

    下載憑證

  8. 按一下​下一步

    在​帳戶​標籤中,建立AdobeIMS帳戶,此帳戶需要在Adobe開發人員控制台中產生的服務帳戶憑證。 暫時保持此頁面開啟。

    開啟新標籤,並在Adobe開發人員控制台🔗中建立服務帳戶(JWT)連線,以取得用於設定IMS帳戶的憑證和JWT裝載。

建立服務帳戶(JWT)連線

在「Adobe開發人員控制台」中,專案和API是在Brand Portal租用戶(組織)層級設定。 設定API會建立服務帳戶(JWT)連線。 有兩種方法可用來設定API,方法是產生金鑰組(私密和公開金鑰)或上傳公開金鑰。 若要使用Brand Portal設定AEM Assets,您必須在AEM Assets中產生公開金鑰(憑證),並透過上傳公開金鑰在Adobe開發人員控制台中建立憑證。 您必須具備這些憑證才能在AEM Assets中設定IMS帳戶。 設定IMS帳戶後,您就可以在AEM Assets中設定Brand Portal雲端服務。

執行下列步驟以產生服務帳戶憑證和JWT裝載:

  1. 以IMS組織(Brand Portal租用戶)的系統管理員權限登入Adobe開發人員控制台。 預設URL為https://www.adobe.com/go/devs_console_ui

    注意

    確認您已從右上角的下拉式清單(組織)中選取正確的IMS組織(Brand Portal租用戶)。

  2. 按一下「建立新項目」。 系統會為您的組織建立一個空白專案,其名稱為系統產生。

    按一下​編輯項目​以更新​項目標題​和​說明,然後按一下​保存

  3. 在​專案概述​標籤中,按一下​新增API

  4. 在​新增API視窗​中,選取​AEM Brand Portal​並按一下​下一步

    確定您擁有AEM Brand Portal服務的存取權。

  5. 在​設定API​視窗中,按一下​上傳公開金鑰。 然後,按一下​選擇檔案​並上載您在獲取公共證書部分下載的公鑰(.crt檔案)。

    按一下​下一步

    上傳公開金鑰

  6. 驗證公鑰,然後按一下​Next

  7. 選擇​Assets Brand Portal​作為預設產品配置檔案,然後按一下​保存配置的API

    選取產品設定檔

  8. 設定API後,系統會將您重新導向至API概觀頁面。 在​Credentials​下的左側導航中,按一下​服務帳戶(JWT)​選項。

    注意

    您可以檢視憑證並執行下列動作:產生JWT代號、複製憑證詳細資訊、擷取用戶端密碼等。

  9. 從​客戶端憑據​頁簽,複製​客戶端ID

    按一下​擷取用戶端密碼​並複製​用戶端密碼

    服務帳戶憑據

  10. 導覽至​產生JWT​標籤,並複製​JWT裝載​資訊。

您現在可以使用用戶端ID(API金鑰)、用戶端密碼,以及JWT裝載來設定AEM Assets中的IMS帳戶

設定IMS帳戶

請確認您已執行下列步驟:

執行下列步驟來設定IMS帳戶。

  1. 開啟IMS設定,並導覽至​Account​標籤。 在取得公開憑證時,您已保持頁面開啟。

  2. 指定 IMS 帳戶的​標題

    在​授權伺服器​欄位中,指定URL:https://ims-na1.adobelogin.com/

    建立服務帳戶(JWT)連線時您複製的​API金鑰​欄位、用戶端密碼​和​裝載(JWT裝載)中指定用戶端ID。

    按一下​建立

    已設定IMS帳戶。

    IMS 帳戶設定

  3. 選取IMS帳戶設定,然後按一下「檢查健康狀況」。

    按一下對話框中的​Check。 成功配置時,將顯示一條消息,說明已成功檢索​令牌

注意

您只能有一個IMS設定。

確認IMS設定通過健康狀況檢查。 如果配置未通過運行狀況檢查,則無效。 您必須刪除它,然後建立新的有效配置。

設定雲端服務

執行下列步驟以設定Brand Portal雲端服務:

  1. 登入AEM Assets。

  2. 從​工具​面板,導覽至​Cloud Services > AEM Brand Portal

  3. 在「Brand Portal設定」頁面中,按一下「建立」。

  4. 指定設定的​標題

    選取您在設定IMS帳戶時建立的IMS設定。

    在​服務URL​欄位中,指定您的Brand Portal租用戶(組織)URL。

  5. 按一下​「儲存並關閉」。雲端設定此時已建立。

    您的AEM Assets as a Cloud Service例項現在已透過Brand Portal租用戶完成設定。

您現在可以檢查發佈代理程式並將資產發佈至Brand Portal,以測試設定。

本頁內容