使用 Brand Portal 配置 AEM Assets configure-integration-65
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租户。
此帮助描述了以下两个用例:
所提供的信息基于这样一种假设,即任何阅读本“帮助”的人员都熟悉以下技术:
-
安装、配置和管理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 aemquickstart
建议使用AEM 6.5来设置AEM创作实例。 如果您没有启动并运行AEM,请从以下位置下载它:
-
如果您是现有AEM客户,请从下载AEM 6.5 Adobe授权网站.
-
如果您是Adobe合作伙伴,请使用 Adobe合作伙伴培训计划 请求AEM 6.5。
下载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中进行配置。
- 在AEM Assets中,创建IMS帐户并生成公共证书(公共密钥)。
- 在Adobe Developer Console中,为您的Brand Portal租户(组织)创建一个项目。
- 在项目下,使用公钥配置API以创建服务帐户(JWT)连接。
- 获取服务帐户凭据和JWT有效负载信息。
- 在AEM Assets中,使用服务帐户凭据和JWT有效负载配置IMS帐户。
- 在AEM Assets中,使用IMS帐户和Brand Portal端点(组织URL)配置Brand Portal云服务。
- 通过将资源从AEM Assets发布到Brand Portal来测试配置。
如果您是首次使用Brand Portal配置AEM Assets,请按照列出的顺序执行以下步骤:
创建 IMS 配置 create-ims-configuration
IMS配置使用AEM Assets租户对您的Brand Portal创作实例进行身份验证。
IMS 配置包括两个步骤:
获取公共证书 public-certificate
公钥(证书)在Adobe Developer控制台上验证您的配置文件。
-
登录到您的AEM Assets创作实例。 默认URL为
http://localhost:4502/aem/start.html
. -
从 工具 面板,导航到 安全性 > Adobe IMS配置.
-
在“Adobe IMS配置”页面中,单击 创建. 它会重定向到 Adobe IMS技术帐户配置 页面。 默认情况下, 证书 选项卡打开。
-
选择 AdobeBrand Portal 在 云解决方案 下拉列表。
-
选择 创建新证书 复选框,并指定 别名 用于公共密钥。 别名将用作公钥的名称。
-
单击 创建证书。然后,单击 确定 以生成公钥。
-
单击 下载公钥 图标并将公钥(.crt)文件保存在计算机上。
公钥稍后用于为Brand Portal租户配置API并在Adobe Developer控制台中生成服务帐户凭据。
-
单击 下一步。
在 帐户 选项卡,将创建一个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有效负载,请执行以下操作:
-
使用IMS组织(Adobe Developer租户)的系统管理员权限登录到Brand Portal控制台。 默认URL为 https://www.adobe.com/go/devs_console_ui.
note note NOTE 确保您从右上角的下拉(组织)列表中选择了正确的IMS组织(Brand Portal租户)。 -
单击 创建新项目. 系统会为您的组织创建一个名称由系统生成的空白项目。
单击 编辑项目 以便您更新 项目标题 和 描述,然后单击 保存.
-
在 项目概述 选项卡,单击 添加API.
-
在 添加API窗口,选择 AEM Brand Portal 并单击 下一个.
确保您有权访问AEM Brand Portal服务。
-
在 配置API 窗口,单击 上传公钥. 然后,单击 选择文件 并上传您在中下载的公共密钥(.crt文件) 获取公共证书 部分。
单击 下一步。
-
验证公钥并单击 下一个.
-
选择 Assets Brand Portal 作为默认产品配置文件,然后单击 保存配置的API.
-
配置API后,您将被重定向到API概述页面。 从左侧导航栏中的 凭据,单击 服务帐户(JWT) 选项。
note note NOTE 您可以查看凭据并执行操作,如生成JWT令牌、复制凭据详细信息和检索客户端密码。 -
从 客户端凭据 选项卡,复制 客户端ID.
单击 检索客户端密码 并复制 客户端密码.
-
导航至 生成JWT 制表并复制 JWT有效负荷 信息。
您现在可以将客户端ID(API密钥)、客户端密钥和JWT有效负载用于 配置IMS帐户 在AEM Assets中。
配置IMS帐户 create-ims-account-configuration
确保您已执行以下步骤:
配置IMS帐户:
-
打开IMS配置并导航到 帐户 选项卡。 你保持页面打开 获取公共证书.
-
为 IMS 帐户指定 标题。
在 授权服务器 字段中,指定URL: https://ims-na1.adobelogin.com/.
在中指定客户端ID API密钥 字段, 客户端密码、和 有效负荷 (JWT有效负荷)您已复制的时间 创建服务帐户(JWT)连接.
单击 创建。
已配置IMS帐户。
-
选择IMS帐户配置并单击 检查运行状况.
单击 Check 对话框中。 成功配置时,将显示一条消息: 已成功检索令牌.
配置Brand Portal云服务 configure-the-cloud-service
-
登录到您的AEM Assets创作实例。
-
从 工具 面板,导航到 Cloud Service > AEM Brand Portal.
-
在Brand Portal配置页面中,单击 创建.
-
指定配置的 标题。
选择您已在以下时间创建的IMS配置: 配置IMS帐户.
在 服务URL 字段中,指定您的Brand Portal租户(组织)URL。
-
单击“保存并关闭”。将创建云配置。
您的AEM Assets创作实例现在已配置有Brand Portal租户。
测试和验证配置 test-integration
-
登录到您的AEM Assets云实例。
-
从 工具 面板,导航到 部署 > 复制.
-
在“复制”页中,单击 作者代理.
您可以看到为您的Brand Portal租户创建的四个复制代理。
找到Brand Portal租户的复制代理,然后单击复制代理URL。
note note NOTE 复制代理并行工作,并均匀地共享作业分发,因此它将发布速度提高到原始速度的四倍。 配置云服务后,无需进行其他配置即可启用复制代理,默认情况下会激活这些代理以启用多个资产的并行发布。 -
要验证AEM Assets与Brand Portal之间的连接,请单击 测试连接 图标。
此时将显示一条消息,表明 测试包已成功交付.
-
验证所有四个复制代理的测试结果。
note note NOTE 请避免禁用任何复制代理,因为这可能会导致资产(在队列中运行)复制失败。 请确保所有四个复制代理均已配置为避免出现超时错误。 请参阅 对并行发布到Brand Portal时出现的问题进行故障诊断. 请勿修改任何自动生成的设置。
您现在可以:
请参阅 Brand Portal文档 以了解更多信息。
升级配置 upgrade-integration-65
要将现有配置升级到Adobe Developer Console,请按列出的顺序执行以下步骤:
验证正在运行的作业 verify-jobs
在进行任何编辑之前,请确保您的AEM Assets创作实例上未运行任何发布作业。 为此,您可以验证所有四个复制代理上活动作业的状态,并确保队列处于空闲状态。
-
登录到您的AEM Assets创作实例。
-
从 工具 面板,导航到 部署 > 部署复制.
-
在“复制”页中,单击 作者代理.
-
找到Brand Portal租户的复制代理。
确保 队列空闲 对于所有复制代理,没有活动的发布作业。
删除现有配置 delete-existing-configuration
删除现有配置时运行以下核对清单:
- 删除全部四个复制代理
- 删除Brand Portal云服务
- 删除Mac用户
-
登录到您的AEM Assets创作实例,并以管理员身份打开CRX Lite。 默认URL为
http://localhost:4502/crx/de/index.jsp
. -
导航到
/etc/replications/agents.author
并删除Brand Portal租户的所有四个复制代理。 -
导航到
/etc/cloudservices/mediaportal
并删除Brand Portal云服务配置。 -
导航到
/home/users/mac
并删除 Mac用户 您的Brand Portal租户的。
您现在可以 创建配置 通过AEM 6.5创作实例上的Adobe Developer控制台。