Show Menu
主題×

使用 Brand Portal 設定 AEM Assets

Adobe Experience Manager(AEM)Assets是透過Adobe Developer Console以品牌入口網站設定,Adobe Developer Console會購買IMS Token以授權您的品牌入口網站租用戶。
設定如何運作?
使用品牌入口網站租用戶(組織)設定AEM Assets雲端例項時,需要在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 Assets雲端例項的品牌入口網站租用戶。

必備條件

您需要下列項目才能使用 Brand Portal 設定 AEM Assets:
  • 已開始運作的 AEM Assets 雲端例項。
  • Brand Portal 租用戶 URL。
  • 在 Brand Portal 租用戶的 IMS 組織具有系統管理員權限的使用者。
請連絡客戶服務 ,以取得進一步的查詢。

建立設定

在指定的序列中執行下列步驟,以使用品牌入口網站設定AEM Assets雲端例項。

建立 IMS 設定

IMS設定會以AEM Assets雲端例項驗證您的品牌入口網站租用戶。
IMS 設定包括兩個步驟:

取得公開憑證

公開憑證可讓您在Adobe Developer Console上驗證您的個人檔案。
  1. 登入您的AEM Assets雲端例項。
  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 check box Create new certificate 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. 按一下​ 下一步
    在「帳 」標籤中,您建立Adobe IMS帳戶,但您需要在Adobe Developer Console中產生的服務帳戶認證。 暫時保持此頁面開啟。
    在Adobe Developer Console中開啟新 標籤並建立服務帳戶(JWT)連線 ,以取得用於設定IMS帳戶的認證和JWT裝載。

建立服務帳戶(JWT)連接

在Adobe Developer Console中,專案和API是在組織(品牌入口網站租用戶)層級設定。 設定API會在Adobe Developer Console中建立服務帳戶(JWT)連線。 有兩種方法可用來設定API:產生金鑰對(私用和公開金鑰)或上傳公開金鑰。 若要使用Brand Portal設定AEM Assets雲端例項,您必須在AEM Assets雲端例項中產生公用憑證(公用金鑰),並透過上傳公用金鑰在Adobe Developer Console中建立認證。 此公開金鑰用來設定所選品牌入口網站組織的API,並產生服務帳戶的認證和JWT裝載。 這些認證可進一步用來設定AEM Assets雲端例項中的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 ,然後按一 下「儲存設定」
  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 Assets雲端例項中設定IMS 帳戶。

設定IMS帳戶

請確認您已執行下列步驟:
執行下列步驟以設定您在取得公用憑證時所建立 的IMS帳戶
  1. 開啟「IMS設定」並導覽至「帳 」標籤。 您在取得公開證書時 仍保持頁面開啟
  2. 指定 IMS 帳戶的​ 標題
    在​ 授權伺服器 ,輸入 URL: https://ims-na1.adobelogin.com/
    將用戶端ID貼入您建立服務帳戶(JWT)連線時複製的API金鑰、用戶 端密碼和JWT裝載中
    按一下​ 建立
    已設定IMS帳戶。
  3. Select the IMS account configuration and click Check Health .
    在對 話方塊中 ,按一下「勾選」。 成功設定時,會顯示訊息,指出 Token已成功擷取
您只能有一個IMS設定。 請勿建立多個 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 雲端例項現在已經以 Brand Portal 租用戶完成設定。

測試設定

執行以下步驟以驗證配置:
  1. 登入您的AEM Assets雲端例項。
  2. From the Tools panel, navigate to Deployment > Distribution .
  3. 在「分發」頁面中,您可以看到已建立品牌入口網站的分 bpdistributionagent0 發代理,以 便發佈至品牌入口網站
    按一下​ 發佈至 Brand Portal
    依預設,系統會為 Brand Portal 租用戶建立一個發佈代理程式。
  4. 在Distribution Agent頁中,您可以在「狀態」頁籤下看到 Distribution queues。
    發佈代理程式包含兩個佇列:
    • processing-queue : 將資產分發至品牌入口網站。
    • error-queue : 對於分發失敗的資產。
    建議您檢閱失敗,並定期清 除錯誤佇列
  5. 若要驗證 AEM Assets 和 Brand Portal 之間的連線,請按一下​ 測試連線
    頁面底部會顯示訊息,指出您的測試封裝已成功傳送。
    請避免停用發佈代理程式,因為可能導致在佇列中執行的資產發佈失敗。
您的 AEM Assets 雲端例項已成功以 Brand Portal 完成設定,您現在可以:
除了上述操作,您也可以從 AEM Assets 將中繼資料結構、影像預設集、搜尋 Facet 和標籤發佈至 Brand Portal。
如需詳細資訊,請參閱 Brand Portal 文件

發佈記錄檔

您可以檢查日誌,以瞭解有關分發代理執行的操作的詳細資訊。
例如,我們已將資產從AEM Assets發佈至品牌入口網站,以驗證設定。
  1. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  2. 按一下​ 記錄檔 ​以檢視發佈記錄檔。您可在此查看處理和錯誤記錄。
發佈代理程式會產生以下記錄檔:
  • 資訊: 這是系統生成的日誌,在成功配置時觸發,用於啟用分發代理。
  • DSTRQ1(請求1): 測試連線時的觸發器。
發佈資產時,會產生下列請求和回應記錄檔:
發佈代理程式請求
  • DSTRQ2 (請求 2):觸發資產發佈請求。
  • DSTRQ3(請求3): 系統會觸發另一個請求來發佈資產所在的資料夾,並複製品牌入口網站中的資料夾。
發佈代理程式回應
  • queue-bpdistributionagent0 (DSTRQ2):資產已發佈至 Brand Portal。
  • queue-bpdistributionagent0 (DSTRQ3):系統會複製含有 Brand Portal 中的資產的資料夾。
在上述範例中,會觸發額外的請求和回應。 系統無法在品牌入口網站中找到父資料夾(亦即新增路徑),因為資產是首次發佈,因此會觸發在發佈資產的品牌入口網站中建立同名父資料夾的額外請求。
如果父資料夾不存在上述例子的 Brand Portal 中,或父資料夾已在 AEM Assets 中經過修改,系統會產生其他請求。