Show Menu
主题×

安装和配置文档服务

AEM Forms提供一组OSGi服务以完成不同的文档级别操作,例如创建、汇编、分发和存档PDF文档的服务,添加数字签名以限制对文档的访问,以及对条形码表单进行解码。 这些服务包含在AEM Forms附加包中。 这些服务统称为文档服务。 现有文档服务的列表及其主要功能如下:
  • 汇编程序服务: 使您能够合并、重新排列和增强PDF和XDP文档,并获取有关PDF文档的信息。 它还帮助将PDF文档转换并验证为PDF/A标准,将PDF forms、XML表单和PDF forms转换为PDF/A-1b、PDF/A-2b和PDFA/A-3b。 有关详细信息,请参 阅Assembler Service
  • ConvertPDF服务: 使您能将PDF文档转换为PostScript或图像文件(JPEG、JPEG 2000、PNG和TIFF)。 有关详细信息,请参 阅ConvertPDF服务
  • Barcoded Forms服务: 使您能够从条形码的电子图像中提取数据。 该服务接受包含一个或多个条码的TIFF和PDF文件作为输入并提取条形码数据。 有关详细信息,请参 阅Barcoded Forms Service
  • 文档保障服务: 使您能够加密和解密文档,使用其他使用权限扩展Adobe Reader的功能,并向文档添加数字签名。 文档保障服务包含三项服务: 签名、加密和读者扩展。 有关详细信息,请参 阅DocAssurance Service
  • 加密服务: 使您能够加密和解密文档。 文档加密后,其内容将变得不可读。 授权用户可以解密文档以获得对其内容的访问。 有关详细信息,请参 阅加密服务
  • 表单服务: 允许您创建交互式数据捕获客户端应用程序,这些应用程序验证、处理、转换和传送通常在表单设计器中创建的表单。 表单服务可呈现您开发为PDF文档的任何表单设计。 有关详细信息,请参 阅表单服务
  • 输出服务: 使您能创建不同格式的文档,包括PDF、激光打印机格式和标签打印机格式。 激光打印机格式为PostScript和打印机控制语言(PCL)。 有关详细信息,请参 阅输出服务
  • PDF Generator服务: PDF Generator服务提供API,可将本机文件格式转换为PDF。 它还将PDF转换为其他文件格式并优化PDF文档的大小。 有关详细信息,请参 阅PDF Generator服务
  • Reader扩展服务: 通过扩展Adobe Reader的功能并授予其他使用权限,使您的组织能够轻松共享交互式PDF文档。 该服务激活在使用Adobe Reader打开PDF文档时不可用的功能,如向文档添加注释、填写表单和保存文档。 有关详细信息,请 参阅Reader Extension Service
  • 签名服务: 允许您在AEM服务器上处理数字签名和文档。 例如,签名服务通常用于以下情况:
    • AEM服务器会在使用Acrobat或Adobe Reader将表单发送给用户以打开前对其进行认证。
    • AEM服务器使用Acrobat或Adobe Reader验证已添加到表单的签名。
    • AEM服务器代表公证人签署表单。
    签名服务访问存储在信任存储中的证书和凭据。 有关详细信息,请参阅 签名服务
AEM Forms是一个功能强大的企业级平台,文档服务只是AEM Forms的能力之一。 有关功能的完整列表,请参 阅AEM Forms简介

部署拓扑

AEM Forms加载项包是部署到AEM上的应用程序。 通常,您只需一个AEM实例(作者或发布)即可运行AEM Forms文档服务。 建议使用以下拓扑来运行AEM Forms文档服务。 有关拓扑的详细信息,请参 阅AEM Forms的架构和部署拓扑
尽管AEM Forms允许您从单台服务器设置和运行所有功能,但您应该执行容量规划、负载平衡,并为生产环境中的特定功能设置专用服务器。 例如,对于使用PDF Generator服务每天转换数千页和多个自适应表单以捕获数据的环境,请为PDF Generator服务和自适应表单功能设置单独的AEM Forms服务器。 它有助于提供最佳性能并独立扩展服务器。

系统要求

开始安装和配置AEM Forms文档服务之前,请确保:
  • 硬件和软件基础架构已到位。 有关受支持硬件和软件的详细列表,请参 阅技术要求
  • AEM实例的安装路径不包含空格。
  • AEM实例已启动并正在运行。 在AEM术语中,“实例”是在创作或发布模式下在服务器上运行的AEM的副本。 通常,您只需一个AEM实例(作者或发布)即可运行AEM Forms文档服务:
    • 作者 : 用于创建、上传和编辑内容以及管理网站的AEM实例。 内容准备就绪后,即会复制到发布实例。
    • 发布 : 通过Internet或内部网络向公众提供已发布内容的AEM实例。
  • 满足内存要求。 AEM Forms加载项包需要:
    • 15 GB临时空间,用于基于Microsoft Windows的安装。
    • 6 GB临时空间用于基于UNIX的安装。
  • 安装了PDF生成器在Microsoft Windows和Linux上执行转换所需的客户端软件:
  • 在Microsoft Windows上,PDF Generator支持WebKit、Acrobat WebCapture和PhantomJS转换路由,以将HTML文件转换为PDF文档。
  • 在基于UNIX的操作系统上,PDF Generator支持WebKit和PhantomJS转换路由,以将HTML文件转换为PDF文档。

对基于UNIX的操作系统的额外要求

如果您使用基于UNIX的操作系统,请从相应操作系统的安装介质安装以下软件包:
  • expat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama
  • (仅限PDF Generator )安装libcurl、libcrypto和libssl库的32位版本并创建以下符号链接。 符号链接指向各个库的最新版本:
    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so
  • (仅限PDF Generator) PDF Generator服务支持WebKit和PhantomJS路由,以将HTML文件转换为PDF文档。 要启用PhantomJS路由的转换,请安装下面列出的64位库。 通常,已安装这些库。 如果缺少任何库,请手动安装它:
    • linux-gate.so.1
    • libz.so.1
    • libfontconfig.so.1
    • libfreetype.so.6
    • libdl.so.2
    • librt.so.1
    • libpthread.so.0
    • libstdc++.so.6
    • libm.so.6
    • libgcc_s.so.1
    • libc.so.6
    • ld-linux.so.2
    • libexpat.so.1

安装前配置

安装前配置部分中列出的配置仅适用于PDF Generator服务。 如果您未配置PDF Generator服务,可跳过安装前配置部分。

安装Adobe Acrobat和第三方应用程序

如果要使用PDF Generator服务将Microsoft Word、Microsoft Excel、Microsoft PowerPoint、OpenOffice、WordPerfect X7和Adobe Acrobat等本机文件格式转换为PDF文档,请确保这些应用程序安装在AEM Forms服务器上。
  • Adobe Acrobat、Microsoft Word、Excel和Powerpoint仅可用于Microsoft Windows。 如果您使用基于UNIX的操作系统,请安装OpenOffice以将富文本文件和支持的Microsoft Office文件转换为PDF文档。
  • 为所有配置为使用PDF Generator服务的用户关闭安装Adobe Acrobat和第三方软件后显示的所有对话框。
  • 开始所有已安装的软件,至少一次。 关闭所有配置为使用PDF Generator服务的用户的所有对话框。
安装Acrobat后,打开Microsoft Word。 在Acrobat ​项卡上,单击​ “创建PDF” ,并将计算机上可用的。doc或。docx文件转换为PDF文档。 如果转换成功,AEM Forms可以将Acrobat与PDF Generator服务结合使用。

设置环境变量

为32位和64位Java开发套件、第三方应用程序和Adobe Acrobat设置环境变量。 环境变量应包含用于开始相应应用程序的可执行文件的绝对路径,例如,下表中的列表环境变量适用于几个应用程序:
应用程序
环境变量
示例
JDK(64位)
JAVA_HOME
C:\Program Files\Java\jdk1.8.0_74
JDK(32位)
JAVA_HOME_32
C:\Program Files (x86)\Java\jdk1.8.0_74
Adobe Acrobat
Acrobat_PATH
C:\Program Files (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe
记事本
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program Files (x86)\OpenOffice.org4
  • 所有环境变量和各个路径均区分大小写。
  • JAVA_HOME、JAVA_HOME_32和Acrobat_PATH(仅限Windows)是必需的环境变量。
  • 环境变量OpenOffice_PATH设置为安装文件夹,而不是可执行文件的路径。
  • 请勿为Microsoft Office应用程序(如Word、PowerPoint、Excel和Project)或AutoCAD设置环境变量。 如果这些应用程序安装在服务器上,“生成PDF”服务会自动开始这些应用程序。
  • 在基于UNIX的平台上,将OpenOffice安装为/root。 如果OpenOffice未作为根安装,则PDF Generator服务将无法将OpenOffice文档转换为PDF文档。 如果需要以非根用户身份安装和运行OpenOffice,则为非根用户提供sudo权限。
  • 如果在基于UNIX的平台上使用OpenOffice,请运行以下命令以设置路径变量:
export OpenOffice_PATH=/opt/openoffice.org4

(仅用于IBM WebSphere)配置IBM SSL套接字提供程序

请执行以下步骤来配置IBM SSL套接字提供程序:
  1. 创建java.security文件的副本。 文件的默认位置为 [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security
  2. 打开复制的java.security文件进行编辑。
  3. 更改默认的SSL套接字工厂以使用JSSE2工厂而不是默认的IBM WebSphere工厂:
    默认内容:
    #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
    #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
    #WebSphere socket factories (in cryptosf.jar)
    ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
    ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
    
    
    修改的内容:
    ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
    ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
    
    #WebSphere socket factories (in cryptosf.jar)
    #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
    #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
    
    
  4. 要使AEM Forms服务器能够使用更新的java.security文件,请在启动AEM Forms服务器时添加以下java参数:
    -Djava.security.properties= [path of newly created Java.security file].

(仅限Windows)配置“安装墨水和手写”服务

如果运行的是Microsoft Windows Server,请配置Ink and Sharting服务。 需要该服务才能打开使用Microsoft Office的输墨功能的Microsoft PowerPoint文件:
  1. 打开服务器管理器。 单击快 速启动托盘 上的“服务器管理器”图标。
  2. 单击 “功能 ”菜单中 的“添加 功能”。 选中“ 墨水和手写服务 ”复选框。
  3. 选择“功能 ”对话框, 并选择“墨水和手写服务 ”。 单 击“ Install(安装)” ,即安装服务。

(仅限Windows)为Microsoft Office配置文件块设置

更改Microsoft Office信任中心设置,使PDF Generator服务能够转换使用旧版Microsoft Office创建的文件。
  1. 打开Microsoft Office应用程序。 例如,Microsoft Word。 导航到 “文件 ”> “选项 ”。 将出现选项对话框。
  2. 单击“ 信任中心 ”,然后单击“ 信任中心设置”
  3. 在“信任 中心”设置中 ,单击“ 文件块设置”
  4. 在“文 件类型 ”列表中, 取消选择“打开 ”以指定PDF Generator服务应允许转换为PDF文档的文件类型。

(仅限Windows)授予替换进程级别令牌权限

用于开始应用程序服务器的用户帐户需要 “替换”进程级别令牌 。 默认情况下,本地系统帐 户具有“替换进程级别令牌 ”权限。 对于与本地管理员组的用户一起运行的服务器,必须明确授予该权限。 请执行以下步骤以授予权限:
  1. 打开Microsoft Windows的组策略编辑器。 要打开组策略编辑器,请单 击开始 ,在“ 开始搜索”框中 键入gpedit.msc ,然后单击“组策 ​略编辑器”。
  2. 导航到“本 地计算机策略 ”>“计 算机配置 ”>“Windows设置 ”>“安全性设置” >“安全性策略”>“本地用户 权限”>“用户权限”和“令牌级别的分配过程和编辑令牌级别策略”,其中包括管理员组。
  3. 将用户添加到替换进程级别令牌条目。

(仅限Windows)为非管理员用户启用PDF Generator服务

您可以允许非管理员用户使用PDF Generator服务。 通常,只有具有管理权限的用户才能使用服务:
  1. 创建环境变量PDFG_NON_ADMIN_ENABLED。
  2. 将环境变量的值设置为TRUE。
  3. 重新启动AEM Forms实例。

(仅限Windows)禁用用户帐户控制(UAC)

  1. 要访问系统配置实用程序,请转到 开始>运行 ,然后输 入MSCONFIG
  2. 单击“工 ”选项卡,向下滚动并选择“ 更改UAC设置” 。 单击 启动 ,在新窗口中运行命令。
  3. 将滑块调整到“从不通知”级别。 完成后,关闭命令窗口并关闭“System Configuration(系统配置)”窗口。
  4. 验证UAC的注册表设置是否设置为0(零)。 请执行以下步骤验证:
    1. Microsoft建议在修改注册表之前先备份它。 有关详细步骤,请 参阅如何在Windows中备份和恢复注册表
    2. 打开Microsoft Windows注册表编辑器。 要打开注册表编辑器,请转到“开始”>“运行”,键入regedit,然后单击“确定”。
    3. 导航至 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\ . 确保将EnableLUA的值设置为0(零)。
    4. 确保EnableLUA 的值 设置为0(零)。 如果值不是0,则将值更改为0。 关闭注册表编辑器。
  5. 重新启动计算机。

(仅限Windows)禁用错误报告服务

在Windows服务器上使用PDF Generator服务将文档转换为PDF时,Windows Server偶尔会报告可执行文件遇到问题,需要关闭。 但是,它不会影响PDF转换,因为它在后台继续。
为避免收到错误,您可以禁用Windows错误报告。 有关禁用错误报告的详细信息,请参 阅https://technet.microsoft.com/en-us/library/cc754364.aspx

(仅限Windows)配置HTML到PDF的转换

PDF Generator服务提供WebKit、WebCapture和PhantomJS路由或方法,将HTML文件转换为PDF文档。 在Windows上,要启用WebKit和Acrobat WebCapture路由的转换,请将Unicode字体复制到%windir%\fonts目录。
只要将新字体安装到字体文件夹,请重新启动AEM Forms实例。

(仅限基于UNIX的平台)HTML到PDF转换的额外配置

在基于UNIX的平台上,PDF Generator服务支持WebKit和PhantomJS路由,以将HTML文件转换为PDF文档。 要启用HTML到PDF的转换,请执行适用于首选转换路由的以下配置:

(仅限基于UNIX的平台)支持Unicode字体(仅限WebKit)

根据您的系统,将Unicode字体复制到以下任意目录:
  • /usr/lib/X11/fonts/TrueType
  • /usr/share/fonts/default/TrueType
  • /usr/X11R6/lib/X11/fonts/ttf
  • /usr/X11R6/lib/X11/fonts/truetype
  • /usr/X11R6/lib/X11/fonts/TrueType
  • /usr/X11R6/lib/X11/fonts/TTF
  • /usr/openwin/lib/X11/fonts/TrueType(Solaris)
  • 在RedHat Enterprise Linux 6.x和更高版本上,快递字体不可用。 要安装快递字体,请下载font-ibm-type1-1.0.3.zip存档。 在/usr/share/fonts解压存档。 创建从/usr/share/X11/fonts到/usr/share/fonts的符号链接。
  • 从Html2PdfSvc/bin和/usr/share/fonts目录中删除所有。lst字体缓存文件。
  • 确保目录/usr/lib/X11/fonts和/usr/share/fonts存在。 如果目录不存在,则使用ln命令创建从/usr/share/X11/fonts到/usr/lib/X11/fonts的符号链接以及从/usr/share/fonts到/usr/share/X11/fonts的其他符号链接。 另外,请确保在/usr/lib/X11/fonts中提供快递字体。
  • 确保/usr/share/fonts或/usr/share/X11/fonts目录中提供所有字体(Unicode和非Unicode)。
  • 以非根用户身份运行PDF Generator服务时,请提供对所有字体目录的非根用户读写权限。
  • 只要将新字体安装到字体文件夹,请重新启动AEM Forms实例。

Install AEM Forms add-on package

AEM Forms加载项包是部署到AEM上的应用程序。 该软件包包含AEM Forms文档服务和其他AEM Forms功能。 请执行以下步骤来安装包:
  1. 开放 软件分发 。 您需要Adobe ID登录软件分发。
  2. 点按 标题 菜单中可用的Adobe Experience Manager。
  3. 在过滤器 部分 :
    1. 从“ 解决方 ”下 拉列表中选择“表单”。
    2. 选择包的版本和类型。 您还可以使用“搜 索下载 ”选项筛选结果。
  4. 点按适用于您的操作系统的包名称,选择“ 接受EULA条款 ”,然后点 按下载
  5. 打开 包管理器 ,然后单 击“上传包 ”以上传包。
  6. Select the package and click Install .
    您还可以通过AEM Forms版本文章中列出的直接链接下载 该包
  7. 安装包后,系统会提示您重新启动AEM实例。 不要立即停止服务器。 在停止AEM Forms服务器之前,请等到ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止显示在。log文 [AEM-Installation-Directory]/crx-quickstart/logs/error 件中,并且日志是稳定的。

安装后配置

为RSA/BouncyCastle库配置引导委派

  1. 停止AEM实例。 导航到AEM # \crx-quickstart\conf\ folder。 打开sling.properties文件进行编辑。
    如果您使 [AEM installation directory]\crx-quickstart\bin\start.bat 用开始AEM实例,请编辑位于的sling.properties [AEM_root]\crx-quickstart\
  2. 将以下属性添加到sling.properties文件:
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
    
    
  3. (仅限AIX)将以下属性添加到sling.properties文件:
    sling.bootdelegation.xerces=org.apache.xerces.*
    
    
  4. 保存并关闭文件。

配置字体管理器服务

  1. 以管理员 身份登录 ,到AEM Configuration Manager。
  2. 找到并打 开CQ-DAM-Handler-Gibson字体管理器服务 。 指定System Fonts、Adobe Server Fonts和Customer Fonts目录的路径。 单击​ 保存
    您使用Adobe以外各方提供的字体的权利受这些字体提供给您的许可协议所管辖,且您使用Adobe软件的许可不涵盖这些权利。 Adobe建议您在将非Adobe字体与Adobe软件一起使用之前,检查并确保您符合所有适用的非Adobe许可协议,特别是在服务器环境中使用字体时。 将新字体安装到字体文件夹时,请重新启动AEM Forms实例。

配置本地用户帐户以运行PDF Generator服务

运行PDF Generator服务需要本地用户帐户。 有关创建本地用户的步骤,请参 阅在Windows中创建用户帐户 , 或在基于UNIX的平台中创建用户帐户
  1. 在“用 户帐户 ”选项卡中,提供本地用户帐户的凭据,然后单击“ 提交” 。 如果Microsoft Windows提示,允许访问用户。 成功添加后,配置的用户将显示在“用 户帐户”选项卡 “您的用户 帐户”部分下

配置超时设置

  1. AEM配置管理器 中,找到并打 开Jacorb ORB提供程序服务
    在Custom Properties.name字 段中添加以下内容 ,然后单 击Save 。 它将挂起的回复超时(也称为CORBA客户端超时)设置为600秒。
    jacorb.connection.client.pending_reply_timeout=600000
  2. 登录到AEM作者实例,然后导航到 Adobe Experience Manager >工 >表 > 配置 PDF Generator 。 默认URL为http://localhost:4502/libs/fd/pdfg/config/ui.html。
    打开“ 常规配置 ”选项卡,并修改以下字段的值以用于您的环境:
字段 描述 默认值
服务器转换超时 PDFG转换在服务器转换超时中定义的秒数内保持活动状态 270 seconds
PDFG 清理扫描秒数 执行转换后操作所需的秒数。 3600秒
作业盗取秒数 允许PDF Generator服务运行转换的持续时间。 确保作业过期秒数的值大于PDFG清除扫描秒数值。 7200秒

(仅限Windows)为PDF Generator服务配置Acrobat

在Microsoft Windows上,PDF Generator服务使用Adobe Acrobat将支持的文件格式转换为PDF文档。 请执行以下步骤为PDF Generator服务配置Adobe Acrobat:
  1. 打开Acrobat并选择“ 编辑 ”> “首 ​选项 >“更新程序”。 在检查更新中,取消选择 自动安装更新 ,然后单 击确定 。 关闭Acrobat。
  2. 多次-单击系统上的PDF文档。 Acrobat首次开始时,将显示登录、欢迎屏幕和EULA的对话框。 为配置为使用PDF生成器的所有用户关闭这些对话框。
  3. 运行PDF Generator实用程序批处理文件,为PDF Generator服务配置Acrobat:
    1. 开AEM包管理器 ,并从包 adobe-aemfd-pdfg-common-pkg-[version].zip 管理器下载文件。
    2. 解压缩下载的。zip文件。 以管理权限打开命令提示符。
    3. 导航到目 [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts 录。 运行以下批处理文件:
      Acrobat_for_PDFG_Configuration.bat
      Acrobat配置为随PDF Generator服务一起运行。
  4. 运行系统就绪性工具(SRT)以验证Acrobat安装。 该工具检查机器是否配置正确以运行PDF生成器转换,并在指定路径下生成报告:
    1. 打开命令提示符。 导览至文 [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt 件夹。 从命令提示符运行以下命令:
      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en
      如果“系统就绪性工具”报告acrobat插件文件夹中不提供pdfgen.api文件,则将pdfgen.api文件从目录 [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 复制到目 [Acrobat_root]\Acrobat\plug_ins 录。
    2. 导航至 [Path_of_reports_folder] . 打开SystemReadinessTool.html文件。 验证报告并修复上述问题。

(仅限Windows)配置HTML到PDF转换的主路由

PDF Generator服务提供多条路由将HTML文件转换为PDF文档: Webkit、Acrobat WebCapture(仅限Windows)和PhantomJS。 Adobe建议使用PhantomJS路由,因为它能够处理动态内容,并且不依赖32位库、32位JDK,或不需要任何额外字体。 此外,PhantomJS路由不需要sudo或root访问权限即可运行转换。
HTML到PDF转换的默认主要路由是Webkit。 要更改转换路线:
  1. 在AEM作者实例上,导航 到工 ​具 >表 ​单 > ​配置PDF生成器。
  2. 在“常 规配置 ”选项卡中,从“HTML到PDF转换的 主要路由”下拉框中选择首选 的转换路线。

初始化全局信任存储

使用信任存储管理,您可以导入、编辑和删除您信任的证书,以验证数字签名和证书身份验证。 您可以导入和导出任意数量的证书。 导入证书后,您可以编辑信任设置和信任存储类型。 请执行以下步骤以初始化信任存储:
  1. 以管理员身份登录AEM Forms实例。
  2. 转到“工 ”>“ 安全 >“ ​信任存储”。
  3. 单击“ 创建信任商店 ”。 设置口令并点 按保存

为Reader扩展和加密服务设置证书

DocAssurance服务可将使用权限应用于PDF文档。 要对PDF文档应用使用权限,请配置证书。
在设置证书之前,请确保您具有:
  • 证书文件(.pfx)。
  • 随证书提供的私钥密码。
  • 私钥别名. 您可以执行Java keytool命令来视图私钥别名: keytool -list -v -keystore [keystore-file] -storetype pkcs12
  • 密钥库文件密码。 如果您使用的是Adobe的Reader Extensions证书,则Keystore文件密码始终与私钥密码相同。
请执行以下步骤配置证书:
  1. 以管理员身份登录AEM Author实例。 转到“工 ”>“ 安全 >“ ​用户”。
  2. 单击 用户帐户 的名称字段。 此时将 打开“编辑用户 设置”页。 在AEM Author实例上,证书驻留在KeyStore中。 如果您之前尚未创建KeyStore,请单 击“创建KeyStore ”并为KeyStore设置新密码。 如果服务器已包含KeyStore,请跳过此步骤。 如果您使用的是Adobe的Reader Extensions证书,则Keystore文件密码始终与私钥密码相同。
  3. 在“编 辑用户设置 ”页面上,选 择KeyStore 选项卡。 展开“ 从密钥存储添加私钥 ”文件选项并提供别名。 别名用于执行Reader扩展程序操作。
  4. 要上传证书文件,请单 击“选择密钥存储文件 ”,然后上传<filename>.pfx文件。
    将与证 书关联的 “密钥 存储密码”、 “私钥密 码”和“私钥别名 ”添加到相应的字段。 单击 提交
    • 在生产环境中,将您的评估凭据替换为生产凭据。 请确保在更新过期或评估凭据之前删除旧的Reader扩展凭据。
  5. 单击 “编辑用户 设置” 页面上的“保存并关 闭”。

启用AES-256

要对PDF文件使用AES 256加密,请获取并安装Java加密扩展(JCE)无限强度管辖权策略文件。 替换jre/lib/security文件夹中的local_policy.jar和US_export_policy.jar文件。 例如,如果您使用Sun JDK,则将下载的文件复制到该文 [JAVA_HOME]/jre/lib/security 件夹。
Assembler服务取决于Reader Extensions服务、签名服务、Forms服务和输出服务。 请执行以下步骤以验证所需的服务是否已启动并正在运行:
  1. 以管理员身 https://'[server]:[port]'/system/console/bundles 份登录URL。
  2. 搜索以下服务,确保服务已启动并正在运行:
服务名称 包名称
签名服务 adobe-aemfd-signatures
Reader Extensions Service com.adobe.aemfd.adobe-aemfd-readerextensions
表单服务 com.adobe.livecycle.adobe-lc-forms-bedrock-connector
输出服务 com.adobe.livecycle.adobe-lc-forms-bedrock-connector

已知问题和疑难解答

  • 如果压缩的输入文件包含文件名中带有多次字节字符的HTML文件,则HTML到PDF的转换将失败。 要避免此问题,请在命名HTML文件时不要使用多次字节字符。
  • 在基于UNIX的操作系统上,执行以下操作以查找任何缺少的库:
  1. 导航至 [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/ .
  2. 运行以下命令以列表PhantomJS需要HTML到PDF转换的所有库。
    ldd phantomjs
    运行以下命令以列表缺少的库。
    ldd phantomjs | grep not
  3. 手动安装缺少的库。

后续步骤

您拥有工作AEM Forms文档服务环境。 您可以通过以下方式使用文档服务: