使用 Brand Portal 設定 AEM Assets configure-integration-65
Adobe Experience Manager Assets Brand Portal可讓您將核准的品牌資產從Adobe Experience Manager資產發佈到Brand Portal,並分發給Brand Portal使用者。
AEM Assets是透過Brand Portal主控台使用Adobe Developer設定的,這可取得AdobeIdentity Management Services (IMS)帳戶Token以授權Brand Portal租使用者。
以下說明介紹以下兩個使用案例:
所提供的資訊是基於任何閱讀本「說明」的人員都熟悉以下技術的假設:
-
安裝、設定和管理Adobe Experience Manager和AEM套件。
-
使用Linux®和Microsoft® Windows作業系統。
先決條件 prerequisites
您需要下列項目才能使用 Brand Portal 設定 AEM Assets:
- 具最新Service Pack且正在執行中的AEM Assets作者執行個體
- Brand Portal租使用者URL
- 在Brand Portal租使用者的IMS組織具有系統管理員許可權的使用者
下載並安裝AEM 6.5 aemquickstart
建議使用AEM 6.5設定AEM Author例項。 如果您尚未啟動並執行AEM,請從下列位置下載:
-
如果您是現有AEM客戶,請從下載AEM 6.5 Adobe授權網站.
-
如果您是Adobe合作夥伴,請使用 Adobe合作夥伴訓練計畫 請求AEM 6.5。
下載AEM後,如需設定AEM Author例項的指示,請參閱 部署和維護.
下載並安裝AEM最新Service Pack servicepack
如需詳細指示,請參閱目前的 AEM 6.5 Service Pack發行說明.
聯絡Adobe客戶支援 如果您找不到最新的AEM套件或Service Pack。
建立設定 configure-new-integration-65
使用Brand Portal設定AEM Assets需要在AEM Assets作者執行個體和Adobe Developer Console中進行設定。
- 在AEM Assets中,建立IMS帳戶並產生公開憑證(公開金鑰)。
- 在Adobe Developer主控台中,為您的Brand Portal租使用者(組織)建立專案。
- 在專案下,使用公開金鑰設定API以建立服務帳戶(JWT)連線。
- 取得服務帳戶憑證和JWT裝載資訊。
- 在AEM Assets中,使用服務帳戶憑證和JWT裝載設定IMS帳戶。
- 在AEM Assets中,使用IMS帳戶和Brand Portal端點(組織URL)設定Brand Portal雲端服務。
- 從AEM Assets發佈資產到Brand Portal以測試設定。
如果您是第一次使用Brand Portal設定AEM Assets,請依照列出的順序執行下列步驟:
建立 IMS 設定 create-ims-configuration
IMS設定會向AEM Assets租使用者驗證您的Brand Portal Author例項。
IMS 設定包括兩個步驟:
取得公開憑證 public-certificate
公開金鑰(憑證)會在Adobe Developer Console上驗證您的設定檔。
-
登入您的AEM Assets Author例項。 預設URL為
http://localhost:4502/aem/start.html
. -
從 工具 面板,導覽至 安全性 > Adobe IMS設定.
-
在Adobe IMS設定頁面中,按一下 建立. 它會重新導向至 Adobe IMS技術帳戶設定 頁面。 根據預設, 憑證 標籤開啟。
-
選取 AdobeBrand Portal 在 雲端解決方案 下拉式清單。
-
選取 建立新憑證 核取方塊並指定 別名 以取得公開金鑰。 別名的作用是公開金鑰的名稱。
-
按一下 建立憑證。然後,按一下 確定 以產生公開金鑰。
-
按一下 下載公開金鑰 圖示並將公開金鑰(.crt)檔案儲存在電腦上。
公開金鑰稍後將用於設定Brand Portal租使用者的API,以及在Adobe Developer主控台中產生服務帳戶認證。
-
按一下 下一步。
在 帳戶 索引標籤中,會建立一個Adobe IMS帳戶,而這需要Adobe Developer主控台中產生的服務帳戶認證。 暫時保持此頁面開啟。
開啟新標籤並 在Adobe Developer主控台中建立服務帳戶(JWT)連線 以便取得認證和JWT裝載來設定IMS帳戶。
建立服務帳戶(JWT)連線 createnewintegration
在Adobe Developer主控台中,專案和API是在Brand Portal租使用者(組織)層級設定。 設定API會建立服務帳戶(JWT)連線。 有兩種方式可設定API:產生金鑰組(私密金鑰和公開金鑰)或上傳公開金鑰。 若要使用Brand Portal設定AEM Assets,您必須在AEM Assets中產生公開金鑰(憑證),並透過上傳公開金鑰在Adobe Developer Console中建立憑證。 在AEM Assets中設定IMS帳戶需要這些認證。 設定IMS帳戶後,您可以在AEM Assets中設定Brand Portal雲端服務。
若要建立服務帳戶憑證和JWT裝載,請執行以下操作:
-
以IMS組織(Adobe Developer租使用者)的系統管理員許可權登入Brand Portal主控台。 預設URL為 https://www.adobe.com/go/devs_console_ui.
note note NOTE 確保您已從右上角的下拉式清單(組織)中選取正確的IMS組織(Brand Portal租使用者)。 -
按一下 建立新專案. 系統會為您的組織建立名稱由系統產生的空白專案。
按一下 編輯專案 以便更新 專案標題 和 說明,然後按一下 儲存.
-
在 專案概述 標籤,按一下 新增API.
-
在 新增API視窗,選取 AEM Brand Portal 並按一下 下一個.
確定您有權存取AEM Brand Portal服務。
-
在 設定API 視窗,按一下 上傳您的公開金鑰. 然後,按一下 選取檔案 並上傳您在中下載的公開金鑰(.crt檔案) 取得公開憑證 區段。
按一下「下一步」。
-
驗證公開金鑰並按一下 下一個.
-
選取 Assets Brand Portal 作為預設產品設定檔,然後按一下 儲存已設定的API.
-
設定API後,您會重新導向至API概觀頁面。 從左側導覽列於 認證,按一下 服務帳戶(JWT) 選項。
note note NOTE 您可以檢視認證並執行產生JWT權杖、複製認證詳細資料和擷取使用者端密碼等動作。 -
從 使用者端認證 標籤,複製 使用者端ID.
按一下 擷取使用者端密碼 並複製 使用者端密碼.
-
導覽至 產生JWT 標籤並複製 JWT裝載 資訊。
您現在可以將使用者端ID (API金鑰)、使用者端密碼和JWT裝載使用至 設定IMS帳戶 在AEM Assets中。
設定IMS帳戶 create-ims-account-configuration
確定您已執行下列步驟:
若要設定IMS帳戶:
-
開啟IMS設定並導覽至 帳戶 標籤。 您保持頁面開啟的時間 取得公開憑證.
-
指定 IMS 帳戶的 標題。
在 授權伺服器 欄位,指定URL: https://ims-na1.adobelogin.com/.
在中指定使用者端ID API金鑰 欄位, 使用者端密碼、和 裝載 (JWT裝載)您已複製的時間 建立服務帳戶(JWT)連線.
按一下 建立。
已設定IMS帳戶。
-
選取IMS帳戶設定並按一下 檢查健康狀態.
按一下 檢查 在對話方塊中。 成功設定時,系統會顯示訊息,指出 Token擷取成功.
設定Brand Portal雲端服務 configure-the-cloud-service
-
登入您的AEM Assets Author例項。
-
從 工具 面板,導覽至 Cloud Service > AEM Brand Portal.
-
在Brand Portal設定頁面中,按一下 建立.
-
指定設定的 標題。
選取您建立的IMS設定,同時 設定IMS帳戶.
在 服務URL 欄位中,指定您的Brand Portal租使用者(組織) URL。
-
按一下 「儲存並關閉」。雲端設定此時已建立。
您的AEM Assets Author例項現在已透過Brand Portal租使用者完成設定。
測試及驗證設定 test-integration
-
登入您的AEM Assets雲端例項。
-
從 工具 面板,導覽至 部署 > 復寫.
-
在「復寫」頁面中,按一下 作者上的代理程式.
您可以看到為您的Brand Portal租使用者建立的四個復寫代理。
找到Brand Portal租使用者的復寫代理,然後按一下復寫代理URL。
note note NOTE 復寫代理程式會平行運作,並平均共用作業分佈,因此將發佈速度提升至原始速度的四倍。 設定雲端服務後,無需進行額外設定即可啟用復寫代理程式,這些代理程式預設為啟用多個資產的平行發佈。 -
若要驗證AEM Assets與Brand Portal之間的連線,請按一下 測試連線 圖示。
系統會顯示訊息,指出 測試封裝已成功傳遞.
-
驗證全部四個復寫代理程式的測試結果。
note note NOTE 請避免停用任何復寫代理程式,因為可能會導致資產(在佇列中執行)復寫失敗。 請確定所有四個復寫代理程式均已設定為避免逾時錯誤。 另請參閱 疑難排解平行發佈至Brand Portal的問題. 請勿修改任何自動產生的設定。
您現在可以:
請參閱 Brand Portal檔案 以取得詳細資訊。
升級設定 upgrade-integration-65
若要將現有設定升級至Adobe Developer Console,請依下列順序執行下列步驟:
驗證執行中的工作 verify-jobs
進行任何編輯之前,請確定您的AEM Assets作者執行個體上未執行任何發佈工作。 為此,您可以驗證所有四個復寫代理程式上作用中工作的狀態,並確保佇列處於閒置狀態。
-
登入您的AEM Assets Author例項。
-
從 工具 面板,導覽至 部署 > 部署復寫.
-
在「復寫」頁面中,按一下 作者上的代理程式.
-
找到Brand Portal租使用者的復寫代理。
確保 佇列閒置 所有復寫代理程式,且沒有作用中的發佈工作。
刪除現有組態 delete-existing-configuration
刪除現有設定時執行以下檢查清單:
- 刪除全部四個復寫代理
- 刪除Brand Portal雲端服務
- 刪除Mac使用者
-
登入您的AEM Assets作者執行個體並以管理員身分開啟CRX Lite。 預設URL為
http://localhost:4502/crx/de/index.jsp
. -
瀏覽至
/etc/replications/agents.author
並刪除Brand Portal租使用者的全部四個復寫代理。 -
瀏覽至
/etc/cloudservices/mediaportal
並刪除Brand Portal雲端服務設定。 -
瀏覽至
/home/users/mac
並刪除 Mac使用者 您的Brand Portal租使用者的。
您現在可以 建立設定 在您的AEM 6.5編寫執行個體上透過Adobe Developer Console進行。