Configure AEM Assets as a Cloud Service with 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:

  • 以AEM Assets为Cloud Service实例
  • 品牌门户租户URL
  • 对Brand Portal租户的IMS组织具有系统管理员权限的用户

创建配置

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

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

创建 IMS 配置

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

IMS 配置包括两个步骤:

获取公共证书

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

  1. 登录 AEM 资产。

  2. From the Tools panel, navigate to Security > Adobe IMS Configurations.

  3. 在“AdobeIMS配置”页中,单击 创建。 It will redirect to the Adobe IMS Technical Account Configuration page. By default, the Certificate tab opens.

  4. 在“ 云解决方案 ”下拉 列表中选 择AdobeBrand Portal。

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

  6. 单击​创建证书。Then, click OK to generate the public key.

    创建证书

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

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

    下载证书

  8. 单击​下一步

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

    在Adobe开发者控 制台中打开一个新选项卡并创建服务帐户(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. Click Create new project. 将为您的组织创建一个空白项目,其名称由系统生成。

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

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

  4. 在“添 加API”窗口中,选 择AEM Brand Portal ,然后单 击“下一步”。

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

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

    单击​下一步

    上传公钥

  6. 验证公钥,然后单击“下 一步”。

  7. 选择 Assets Brand Portal 作为默认产品用户档案,然后单 击保存配置的API

    选择产品用户档案

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

    注意

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

  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 Assets的IMS帐户

配置IMS帐户

确保您已执行以下步骤:

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

  1. 打开IMS配置并导航到“帐 ”选项卡。 您在获取公共证书时使 页面保持打开状态

  2. 为 IMS 帐户指定​标题

    In the Authorization Server field, specify the URL: https://ims-na1.adobelogin.com/

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

    单击​创建

    已配置IMS帐户。

    IMS 帐户配置

  3. Select the IMS account configuration and click Check Health.

    在对 话框 中单击“检查”。 成功配置时,将显示一条消息,告 示标记已成功检索

注意

您只能有一个IMS配置。

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

配置云服务

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

  1. 登录 AEM 资产。

  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal.

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

  4. 指定配置的​标题

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

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

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

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

测试配置

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

  1. 登录 AEM 资产。

  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:用于将资产分发到Brand Portal。

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

    注意

    建议定期检查故障并清 除错误队列

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

    将显示一条消息, 表明测试包已成功交付

    注意

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

您现在可以:

See Brand Portal documentation for more information.

分发日志

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

例如,我们已将资产从AEM Assets发布到Brand Portal以验证配置。

  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文件夹(该资产存在),并在Brand Portal中复制该文件夹。

分发代理响应

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

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

注意

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

在此页面上