使用 Brand Portal 設定 AEM Assets

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

AEM Assets是透過Brand Portal Developer Console使用Adobe來設定,其中會擷取AdobeIdentity Management服務(IMS)帳戶代號,以便授權Brand Portal租用戶。

注意

AEM 6.5.4.0及更新版本支援透過Adobe開發人員控制台使用Brand Portal設定AEM Assets。

過去,Brand Portal是透過舊版OAuth閘道設定,該閘道使用JSON網頁代號(JWT)交換來取得IMS存取代號以進行授權。

自2020年4月6日起,不再支援透過舊版OAuth閘道進行設定,且已變更為Adobe開發人員主控台。

秘訣

僅適用於現有客戶

建議您繼續使用現有的舊版OAuth閘道設定。 如果您遇到舊版OAuth閘道設定的問題,請刪除現有設定,並透過Adobe開發人員控制台建立新設定。

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

  • 新配置:如果您是新的Brand Portal使用者,且想使用Brand Portal設定您的AEM Assets製作例項,可以透過Adobe開發人員控制台建立設定。
  • 升級配置:如果您是現有Brand Portal使用者,且在舊版OAuth閘道上設定,請刪除現有設定,並透過Adobe開發人員控制台建立新設定。

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

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

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

必備條件

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

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

下載並安裝AEM 6.5

下載並安裝最新的AEM Service Pack

下載並安裝AEM 6.5

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

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

下載及安裝AEM最新Service Pack

有關詳細說明,請參閱

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

建立設定

使用Brand Portal設定AEM Assets需要同時在AEM Assets製作例項和Adobe開發人員控制台中進行設定。

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

AEM Assets製作例項只能設定一個Brand Portal租用戶。

如果您是第一次使用Brand Portal設定AEM Assets,請依所列順序執行下列步驟:

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

建立 IMS 設定

IMS設定會以Brand Portal租用戶驗證您的AEM Assets製作例項。

IMS 設定包括兩個步驟:

取得公開憑證

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

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

  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作者例項現在已以Brand Portal租用戶設定。

測試設定

執行下列步驟驗證設定:

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

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

  3. 在「復寫」頁面中,按一下「作者上的代理」

    您可以看到為您的Brand Portal租用戶建立的四個復寫代理。

    找出Brand Portal租用戶的復寫代理,然後按一下復寫代理URL。

    注意

    復寫代理並行工作,並平等共用作業分配,從而將發佈速度提高了原始速度的四倍。 設定雲端服務後,若要啟用依預設啟動的復寫代理,以啟用多個資產的平行發佈,則不需要額外設定。

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

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

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

    注意

    請避免停用任何復寫代理,因為這可能導致資產復寫(在佇列中執行)失敗。

    請確定所有四個復寫代理均已設定,以避免逾時錯誤。 請參閱疑難排解平行發佈至Brand Portal時的問題

您現在可以:

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

升級配置

請依所列順序執行下列步驟,將您現有的設定升級至Adobe開發人員控制台:

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

驗證正在運行的作業

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

  1. 登入您的AEM Assets製作例項。

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

  3. 在「復寫」頁面中,按一下「作者上的代理」

  4. 找出您Brand Portal租用戶的復寫代理。

    確保所有復寫代理的​Queue均為Idle,沒有任何發佈作業處於活動狀態。

刪除現有配置

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

  • 刪除所有四個複製代理
  • 刪除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並刪除您Brand Portal租用戶的​MAC使用者

您現在可以透過AEM 6.5製作例項上的Adobe開發人員控制台,建立設定

本頁內容