使用 Brand Portal 設定 AEM Assets

版本 文章連結
AEM as a Cloud Service 按一下這裡
AEM 6.5 本文
AEM 6.4 按一下這裡

Adobe Experience Manager Assets Brand Portal允許您將批准的品牌資產從Adobe Experience Manager資產發佈到Brand Portal,並分發給Brand Portal用戶。

AEM Assets通過Adobe Developer控制台配置Brand Portal,該控制台為Brand Portal租戶的授權採購AdobeIdentity Management服務(IMS)帳戶令牌。

注意

通過AEM Assets控制台在6.5.4.0及更高版本上AEM支援配置Brand Portal。

此前,Brand Portal通過舊式OAuth網關進行配置,該網關使用JSON Web令牌(JWT)交換來獲取IMS訪問令牌以進行授權。

從2020年4月6日起不再支援通過舊式OAuth網關進行配置,並將其更改為Adobe Developer控制台。

秘訣

僅適用於現有客戶

建議繼續使用現有的舊式OAuth網關配置。 在舊式OAuth網關配置中遇到問題時,請刪除現有配置並通過Adobe Developer控制台建立新配置。

本幫助描述以下兩種使用情形:

  • 新配置:如果您是新的Brand Portal用戶,並想在Brand Portal上配置您的AEM Assets作者實例,則可以通過Adobe Developer控制台建立配置。
  • 升級配置:如果您是現有的Brand Portal用戶,在舊式OAuth網關上進行配置,請刪除現有配置,並通過Adobe Developer控制台建立新配置。

所提供的資訊基於以下假設:任何閱讀本幫助的人都熟悉以下技術:

  • 安裝、配置和管理Adobe Experience Manager和AEM包。

  • 使用Linux和MicrosoftWindows作業系統。

必備條件

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

  • 具有最新Service Pack的正在運行的AEM Assets作者實例
  • Brand Portal租戶URL
  • 對Brand Portal租戶的IMS組織具有系統管理員權限的用戶

下載並安裝AEM6.5

下載並安裝最新AEM的Service Pack

下載並安裝AEM6.5

建議使AEM用6.5設定作AEM者實例。 如果沒有啟動和AEM運行,請從以下位置下載它:

下載後AEM,有關設定作者實例的說AEM明,請參見 部署和維護

下載並安裝最AEM新的Service Pack

有關詳細說明,請參見

聯繫支援 找不到最新包或AEMService Pack。

建立設定

將AEM Assets配置為Brand Portal需要兩種配置:AEM Assets作者實例和Adobe Developer控制台。

  1. 在AEM Assets,建立IMS帳戶並生成公共證書(公鑰)。
  2. 在Adobe Developer控制台中,為您的Brand Portal租戶(組織)建立項目。
  3. 在項目下,使用公鑰配置API以建立服務帳戶(JWT)連接。
  4. 獲取服務帳戶憑據和JWT負載資訊。
  5. 在AEM Assets,使用服務帳戶憑據和JWT負載配置IMS帳戶。
  6. 在AEM Assets,使用IMS帳戶和Brand Portal端點(組織URL)配置Brand Portal雲服務。
  7. Test配置,將資產從AEM Assets發佈到Brand Portal。
注意

AEM Assets的作者實例只能配置一個Brand Portal租戶。

如果您首次將AEM Assets配置為Brand Portal,請按列出的順序執行以下步驟:

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

建立 IMS 設定

IMS配置向Brand Portal租戶驗證您的AEM Assets作者實例。

IMS 設定包括兩個步驟:

取得公開憑證

公鑰(證書)在Adobe Developer控制台上驗證您的配置檔案。

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

  2. 工具 工具 面板,導航至 安全 > Adobe IMS配置

  3. 在「Adobe IMS配置」頁中,按一下 建立。 它將重定向到 Adobe IMS技術帳戶配置 的子菜單。 預設情況下, 證書 的子菜單。

  4. 選擇 AdobeBrand Portal雲解決方案 下拉清單。

  5. 選擇 建立新證書 複選框並指定 別名 公鑰。 別名用作公鑰的名稱。

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

    建立憑證

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

    公鑰稍後將用於為您的Brand Portal租戶配置API並在Adobe Developer控制台中生成服務帳戶憑據。

    下載憑證

  8. 按一下​下一步

    帳戶 頁籤,建立Adobe IMS帳戶,它需要在Adobe Developer控制台中生成的服務帳戶憑據。 暫時保持此頁面開啟。

    開啟新頁籤並 在Adobe Developer控制台中建立服務帳戶(JWT)連接 獲取用於配置IMS帳戶的憑據和JWT負載。

建立服務帳戶(JWT)連接

在Adobe Developer控制台中,項目和API在Brand Portal租戶(組織)級別配置。 配置API可建立服務帳戶(JWT)連接。 通過生成密鑰對(私鑰和公鑰)或上載公鑰來配置API有兩種方法。 要將AEM Assets配置為Brand Portal,必須在AEM Assets中生成公鑰(證書),並通過上載公鑰在Adobe Developer控制台中建立憑據。 配置AEM Assets的IMS帳戶需要這些憑據。 一旦配置了IMS帳戶,您就可以在AEM Assets配置Brand Portal雲服務。

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

  1. 使用IMS組織(Brand Portal租戶)的系統管理員權限登錄到Adobe Developer控制台。 預設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 窗口,按一下 上載公鑰。 然後,按一下 選擇檔案 並上載您已在 獲取公共證書 的子菜單。

    按一下​下一步

    上載公鑰

  6. 驗證公鑰並按一下 下一個

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

    選擇產品配置檔案

  8. 配置API後,您將重定向到「API概述」頁。 從左導航下 憑據,按一下 服務帳戶(JWT) 的雙曲餘切值。

    注意

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

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

    按一下 檢索客戶端密鑰 複製 客戶端機密

    服務帳戶憑據

  10. 導航到 生成JWT 頁籤並複製 JWT負載 的下界。

現在,您可以使用客戶端ID(API密鑰)、客戶端密鑰和JWT負載 配置IMS帳戶 在AEM Assets。

配置IMS帳戶

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

執行以下步驟來配置IMS帳戶。

  1. 開啟IMS配置並導航到 帳戶 頁籤。 你一直開啟這頁 獲取公共證書

  2. 指定 IMS 帳戶的​標題

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

    API密鑰 欄位, 客戶端密碼, 負載 (JWT負載) 建立服務帳戶(JWT)連接

    按一下​建立

    已配置IMS帳戶。

    IMS 帳戶設定

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

    按一下 檢查 的子菜單。 成功配置時,將顯示一條消息, 已成功檢索令牌

注意

您必須只有一個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作者實例現在已與Brand Portal租戶配置。

測試設定

執行以下步驟驗證配置:

  1. 登錄到您的AEM Assets雲實例。

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

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

    您可以看到為您的Brand Portal租戶建立的四個複製代理。

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

    注意

    複製代理並行工作,並平等共用作業分配,從而將發佈速度提高了原始速度的四倍。 配置雲服務後,無需進行其他配置即可啟用預設激活的複製代理,以啟用多個資產的並行發佈。

  4. 要驗證AEM Assets和Brand Portal之間的連接,請按一下 Test連接 表徵圖

    出現一條消息, test包已成功交付

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

    注意

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

    確保將所有四個複製代理配置為避免超時錯誤。 請參閱 排除與Brand Portal並行發佈的問題

    不要修改任何自動生成的設定。

您現在可以:

請參閱 Brand Portal文檔 的子菜單。

升級配置

按列出的順序執行以下步驟,將現有配置升級到Adobe Developer控制台:

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

驗證正在運行的作業

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

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

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

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

  4. 找到您的Brand Portal租戶的複製代理。

    確保 隊列空閒 對於所有複製代理,沒有發佈作業處於活動狀態。

刪除現有配置

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

  • 刪除所有四個複製代理
  • 刪除Brand Portal雲服務
  • 刪除MAC用戶
  1. 以管理員身份登錄到AEM Assets作者實例並開啟CRX Lite。 預設URL為 http://localhost:4502/crx/de/index.jsp

  2. 導航到 /etc/replications/agents.author 並刪除您的Brand Portal租戶的所有四個複製代理。

  3. 導航到 /etc/cloudservices/mediaportal 刪除Brand Portal雲服務配置。

  4. 導航到 /home/users/mac 刪除 Mac用戶 你Brand Portal的房客。

你現在可以 建立配置 通過Adobe Developer控制台AEM的6.5作者實例。

本頁內容