Show Menu
主題×

Configure AEM Assets as a Cloud Service with Brand Portal

設定Adobe Experience Manager Assets Brand Portal可讓您將Adobe Experience Manager Assets中經過核准的品牌資產發佈為雲端服務例項至品牌入口網站,並將其分發給品牌入口網站使用者。
設定工作流程
AEM Assets as a Cloud Service是透過Adobe Developer Console設定品牌入口網站,該網站會購買Adobe Identity Management Services(IMS)帳戶代號以授權品牌入口網站租戶。 這需要AEM Assets和Adobe Developer Console中的設定。
  1. 在AEM Assets中,建立IMS帳戶並產生公開金鑰(憑證)。
  2. 在Adobe Developer Console中,為您的品牌入口網站租用戶(組織)建立專案。
  3. 在專案下,使用公開金鑰來設定API,以建立服務帳戶連線。
  4. 取得服務帳戶認證和JSON Web Token(JWT)裝載資訊。
  5. 在AEM Assets中,使用服務帳戶認證和JWT裝載來設定IMS帳戶。
  6. 在AEM Assets中,使用IMS帳戶和品牌入口端端點(組織URL)來設定品牌入口網站雲端服務。
  7. 將資產從AEM Assets發佈至品牌入口網站,以測試您的設定。
AEM Assets做為Cloud Service例項時,只能設定一個Brand Portal租用戶。

必備條件

您需要下列項目才能使用 Brand Portal 設定 AEM Assets:
  • 以雲端服務實例啟動並執行AEM Assets
  • 品牌入口網站租用戶URL
  • 對品牌入口網站的IMS組織具有系統管理員權限的使用者

建立設定

在指定的序列中執行下列步驟,以設定具有品牌入口網站的AEM資產。

建立 IMS 設定

IMS設定會以Brand Portal租用戶的雲端服務例項驗證您的AEM資產。
IMS 設定包括兩個步驟:

取得公開憑證

公開金鑰(憑證)會在Adobe Developer Console上驗證您的個人檔案。
  1. 登入AEM Assets。
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. 在「Adobe IMS設定」頁面中,按一下「 建立 」。 It will redirect to the Adobe IMS Technical Account Configuration page. By default, the Certificate tab opens.
  4. 在「 雲端解決方案 」下拉式清 單中選取Adobe品牌入口網站
  5. 選中「 建立新證書 」複選框,並指定 公鑰的別名 。 別名用作公共密鑰的名稱。
  6. 按一下​ 建立憑證 。Then, click OK to generate the public key.
  7. 按一下 下載公開金鑰 (Download Public Key)圖示,並將公開金鑰(.crt)檔案儲存在您的電腦上。
    公開金鑰稍後將用於為您的品牌入口網站租用戶設定API,並在Adobe Developer Console中產生服務帳戶認證。
  8. 按一下​ 下一步
    在「帳 」索引標籤中,會建立Adobe IMS帳戶,其需要Adobe Developer Console中產生的服務帳戶認證。 暫時保持此頁面開啟。
    在Adobe Developer Console中開啟新 標籤並建立服務帳戶(JWT)連線 ,以取得用於設定IMS帳戶的認證和JWT裝載。

建立服務帳戶(JWT)連接

在Adobe Developer Console中,專案和API是在品牌入口網站租用戶(組織)層級設定。 配置API會建立服務帳戶(JWT)連接。 有兩種方法可用來設定API:產生金鑰對(私用和公開金鑰)或上傳公開金鑰。 若要使用品牌入口網站設定AEM資產,您必須在AEM資產中產生公開金鑰(憑證),並透過上傳公開金鑰在Adobe Developer Console中建立認證。 在AEM資產中設定IMS帳戶時,需要這些認證。 在設定IMS帳戶後,您就可以在AEM Assets中設定品牌入口網站雲端服務。
執行以下步驟以生成服務帳戶憑據和JWT裝載:
  1. 以IMS組織(品牌入口網站租用戶)的系統管理員權限登入Adobe Developer Console。 預設URL為 https://www.adobe.com/go/devs_console_ui
    請確定您已從右上角的下拉式(組織)清單中選取正確的IMS組織(品牌入口網站租用戶)。
  2. Click Create new project . 系統會為您的組織建立空白專案,其名稱由系統產生。
    按一 下「編輯專案 」以更新「 專案標題 」和「說 明」 ,然後按 ​一下「儲存」。
  3. 在「專案 概述」標籤中 ,按一 下「新增API」
  4. 在「新 增API」視窗中 ,選取「 AEM品牌入口網站 」並按「 下一步 」。
    請確定您擁有AEM品牌入口網站服務的存取權。
  5. 在「設 定API 」視窗中,按 一下「上傳公開金鑰」 。 然後,按一 下「選取檔案 」,並上傳您已在取得公用憑證區段中下載的公 用金鑰(.crt檔案)
    按一下​ 下一步
  6. 驗證公開密鑰,然後按一下「 Next(下一步) 」。
  7. 選取 資產品牌入口網站 ,做為預設產品設定檔,然後按一下 儲存設定的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 information.
您現在可以使用用戶端ID(API金鑰)、用戶端密碼和JWT裝載,在AEM 資產中設定IMS 帳戶。

設定IMS帳戶

請確認您已執行下列步驟:
執行下列步驟以設定IMS帳戶。
  1. 開啟「IMS設定」並導覽至「帳戶 」標 簽。 您在取得公開憑證時 仍保持頁面開啟
  2. 指定 IMS 帳戶的​ 標題
    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/
    在建立服務帳戶(JWT)連接 ​Introxing時複製的 API密鑰欄位、Client Secret ​和 Payload 建立服務帳戶(JWT)連接 (JWT payload)中指定客戶機ID。
    按一下​ 建立
    已設定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設定
    在「服 務URL 」欄位中,指定您的品牌入口網站租用戶(組織)URL。
  5. 按一下​ 「儲存並關閉」 。雲端設定此時已建立。
    您的AEM Assets as a Cloud Service例項現在已設定品牌入口網站租用戶。

測試設定

執行以下步驟以驗證配置:
  1. 登入AEM Assets。
  2. From the Tools panel, navigate to Deployment > Distribution .
    A Brand Portal distribution agent ( bpdistributionagent0 ) is created under Publish to Brand Portal .
  3. 按一 下「發佈至品牌入口網站 」以開啟散發代理。
    您可以在「狀態」頁籤下看到分 發隊列
    發佈代理程式包含兩個佇列:
    • processing-queue :將資產分發至品牌入口網站。
    • error-queue :對於分發失敗的資產。
    建議您檢閱失敗,並定期清 除錯誤佇列
  4. 若要驗證AEM Assets(雲端服務)和品牌入口網站(Brand Portal)之間的連線,請按一下「 Test Connection 」圖示。
    出現一則訊息,指出您 的測試套件已成功傳送
    請避免停用發佈代理程式,因為可能導致在佇列中執行的資產發佈失敗。
您現在可以:
See Brand Portal documentation for more information.

發佈記錄檔

您可以監視資產發佈工作流程的散發代理記錄檔。
例如,我們已將資產從AEM Assets發佈至品牌入口網站,以驗證設定。
  1. Follow the steps (from 1 to 4) as shown in the Test Configuration section and navigate to the distribution agent page.
  2. 按一 下「記錄 」以檢視處理和錯誤記錄。
分發代理已生成以下日誌:
  • 資訊:這是系統生成的日誌,在成功配置分發代理時觸發。
  • DSTRQ1(請求1):測試連線時的觸發器。
發佈資產時,會產生下列請求和回應記錄檔:
發佈代理程式請求
  • DSTRQ2 (請求 2):觸發資產發佈請求。
  • DSTRQ3(請求3):系統會觸發另一個請求,以發佈AEM Assets檔案夾(資產存在其中)並複製品牌入口網站中的檔案夾。
發佈代理程式回應
  • queue-bpdistributionagent0 (DSTRQ2):資產已發佈至 Brand Portal。
  • queue-bpdistributionagent0(DSTRQ3):系統會複製品牌入口網站中的「AEM資產」檔案夾(包含資產)。
在上述範例中,系統會觸發其他請求和回應。系統無法在品牌入口網站中找到父資料夾(新增路徑),因為資產是第一次發佈,因此會觸發額外請求,在發佈資產的品牌入口網站中建立同名的父資料夾。
當父資料夾不存在於品牌入口網站中或已在AEM Assets中修改時,會產生其他請求。