使用 Brand Portal 配置 AEM Assets configure-integration-65

版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

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

AEM Assets是通过Brand Portal控制台使用Adobe Developer配置的,该控制台可获取Adobe的Identity Management服务(IMS)帐户令牌以授权Brand Portal租户。

NOTE
AEM 6.5.4.0及更高版本支持通过Brand Portal控制台使用Adobe Developer配置AEM Assets。
之前,Brand Portal通过旧版OAuth网关进行配置,该网关使用JSON Web令牌(JWT)交换获取IMS访问令牌进行授权。
从2020年4月6日起,不再支持通过旧版OAuth网关进行配置,并且已将配置更改为Adobe Developer控制台。
TIP
仅针对现有客户
Adobe建议您继续使用现有的旧版OAuth网关配置。 如果您遇到旧版OAuth网关配置问题,请删除现有配置,并通过Adobe Developer控制台创建配置。

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

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

所提供的信息基于这样一种假设,即任何阅读本“帮助”的人员都熟悉以下技术:

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

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

前提条件 prerequisites

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

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

下载并安装AEM 6.5

下载并安装最新的AEM Service Pack

下载并安装AEM 6.5 aemquickstart

建议使用AEM 6.5来设置AEM创作实例。 如果您没有启动并运行AEM,请从以下位置下载它:

下载AEM后,有关设置AEM创作实例的说明,请参阅 部署和维护.

下载并安装AEM最新服务包 servicepack

有关详细说明,请参阅当前的 AEM 6.5 Service Pack发行说明.

联系Adobe客户支持 如果您找不到最新的AEM包或Service Pack。

创建配置 configure-new-integration-65

使用Brand Portal配置AEM Assets需要在AEM Assets创作实例和Adobe Developer Console中进行配置。

  1. 在AEM Assets中,创建IMS帐户并生成公共证书(公共密钥)。
  2. 在Adobe Developer Console中,为您的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来测试配置。
NOTE
AEM Assets创作实例只能配置一个Brand Portal租户。

如果您是首次使用Brand Portal配置AEM Assets,请按照列出的顺序执行以下步骤:

创建 IMS 配置 create-ims-configuration

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

IMS 配置包括两个步骤:

获取公共证书 public-certificate

公钥(证书)在Adobe Developer控制台上验证您的配置文件。

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

  2. 工具 工具 面板,导航到 安全性 > Adobe IMS配置.

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

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

  5. 选择 创建新证书 复选框,并指定 别名 用于公共密钥。 别名将用作公钥的名称。

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

    创建证书

  7. 单击 下载公钥 图标并将公钥(.crt)文件保存在计算机上。

    公钥稍后用于为Brand Portal租户配置API并在Adobe Developer控制台中生成服务帐户凭据。

    下载证书

  8. 单击​ 下一步

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

    打开新选项卡并 在Adobe Developer控制台中创建服务帐户(JWT)连接 因此,您可以获取用于配置IMS帐户的凭据和JWT有效负荷。

创建服务帐户(JWT)连接 createnewintegration

在Adobe Developer控制台中,项目和API在Brand Portal租户(组织)级别配置。 配置API将创建服务帐户(JWT)连接。 可通过两种方法来配置API:生成密钥对(私钥和公钥)或上传公钥。 要使用Brand Portal配置AEM Assets,您必须在AEM Assets中生成公钥(证书),并通过上传公钥在Adobe Developer Console中创建凭据。 在AEM Assets中配置IMS帐户需要这些凭据。 配置IMS帐户后,您可以在AEM Assets中配置Brand Portal云服务。

要创建服务帐户凭据和JWT有效负载,请执行以下操作:

  1. 使用IMS组织(Adobe Developer租户)的系统管理员权限登录到Brand Portal控制台。 默认URL为 https://www.adobe.com/go/devs_console_ui.

    note note
    NOTE
    确保您从右上角的下拉(组织)列表中选择了正确的IMS组织(Brand Portal租户)。
  2. 单击 创建新项目. 系统会为您的组织创建一个名称由系统生成的空白项目。

    单击 编辑项目 以便您更新 项目标题描述,然后单击 保存.

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

  4. 添加API窗口,选择 AEM Brand Portal 并单击 下一个.

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

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

    单击​ 下一步

    上传公钥

  6. 验证公钥并单击 下一个.

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

    选择产品配置文件

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

    note note
    NOTE
    您可以查看凭据并执行操作,如生成JWT令牌、复制凭据详细信息和检索客户端密码。
  9. 客户端凭据 选项卡,复制 客户端ID.

    单击 检索客户端密码 并复制 客户端密码.

    服务帐户凭据

  10. 导航至 生成JWT 制表并复制 JWT有效负荷 信息。

您现在可以将客户端ID(API密钥)、客户端密钥和JWT有效负载用于 配置IMS帐户 在AEM Assets中。

配置IMS帐户 create-ims-account-configuration

确保您已执行以下步骤:

配置IMS帐户:

  1. 打开IMS配置并导航到 帐户 选项卡。 你保持页面打开 获取公共证书.

  2. 为 IMS 帐户指定​ 标题

    授权服务器 字段中,指定URL: https://ims-na1.adobelogin.com/.

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

    单击​ 创建

    已配置IMS帐户。

    IMS 帐户配置

  3. 选择IMS帐户配置并单击 检查运行状况.

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

    配置健康确认对话框

CAUTION
您必须只有一个IMS配置。
确保IMS配置通过运行状况检查。 如果配置未通过运行状况检查,则该配置无效。 删除它并创建另一个有效配置。

配置Brand Portal云服务 configure-the-cloud-service

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

  2. 工具 工具 面板,导航到 Cloud Service > AEM Brand Portal.

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

  4. 指定配置的​ 标题

    选择您已在以下时间创建的IMS配置: 配置IMS帐户.

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

    Brand Portal配置窗口

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

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

测试和验证配置 test-integration

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

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

    “工具”面板

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

    复制页面

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

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

    资产复制配置

    note note
    NOTE
    复制代理并行工作,并均匀地共享作业分发,因此它将发布速度提高到原始速度的四倍。 配置云服务后,无需进行其他配置即可启用复制代理,默认情况下会激活这些代理以启用多个资产的并行发布。
  4. 要验证AEM Assets与Brand Portal之间的连接,请单击 测试连接 图标。

    验证资产复制设置

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

    测试确认输出

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

    note note
    NOTE
    请避免禁用任何复制代理,因为这可能会导致资产(在队列中运行)复制失败。
    请确保所有四个复制代理均已配置为避免出现超时错误。 请参阅 对并行发布到Brand Portal时出现的问题进行故障诊断.
    请勿修改任何自动生成的设置。

您现在可以:

请参阅 Brand Portal文档 以了解更多信息。

升级配置 upgrade-integration-65

要将现有配置升级到Adobe Developer Console,请按列出的顺序执行以下步骤:

验证正在运行的作业 verify-jobs

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

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

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

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

    资产的复制代理

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

    确保 队列空闲 对于所有复制代理,没有活动的发布作业。

    复制队列设置

删除现有配置 delete-existing-configuration

删除现有配置时运行以下核对清单:

  • 删除全部四个复制代理
  • 删除Brand Portal云服务
  • 删除Mac用户
  1. 登录到您的AEM Assets创作实例,并以管理员身份打开CRX Lite。 默认URL为 http://localhost:4502/crx/de/index.jsp.

  2. 导航到 /etc/replications/agents.author 并删除Brand Portal租户的所有四个复制代理。

    CRXDE中的复制代理

  3. 导航到 /etc/cloudservices/mediaportal 并删除Brand Portal云服务配置。

    CRXDE中复制代理的详细信息

  4. 导航到 /home/users/mac 并删除 Mac用户 您的Brand Portal租户的。

    CRXDE中复制代理的更多详细信息

您现在可以 创建配置 通过AEM 6.5创作实例上的Adobe Developer控制台。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2