将AEM Assets配置为Cloud Service(带有Brand Portal)

通过配置Adobe Experience Manager Assets Brand Portal,您可以将Adobe Experience Manager Assets中已批准的品牌资产作为Cloud Service实例发布到Brand Portal,然后将其分发到Brand Portal用户。

使用Cloud Manager激活Brand Portal

Cloud Manager用户将AEM Assets的Brand Portal激活为Cloud Service实例。 激活工作流会在后端创建所需的配置(授权令牌、IMS配置和Brand Portal云服务),并反映Cloud Manager中Brand Portal租户的状态。 激活Brand Portal使AEM Assets用户能够将资产发布到Brand Portal并分发到Brand Portal用户。

前提条件

您需要以下内容才能将AEM Assets上的Brand Portal作为Cloud Service实例激活:

  • 作为Cloud Service实例启动并运行AEM Assets。
  • 有权访问Cloud Manager的用户,已分配给Cloud Manager产品的用户档案。 有关详细信息,请参阅访问Cloud Manager
注意

作为Cloud Service实例的AEM Assets仅有权与一个Brand Portal租户连接。 您可以将AEM Assets作为Cloud Service实例具有多个环境(开发、生产和舞台),其中Brand Portal在一个环境上激活。

激活Brand Portal的步骤

您可以在将AEM Assets创建为Cloud Service实例的环境时激活Brand Portal,也可以单独激活。 假设环境已创建,您现在需要激活Brand Portal。

  1. 登录到Adobe Cloud Manager,然后导航到​环境

    环境​页显示所有现有环境的列表。

  2. 从列表中选择环境(逐个)以视图环境详细信息。

    Brand Portal有权访问某个可用环境,并反映在​环境信息​下。

    找到与Brand Portal关联的环境后,单击​激活Brand Portal​按钮,开始激活工作流。

    激活Brand Portal

  3. 激活工作流在后端创建所需的配置时,激活Brand Portal租户需要几分钟。 激活Brand Portal租户后,状态将更改为“已激活”。

    视图状态

注意

必须在与AEM Assets作为Cloud Service实例的相同IMS组织上激活Brand Portal。

如果您为IMS组织(org1-existing)现有Brand Portal云配置(使用Adobe Developer Console手动配置),且您的AEM Assets为另一个IMS组织(org2-new)配置了Cloud Service实例,则从云管理器激活Brand Portal会将Brand Portal IMS组织重置为org2-new. 尽管在org1-existing上手动配置的云配置在AEM Assets作者实例中可见,但在从云管理器激活Brand Portal后,将不再使用。

如果现有Brand Portal云配置和作为Cloud Service实例的AEM Assets使用相同的IMS组织(org1),您只需从云管理器激活Brand Portal。

另请参阅:

登录到您的Brand Portal租户:

在Cloud Manager中激活您的Brand Portal租户后,您可以从Admin Console或直接使用租户URL登录到Brand Portal。

您的Brand Portal租户的默认URL为:https://<tenant-id>.brand-portal.adobe.com/

其中,租户ID为IMS组织。

如果您不确定Brand Portal URL,请执行以下步骤:

  1. 登录Admin Console并导航到​产品

  2. 在左边栏中,选择​Adobe Experience Manager Brand Portal - Brand Portal

  3. 单击​转至Brand Portal​以在浏览器中直接打开Brand Portal。

    或者,从​转到Brand Portal​链接复制Brand Portal租户URL,并将其粘贴到您的浏览器中以打开Brand Portal界面。

    访问Brand Portal

测试连接

请执行以下步骤来验证作为Cloud Service实例的AEM Assets与Brand Portal租户之间的连接:

  1. 登录 AEM Assets。

  2. 从​工具​面板,导航到​部署 > 分发

    在​发布到Brand Portal​下创建Brand Portal分发代理(bpdistributionagent0)。

  3. 单击​发布到Brand Portal​以打开分发代理。

    您可以在​状态​选项卡下看到分布队列。

    分发代理包含两个队列:

    • processing-queue:用于将资产分发到Brand Portal。

    • error-queue:对于分发失败的资产。

    注意

    建议定期查看故障并清除​error-queue

  4. 要验证作为Cloud Service的AEM Assets与Brand Portal之间的连接,请单击​测试连接​图标。

    将显示一条消息,提示已成功传送​测试包

    注意

    请避免禁用分发代理,因为这可能导致资产分发(在队列中运行)失败。

要验证作为Cloud Service实例的AEM Assets与Brand Portal租户之间的连接,请将资产从AEM Assets发布到Brand Portal。 如果连接成功,则已发布的资产会显示在Brand Portal界面中。

您现在可以:

有关详细信息,请参阅Brand Portal文档

分发日志

您可以监视资产发布工作流的分发代理日志。

现在,让我们将资产从AEM Assets发布到Brand Portal并查看日志。

  1. 按照​测试连接​部分中显示的步骤(从1到4)操作,并导航到分发代理页。

  2. 单击​日志​以视图处理日志和错误日志。

分发代理已生成以下日志:

  • 信息:它是系统生成的日志,在成功配置分发代理时触发。
  • DSTRQ1(请求1):测试连接时触发器。

发布资产时,会生成以下请求和响应日志:

分发代理请求

  • DSTRQ2(请求 2):触发资产发布请求。
  • DSTRQ3(请求3):系统会触发另一个请求,以发布AEM Assets文件夹(资产所在的文件夹),并在Brand Portal中复制该文件夹。

分发代理响应

  • queue-bpdistributionagent0(DSTRQ2):将资产发布到 Brand Portal。
  • queue-bpdistributionagent0(DSTRQ3):系统将复制Brand Portal中的AEM Assets文件夹(包含资产)。

在上例中,将触发其他请求和响应。 系统无法在Brand Portal中找到父文件夹(添加路径),因为资产是首次发布的,因此系统会触发另一个请求,要求在发布资产的Brand Portal中创建同名的父文件夹。

注意

如果父级文件夹在Brand Portal中不存在或在AEM Assets中已修改,则会生成其他请求。

除了将AEM Assets上的Brand Portal激活为Cloud Service的自动化工作流程外,还有一种方法可使用Adobe开发人员控制台将AEM Assets手动配置为Cloud Service并将Brand Portal,这已不再建议使用。

注意

如果您在激活Brand Portal租户时遇到任何问题,请与Adobe支持联系。

使用Adobe Developer Console进行手动配置

下节介绍如何使用Adobe Developer Console将AEM Assets手动配置为Cloud Service和Brand Portal。

以前,AEM Assets作为Cloud Service是通过Adobe Developer Console手动配置Brand Portal的,后者为Brand Portal租户购买Adobe Identity Management Services(IMS)帐户令牌以授权。 它要求在AEM Assets和Adobe开发人员控制台中进行配置。

  1. 在AEM Assets中,创建IMS帐户并生成公钥(证书)。
  2. 在Adobe开发人员控制台中,为您的Brand Portal租户(组织)创建一个项目。
  3. 在项目下,使用公钥配置API以创建服务帐户连接。
  4. 获取服务帐户凭据和JSON Web Token(JWT)有效负荷信息。
  5. 在AEM Assets中,使用服务帐户凭据和JWT负载配置IMS帐户。
  6. 在AEM Assets中,使用IMS帐户和Brand Portal端点(组织URL)配置Brand Portal云服务。
  7. 通过将资产从AEM Assets发布到Brand Portal来测试配置。
注意

作为Cloud Service实例的AEM Assets只能配置一个Brand Portal租户。

前提条件

您需要以下各项才能使用 Brand Portal 配置 AEM Assets:

  • 作为Cloud Service实例启动并运行AEM Assets
  • Brand Portal租户URL
  • 对Brand Portal租户的IMS组织具有系统管理员权限的用户

创建配置

在指定序列中执行以下步骤以配置带Brand Portal的AEM Assets。

  1. 获取公共证书
  2. 创建服务帐户(JWT)连接
  3. 配置IMS帐户
  4. 配置云服务

创建 IMS 配置

IMS配置将AEM Assets作为Cloud Service实例与Brand Portal租户进行身份验证。

IMS 配置包括两个步骤:

获取公共证书

公钥(证书)可在Adobe Developer控制台上验证您的用户档案。

  1. 登录 AEM Assets。

  2. 从​工具​面板,导航到​安全 > AdobeIMS配置

  3. 在Adobe IMS配置页中,单击​创建。 它将重定向到​AdobeIMS技术帐户配置​页。 默认情况下,将打开​证书​选项卡。

  4. 在​云解决方案​下拉列表中选择​Adobe品牌门户

  5. 选中​创建新证书​复选框,并为公钥指定​别名。 别名用作公钥的名称。

  6. 单击​创建证书。然后,单击​确定​以生成公钥。

    创建证书

  7. 单击​下载公钥​图标,并将公钥(CRT)文件保存到计算机上。

    公钥稍后将用于为您的Brand Portal租户配置API,并在Adobe Developer Console中生成服务帐户凭据。

    下载证书

  8. 单击​下一步

    在​帐户​选项卡中,将创建Adobe IMS帐户,该帐户需要在Adobe开发人员控制台中生成的服务帐户凭据。 暂时保持此页面打开。

    在Adobe Developer Console](#createnewintegration)中打开新选项卡并创建服务帐户(JWT)连接,以获取用于配置IMS帐户的凭据和JWT负载。[

创建服务帐户(JWT)连接

在Adobe开发人员控制台中,项目和API在Brand Portal租户(组织)级别进行配置。 配置API可创建服务帐户(JWT)连接。 可通过生成密钥对(私钥和公钥)或上传公钥来配置API有两种方法。 要通过Brand Portal配置AEM Assets,您必须在AEM Assets中生成公钥(证书),并通过上传公钥在Adobe Developer Console中创建凭据。 在AEM Assets中配置IMS帐户时需要这些凭据。 配置IMS帐户后,即可在AEM Assets中配置Brand Portal云服务。

执行以下步骤以生成服务帐户凭据和JWT负载:

  1. 使用IMS组织(Brand Portal租户)的系统管理员权限登录到Adobe Developer Console。 默认URL为https://www.adobe.com/go/devs_console_ui

    注意

    确保您从右上角的下拉(组织)列表中选择了正确的IMS组织(Brand Portal租户)。

  2. 单击​新建项目。 系统会为您的组织创建一个具有系统生成名称的空白项目。

    单击​编辑项目​以更新​项目标题​和​说明,然后单击​保存

  3. 在​项目概述​选项卡中,单击​添加API

  4. 在​添加API窗口​中,选择​AEM Brand Portal​并单击​下一步

    确保您有权访问AEM Brand Portal服务。

  5. 在​配置API​窗口中,单击​上传公钥。 然后,单击​选择文件​并上传您在获取公共证书部分下载的公钥(.crt文件)。

    单击​下一步

    上传公钥

  6. 验证公钥,然后单击​下一步

  7. 选择​资产品牌门户​作为默认产品用户档案,然后单击​保存配置的API

    选择产品用户档案

  8. 配置API后,您将被重定向到API概述页。 在左侧导航下的​凭据​中,单击​服务帐户(JWT)​选项。

    注意

    您可以视图凭据并执行诸如生成JWT令牌、复制凭据详细信息、检索客户端机密等操作。

  9. 从​客户端凭据​选项卡中,复制​客户端ID

    单击​检索客户端机密​并复制​客户端机密

    服务帐户凭据

  10. 导航到​生成JWT​选项卡并复制​JWT负载​信息。

您现在可以使用客户端ID(API密钥)、客户端机密和JWT负载在AEM Assets中配置IMS帐户

配置IMS帐户

确保您已执行以下步骤:

请执行以下步骤来配置IMS帐户。

  1. 打开IMS配置并导航到​帐户​选项卡。 在获取公共证书时,您保持页面打开。

  2. 为 IMS 帐户指定​标题

    在​授权服务器​字段中,指定URL:https://ims-na1.adobelogin.com/

    创建服务帐户(JWT)连接时,在​API密钥​字段、客户端密钥​和​负载(JWT负载)中指定您复制的客户端ID。

    单击​创建

    已配置IMS帐户。

    IMS 帐户配置

  3. 选择IMS帐户配置,然后单击​检查运行状况

    单击对话框中的​选中。 成功配置时,将显示一条消息,提示已成功检索​令牌

注意

您只能有一个IMS配置。

确保IMS配置通过运行状况检查。 如果配置未通过运行状况检查,则无效。 您必须删除它并创建新的有效配置。

配置云服务

请执行以下步骤来配置Brand Portal云服务:

  1. 登录 AEM Assets。

  2. 从​工具​面板,导航到​Cloud Services > AEM Brand Portal

  3. 在“Brand Portal配置”页中,单击​创建

  4. 指定配置的​标题

    选择在配置IMS帐户时创建的IMS配置。

    在​服务URL​字段中,指定您的Brand Portal租户(组织)URL。

  5. 单击​保存并关闭。将创建云配置。

    您的AEM Assets现在已配置为Cloud Service实例的Brand Portal租户。

您现在可以通过检查分发代理并将资产发布到Brand Portal来测试配置。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now