使用 Brand Portal 設定 AEM Assets

Adobe Experience Manager Assets Brand Portal可讓您從Adobe Experience Manager Assets將經核准的品牌資產發佈至品牌入口網站,並將其分發給品牌入口網站使用者。

AEM Assets已透過Adobe Developer Console設定品牌入口網站,該網站會購買Adobe Identity Management Services(IMS)帳戶Token以授權品牌入口網站租用戶。

注意

AEM 6.5.4.0及更新版本支援透過Adobe Developer Console以品牌入口網站設定AEM資產。

之前,品牌入口網站是透過舊版OAuth閘道來設定,該閘道使用JSON Web Token(JWT)交換來取得IMS存取Token以進行授權。

從2020年4月6日起,不再支援透過舊版OAuth閘道進行的設定,並變更為Adobe Developer Console。

秘訣

僅限現有客戶

建議您繼續使用現有的舊版OAuth閘道設定。 萬一您遇到舊版OAuth閘道設定的問題,請刪除現有的設定,並透過Adobe Developer Console建立新的設定。

本說明說明下列兩個使用案例:

  • 新配置:如果您是新的品牌入口網站使用者,並想要使用品牌入口網站設定您的AEM Assets作者例項,您可以透過Adobe Developer Console建立設定。
  • 升級配置:如果您是現有的品牌入口網站使用者,在舊版OAuth閘道上有設定,請刪除現有的設定,並透過Adobe Developer Console建立新的設定。

提供的資訊基於以下假設:閱讀本「說明」的人熟悉下列技術:

  • 安裝、設定和管理Adobe Experience Manager和AEM套件。

  • 使用Linux和Microsoft Windows作業系統。

必備條件

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

  • 具有最新Service Pack的啟動和執行AEM Assets作者實例
  • 品牌入口網站租用戶URL
  • 對品牌入口網站的IMS組織具有系統管理員權限的使用者

下載並安裝AEM 6.5

下載並安裝最新的AEM Service Pack

下載並安裝AEM 6.5

建議您讓AEM 6.5來設定AEM作者例項。 如果您沒有啟動並執行AEM,請從下列位置下載:

下載AEM後,如需設定AEM作者例項的指示,請參閱部署與維護

下載並安裝AEM最新的Service Pack

如需詳細指示,請參閱

若您 找不到最新的AEM套件或Service Pack,請聯絡「支援」。

建立設定

使用品牌入口網站設定AEM資產需要同時在AEM Assets作者實例和Adobe Developer Console中進行設定。

  1. 在AEM Assets中,建立IMS帳戶並產生公用憑證(公用金鑰)。
  2. 在Adobe Developer Console中,為您的品牌入口網站租用戶(組織)建立專案。
  3. 在專案下,使用公開金鑰來設定API,以建立服務帳戶(JWT)連線。
  4. 獲取服務帳戶憑據和JWT裝載資訊。
  5. 在AEM Assets中,使用服務帳戶認證和JWT裝載來設定IMS帳戶。
  6. 在AEM Assets中,使用IMS帳戶和品牌入口端端點(組織URL)來設定品牌入口網站雲端服務。
  7. 將資產從AEM Assets發佈至品牌入口網站,以測試您的設定。
注意

AEM Assets作者實例僅應設定一個品牌入口網站租戶。

如果您是第一次使用品牌入口網站設定AEM資產,請在所列順序中執行下列步驟:

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

建立 IMS 設定

IMS設定會向品牌入口網站租用戶驗證您的AEM Assets作者實例。

IMS 設定包括兩個步驟:

取得公開憑證

公開金鑰(憑證)會在Adobe Developer Console上驗證您的個人檔案。

  1. 登入您的AEM Assets作者實例。 預設URL為http://localhost:4502/aem/start.html

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

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

  4. 在​雲端解決方案​下拉式清單中,選取​Adobe品牌入口網站

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

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

    建立憑證

  7. 按一下「下載公開金鑰」圖示,並將公開金鑰(.crt)檔案儲存在您的電腦上。

    公開金鑰稍後將用於為您的品牌入口網站租用戶設定API,並在Adobe Developer Console中產生服務帳戶認證。

    下載憑證

  8. 按一下​下一步

    在​Account​標籤中,會建立Adobe IMS帳戶,此帳戶需要Adobe Developer Console中產生的服務帳戶認證。 暫時保持此頁面開啟。

    在Adobe Developer Console中開啟新標籤並建立服務帳戶(JWT)連線,以取得用於設定IMS帳戶的認證和JWT裝載。

建立服務帳戶(JWT)連接

在Adobe Developer Console中,專案和API是在品牌入口網站租用戶(組織)層級設定。 配置API會建立服務帳戶(JWT)連接。 有兩種方法可用來設定API:產生金鑰對(私用和公開金鑰)或上傳公開金鑰。 若要使用品牌入口網站設定AEM資產,您必須在AEM資產中產生公開金鑰(憑證),並透過上傳公開金鑰在Adobe Developer Console中建立認證。 在AEM資產中設定IMS帳戶時,需要這些認證。 在設定IMS帳戶後,您就可以在AEM Assets中設定品牌入口網站雲端服務。

執行以下步驟以生成服務帳戶憑據和JWT裝載:

  1. 以IMS組織(品牌入口網站租用戶)的系統管理員權限登入Adobe Developer Console。 預設URL為https://www.adobe.com/go/devs_console_ui

    注意

    請確定您已從右上角的下拉式(組織)清單中選取正確的IMS組織(品牌入口網站租用戶)。

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

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

  3. 在​Project overview​標籤中,按一下​Add API

  4. 在​新增API視窗​中,選取​AEM品牌入口網站,然後按一下​Next

    請確定您擁有AEM品牌入口網站服務的存取權。

  5. 在​配置API​窗口中,按一下​上傳公開密鑰。 然後,按一下「選擇檔案」並上傳您在獲取公共證書部分中下載的公開密鑰(.crt檔案)。

    按一下​下一步

    上傳公開金鑰

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

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

    選擇產品設定檔

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

    注意

    您可以查看憑據並執行諸如生成JWT Token、複製憑據詳細資訊、檢索客戶機密碼等操作。

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

    按一下「檢索客戶機密碼」並複製​[!UICONTROL ​客戶機密碼​]

    服務帳戶認證

  10. 導航至「生成JWT ]」頁籤並複製​JWT Payload​資訊。[

您現在可以使用用戶端ID(API金鑰)、用戶端密碼和JWT裝載至,在AEM資產中設定IMS帳戶

設定IMS帳戶

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

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

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

  2. 指定 IMS 帳戶的​標題

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

    建立服務帳戶(JWT)連線時,在​API金鑰​欄位、客戶機密碼​和​Payload(JWT有效載荷)中指定您複製的用戶端ID。

    按一下​建立

    已設定IMS帳戶。

    IMS 帳戶設定

  3. 選擇IMS帳戶配置,然後按一下​檢查運行狀況

    在對話框中按一下「檢查」。 成功配置時,將顯示一條消息,表示​Token已成功檢索

注意

您只能有一個IMS設定。

確保IMS配置通過健康檢查。 如果配置未通過健康檢查,則無效。 您必須刪除它並建立新的有效設定。

設定雲端服務

執行下列步驟以設定品牌入口網站雲端服務:

  1. 登入您的AEM Assets作者實例。

  2. 從​工具 工具面板,導覽至​雲端服務 > AEM品牌入口網站

  3. 在「品牌入口網站設定」頁面中,按一下「建立​」。

  4. 指定設定的​標題

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

    在​服務URL​欄位中,指定您的品牌入口網站租用戶(組織)URL。

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

    您的AEM Assets作者例項現在已設定為品牌入口網站租用戶。

測試設定

執行以下步驟以驗證配置:

  1. 登入您的AEM Assets雲端例項。

  2. 從​工具工具面板,導航至​部署 > 複製

  3. 在「複製」頁中,按一下​作者上的代理

    您可以看到為您的品牌門戶租用戶建立的四個複製代理。

    找到您的Brand Portal租用戶的複製代理,然後按一下複製代理URL。

    注意

    複製代理並行工作,共用作業分配,使發佈速度提高了原始速度的四倍。 在設定雲端服務後,不需要額外的設定,就可啟用依預設啟用的複製代理,以啟用多個資產的並行發佈。

  4. 若要驗證AEM Assets和品牌入口網站之間的連線,請按一下​Test Connection​圖示。

    出現一條消息,表示​測試包已成功交付

  5. 驗證所有四個複製代理上的測試結果。

    注意

    請避免禁用任何複製代理,因為它可能導致資產的複製(在隊列中運行)失敗。

    確保所有4個複製代理都配置為避免超時錯誤。 請參閱疑難排解並行發佈至品牌入口網站的問題。

您現在可以:

如需詳細資訊,請參閱品牌入口網站檔案

升級配置

請依所列順序執行下列步驟,將您現有的組態升級至Adobe Developer Console:

  1. 驗證正在運行的作業
  2. 刪除現有配置
  3. 建立設定

驗證正在運行的作業

在您進行任何修改之前,請確定您的AEM Assets作者實例上沒有執行任何發佈工作。 為此,您可以驗證所有四個複製代理上活動作業的狀態,並確保隊列處於空閒狀態。

  1. 登入您的AEM Assets作者實例。

  2. 從​工具工具面板,導航至​部署 > 部署複製

  3. 在「複製」頁中,按一下​作者上的代理

  4. 找到您品牌門戶租用戶的複製代理。

    確保所有複製代理的​隊列都為Idle ,則未激活發佈作業。

刪除現有配置

刪除現有配置時,必須運行以下檢查清單:

  • 刪除所有四個複製代理
  • 刪除品牌入口網站雲端服務
  • 刪除MAC用戶
  1. 登入您的AEM Assets作者例項,並以管理員身分開啟CRX Lite。 預設URL為http://localhost:4502/crx/de/index.jsp

  2. 導覽至/etc/replications/agents.author並刪除您品牌入口網站租用戶的所有4個複製代理。

  3. 導覽至/etc/cloudservices/mediaportal並刪除品牌入口網站雲端服務設定。

  4. 導覽至/home/users/mac並刪除您品牌入口網站的​MAC使用者

您現在可以透過AEM 6.5作者例項上的Adobe Developer Console,建立configuration

本頁內容