安装和配置文档服务

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服务

  • 巴科德Forms社: 使您能够从条形码的电子图像中提取数据。 该服务接受包含一个或多个条码的TIFF和PDF文件作为输入并提取条形码数据。 有关详细信息,请参 阅BarcodedForms服务

  • 文档保障服务: 使您能够加密和解密文档,扩展Adobe Reader的功能并增加使用权限,并为文档添加数字签名。 文档保障服务包含三项服务:签名、加密和读者扩展。 有关详细信息,请参 阅DocAssurance Service

  • 加密服务: 使您能够加密和解密文档。 文档加密后,其内容将变得不可读。 授权用户可以解密文档以获得对其内容的访问。 有关详细信息,请参 阅加密服务

  • Forms服务: 允许您创建交互式数据捕获客户端应用程序,这些应用程序验证、处理、转换和交付通常在Forms设计器中创建的表单。 Forms服务可呈现您开发为PDF文档的任何表单设计。 有关详细信息,请参阅 Forms服务

  • 输出服务: 使您能创建不同格式的文档,包括PDF、激光打印机格式和标签打印机格式。 激光打印机格式为PostScript和打印机控制语言(PCL)。 有关详细信息,请参 阅输出服务

  • PDF Generator服务: PDF Generator服务提供API,可将本机文件格式转换为PDF。 它还将PDF转换为其他文件格式并优化PDF文档的大小。 有关详细信息,请参 阅PDF Generator服务

  • Reader扩展服务: 通过扩展Adobe Reader的功能以及额外的使用权限,使您的组织能够轻松共享交互式PDF文档。 该服务激活在使用Adobe Reader打开PDF文档时不可用的功能,如向文档添加注释、填写表单和保存文档。 有关详细信息,请参 阅Reader扩展服务

  • 签名服务: 允许您在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的架构和部署拓扑

注意

尽管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、AcrobatWebCapture和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和AcrobatWebCapture路由的转换,请将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. 从“ 解决方”下拉 列表中选择Forms。
    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.*
    
  3. (仅限AIX)将以下属性添加到sling.properties文件:

    sling.bootdelegation.xerces=org.apache.xerces.*
    
  4. 保存并关闭文件。

配置字体管理器服务

  1. 以管理员 身份登录 到AEM Configuration Manager。

  2. 找到并打 开CQ-DAM-Handler-Gibson字体管理器服务 。 指定“系统字体”、“Adobe服务器字体”和“客户字体”目录的路径。 单击​保存

    注意

    您使用Adobe以外各方提供的字体的权利受这些字体协议提供给您的许可协议约束,且您使用Adobe软件的许可不涵盖您的权利。 Adobe建议您在将非Adobe字体与Adobe软件一起使用之前,检查并确保遵守所有适用的非Adobe许可协议,特别是在服务器环境中使用字体时。
    将新字体安装到字体文件夹时,请重新启动AEM Forms实例。

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

运行PDF Generator服务需要本地用户帐户。 有关创建本地用户的步骤,请参 阅在Windows中创建用户帐户 , 或在基于UNIX的平台中创建用户帐户

  1. 打开“ AEM FormsPDF生成器配置 ”页。

  2. 在“用 户帐户 ”选项卡中,提供本地用户帐户的凭据,然后单击“ 提交”。 如果Microsoft Windows提示,允许访问用户。 成功添加后,配置的用户将显示在“用 户帐户”选项卡 “您的用户 帐户”部分下

配置超时设置

  1. 在AEM 配置管理器中,找到并 打开Jacorb ORB Provider service。

    在Custom Properties.name字 段中添加以下内容 ,然后单 击Save。 它将挂起的回复超时(也称为CORBA客户端超时)设置为600秒。

    jacorb.connection.client.pending_reply_timeout=600000

  2. 登录到AEM作者实例,并导航到 Adobe Experience Manager >工 > Forms > ​Configure 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 Package Manager并从包 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、AcrobatWebCapture(仅限Windows)和PhantomJS。 Adobe建议使用PhantomJS路由,因为它能够处理动态内容,并且不依赖32位库、32位JDK,或不需要任何额外字体。 此外,PhantomJS路由不需要sudo或root访问权限即可运行转换。

HTML到PDF转换的默认主要路由是Webkit。 要更改转换路线:

  1. 在AEM作者实例上,导航 到工​具 > Forms >​配置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扩展证书,则Keystore文件密码始终与私钥密码相同。

请执行以下步骤配置证书:

  1. 以管理员身份登录到AEM作者实例。 转到“工 ”>“ 安全>“​用户”。

  2. 单击 用户帐户 的名称字段。 此时将 打开“编辑用户 设置”页。 在AEM作者实例中,证书驻留在KeyStore中。 如果您之前尚未创建KeyStore,请单 击“创建KeyStore ”并为KeyStore设置新密码。 如果服务器已包含KeyStore,请跳过此步骤。 如果您使用Adobe的Reader扩展证书,则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扩展服务、签名服务、Forms服务和输出服务。 请执行以下步骤以验证所需的服务是否已启动并正在运行:

  1. 以管理员身 https://'[server]:[port]'/system/console/bundles 份登录URL。
  2. 搜索以下服务,确保服务已启动并正在运行:
服务名称 包名称
签名服务 adobe-aemfd-signatures
Reader扩展服务 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文档服务环境。 您可以通过以下方式使用文档服务:

在此页面上