使用 Brand Portal 設定 AEM Assets configure-integration-65

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

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租使用者。

NOTE
AEM 6.5.4.0及更高版本支援透過AEM Assets主控台使用Brand Portal設定Adobe Developer。
之前,Brand Portal是透過舊版OAuth閘道進行設定,該閘道使用JSON Web權杖(JWT)交換取得IMS存取權杖以授權。
自2020年4月6日起,不再支援透過舊版OAuth閘道進行設定,且已變更為Adobe Developer主控台。
TIP
僅適用於現有客戶
Adobe建議您繼續使用現有的舊版OAuth閘道設定。 如果您遇到舊版OAuth閘道組態的問題,請刪除現有組態,並透過Adobe Developer主控台建立組態。

以下說明介紹以下兩個使用案例:

  • 新設定:如果您是新的Brand Portal使用者,並且想要使用Brand Portal設定您的AEM Assets Author例項,您可以透過Adobe Developer Console建立設定。
  • 升級設定:如果您是擁有舊版OAuth閘道設定的現有Brand Portal使用者,請刪除現有設定,並透過Adobe Developer主控台建立設定。

所提供的資訊是基於任何閱讀本「說明」的人員都熟悉以下技術的假設:

  • 安裝、設定和管理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

下載及安裝最新AEM Service Pack

下載並安裝AEM 6.5 aemquickstart

建議使用AEM 6.5設定AEM Author例項。 如果您尚未啟動並執行AEM,請從下列位置下載:

下載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中進行設定。

  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. 從AEM Assets發佈資產到Brand Portal以測試設定。
NOTE
AEM Assets作者例項只能設定為一個Brand Portal租使用者。

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

建立 IMS 設定 create-ims-configuration

IMS設定會向AEM Assets租使用者驗證您的Brand Portal Author例項。

IMS 設定包括兩個步驟:

取得公開憑證 public-certificate

公開金鑰(憑證)會在Adobe Developer Console上驗證您的設定檔。

  1. 登入您的AEM Assets Author例項。 預設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)連線 以便取得認證和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裝載,請執行以下操作:

  1. 以IMS組織(Adobe Developer租使用者)的系統管理員許可權登入Brand Portal主控台。 預設URL為 https://www.adobe.com/go/devs_console_ui.

    note note
    NOTE
    確保您已從右上角的下拉式清單(組織)中選取正確的IMS組織(Brand Portal租使用者)。
  2. 按一下 建立新專案. 系統會為您的組織建立名稱由系統產生的空白專案。

    按一下 編輯專案 以便更新 專案標題說明,然後按一下 儲存.

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

  4. 新增API視窗,選取 AEM Brand Portal 並按一下 下一個.

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

  5. 設定API 視窗,按一下 上傳您的公開金鑰. 然後,按一下 選取檔案 並上傳您在中下載的公開金鑰(.crt檔案) 取得公開憑證 區段。

    按一下「下一步」。

    上傳公開金鑰

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

  7. 選取 Assets Brand Portal 作為預設產品設定檔,然後按一下 儲存已設定的API.

    選取產品設定檔

  8. 設定API後,您會重新導向至API概觀頁面。 從左側導覽列於 認證,按一下 服務帳戶(JWT) 選項。

    note note
    NOTE
    您可以檢視認證並執行產生JWT權杖、複製認證詳細資料和擷取使用者端密碼等動作。
  9. 使用者端認證 標籤,複製 使用者端ID.

    按一下 擷取使用者端密碼 並複製 使用者端密碼.

    服務帳戶認證

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

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

設定IMS帳戶 create-ims-account-configuration

確定您已執行下列步驟:

若要設定IMS帳戶:

  1. 開啟IMS設定並導覽至 帳戶 標籤。 您保持頁面開啟的時間 取得公開憑證.

  2. 指定 IMS 帳戶的​ 標題

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

    在中指定使用者端ID API金鑰 欄位, 使用者端密碼、和 裝載 (JWT裝載)您已複製的時間 建立服務帳戶(JWT)連線.

    按一下​ 建立

    已設定IMS帳戶。

    IMS 帳戶設定

  3. 選取IMS帳戶設定並按一下 檢查健康狀態.

    按一下 檢查 在對話方塊中。 成功設定時,系統會顯示訊息,指出 Token擷取成功.

    設定確認對話方塊狀況良好

CAUTION
您必須只有一個IMS設定。
確保IMS設定通過健康狀態檢查。 如果設定未通過健康狀態檢查,則為無效。 刪除它並建立另一個有效的設定。

設定Brand Portal雲端服務 configure-the-cloud-service

  1. 登入您的AEM Assets Author例項。

  2. 工具 工具 面板,導覽至 Cloud Service > AEM Brand Portal.

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

  4. 指定設定的​ 標題

    選取您建立的IMS設定,同時 設定IMS帳戶.

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

    Brand Portal設定視窗

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

    您的AEM Assets Author例項現在已透過Brand Portal租使用者完成設定。

測試及驗證設定 test-integration

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

  2. 工具 工具 面板,導覽至 部署 > 復寫.

    「工具」面板

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

    復寫頁面

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

    找到Brand Portal租使用者的復寫代理,然後按一下復寫代理URL。

    資產復寫設定

    note note
    NOTE
    復寫代理程式會平行運作,並平均共用作業分佈,因此將發佈速度提升至原始速度的四倍。 設定雲端服務後,無需進行額外設定即可啟用復寫代理程式,這些代理程式預設為啟用多個資產的平行發佈。
  4. 若要驗證AEM Assets與Brand Portal之間的連線,請按一下 測試連線 圖示。

    驗證資產復寫設定

    系統會顯示訊息,指出 測試封裝已成功傳遞.

    測試確認輸出

  5. 驗證全部四個復寫代理程式的測試結果。

    note note
    NOTE
    請避免停用任何復寫代理程式,因為可能會導致資產(在佇列中執行)復寫失敗。
    請確定所有四個復寫代理程式均已設定為避免逾時錯誤。 另請參閱 疑難排解平行發佈至Brand Portal的問題.
    請勿修改任何自動產生的設定。

您現在可以:

請參閱 Brand Portal檔案 以取得詳細資訊。

升級設定 upgrade-integration-65

若要將現有設定升級至Adobe Developer Console,請依下列順序執行下列步驟:

驗證執行中的工作 verify-jobs

進行任何編輯之前,請確定您的AEM Assets作者執行個體上未執行任何發佈工作。 為此,您可以驗證所有四個復寫代理程式上作用中工作的狀態,並確保佇列處於閒置狀態。

  1. 登入您的AEM Assets Author例項。

  2. 工具 工具 面板,導覽至 部署 > 部署復寫.

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

    資產的復寫代理

  4. 找到Brand Portal租使用者的復寫代理。

    確保 佇列閒置 所有復寫代理程式,且沒有作用中的發佈工作。

    復寫佇列設定

刪除現有組態 delete-existing-configuration

刪除現有設定時執行以下檢查清單:

  • 刪除全部四個復寫代理
  • 刪除Brand Portal雲端服務
  • 刪除Mac使用者
  1. 登入您的AEM Assets作者執行個體並以管理員身分開啟CRX Lite。 預設URL為 http://localhost:4502/crx/de/index.jsp.

  2. 瀏覽至 /etc/replications/agents.author 並刪除Brand Portal租使用者的全部四個復寫代理。

    CRXDE中的復寫代理程式

  3. 瀏覽至 /etc/cloudservices/mediaportal 並刪除Brand Portal雲端服務設定。

    CRXDE中復寫代理程式的詳細資料

  4. 瀏覽至 /home/users/mac 並刪除 Mac使用者 您的Brand Portal租使用者的。

    CRXDE中復寫代理的更多詳細資料

您現在可以 建立設定 在您的AEM 6.5編寫執行個體上透過Adobe Developer Console進行。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2