使用 Brand Portal 配置 AEM Assets

Adobe Experience Manager Assets Brand Portal允许您将已批准的品牌资产从Adobe Experience Manager Assets发布到Brand Portal,并将其分发给Brand Portal用户。

AEM Assets通过Adobe开发人员控制台使用Brand Portal进行配置,从而获取AdobeIdentity Management服务(IMS)帐户令牌以授权Brand Portal租户。

注意

AEM 6.5.4.0及更高版本支持通过Adobe开发人员控制台在Brand Portal中配置AEM Assets。

以前,Brand Portal是通过旧版OAuth网关配置的,旧版OAuth网关使用JSON Web令牌(JWT)交换获取IMS访问令牌以进行授权。

自2020年4月6日起,不再支持通过旧版OAuth网关进行配置,并将其更改为Adobe开发人员控制台。

小贴士

仅适用于现有客户

建议继续使用现有的旧版OAuth网关配置。 如果您在旧版OAuth网关配置中遇到问题,请删除现有配置,并通过Adobe开发人员控制台创建新配置。

此帮助描述了以下两个用例:

  • 新配置:如果您是新的Brand Portal用户,并且想要使用Brand Portal配置AEM Assets创作实例,则可以通过Adobe开发人员控制台创建配置。
  • 升级配置:如果您是在旧版OAuth网关上进行配置的现有Brand Portal用户,请删除现有配置,并通过Adobe开发人员控制台创建新配置。

提供的信息基于以下假设:阅读本帮助的任何人都熟悉以下技术:

  • 安装、配置和管理Adobe Experience Manager和AEM包。

  • 使用Linux和Microsoft Windows操作系统。

前提条件

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

  • 具有最新Service Pack的已启动且正在运行的AEM Assets创作实例
  • Brand Portal租户URL
  • 对Brand Portal租户的IMS组织具有系统管理员权限的用户

下载并安装AEM 6.5

下载并安装最新的AEM Service Pack

下载并安装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,请按照列出的顺序执行以下步骤:

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

创建 IMS 配置

IMS配置通过Brand Portal租户对您的AEM Assets创作实例进行身份验证。

IMS 配置包括两个步骤:

获取公共证书

公钥(证书)在Adobe开发人员控制台上对您的配置文件进行身份验证。

  1. 登录到您的AEM Assets创作实例。 默认URL为http://localhost:4502/aem/start.html

  2. 从​Tools Tools面板中,导航到​Security > AdobeIMS配置

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

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

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

  6. 单击​创建证书。然后,单击​OK​以生成公共密钥。

    创建证书

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

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

    下载证书

  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. 单击​创建新项目。 系统会为您的组织创建一个名为的空白项目。

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

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

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

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

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

    单击​下一步

    上传公共密钥

  6. 验证公钥,然后单击​Next

  7. 选择​Assets Brand Portal​作为默认的产品配置文件,然后单击​保存配置的API

    选择产品配置文件

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

    注意

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

  9. 从​Client Credentials​选项卡中,复制​客户端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帐户配置,然后单击​检查运行状况

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

注意

您只能有一个IMS配置。

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

配置云服务

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

  1. 登录到您的AEM Assets创作实例。

  2. 在​Tools Tools面板中,导航到​Cloud Services > AEM Brand Portal

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

  4. 指定配置的​标题

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

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

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

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

测试配置

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

  1. 登录到AEM Assets云实例。

  2. 从​Tools Tools面板中,导航到​Deployment > Replication

  3. 在“复制”页中,单击​创作代理

    您可以看到为您的Brand Portal租户创建的四个复制代理。

    找到Brand Portal租户的复制代理,然后单击复制代理URL。

    注意

    复制代理并行工作并平均共享作业分配,从而将发布速度提高了原速度的四倍。 配置云服务后,无需进行其他配置即可启用默认激活的复制代理,以启用多个资产的并行发布。

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

    出现一条消息,显示​测试包已成功交付

  5. 在所有四个复制代理上验证测试结果。

    注意

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

    确保将所有四个复制代理都配置为避免超时错误。 请参阅并行发布到Brand Portal时出现的问题疑难解答

您现在可以:

有关更多信息,请参阅Brand Portal文档

升级配置

按照所列顺序执行以下步骤,将现有配置升级到Adobe开发人员控制台:

  1. 验证正在运行的作业
  2. 删除现有配置
  3. 创建配置

验证正在运行的作业

在进行任何修改之前,请确保您的AEM Assets创作实例上未运行任何发布作业。 为此,您可以验证所有四个复制代理上活动作业的状态,并确保队列处于空闲状态。

  1. 登录到您的AEM Assets创作实例。

  2. 从​工具 工具面板中,导航到​部署 > 部署复制

  3. 在“复制”页中,单击​创作代理

  4. 找到Brand Portal租户的复制代理。

    请确保所有复制代理的​队列都为Idle,则未激活任何发布作业。

删除现有配置

删除现有配置时,必须运行以下检查列表:

  • 删除所有四个复制代理
  • 删除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并删除Brand Portal云服务配置。

  4. 导航到/home/users/mac并删除Brand Portal租户的​MAC用户

现在,您可以通过AEM 6.5创作实例上的Adobe开发人员控制台,创建配置

在此页面上