将AEM Assets配置为Cloud Service（带有Brand Portal）

通过配置Adobe Experience Manager Assets Brand Portal，您可以将Adobe Experience Manager Assets中已批准的品牌资产作为Cloud Service实例发布到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。

登录到Adobe Cloud Manager，然后导航到环境。

环境页显示所有现有环境的列表。
从列表中选择环境（逐个）以视图环境详细信息。

Brand Portal有权访问某个可用环境，并反映在环境信息下。

找到与Brand Portal关联的环境后，单击激活Brand Portal按钮，开始激活工作流。
激活工作流在后端创建所需的配置时，激活Brand Portal租户需要几分钟。激活Brand Portal租户后，状态将更改为“已激活”。

注意

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

如果您为IMS组织(org1-existing)现有Brand Portal云配置(使用Adobe Developer Console手动配置)，且您的AEM Assets为另一个IMS组织(org2-new)配置了Cloud Service实例，则从云管理器激活Brand Portal会将Brand Portal IMS组织重置为org2-new. 尽管在org1-existing上手动配置的云配置在AEM Assets作者实例中可见，但在从云管理器激活Brand Portal后，将不再使用。

如果现有Brand Portal云配置和作为Cloud Service实例的AEM Assets使用相同的IMS组织(org1)，您只需从云管理器激活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，请执行以下步骤：

登录Admin Console并导航到产品。
在左边栏中，选择Adobe Experience Manager Brand Portal - Brand Portal。
单击转至Brand Portal以在浏览器中直接打开Brand Portal。

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

测试连接

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

登录 AEM Assets。
从工具面板，导航到部署 > 分发。

在发布到Brand Portal下创建Brand Portal分发代理(bpdistributionagent0)。
单击发布到Brand Portal以打开分发代理。

您可以在状态选项卡下看到分布队列。

分发代理包含两个队列：
- processing-queue:用于将资产分发到Brand Portal。
- error-queue:对于分发失败的资产。
注意

建议定期查看故障并清除error-queue。
要验证作为Cloud Service的AEM Assets与Brand Portal之间的连接，请单击测试连接图标。

将显示一条消息，提示已成功传送测试包。

注意

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

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

您现在可以：

有关详细信息，请参阅Brand Portal文档。

分发日志

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

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

按照测试连接部分中显示的步骤（从1到4）操作，并导航到分发代理页。
单击日志以视图处理日志和错误日志。

分发代理已生成以下日志：

信息：它是系统生成的日志，在成功配置分发代理时触发。
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上的Brand Portal激活为Cloud Service的自动化工作流程外，还有一种方法可使用Adobe开发人员控制台将AEM Assets手动配置为Cloud Service并将Brand Portal，这已不再建议使用。

注意

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

使用Adobe Developer Console进行手动配置

下节介绍如何使用Adobe Developer Console将AEM Assets手动配置为Cloud Service和Brand Portal。

以前，AEM Assets作为Cloud Service是通过Adobe Developer Console手动配置Brand Portal的，后者为Brand Portal租户购买Adobe Identity Management Services(IMS)帐户令牌以授权。它要求在AEM Assets和Adobe开发人员控制台中进行配置。

在AEM Assets中，创建IMS帐户并生成公钥（证书）。
在Adobe开发人员控制台中，为您的Brand Portal租户（组织）创建一个项目。
在项目下，使用公钥配置API以创建服务帐户连接。
获取服务帐户凭据和JSON Web Token(JWT)有效负荷信息。
在AEM Assets中，使用服务帐户凭据和JWT负载配置IMS帐户。
在AEM Assets中，使用IMS帐户和Brand Portal端点（组织URL）配置Brand Portal云服务。
通过将资产从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。

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

创建 IMS 配置

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

IMS 配置包括两个步骤：

获取公共证书
配置IMS帐户

获取公共证书

公钥（证书）可在Adobe Developer控制台上验证您的用户档案。

登录 AEM Assets。
从工具面板，导航到安全 > AdobeIMS配置。
在Adobe IMS配置页中，单击创建。它将重定向到AdobeIMS技术帐户配置页。默认情况下，将打开证书选项卡。
在云解决方案下拉列表中选择Adobe品牌门户。
选中创建新证书复选框，并为公钥指定别名。别名用作公钥的名称。
单击创建证书。然后，单击确定以生成公钥。
单击下载公钥图标，并将公钥(CRT)文件保存到计算机上。

公钥稍后将用于为您的Brand Portal租户配置API，并在Adobe Developer Console中生成服务帐户凭据。
单击下一步。

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

在Adobe Developer Console](#createnewintegration)中打开新选项卡并创建服务帐户(JWT)连接，以获取用于配置IMS帐户的凭据和JWT负载。[

创建服务帐户(JWT)连接

在Adobe开发人员控制台中，项目和API在Brand Portal租户（组织）级别进行配置。配置API可创建服务帐户(JWT)连接。可通过生成密钥对（私钥和公钥）或上传公钥来配置API有两种方法。要通过Brand Portal配置AEM Assets，您必须在AEM Assets中生成公钥（证书），并通过上传公钥在Adobe Developer Console中创建凭据。在AEM Assets中配置IMS帐户时需要这些凭据。配置IMS帐户后，即可在AEM Assets中配置Brand Portal云服务。

执行以下步骤以生成服务帐户凭据和JWT负载：

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

注意

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

单击编辑项目以更新项目标题和说明，然后单击保存。
在项目概述选项卡中，单击添加API。
在添加API窗口中，选择AEM Brand Portal并单击下一步。

确保您有权访问AEM Brand Portal服务。
在配置API窗口中，单击上传公钥。然后，单击选择文件并上传您在获取公共证书部分下载的公钥（.crt文件）。

单击下一步。
验证公钥，然后单击下一步。
选择资产品牌门户作为默认产品用户档案，然后单击保存配置的API。
配置API后，您将被重定向到API概述页。在左侧导航下的凭据中，单击服务帐户(JWT)选项。

注意

您可以视图凭据并执行诸如生成JWT令牌、复制凭据详细信息、检索客户端机密等操作。
从客户端凭据选项卡中，复制客户端ID。

单击检索客户端机密并复制客户端机密。
导航到生成JWT选项卡并复制JWT负载信息。

您现在可以使用客户端ID（API密钥）、客户端机密和JWT负载在AEM Assets中配置IMS帐户。

配置IMS帐户

确保您已执行以下步骤：

获取公共证书
创建服务帐户(JWT)连接

请执行以下步骤来配置IMS帐户。

打开IMS配置并导航到帐户选项卡。在获取公共证书时，您保持页面打开。
为 IMS 帐户指定标题。

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

在创建服务帐户(JWT)连接时，在API密钥字段、客户端密钥和负载（JWT负载）中指定您复制的客户端ID。

单击创建。

已配置IMS帐户。
选择IMS帐户配置，然后单击检查运行状况。

单击对话框中的选中。成功配置时，将显示一条消息，提示已成功检索令牌。