Show Menu
主题×

使用 Brand Portal 配置 AEM Assets

Adobe Experience Manager(AEM)资产通过Adobe开发人员控制台配置为品牌门户,该控制台为品牌门户租户购买IMS令牌以进行授权。
配置如何工作?
使用Brand Portal租户(组织)配置AEM Assets云实例需要在AEM Assets云实例和Adobe Developer Console中进行配置。
  1. 在AEM Assets云实例中,创建IMS帐户并生成公共证书(公钥)。
  2. 在Adobe开发人员控制台中,为您的Brand Portal租户(组织)创建一个项目。
  3. 在项目下,使用公钥配置API以创建服务帐户(JWT)连接。
  4. 获取服务帐户凭据和JWT有效负荷信息。
  5. 在AEM Assets云实例中,使用服务帐户凭据和JWT有效负荷配置IMS帐户。
  6. 在AEM Assets云实例中,使用IMS帐户和Brand Portal端点(组织URL)配置Brand Portal云服务。
  7. 通过将资产从AEM Assets云实例发布到Brand Portal来测试配置。
Brand Portal租户只应配置一个AEM Assets云实例。
请勿配置具有多个AEM资产云实例的Brand Portal租户。

前提条件

您需要以下各项才能使用 Brand Portal 配置 AEM Assets:
  • 已启动且正在运行的 AEM Assets 云实例。
  • Brand Portal 租户 URL。
  • 对 Brand Portal 租户的 IMS 组织具有系统管理员权限的用户。
联系客户关怀 ,进一步了解查询。

创建配置

按指定顺序执行以下步骤,在Brand Portal中配置AEM Assets云实例。

创建 IMS 配置

IMS配置使用AEM Assets云实例对您的Brand Portal租户进行身份验证。
IMS 配置包括两个步骤:

获取公共证书

公共证书允许您在Adobe开发人员控制台上验证用户档案。
  1. 登录AEM Assets云实例。
  2. From the Tools panel, navigate to Security > Adobe IMS Configurations .
  3. 在Adobe IMS配置页面中,单击创
  4. 您将被重定向到“ Adobe IMS技术帐户配置”页 。 By default, the Certificate tab opens.
    选择云解决方 案Adobe Brand Portal
  5. Mark the check box Create new certificate and specify an alias for the certificate. 别名将用作对话框的名称。
  6. 单击​ 创建证书 。然后,在对 话框 中单击“确定”以生成公共证书。
  7. Click Download Public Key and save the certificate (.crt) file on your machine.
    该证书文件将用于后续步骤,以在Adobe开发人员控制台中为Brand Portal租户配置API并生成服务帐户凭据。
  8. 单击​ 下一步
    在“帐 ”选项卡中,您创建Adobe IMS帐户,但为此,您需要在Adobe开发人员控制台中生成服务帐户凭据。 暂时保持此页面打开。
    在Adobe Developer Console中打开一 个新选项卡并创建一个服务帐户(JWT)连接 ,以获取用于配置IMS帐户的凭据和JWT有效负荷。

创建服务帐户(JWT)连接

在Adobe开发人员控制台中,项目和API在组织(Brand Portal租户)级别进行配置。 配置API可在Adobe开发人员控制台中创建服务帐户(JWT)连接。 可通过生成密钥对(私钥和公钥)或上传公钥来配置API的方法有两种。 要在Brand Portal中配置AEM Assets云实例,您必须在AEM Assets云实例中生成公共证书(公钥),并通过上传公钥在Adobe Developer Console中创建凭据。 此公钥用于为所选Brand Portal组织配置API,并为服务帐户生成凭据和JWT有效负荷。 这些凭据还用于在AEM Assets云实例中配置IMS帐户。 配置IMS帐户后,您可以在AEM Assets云实例中配置Brand Portal云服务。
执行以下步骤以生成服务帐户凭据和JWT有效负荷:
  1. 以IMS组织(Brand Portal租户)的系统管理员权限登录到Adobe Developer Console。 默认URL为
    确保您从右上角的下拉菜单(组织列表)中选择了正确的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. 选择默认的产品用户档案 资产品牌门户 ,然后单 击保存配置
  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 .
您现在可以使用客户端ID(API密钥)、客户端机密和JWT负载 在AEM资产云实例中 配置IMS帐户。

配置IMS帐户

确保您已执行以下步骤:
请执行以下步骤来配置您在获取公共证书时创建 的IMS帐户
  1. 打开IMS配置并导航到帐 户选 项卡。 您在获取公共证书时 使页面保持打开状态
  2. 为 IMS 帐户指定​ 标题
    在​ 授权服务器 ​中,输入 URL: https://ims-na1.adobelogin.com/
    将客户端ID粘贴到您在创建服务帐户(JWT)连接时复制的API密钥、 客户端机密和JWT有效负荷中
    单击​ 创建
    已配置IMS帐户。
  3. Select the IMS account configuration and click Check Health .
    在对 话框 中单击“检查”。 成功配置时,将显示一条消息,告 示标记已成功检索
您只能有一个IMS配置。 请勿创建多个 IMS 配置。
确保IMS配置通过运行状况检查。 如果配置未通过运行状况检查,则无效。 您必须删除它并创建新的有效配置。

配置云服务

请执行以下步骤来配置Brand Portal云服务:
  1. 登录AEM Assets云实例。
  2. From the Tools panel, navigate to Cloud Services > AEM Brand Portal .
  3. 在Brand Portal的“配置”页中,单击“ 创建 ”。
  4. 指定配置的​ 标题
    选择配置IMS帐户时已 创建的IMS配置
    In the Service URL , enter your Brand Portal tenant (organization URL).
  5. 选择​ 保存并关闭 。将创建云配置。现在已为您的 AEM Assets 云实例配置了 Brand Portal 租户。

测试配置

请执行以下步骤以验证配置:
  1. 登录AEM Assets云实例。
  2. From the Tools panel, navigate to Deployment > Distribution .
  3. 在“分发”页面中,您可以看到已为发布到品牌门 bpdistributionagent0 户创建一 个品牌门户分发代理
    单击​ 发布到 Brand Portal
    默认情况下,将为 Brand Portal 租户创建一个分发代理。
  4. 在分发代理页面中,您可以在状态选项卡下看到分 发队列
    分发代理包含两个队列:
    • processing-queue : 用于将资产分发到Brand Portal。
    • error-queue : 对于分发失败的资产。
    建议定期检查故障并清 除错误队列
  5. 要验证 AEM Assets 与 Brand Portal 之间的连接,请单击​ 测试连接
    页面底部会显示一条消息,表明测试包已成功交付。
    请避免禁用分发代理,因为这可能导致资产分发(在队列中运行)失败。
已成功为您的 AEM Assets 云实例配置了 Brand Portal,您现在可以:
除了上述功能,您还可以将元数据架构、图像预设、搜索 Facet 和标记从 AEM Assets 发布到 Brand Portal。
有关详细信息,请参阅 Brand Portal 文档

分发日志

您可以检查日志,以了解有关分发代理执行的操作的详细信息。
例如,我们已将资产从AEM资产发布到Brand Portal以验证配置。
  1. Follow the steps (from 1 to 4) as shown in the test connection section and navigate to the distribution agent page.
  2. 单击​ 日志 ​以查看分发日志。您可以在此处查看处理日志和错误日志。
分发代理生成日志如下:
  • 信息: 这是系统生成的日志,在成功配置时触发,从而启用分发代理。
  • DSTRQ1(请求1): 测试连接时的触发器。
发布资产时,会生成以下请求和响应日志:
分发代理请求
  • DSTRQ2(请求 2):触发资产发布请求。
  • DSTRQ3(请求3): 系统会触发另一个请求,以发布资产所在的文件夹,并在Brand Portal中复制该文件夹。
分发代理响应
  • queue-bpdistributionagent0(DSTRQ2):将资产发布到 Brand Portal。
  • queue-bpdistributionagent0(DSTRQ3):系统会在 Brand Portal 中复制包含该资产的文件夹。
在上例中,将触发其他请求和响应。 系统无法在Brand Portal中找到父文件夹(即添加路径),因为资产是首次发布的,因此,系统会触发其他请求,在发布资产的Brand Portal中创建具有相同名称的父文件夹。
如果 Brand Portal 中(上述示例中)不存在父文件夹,或父文件夹在 AEM Assets 中已被修改,则会生成其他请求。