將AEM Assets配置為Cloud Service和品牌門戶

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

使用Cloud Manager啟用品牌入口網站

Cloud Manager使用者會啟動AEM Assets的品牌入口網站作為Cloud Service例項。 啟動工作流程會在後端建立必要的設定(授權Token、IMS設定和品牌入口雲端服務),並反映Cloud Manager中品牌入口租戶的狀態。 啟用品牌入口網站可讓AEM Assets使用者將資產發佈至品牌入口網站,並將資產分發至品牌入口網站使用者。

必備條件

您需要下列項目才能將您AEM Assets的品牌入口網站啟動為Cloud Service實例:

  • 以Cloud Service實例啟動並運行AEM Assets。
  • 可存取Cloud Manager的使用者,已指派給Cloud Manager產品的設定檔。 如需詳細資訊,請參閱存取Cloud Manager
注意

Cloud Service實例的AEM Assets僅有權與一個品牌入口網站租用戶連接。 您可以將AEM Assets的多個環境(開發、生產和階段)當作Cloud Service實例,其中品牌入口網站在一個環境上啟動。

啟動品牌入口網站的步驟

您可以啟動品牌入口網站,同時將AEM Assets的環境建立為Cloud Service例項,或個別建立。 假設環境已建立,您現在必須啟動品牌入口網站。

  1. 登入AdobeCloud Manager,並導覽至​Environments

    Environments​頁面會顯示所有現有環境的清單。

  2. 從清單中選擇環境(逐個)以查看環境詳細資訊。

    品牌門戶有權使用其中一個可用環境,並反映在​環境資訊​下。

    找到與品牌入口網站相關的環境後,按一下​啟用品牌入口網站​按鈕,開始啟動工作流程。

    啟動品牌入口網站

  3. 啟動工作流程會在後端建立必要的組態時,啟動品牌入口網站租用戶只需幾分鐘。 啟用品牌入口網站租用戶後,狀態會變更為「已啟用」。

    檢視狀態

注意

品牌入口網站必須在與AEM Assets相同的IMS組織上啟動為Cloud Service例項。

如果您對IMS組織(組織1-現有)有現有的品牌入口網站雲端設定(使用Adobe開發人員主控台手動設定),而您的AEM Assets為Cloud Service例項,則會針對其他IMS組織(組織2-新)設定,從雲端管理員啟動品牌入口網站會將品牌入口網站IMS組織重設為org2-new。 雖然org1-existing上的手動設定雲端設定會顯示在AEM Assets作者例項中,但在從Cloud Manager啟動品牌入口網站後,將不再使用。

如果現有的品牌入口網站雲端設定和Cloud Service例項的AEM Assets使用相同的IMS組織(組織1),您只需從Cloud Manager啟動品牌入口網站。

另請參閱:

登入您的品牌入口網站租用戶:

在Cloud Manager中啟動您的品牌入口網站租用戶後,您可以從Admin Console或直接使用租用戶URL登入品牌入口網站。

您的品牌入口網站租用戶的預設URL為:https://<tenant-id>.brand-portal.adobe.com/

其中,租用戶ID為IMS組織。

如果您不確定品牌入口網站URL,請執行下列步驟:

  1. 登入Admin Console並導覽至​產品

  2. 從左側導軌中,選擇​Adobe Experience Manager品牌入口網站——品牌入口網站

  3. 按一下​前往品牌入口網站,直接在瀏覽器中開啟品牌入口網站。

    或者,從​前往品牌入口網站​連結複製品牌入口網站URL,並貼到您的瀏覽器中以開啟品牌入口網站介面。

    存取品牌入口網站

測試連線

執行下列步驟以驗證您的AEM Assets作為Cloud Service實例與品牌入口網站租用戶之間的連接:

  1. 登入AEM Assets。

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

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

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

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

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

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

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

    注意

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

  4. 要驗證作為Cloud Service和品牌門戶的AEM Assets之間的連接,請按一下​測試連接​表徵圖。

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

    注意

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

若要確認您的AEM Assets(Cloud Service實例)與品牌入口網站租用戶之間的連接,請從AEM Assets發佈資產至品牌入口網站。 如果連線成功,發佈的資產會顯示在品牌入口網站介面中。

您現在可以:

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

發佈記錄檔

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

現在,讓我們將資產從AEM Assets發佈至品牌入口網站,並查看記錄檔。

  1. 按照​測試連接​部分中顯示的步驟(從1到4),導航到分發代理頁面。

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

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

  • 資訊:它是系統生成的日誌,在成功配置分發代理時觸發。
  • DSTRQ1(請求1):測試連線時的觸發器。

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

發佈代理程式請求

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

發佈代理程式回應

  • queue-bpdistributionagent0 (DSTRQ2):資產已發佈至 Brand Portal。
  • queue-bpdistributionagent0(DSTRQ3):系統會複製品牌入口網站中的AEM Assets資料夾(包含資產)。

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

注意

當父資料夾不存在於Brand Portal中或已修改於AEM Assets時,會產生其他請求。

除了以Cloud Service啟動AEM Assets的品牌入口網站的自動化工作流程外,還有另一種方法可使用Adobe開發人員主控台手動將AEM Assets設定為Cloud Service品牌入口網站,這已不再建議使用。

注意

如果您在啟動品牌入口網站租用戶時遇到任何問題,請連絡Adobe支援。

使用Adobe開發人員控制台進行手動配置

下節說明如何使用Adobe開發人員主控台手動將AEM Assets設為Cloud Service品牌入口網站。

之前,AEM Assets是Cloud Service透過Adobe開發人員主控台手動設定品牌入口網站,該主控台會購買AdobeIdentity Management服務(IMS)帳戶代號以授權品牌入口網站租戶。 它需要在AEM Assets和Adobe開發人員主控台中進行配置。

  1. 在AEM Assets,建立IMS帳戶並產生公開金鑰(憑證)。
  2. 在Adobe開發人員主控台中,為您的品牌入口網站租用戶(組織)建立專案。
  3. 在專案下,使用公開金鑰來設定API,以建立服務帳戶連線。
  4. 取得服務帳戶認證和JSON Web Token(JWT)裝載資訊。
  5. 在AEM Assets,使用服務帳戶憑證和JWT裝載來設定IMS帳戶。
  6. 在AEM Assets,使用IMS帳戶和品牌入口端端點(組織URL)來設定品牌入口網站雲端服務。
  7. 將資產從AEM Assets發佈至品牌入口網站,以測試您的設定。
注意

作為Cloud Service實例的AEM Assets僅應配置一個品牌門戶租戶。

必備條件

您需要下列項目才能使用 Brand Portal 設定 AEM Assets:

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

建立設定

在指定的序列中執行下列步驟,以使用品牌入口網站配置AEM Assets。

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

建立 IMS 設定

IMS設定會將您的AEM Assets驗證為品牌入口網站的Cloud Service實例。

IMS 設定包括兩個步驟:

取得公開憑證

公開金鑰(憑證)會在Adobe開發人員主控台上驗證您的個人檔案。

  1. 登入AEM Assets。

  2. 從​工具​面板,瀏覽至​安全 > AdobeIMS配置

  3. 在「AdobeIMS配置」頁中,按一下​建立。 它將重定向至「AdobeIMS技術帳戶配置」頁。 預設情況下,Certificate​頁籤開啟。

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

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

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

    建立憑證

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

    公開金鑰稍後會用來為您的品牌入口網站租用戶設定API,並在Adobe開發人員主控台中產生服務帳戶認證。

    下載憑證

  8. 按一下​下一步

    在​Account​標籤中,建立AdobeIMS帳戶,此帳戶需要在Adobe開發人員主控台中產生的服務帳戶認證。 暫時保持此頁面開啟。

    開啟新標籤,並在Adobe開發人員主控台(Developer Console)中建立服務帳戶(JWT)連線,以取得用於設定IMS帳戶的認證和JWT裝載。🔗

建立服務帳戶(JWT)連接

在Adobe開發人員主控台中,專案和API是在品牌入口網站租用戶(組織)層級設定。 配置API會建立服務帳戶(JWT)連接。 有兩種方法可用來設定API:產生金鑰對(私用和公開金鑰)或上傳公開金鑰。 若要使用品牌入口網站來設定AEM Assets,您必須在AEM Assets產生公開金鑰(憑證),並上傳公開金鑰以在Adobe開發人員主控台中建立認證。 必須有這些認證才能在AEM Assets設定IMS帳戶。 一旦設定IMS帳戶後,您就可以在AEM Assets設定品牌入口網站雲端服務。

執行以下步驟以生成服務帳戶憑據和JWT裝載:

  1. 以IMS組織(品牌入口租戶)的系統管理員權限登入Adobe開發人員主控台。 預設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 Assets設定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. 從​工具​面板,導覽至​Cloud Services > 品AEM牌入口網站

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

  4. 指定設定的​標題

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

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

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

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

您現在可以檢查散發代理並將資產發佈至品牌入口網站,以測試設定。

本頁內容