为 Adobe Asset Link 配置 Adobe Experience Manager 6.x Assets

了解如何配置 Adobe Experience Manage (AEM) Assets,以便与适用于 Creative Cloud 应用程序的 Adobe Asset Link (AAL) 扩展一起使用。

Adobe Asset Link 简化了内容创建过程中创意人员和营销人员之间的协作。它将 Adobe Experience Manager Assets 与 Creative Cloud 桌面应用程序 Adobe InDesign、Adobe Photoshop 和 Adobe Illustrator 相关联。通过 Adobe Asset Link 面板,创意人员可直接访问和修改存储在 AEM Assets 中的内容,且无需关闭他们最熟悉的创意应用程序。

注意:

如果您使用此服务,请参照说明,配置 Adobe Experience Manager Assets 即云服务

要将 Experience Manager Assets 配置为可与 Asset Link 一起使用,请执行以下任务。使用 Experience Manager 管理员帐户进行配置。

  1. 根据需要安装程序包。详细信息请参阅先决条件

  2. 手动配置 Experience Manager,也可以使用程序包进行配置。

  3. 管理用户访问控制,将 Creative Cloud 许可用户与 Experience Manager 用户一一对应。

各种功能的先决条件和支持

确保根据需要安装适当的 Service Pack 和程序包。请参阅以下针对每个 AEM 版本和特定 AEM 功能的相关要求。

Assets 功能

AEM 版本和支持要求

Asset Link 默认可以使用

  • AEM 6.5 和 AEM 6.5.2 或更高版本。
  • AEM 6.4.4 和 AEM 6.4.6 或更高版本。

Adobe 建议安装最新版本的 AEM Service Pack (SP),然后再使用 AAL。

Asset Link 在安装程序包后可以使用

对于 AEM 6.4.0-6.4.3,请安装 adobe-asset-link-support 程序包。

Adobe Stock 集成

AEM 6.4.2 或更高版本

视觉或相似性搜索

AEM 6.5.0 或更高版本

使用配置程序包配置 Experience Manager

Adobe 建议您安装 adobe-asset-link-config 配置程序包以自动完成大部分配置任务,然后手动完成少量任务。或者,您可以进行手动配置

注意:

如果您的 AEM 实例已配置为支持用户使用 Adobe IMS 帐户登录,请勿使用配置程序包。而应手动配置 AEM

  1. 要打开 Package Manager,请在 AEM Web 界面中访问“工具”>“部署”>“Package Share”。安装 adobe-asset-link-config 程序包。

  2. 访问“工具”>“操作”>“Web 控制台”。找到 Adobe Granite OAuth IMS Provider 配置。单击 以进行编辑。设置以下属性,然后保存更改。

    属性名称

    组映射

    保留空白,除非需要设置。有关详细信息,请参阅组映射

    组织

    输入您在 Adobe Admin Console 中使用的组织 ID。有关组织 ID 的更多信息,请参阅创建用户组

  3. 找到 Adobe Granite Bearer Authentication Handler 配置,并单击  进行编辑。

    InDesignAem2 客户端 ID 添加到允许的 OAuth 客户端 ID 配置属性。

手动配置 AEM

如果您选择不使用配置程序包,或者如果您的 AEM 部署已经配置为支持用户使用 Adobe IMS 帐户登录,请手动配置 AEM。请按照以下步骤进行手动配置。

  1. 要访问配置管理器,请访问“工具”>“操作”>“Web 控制台”。从顶部的菜单中选择“OSGi”>“配置”

  2. 找到 Adobe Granite OAuth IMS Provider 配置并单击  以进行编辑。设置以下配置,然后单击“保存”

    属性名称

    授权端点

    令牌端点

    配置文件端点

    验证 URL

    组织

    设置为 Adobe Admin Console 中的组织 ID。

    组映射

    除非您有特殊情况,否则请留空。有关详细信息,请参阅组映射

  3. 找到 Adobe Granite Bearer Authentication Handler 配置,并单击  进行编辑。

    将以下客户端 ID 添加到允许的 OAuth 客户端 ID 配置属性:InDesignAem2cc-europa-desktop_0_1cc-europa-desktop_1_0cc-europa-desktop_2_0cc-europa-desktop_3_0cc-europa-desktop_4_0cc-europa-desktop_5_0cc-europa-desktop_6_0cc-europa-desktop_7_0cc-europa-desktop_8_0cc-europa-desktop_9_0cc-europa-desktop_10_0

    要添加每个客户端 ID,请单击“+”。添加所有 ID 后,单击“保存”

  4. Adobe Granite OAuth Application and Provider 配置中,检查现有 Adobe Granite OAuth Authentication Handler 实例。如果您找到配置 ID 值具有 ims 的实例,请将其用于此过程中的说明。如果未找到,请单击“+”来创建配置实例。设置以下属性值,然后单击“保存”

    属性名称

    客户端 ID

    请勿更改

    客户端密钥

    请勿更改

    配置 ID

    ims

    范围

    AdobeID、OpenID、read_organizations(其他值也可能在配置中)

    提供程序 ID

    ims

    创建用户

    选中(true)

    用户 ID 属性

    通过电子邮件发送新创建的配置。否则,请勿更改。

  5. 找到同步处理函数名称ims 的 Apache Jackrabbit Oak Default Sync Handler 配置,然后单击  进行编辑。

    设置以下配置属性,然后单击“保存”

    属性名称

    用户到期时间和用户成员资格到期

    时间以分钟为单位,后跟“m”且无空格。例如,15m 代表 15 分钟。有关详细信息,请参阅组映射

    用户自动具有成员资格

    请勿更改

    用户动态成员资格

    取消选中 (false)

  6. 找到 Adobe Granite OAuth Authentication Handler 配置,然后单击  进行编辑。不进行任何更改并单击“保存”

  7. 要调整 Bearer 身份验证处理函数的相对优先级,请在 CRXDE 中导航到 /apps/system/config。找到 com.adobe.granite.auth.oauth.impl.BearerAuthenticationHandler.config 并打开其配置。最后,添加 service.ranking=I"-10"。保存更改。

    注意:

    使用 Bearer 令牌进行身份验证的每个请求都会产生三次 Adobe IMS 调用、用户同步以及在 AEM 中创建登录令牌的开销。为避免这种开销,Adobe Asset Link 捕获 AEM 响应中返回的登录令牌,并将其与后续请求一起发送。要使此过程起作用,必须调整 Bearer 身份验证处理函数的相对优先级。

  8. (可选)如果 AEM 用户的电子邮件 ID 中包含大写或大小写混合的域名,请在 AEM Web 控制台的“Adobe Granite ACP 平台配置”中选择“将锁定用户更改为小写”

在 AEM 存储库上管理用户访问控制

本节介绍如何管理用户及其对 AEM 存储库的访问权限。

组映射

组映射确定 AEM 中的组如何对应于 Adobe IMS 中的组。它在 Adobe Asset Link 用户如何被授予 AEM Assets 访问权限方面发挥着重要作用。

与 Adobe Asset Link 一起使用时,AEM 将用户管理功能委派给 Adobe IMS。AEM 自动创建用户和组,与 Adobe IMS 中的用户和组相对应。此外,AEM 还会同步 AEM 中的用户、组和组成员资格,以匹配 Adobe IMS 中的用户、组和组成员资格。

例如,假设 Adobe Asset Link 用户是 Adobe IMS 组 assetlink-users 的成员。这种情况下,当这个 Adobe IMS 组中的某个成员首次连接到 Adobe Asset Link 时,AEM 中会创建一个名为 assetlink-users 的同步组。Adobe IMS 组中的每个新用户在首次通过 Adobe Asset Link 连接到 AEM 时,将添加到 AEM 中对应的组。

与 Adobe IMS 中的组对应并同步的 AEM 中的组,可以直接向其授予访问权限或者使其成为 AEM 中另一个组的成员。以下是如何管理权限的示例。

组示例
AEM 和 Adobe IMS 中的组映射示例

以下规则适用于 AEM 中的组映射:

  • 确保 Adobe Granite OAuth IMS Provider 配置中的“组映射”属性为空白。
  • 在用户进行身份验证时,以及 Apache Jackrabbit Oak Default Sync Handler 配置“用户到期时间”属性中指明的时间段结束后,将评估 Adobe Asset Link 用户组成员资格。目前,可以在 AEM 中向组添加用户和从组中删除用户,从而与 Adobe IMS 中的组同步。
  • 避免组名冲突。确保 Adobe IMS 中创建的组的名称(用于管理用户),与所有 AEM 系统组名称不同。
    例如,确保这些组名称不同于 dam-users 组以及 AEM 管理员创建的组。
    若 Adobe IMS 组的名称与 AEM 系统组或手动创建组的名称冲突,则该组无法用于控制用户权限。
  • 如果某个 Adobe IMS 用户连接到 AEM 实例并且该用户的名称与先前创建的 AEM 用户冲突,则会为该 Adobe IMS 用户赋予另一个名称,同时在该名称中添加一些数字以使其唯一。

设置首次访问控制

通过 Adobe Asset Link 连接的用户,只有在被授予所需权限之后才能查看资源以及与资源交互。以上组映射部分讲述了如何在 AEM 中创建用户组,这些用户组与 Adobe IMS 中组织的用户组相对应并与之同步。建议 AEM 管理员使用这些组来管理 Adobe Asset Link 用户的访问控制。

对于与 Adobe IMS 组(用于管理用户访问控制)同步的每个 AEM 组:

  1. 确保该组具有可用于从 Adobe Asset Link 进行初始连接的成员。

  2. 使用该用户登录 Adobe Asset Link,然后连接到 AEM。此连接预计会失败。

  3. 在 AEM 中,找到与 Adobe IMS 中的组对应的组,并为其授予所需的访问控制。例如,使新组成为 dam-users 组的成员。

  4. 关闭 Adobe Asset Link,然后重新启动 Creative Cloud 应用程序。

  5. 如需验证用户是否已具有预期的访问权限,请重新打开 Adobe Asset Link。

执行这些步骤后,同一组中的其他用户在首次尝试时,可使用 Adobe Asset Link 连接到 AEM。他们将自动拥有与组中其他用户相同的权限。

管理 AEM 用户以使用 Adobe Asset Link

Adobe Asset Link 用户在登录其 Creative Cloud 应用程序之后可以与 AEM 连接。此身份验证使用 Adobe IMS 技术并在 AEM 中创建用户信息(如果尚不存在)。AEM 企业客户经常会使用与 AEM 集成的外部身份提供程序来管理其用户。身份提供程序包括 Adobe IMS 以及使用 SAML 和 LDAP 协议的其他产品。或者,可以在 AEM 中本地创建和管理用户。

使用 Adobe Asset Link 连接到 AEM 的用户,与以前直接登录时存储在 AEM 中的现有用户信息不会发生冲突,前提是:

  • 用于直接登录 AEM 的所有用户名与 Adobe IMS 中用于 Creative Cloud 登录的用户名不同。
  • Adobe IMS 用作直接 AEM 登录的身份提供程序。
  • 用户在使用相同帐户直接登录 AEM 之前通过 Adobe Asset Link 连接到 AEM。

另一方面,在以下情景中,必须更新直接 AEM 登录所创建的用户信息,才能使用 Adobe Asset Link:

  • Creative Cloud(使用 Adobe IMS)中的帐户以及 Adobe IMS 之外的外部身份提供程序中的帐户使用了相同的用户名(例如用户的电子邮件地址)。
  • Creative Cloud 中的帐户和本地 AEM 帐户使用了相同的用户名。
  • Adobe IMS 中的 Creative Cloud 帐户是 Federated ID,由与 AEM 集成以直接登录的同一外部身份提供程序提供服务。

通过这些情景创建的 AEM 用户不具备与 Adobe IMS 同步的用户所需的属性。要在 AEM 中更新此类用户以使用 Adobe Asset Link,请执行以下操作:

  1. 在 AEM Web 控制台中,找到 Apache Jackrabbit Oak External PrincipalConfiguration 配置并单击 以编辑它。取消选中“外部身份保护”复选框,然后单击“保存”

  2. 要访问 AEM 的用户管理界面,请导航到“工具”>“安全”>“用户”。选择要更新的用户,然后记下该用户在浏览器 URL 中路径从 /home/users 开始的结尾部分。或者,您可以使用 AEM CRXDE 搜索用户名。用户路径看上去类似于 /home/users/x/xTac082TDh-guJzzG7WM

  3. 使用 AEM CRXDE 导航到用户路径,选择用户节点,然后选择中下部的“属性”选项卡,查看节点的属性。这个节点有一个 jcr:primaryType 属性,值为 rep:User

  4. 在“属性”选项卡区域的底部,输入“Name”值 rep:externalId、“Type”值 String 以及“Value”值 <rep:authorizableId>;ims,其中 <rep:authorizableId> 是节点的 rep:authorizableId 属性的值。(使用不带空格的分号来将 rep:authorizableId 值与 ims 分隔开。)

  5. 单击您的新条目右侧的“添加”按钮,然后单击浏览器窗口左上角的“全部保存”,或者按 Command + S/Ctrl + S。

  6. 对于要升级以使用 Adobe Asset Link 的任何其他用户,请重复步骤 2 到 5。

  7. 使用 AEM Web 控制台,找到“Apache Jackrabbit Oak External PrincipalConfiguration”配置并单击 以编辑。取消选中“外部身份保护”复选框,然后单击“保存”

    注意:

    如果服务未在几分钟内恢复,请重新启动 AEM 以允许成功进行身份验证。

在此更改后,更新的 AEM 用户可使用 Adobe Asset Link 进行连接,并能够继续像更新之前一样直接登录 AEM。成功通过 Adobe IMS 进行身份验证后,AEM 用户配置文件信息将与 Adobe IMS 中的用户配置文件同步。

有一种方法可以执行多个 AEM 用户的批量迁移,以使这些用户能够使用 Adobe Asset Link。有关启用此选项的更多信息和帮助,请与 Adobe Care 联系。

作为这些步骤的替代方案,在某些情况下,可以向 Adobe Asset Link 用户提供 AEM 的快速访问权限。在这些情况下,在连接 Adobe Asset Link 之前,使用 AEM 用户管理或 AEM CRXDE 找到并删除预先存在的用户信息。连接之后在 AEM 中创建新用户信息。只有在您确定没有将重要数据添加作为用户节点的子集时,才能使用此方法。这样的额外数据是用户节点除了 tokenspreferencesprofileprofilesprofiles/publicrep:policy/* 节点之外的任何子节点

自动启动工作流以有条件地处理资源

在 Experience Manager 6.4 和 Experience Manager 6.5 中,管理员可以配置工作流,从而根据预定义的条件自动执行和处理资源。

对于业务线用户和营销人员来说,此配置很有用,例如,可使用它在若干特定文件夹上创建自定义工作流程。例如,可以为机构拍摄的所有资源加上水印,或者可以处理自由职业者上传的所有资源来创建特定的演绎版。

有关 Experience Manager 配置的更多信息,请参阅自动执行资源相关工作流

为 Adobe InDesign 生成仅用于放置的演绎版

将 AEM 中的大型资源放入 Adobe InDesign 文档中时,创意专业人员需在放置资源后等待相当长的时间。与此同时,用户也无法使用 InDesign。这会中断创意流程,并对用户体验产生负面影响。Adobe 允许先在 InDesign 文档中临时放置小型的演绎版。需要最终输出时(例如对于打印和发布工作流程而言),原始的全分辨率资源将在背景中替换临时演绎版。这种在背景中进行的异步更新可加快设计流程以提高工作效率,同时不影响创作过程。

AEM 可提供仅用于放置 (FPO) 的演绎版。这些 FPO 演绎版的文件尺寸较小,但宽高比相同。如果 FPO 演绎版无法用于某个资源,则 Adobe InDesign 将使用原始资源。这种回退机制可确保创意工作流程顺利进行而不会中断。

生成 FPO 呈现形式的方法

AEM 允许使用多种方法来处理可用于生成 FPO 呈现形式的图像。其中最常见的两种方法是使用内置 AEM 工作流程和使用 ImageMagick。使用这两种方法,您可对新上传资源和 AEM 现有资源的呈现形式生成进行配置。

您可使用 ImageMagick 来处理图像,包括生成 FPO 呈现形式。这种呈现形式将采用降采样处理,也就是说,如果原始图像的 PPI 大于 72,呈现形式的像素尺寸将按比例缩减。请参阅安装和配置 ImageMagick 以使用 AEM Assets

 

使用 AEM 的内置工作流程

使用 ImageMagick 工作流程

备注

对于新资源

启用 FPO 呈现形式(帮助

在 AEM 工作流程中添加 ImageMagick 命令行(帮助

AEM 在每次上传时都会执行“DAM 更新资源”工作流程。

现有资源

在新的专用 AEM 工作流程中启用 FPO 呈现形式(帮助

在新的专用 AEM 工作流程中添加 ImageMagick 命令行(帮助

现有资源的 FPO 呈现形式可按需创建或批量创建。

注意:

通过修改默认工作流程的副本来创建工作流程以生成呈现形式。它可以防止在更新 AEM 时覆盖所做的更改,例如,通过安装新的 Service Pack 更新时。

使用 AEM 工作流程生成新资源的呈现形式

要配置“DAM 更新资源”工作流程模型以生成呈现形式,请按照下列步骤操作:

  1. 单击“工具”>“工作流程”>“模型”。选择“DAM 更新资源”模型,然后单击“编辑”

  2. 选择“处理缩略图”步骤,然后单击“配置”

  3. 单击“FPO 呈现形式”选项卡。选择“启用 FPO 呈现形式创建”

    在“处理缩略图”工作流程中启用 FPO 呈现形式创建。
    在“处理缩略图”工作流程中启用 FPO 呈现形式创建

  4. 调整“质量”并根据需要添加或修改“格式列表”值。默认情况下,生成 FPO 呈现形式的 MIME 类型列表为 pjpegjpegjpggifpngx-pngtiff。单击“完成”

    注意:

    JPEG、GIF、PNG、TIFF、PSD 和 BMP 文件类型支持呈现形式生成。

  5. 要激活更改,请单击“同步”

注意:

单侧大于 1280 像素的图像不保留 FPO 呈现形式中的像素尺寸。

使用 ImageMagick 生成新资源的呈现形式

在 AEM 中,“DAM 更新资源”工作流程将在上传新资源时执行。要使用 ImageMagick 处理新上传资源的呈现形式,请向工作流程模型中添加新命令。

  1. 单击“工具”>“工作流程”>“模型”。选择“DAM 更新资源”模型,然后单击“编辑”

  2. 单击左上角的“切换侧面板”。搜索“命令行”步骤。

  3. 拖动“命令行”步骤并将其添加在“处理缩略图”步骤前。

  4. 选择“命令行”步骤,然后单击“配置”

  5. 将所需信息添加为自定义“标题”“说明”。例如,FPO 呈现形式(通过 ImageMagick 生成)。

  6. “参数”选项卡中,添加相关“MIME 类型”以提供该命令适用的文件格式列表。

    设置 ImageMagick 命令适用的 MIME 类型。
    设置 ImageMagick 命令适用的 MIME 类型。

  7. “参数”选项卡中的“命令”部分,添加相关的 ImageMagick 命令以生成 FPO 呈现形式。

    以下是一个命令示例,该命令以 JPEG 格式生成 FPO 呈现形式,以 10%的质量设置将其降采样为 72 PPI,并通过拼合输出来处理多层 Adobe Photoshop 文件:

    convert -quality 10% -units PixelsPerInch ${filename} -resample 72 -flatten cq5dam.fpo.jpeg
  8. 要激活更改,请单击“同步”

有关 ImageMagick 命令行功能的详细信息,请参阅 https://imagemagick.org

使用 AEM 工作流程生成现有资源的呈现形式

要使用 AEM 工作流程生成现有资源的 FPO 呈现形式,请创建一个使用内置 FPO 呈现形式选项的专用工作流程模型。

  1. 在 AEM 中,单击“工具”>“工作流程”>“模型”。要创建模型,请单击“创建”>“创建模型”。添加有意义的“标题”“名称”

  2. 选择模型并单击“编辑”。单击“页面信息”>“打开属性”。选择“瞬态工作流程”。这样可提高可扩展性和性能。单击“保存并关闭”

  3. 单击左上角的“切换侧面板”。搜索“处理缩略图”步骤。拖动“处理缩略图”步骤。

  4. 选择“处理缩略图”,然后单击“配置”。按照配置以使用 AEM 工作流程生成新资源的呈现形式进行操作。要激活更改,请单击“同步”

使用 ImageMagick 生成现有资源的呈现形式

要使用 ImageMagick 处理功能来生成现有资源的 FPO 呈现形式,请创建一个使用 ImageMagick 命令行的专用工作流程模型来执行此操作。

  1. 按照配置以使用 AEM 工作流程生成现有资源的呈现形式部分中的第 1 步到第 3 步进行操作。

  2. 按照配置以使用 ImageMagick 生成新资源的呈现形式部分中的第 4 步到第 8 步进行操作。

查看 FPO 呈现形式

您可在工作流程完成后查看生成的 FPO 演绎版。在 AEM Assets 用户界面中,单击资源以打开大型预览视图。打开左侧边栏并选择“演绎版”。或者,在预览打开时使用键盘快捷键 Alt + 3

单击 FPO 演绎版以加载其预览。(可选)您可以右键单击演绎版并将其保存到您的文件系统。

检查左侧边栏中的可用演绎版。
检查左侧边栏中的可用演绎版。

提示和限制

  • 要使用基于 ImageMagick 的配置,请将 ImageMagick 与 AEM 安装在同一台计算机上。
  • 要生成多个资源或整个存储库的 FPO 呈现形式,请做好计划并在流量少的时间段内执行工作流程。为大量资源生成 FPO 呈现形式是一项资源密集型活动,并且 AEM 服务器必须具有足够的处理能力和可用内存。
  • 有关性能和可扩展性,请参阅微调 ImageMagick
  • 有关资源的常规命令行处理,请参阅用于处理资源的命令行处理函数

在 AEM 6.4.x 版本中创建自定义索引

AEM 包含用于查询的索引。为指定版本创建以下自定义索引。默认情况下,AEM 6.5.0 包含此索引。Adobe Asset Link 需要这个来确定用户已经签出的资源。

  1. 在 CRXDE 中,找到 /oak:index 节点。创建一个名为 cqDrivelock 的新节点将其“类型”设置为 oak:QueryIndexDefinition

  2. 将以下属性添加到新节点并保存更改:

    • 名称:type;类型:string;值:property
    • 名称:propertyNames;类型:Name[](单击“多个”按钮);值:cq:drivelock

与 Adobe Stock 的集成

组织将其 Adobe Stock 帐户与 AEM Assets 进行集成。它可以帮助营销人员为他们的创意和营销项目提供获得许可且高质量、免版税的照片、矢量、插图、视频、模板和 3D 资源。创意专业人士可以通过 Asset Link 面板来使用这些资源。

要与 Adobe Stock 集成,请参阅 AEM Assets 中的 Adobe Stock 资源。与 Adobe Stock 集成需要 AEM 6.4.2 或更高版本。

配置视觉或相似性搜索

借助视觉搜索功能,您可以使用 Adobe Asset Link 面板在 AEM Assets 存储库中搜索视觉上相似的资源。该功能在 6.5.0 或更高版本中提供,且仅可搜索编制了索引的资源。有关更多信息,请参阅如何配置视觉搜索

解决与 AEM 相关的问题

如果您在配置或使用 Asset Link 时遇到问题,请尝试以下操作:

  • 确保您的部署符合先决条件。具体来说,请确保已安装正确的 Feature Pack 或程序包。
  • 联系您组织的合作伙伴或系统集成商。
  • 如果您的 Creative Cloud 用户无法签入已签出的资源,请检查此问题是否由电子邮件 ID 中域名的大小写所导致。要修复问题,请参阅 AEM 手动配置
  • 有关更多信息,请参阅解决 Asset Link 问题
Adobe 徽标

登录到您的帐户