Show Menu
主题×

使用 Brand Portal 配置 AEM Assets

Adobe Experience Manager(AEM)资产通过Adobe开发者控制台配置了品牌门户,该控制台为您的品牌门户租户购买IMS令牌以进行授权。
在AEM 6.5.4.0及更高版本上支持通过Adobe开发人员控制台在AEM Assets中配置品牌门户。
早期,品牌门户通过旧版OAuth网关进行配置,该网关使用JWT令牌交换获得IMS访问令牌进行授权。
从2020年4月6日起,不再支持通过旧版OAuth网关进行配置,现已更改为Adobe开发人员控制台。
仅限现有客户
建议继续使用现有的旧版OAuth网关配置。 如果您在旧版OAuth网关配置中遇到问题,请删除现有配置并通过Adobe开发人员控制台创建新配置。
本帮助描述以下两个用例:
  • 新配置 :如果您是新的Brand Portal用户,并且希望使用Brand Portal配置您的AEM Assets作者实例,则可以在Adobe开发人员控制台上创建配置。
  • 升级配置 :如果您是现有的Brand Portal用户,且您的AEM Assets作者实例在旧版OAuth Gateway上配置了Brand Portal,请删除现有配置,并在Adobe开发人员控制台上创建新配置。
提供的信息基于以下假设:阅读本帮助的任何人都熟悉以下技术:
  • 安装、配置和管理Adobe Experience Manager和AEM包。
  • 使用Linux和Microsoft Windows操作系统。

前提条件

您需要以下各项才能使用 Brand Portal 配置 AEM Assets:
  • 具有最新Service Pack的正在运行的AEM Assets作者实例。
  • 品牌门户租户URL。
  • 对 Brand Portal 租户的 IMS 组织具有系统管理员权限的用户。

下载并安装AEM 6.5

建议使AEM 6.5设置AEM作者实例。 如果您没有AEM并且正在运行,请从以下位置下载它:
下载AEM后,有关设置AEM作者实例的说明,请参阅部署 和维护

下载并安装AEM最新Service Pack

有关详细说明,请参阅
如果找不到 最新的AEM包或Service Pack,请与客户服务部门联系。

创建配置

使用Brand Portal配置AEM Assets需要在AEM Assets创作实例和Adobe开发者控制台中进行配置。
  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来测试配置。
AEM Assets作者实例仅应配置一个Brand Portal租户。
如果您是首次使用Brand Portal配置AEM Assets,请在列出的序列中执行以下步骤:

创建 IMS 配置

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

获取公共证书

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

创建服务帐户(JWT)连接

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

配置IMS帐户

确保您已执行以下步骤:
请执行以下步骤配置IMS帐户。
  1. 打开IMS配置并导航到“帐 ”选项卡。 您在获取公共证书时使 页面保持打开状态
  2. 为 IMS 帐户指定​ 标题
    在​ 授权服务器 ​中,输入 URL: https://ims-na1.adobelogin.com/
    粘贴您 在创建服务帐户 (JWT)连接时复制的 API密钥 (客户端ID)、客户端机密和 创建服务帐户(JWT)连接 有效负荷(JWT有效负荷)。
    单击​ 创建
    已配置IMS帐户。
  3. Select the IMS account configuration and click Check Health .
    在对 话框 中单击“检查”。 成功配置时,将显示一条消息,告 示标记已成功检索
您只能有一个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 > Replication .
  3. 在复制页面中,单击作 者上的代理
  4. 为每个租户创建四个复制代理。
    找到Brand Portal租户的复制代理。
    单击复制代理URL。
    复制代理并行工作并平等地共享作业分配,从而将发布速度提高四倍于原始速度。 配置云服务后,无需进行额外配置即可启用默认激活的复制代理以启用多个资产的并行发布。
  5. 要验证 AEM Assets 与 Brand Portal 之间的连接,请单击​ 测试连接
    页面底部显示一条消息,表明*test包已成功交付。
  6. 验证所有四个复制代理的测试结果。
    避免禁用任何复制代理。 它可能导致某些资产的复制失败。
您的AEM Assets作者实例已通过Brand Portal成功配置,您现在可以:

升级配置

按照列出的顺序执行以下步骤以升级现有配置:

验证正在运行的作业

在进行任何修改之前,请确保没有在您的AEM Assets作者实例上运行发布作业。 为此,您可以验证所有四个复制代理,并确保队列处于空闲状态。
  1. 登录您的AEM Assets作者实例。
  2. 从“工 板,导航至“部 ”>“ ​部署复制”。
  3. 在复制页面中,单击作 者上的代理
  4. 找到Brand Portal租户的复制代理。
    确保所有 复制代理的队列 “空闲”,没有发布作业处于活动状态。

删除现有配置

删除现有配置时,必须运行以下清单。
  • 删除所有四个复制代理
  • 删除Brand Portal云服务
  • 删除MAC用户
  1. 登录您的AEM Assets创作实例,以管理员身份打开CRX Lite。 默认URL为
    http://localhost:4502/crx/de/index.jsp
  2. 导航到 /etc/replications/agents.author 并删除Brand Portal租户的所有四个复制代理。
  3. 导航到 /etc/cloudservices/mediaportal 并删除 Cloud Service配置
  4. 导航到 /home/users/mac 并删除您 的Brand Portal租户的MAC用户。
您现在可以 通过AEM 6.5作者实例上的Adobe开发者控制台创建配置。