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

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

配置工作流

AEM Assets作为Cloud Service已通过Adobe开发者控制台配置品牌门户,该控制台为品牌门户租户购买AdobeIdentity Management服务(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
  • 品牌门户租户URL
  • 对Brand Portal租户的IMS组织具有系统管理员权限的用户

创建配置

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

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

创建 IMS 配置

IMS配置以Cloud Service实例的身份验证您的AEM Assets,该实例使用Brand Portal租户。

IMS 配置包括两个步骤:

获取公共证书

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

  1. 登录 AEM Assets。

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

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

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

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

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

    创建证书

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

    公钥稍后将用于为您的Brand Portal租户配置API并在Adobe开发人员控制台中生成服务帐户凭据。

    下载证书

  8. 单击​下一步

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

    在Adobe开发者控制台](#createnewintegration)中打开一个新选项卡并[创建服务帐户(JWT)连接,以获取用于配置IMS帐户的凭据和JWT有效负荷。

创建服务帐户(JWT)连接

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

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

  1. 使用IMS组织(Brand Portal租户)的系统管理员权限登录Adobe开发人员控制台。 默认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. 验证公钥,然后单击​Next

  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品牌门户

  3. 在“品牌门户配置”页中,单击​创建

  4. 指定配置的​标题

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

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

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

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

测试配置

请执行以下步骤以验证配置:

  1. 登录 AEM Assets。

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

    在​发布到品牌门户​下创建品牌门户分发代理(bpdistributionagent0)。

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

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

    分发代理包含两个队列:

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

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

    注意

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

  4. 要验证作为Cloud Service的AEM Assets与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修改过,则会生成其他请求。

在此页面上