將AEM Assets設定為Cloud Service及品牌入口網站

設定Adobe Experience Manager Assets Brand Portal可讓您將Adobe Experience Manager Assets中已核准的品牌資產發佈為Cloud Service例項至品牌入口網站，並將其發佈至品牌入口網站使用者。

設定工作流程

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 設定 AEM Assets：

  • 以Cloud Service例項啟動並執行AEM Assets
  • 品牌入口網站租用戶URL
  • 對品牌入口網站的IMS組織具有系統管理員權限的使用者

建立設定

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

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

建立 IMS 設定

IMS設定會以Cloud Service例項驗證您的AEM資產，並與品牌入口網站租用戶一起使用。

IMS 設定包括兩個步驟：

取得公開憑證

公開金鑰（憑證）會在Adobe Developer Console上驗證您的個人檔案。

  1. 登入AEM Assets。

  2. 從​工具​面板，導覽至​安全性 > Adobe IMS設定。

  3. 在「Adobe IMS設定」頁面中，按一下「建立」。 它會重新導向至​Adobe IMS技術帳戶設定​頁面。 預設情況下，Certificate​頁籤開啟。

  4. 在​雲端解決方案​下拉式清單中，選取​Adobe品牌入口網站。

  5. 選擇「建立新證書」複選框，並為公鑰指定​別名。 ​​別名用作公共密鑰的名稱。

  6. 按一下​建立憑證。然後，按一下​OK​以生成公鑰。

    建立憑證

  7. 按一下​下載公開密鑰​表徵圖，並將公開密鑰(CRT)檔案保存在電腦上。

    公開金鑰稍後將用於為您的品牌入口網站租用戶設定API，並在Adobe Developer Console中產生服務帳戶認證。

    下載憑證

  8. 按一下​下一步。

    在​Account​標籤中，會建立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. 按一下​建立新項目。 系統會為您的組織建立空白專案，其名稱由系統產生。

    按一下​編輯項目​以更新​項目標題​和​說明，然後按一下​保存。

  3. 在​Project overview​標籤中，按一下​Add API。

  4. 在​新增API視窗​中，選取​AEM品牌入口網站，然後按一下​Next。

    請確定您擁有AEM品牌入口網站服務的存取權。

  5. 在​配置API​窗口中，按一下​上傳公開密鑰。 然後，按一下「選擇檔案」並上傳您在獲取公共證書部分中下載的公開密鑰（.crt檔案）。

    按一下​下一步。

    上傳公開金鑰

  6. 驗證公鑰，然後按一下​Next。

  7. 選擇​Assets Brand Portal​作為預設產品配置檔案，然後按一下​Save configured API。

    選擇產品設定檔

  8. 一旦設定API後，就會將您重新導向至API概觀頁面。 在​Credentials​下的左側導航中，按一下​服務帳戶(JWT)​選項。

    注意

    您可以查看憑據並執行諸如生成JWT Token、複製憑據詳細資訊、檢索客戶機密碼等操作。

  9. 從​客戶端憑據​頁籤複製​客戶端ID。

    按一下「檢索客戶機密碼」並複製​[!UICONTROL ​客戶機密碼​]。

    服務帳戶認證

  10. 導航至「生成JWT ]」頁籤並複製​JWT Payload​資訊。[

您現在可以使用用戶端ID（API金鑰）、用戶端密碼和JWT裝載至，在AEM資產中設定IMS帳戶。

設定IMS帳戶

請確認您已執行下列步驟：

執行下列步驟以設定IMS帳戶。

  1. 開啟IMS設定並導覽至​Account​標籤。 在取得公共憑證時，您會保持頁面開啟。

  2. 指定 IMS 帳戶的​標題。

    在​授權伺服器​欄位中，指定URL:https://ims-na1.adobelogin.com/

    在建立服務帳戶(JWT)連線時，在​API金鑰​欄位、客戶機密碼​和​Payload（JWT有效載荷）中指定您複製的用戶端ID。

    按一下​建立。

    已設定IMS帳戶。

    IMS 帳戶設定

  3. 選擇IMS帳戶配置，然後按一下​檢查運行狀況。

    在對話框中按一下「檢查」。 成功配置時，將顯示一條消息，表示​Token已成功檢索。

注意

您只能有一個IMS設定。

確保IMS配置通過健康檢查。 如果配置未通過健康檢查，則無效。 您必須刪除它並建立新的有效設定。

設定雲端服務

執行下列步驟以設定品牌入口網站雲端服務：

  1. 登入AEM Assets。

  2. 從​工具​面板，導覽至​雲端服務 > AEM品牌入口網站。

  3. 在「品牌入口網站設定」頁面中，按一下「建立​」。

  4. 指定設定的​標題。

    選擇您在設定IMS帳戶時建立的IMS設定。

    在​服務URL​欄位中，指定您的品牌入口網站租用戶（組織）URL。

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

    您的AEM Assets（Cloud Service例項）現在已設定為品牌入口網站租用戶。

測試設定

執行以下步驟以驗證配置：

  1. 登入AEM Assets。

  2. 從​工具​面板，導航至​部署 > 分發。

    在​發佈到品牌門戶​下建立品牌門戶分發代理(bpdistributionagent0)。

  3. 按一下「發佈至品牌入口網站」，以開啟散發代理。​

    您可以在​Status​標籤下看到分佈隊列。

    發佈代理程式包含兩個佇列：

    • processing-queue:將資產分發至品牌入口網站。

    • error-queue:對於分發失敗的資產。

    注意

    建議定期檢查故障並清除​error-queue。

  4. 若要驗證AEM Assets(Cloud Service)與品牌入口網站之間的連線，請按一下​Test Connection（測試連線）​圖示。

    出現一條消息，表示​測試包已成功交付。

    注意

    請避免停用發佈代理程式，因為可能導致在佇列中執行的資產發佈失敗。

您現在可以：

如需詳細資訊，請參閱品牌入口網站檔案。

發佈記錄檔

您可以監視資產發佈工作流程的散發代理記錄檔。

例如，我們已將資產從AEM Assets發佈至品牌入口網站，以驗證設定。

  1. 按照測試配置部分中顯示的步驟（從1到4），導航到分發代理頁面。

  2. 按一下​日誌​查看處理和錯誤日誌。

分發代理已生成以下日誌：

  • 資訊：這是系統生成的日誌，在成功配置分發代理時觸發。
  • DSTRQ1（請求1）:測試連線時的觸發器。

發佈資產時，會產生下列請求和回應記錄檔：

發佈代理程式請求：

  • DSTRQ2 (請求 2)：觸發資產發佈請求。
  • DSTRQ3（請求3）:系統會觸發另一個請求，以發佈AEM Assets檔案夾（資產存在其中）並複製品牌入口網站中的檔案夾。

發佈代理程式回應：

  • queue-bpdistributionagent0 (DSTRQ2)：資產已發佈至 Brand Portal。
  • queue-bpdistributionagent0(DSTRQ3):系統會複製品牌入口網站中的「AEM資產」檔案夾（包含資產）。

在上述範例中，系統會觸發其他請求和回應。系統無法在品牌入口網站中找到父資料夾（新增路徑），因為資產是第一次發佈，因此會觸發額外請求，在發佈資產的品牌入口網站中建立同名的父資料夾。

注意

當父資料夾不存在於品牌入口網站中或已在AEM Assets中修改時，會產生其他請求。

本頁內容