使用AEM Assets将Brand Portal配置为Cloud Service

通过配置Adobe Experience Manager Assets Brand Portal，您可以将已批准的品牌资产作为Cloud Service实例从Adobe Experience Manager Assets发布到Brand Portal，并分发给Brand Portal用户。

使用Cloud Manager激活Brand Portal

Cloud Manager用户将AEM Assets的Brand Portal激活为Cloud Service实例。 激活工作流会在后端创建所需的配置(授权令牌、IMS配置和Brand Portal云服务)，并反映Cloud Manager中Brand Portal租户的状态。 激活Brand Portal后，AEM Assets用户可以将资产发布到Brand Portal，并将其分发给Brand Portal用户。

前提条件

您需要以下条件才能将AEM Assets上的Brand Portal作为Cloud Service实例激活：

  • 作为Cloud Service实例已启动且正在运行的AEM Assets。
  • 有权访问Cloud Manager的用户，已分配给Cloud Manager产品的配置文件。 有关更多信息，请参阅访问Cloud Manager。
注意

作为Cloud Service实例的AEM Assets只能与一个Brand Portal租户连接。 您可以将AEM Assets作为Cloud Service实例具有多个环境（开发、生产和暂存），其中Brand Portal在一个环境中激活。

激活Brand Portal的步骤

您可以在为AEM Assets创建Cloud Service实例环境时激活Brand Portal，也可以单独激活。 假设环境已创建，此时您需要激活Brand Portal。

  1. 登录到AdobeCloud Manager，然后导航到​Environments。

    Environments​页面显示所有现有环境的列表。

  2. 从列表中选择环境（逐个）以查看环境详细信息。

    Brand Portal有权访问其中一个可用的环境，并反映在​环境信息​下。

    找到与Brand Portal关联的环境后，单击​激活Brand Portal​按钮以开始激活工作流。

    激活Brand Portal

  3. 激活Brand Portal租户需要几分钟时间，因为激活工作流会在后端创建所需的配置。 激活Brand Portal租户后，状态将变为“已激活”。

    查看状态

注意

必须在与Cloud Service实例相同的AEM Assets IMS组织上激活Brand Portal。

如果您为IMS组织(org1-existing)现有Brand Portal云配置(使用Adobe开发人员控制台手动配置)，并且为其他IMS组织(org2-new)配置了AEM Assets作为Cloud Service实例，则从Cloud Manager激活Brand Portal会将Brand Portal IMS组织重置为org2-new。 尽管在org1-existing上手动配置的云配置将在AEM Assets创作实例中可见，但在从Cloud Manager激活Brand Portal后将不再使用。

如果现有的Brand Portal云配置和作为Cloud Service实例的AEM Assets使用的是相同的IMS组织(org1)，则您只需从Cloud Manager中激活Brand Portal。

请勿修改任何自动生成的设置。

另请参阅:

登录到您的Brand Portal租户:

在Cloud Manager中激活您的Brand Portal租户后，您可以从Admin Console或直接使用租户URL登录到Brand Portal。

您的Brand Portal租户的默认URL是：https://<tenant-id>.brand-portal.adobe.com/。

其中，租户ID为IMS组织。

如果您不确定Brand Portal URL，请执行以下步骤：

  1. 登录到Admin Console，然后导航到​产品。

  2. 从左边栏中，选择​Adobe Experience Manager Brand Portal - Brand Portal。

  3. 单击​转到Brand Portal，以在浏览器中直接打开Brand Portal。

    或者，从​转到Brand Portal​链接中复制Brand Portal租户URL，并将其粘贴到浏览器中以打开Brand Portal界面。

    访问Brand Portal

测试连接

执行以下步骤以验证Cloud Service实例的AEM Assets与Brand Portal租户之间的连接：

  1. 登录 AEM Assets。

  2. 从​工具​面板中，导航到​部署 > 分发。

    在​发布到Brand Portal​下创建Brand Portal分发代理(bpdistributionagent0)。

  3. 单击​发布到Brand Portal​以打开分发代理。

    您可以在​Status​选项卡下看到分发队列。

    分发代理包含两个队列：

    • processing-queue:分配给Brand Portal。

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

    注意

    建议定期查看故障并清除​error-queue。

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

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

    注意

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

要验证Cloud Service实例的AEM Assets与Brand Portal租户之间的连接，请将资产从AEM Assets发布到Brand Portal。 如果连接成功，则发布的资产会显示在Brand Portal界面中。

您现在可以：

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

分发日志

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

现在，让我们将资产从AEM Assets发布到Brand Portal并查看日志。

  1. 按照​测试连接​部分中所示的步骤（从1到4）操作，然后导航到分发代理页面。

  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中已修改，则会生成其他请求。

除了在AEM Assets上以Cloud Service形式激活Brand Portal的自动化工作流之外，还有一种方法可使用Adobe开发人员控制台将AEM Assets手动配置为Cloud Service和Brand Portal，这已不再推荐使用此方法。

注意

如果您在激活Brand Portal租户时遇到任何问题，请联系客户支持。

使用Adobe开发人员控制台进行手动配置

以下部分介绍如何使用“Adobe开发人员控制台”，使用Brand Portal手动将AEM Assets配置为Cloud Service。

以前，使用Brand Portal通过Adobe开发人员控制台手动配置了AEM Assets as a Cloud Service，该控制台可获取AdobeIdentity Management服务(IMS)帐户令牌以授权Brand Portal租户。 它需要在AEM Assets和Adobe开发人员控制台中进行配置。

  1. 在AEM Assets中，创建IMS帐户并生成公钥（证书）。
  2. 在Adobe开发人员控制台中，为Brand Portal租户（组织）创建一个项目。
  3. 在项目下，使用公钥配置API以创建服务帐户连接。
  4. 获取服务帐户凭据和JSON Web令牌(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：

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

创建配置

按照指定的顺序执行以下步骤，以使用Brand Portal配置AEM Assets。

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

创建 IMS 配置

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

IMS 配置包括两个步骤：

获取公共证书

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

  1. 登录 AEM Assets。

  2. 从​工具​面板中，导航到​安全 > Adobe IMS配置。

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

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

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

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

    创建证书

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

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

    下载证书

  8. 单击​下一步。

    在​帐户​选项卡中，将创建Adobe IMS帐户，该帐户需要在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. 从​工具​面板中，导航到​Cloud Services > AEM Brand Portal。

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

  4. 指定配置的​标题。

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

    在​服务URL​字段中，指定您的Brand Portal租户（组织）URL。

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

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

您现在可以通过检查分发代理并将资产发布到Brand Portal来测试配置。

在此页面上