Show Menu
主題×

使用 Brand Portal 設定 AEM Assets

Adobe Experience Manager(AEM)Assets是透過Adobe Developer Console設定品牌入口網站,該網站會購買IMS Token以授權您的品牌入口網站租用戶。
AEM 6.5.4.0及更新版本支援透過Adobe Developer Console以品牌入口網站設定AEM資產。
之前,品牌入口網站是透過舊版OAuth閘道來設定,該閘道使用JWT代號交換來取得IMS存取代號以進行授權。
從2020年4月6日起,不再支援透過舊版OAuth閘道進行設定,並變更為Adobe Developer Console。
僅限現有客戶
建議您繼續使用現有的舊版OAuth閘道設定。 萬一您遇到舊版OAuth閘道設定的問題,請刪除現有的設定,並透過Adobe Developer Console建立新的設定。
本說明說明下列兩個使用案例:
  • 新配置 :如果您是新的品牌入口網站使用者,並想要使用品牌入口網站設定您的AEM Assets作者例項,則可以在Adobe Developer Console上建立設定。
  • 升級配置 :如果您是現有的品牌入口網站使用者,且您的AEM Assets作者實例在舊版OAuth閘道上設定了品牌入口網站,請刪除現有的設定,並在Adobe Developer Console上建立新的設定。
提供的資訊基於以下假設:閱讀本「說明」的人熟悉下列技術:
  • 安裝、設定和管理Adobe Experience Manager和AEM套件。
  • 使用Linux和Microsoft Windows作業系統。

必備條件

您需要下列項目才能使用 Brand Portal 設定 AEM Assets:
  • 具有最新Service Pack的AEM Assets作者例項(啟動並執行)。
  • 品牌入口網站租用戶URL。
  • 在 Brand Portal 租用戶的 IMS 組織具有系統管理員權限的使用者。

下載並安裝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資產,請在所列順序中執行下列步驟:

建立 IMS 設定

IMS 設定會以 AEM Assets 作者例項驗證您的 Brand Portal 租用戶。
IMS 設定包括兩個步驟:

取得公開憑證

公開憑證可讓您在Adobe Developer Console上驗證您的個人檔案。
  1. 登入您的AEM Assets作者實例。 預設URL為 http://localhost:4502/aem/start.html
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. 在「Adobe IMS設定」頁面中,按一下「 建立 」。
  4. 您已重新導向至「 Adobe IMS技術帳戶設定」頁面 。 By default, the Certificate tab opens.
    選取雲端解決方 案Adobe Brand Portal
  5. Mark the Create new certificate checkbox and specify an alias for the certificate. 別名的作用是對話方塊的名稱。
  6. 按一下​ 建立憑證 。然後,在對 話方塊中 ,按一下「確定」以產生公用憑證。
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    憑證檔案稍後將用於為您的品牌入口網站租用戶設定API,並在Adobe Developer Console中產生服務帳戶認證。
  8. 按一下​ 下一步
    在「 Account 」(帳戶)標籤中,會建立Adobe IMS帳戶,但您需要在Adobe Developer Console中產生的服務帳戶認證。 暫時保持此頁面開啟。
    在Adobe Developer Console中開啟新 標籤並建立服務帳戶(JWT)連線 ,以取得用於設定IMS帳戶的認證和JWT裝載。

建立服務帳戶(JWT)連接

在Adobe Developer Console中,專案和API是在品牌入口網站租用戶(組織)層級設定。 設定API會在Adobe Developer Console中建立服務帳戶(JWT)連線。 有兩種方法可用來設定API:產生金鑰對(私用和公開金鑰)或上傳公開金鑰。 若要使用品牌入口網站設定AEM資產,您必須在AEM資產中產生公用憑證(公用金鑰),並透過上傳公用金鑰在Adobe Developer Console中建立認證。 此公開金鑰用於為選取的品牌入口網站租用戶設定API,並產生服務帳戶的認證和JWT裝載。 這些認證可進一步用來設定AEM資產中的IMS帳戶。 在設定IMS帳戶後,您就可以在AEM Assets中設定品牌入口網站雲端服務。
執行以下步驟以生成服務帳戶憑據和JWT裝載:
  1. 以IMS組織(品牌入口網站租用戶)的系統管理員權限登入Adobe Developer Console。 預設URL為
    請確定您已從右上角的下拉式(組織)清單中選取正確的IMS組織(品牌入口網站租用戶)。
  2. Click Create new project . 系統會為您的組織建立空白專案。
    按一 下「編輯專案 」以更新「 專案標題 」和「說 明」 ,然後按 ​一下「儲存」。
  3. 在「專案 概述」標籤中 ,按一 下「新增API」
  4. 在「新 增API」視窗中 ,選取「 AEM品牌入口網站 」並按「 下一步 」。
    請確定您擁有AEM品牌入口網站服務的存取權。
  5. 在「設 定API 」視窗中,按 一下「上傳公開金鑰」 。 然後,按一 下「選取檔案 」,並上傳您已在取得公用憑證區段中下載的公 用憑證(.crt 檔案)。
    按一下​ 下一步
  6. 驗證公共證書並按一下「 Next(下一步) 」。
  7. 選取預設產品設定檔 Assets Brand Portal ,然後按一 下「儲存設定的API 」。
  8. 在設定API後,您會重新導向至API概觀。 在左邊導覽的「憑 據」下 ,單 擊「服務帳戶(JWT)」
    您可以視需要檢視憑證並執行其他動作(產生JWT Token、複製憑證詳細資訊、擷取用戶端密碼等)。
  9. 從「客 戶端認證 」標籤複製 客戶端ID
    Click Retrieve Client Secret and copy the client secret .
  10. Navigate to the Generate JWT tab and copy the JWT Payload .
您現在可以使用用戶端ID(API金鑰)、用戶端密碼和JWT裝載,在AEM 資產中設定IMS 帳戶。

設定IMS帳戶

請確認您已執行下列步驟:
執行下列步驟以設定IMS帳戶。
  1. 開啟「IMS設定」並導覽至「帳戶 」標 簽。 您在取得公開憑證時 仍保持頁面開啟
  2. 指定 IMS 帳戶的​ 標題
    在​ 授權伺服器 ,輸入 URL: https://ims-na1.adobelogin.com/
    貼上您在建 立服務帳戶( JWT)連線時複製的 API金鑰(用戶端ID)、用戶端密碼(Client Secret )和 建立服務帳戶(JWT)連接 Payload(JWT payload)。
    按一下​ 建立
    已設定IMS帳戶。
  3. Select the IMS account configuration and click Check Health .
    在對 話方塊中 ,按一下「勾選」。 成功設定時,會顯示訊息,指出 Token已成功擷取
您只能有一個IMS設定。
確保IMS配置通過健康檢查。 如果配置未通過健康檢查,則無效。 您必須刪除它並建立新的有效設定。

設定雲端服務

執行下列步驟以設定品牌入口網站雲端服務:
  1. 登入您的AEM Assets作者實例。
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. 在「品牌入口網站設定」頁面中,按一下「 建立 」。
  4. 指定設定的​ 標題
    選取您在設定IMS帳戶時所建 立的IMS設定
    In the Service URL , enter your Brand Portal tenant (organization URL).
  5. 按一下​ 「儲存並關閉」 。雲端設定此時已建立。
    您的AEM Assets作者例項現在已設定為品牌入口網站租用戶。

測試設定

執行以下步驟以驗證配置:
  1. 登入您的AEM Assets雲端例項。
  2. From the Tools panel, navigate to Deployment > Replication .
  3. 在「複製」頁中,按一下「作 者上的代理」
  4. 為每個租用戶建立四個複製代理。
    找到您品牌門戶租用戶的複製代理。
    按一下複製代理URL。
    複製代理並行工作,共用作業分配,使發佈速度提高了原始速度的四倍。 在設定雲端服務後,不需要額外的設定,就可啟用依預設啟用的複製代理,以啟用多個資產的並行發佈。
  5. 若要驗證 AEM Assets 和 Brand Portal 之間的連線,請按一下​ 測試連線
    頁面底部會出現訊息,指出您的*test套件已成功傳送。
  6. 驗證所有四個複製代理上的測試結果。
    避免禁用任何複製代理。 這可能會導致某些資產的複製失敗。
    確保所有4個複製代理都配置為避免超時錯誤。 See troubleshoot issues in parallel publishing to Brand Portal .
您的AEM Assets作者實例已成功設定為品牌入口網站,您現在可以:

升級配置

在所列順序中執行以下步驟以升級現有配置:

驗證正在運行的作業

在您進行任何修改之前,請確定您的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使用者。
您現在可 以透過 Adobe Developer Console在AEM 6.5作者實例上建立設定。