cvs commit: xml-fop/src/documentation/content/xdocs pdfencryption.xml
jeremias2003/06/23 01:36:13 Modified:src/documentation/content/xdocs pdfencryption.xml Log: Added instructions for embedding. Revision ChangesPath 1.6 +69 -1 xml-fop/src/documentation/content/xdocs/pdfencryption.xml Index: pdfencryption.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/pdfencryption.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- pdfencryption.xml 27 May 2003 00:02:42 - 1.5 +++ pdfencryption.xml 23 Jun 2003 08:36:13 - 1.6 @@ -7,6 +7,7 @@ titlePDF encryption./title authors person name=J.Pietschmann email=[EMAIL PROTECTED]/ + person name=Jeremias Märki email=[EMAIL PROTECTED]/ /authors /header body @@ -30,7 +31,7 @@ /p /section section - titleUsage/title + titleUsage (command line)/title p Encryption is enabled by supplying any of the encryption related options. @@ -58,6 +59,73 @@ code-noannotations/code options, which disable printing, copying text, editing in Adobe Acrobat and making annotations, respectively. /p +/section +section + titleUsage (embedded)/title + p +When FOP is embedded in another Java application you need to set an +options map on the renderer. These are the supported options: + /p + table +tr + thOption/th + thDescription/th + thValues/th + thDefault/th +/tr +tr + tdownerPassword/td + tdThe owner password/td + tdString/td + td/ +/tr +tr + tduserPassword/td + tdThe user password/td + tdString/td + td/ +/tr +tr + tdallowPrint/td + tdAllows/disallows printing of the PDF/td + tdTRUE or FALSE/td + tdTRUE/td +/tr +tr + tdallowCopyContent/td + tdAllows/disallows copy/paste of content/td + tdTRUE or FALSE/td + tdTRUE/td +/tr +tr + tdallowEditContent/td + tdAllows/disallows editing of content/td + tdTRUE or FALSE/td + tdTRUE/td +/tr +tr + tdallowEditAnnotations/td + tdAllows/disallows editing of annotations/td + tdTRUE or FALSE/td + tdTRUE/td +/tr + /table + note +Encryption is enabled as soon as one of these options is set. + /note + p +An example to enable PDF encryption in Java code: + /p + source![CDATA[ +Driver driver = new Driver(); +driver.setRenderer(Driver.RENDER_PDF); +Map rendererOptions = new java.util.HashMap(); +rendererOptions.put(ownerPassword, mypassword); +rendererOptions.put(allowCopyContent, FALSE); +rendererOptions.put(allowEditContent, FALSE); +rendererOptions.put(allowPrint, FALSE); +driver.getRenderer().setOptions(rendererOptions); +driver.setOutputStream(...]]/source /section section titleEnvironment/title - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: xml-fop/src/documentation/content/xdocs pdfencryption.xml
jeremias2003/03/12 07:53:31 Modified:src/documentation/content/xdocs pdfencryption.xml Log: Fixed some typos. Revision ChangesPath 1.2 +111 -108 xml-fop/src/documentation/content/xdocs/pdfencryption.xml Index: pdfencryption.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/pdfencryption.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- pdfencryption.xml 5 Mar 2003 23:15:25 - 1.1 +++ pdfencryption.xml 12 Mar 2003 15:53:31 - 1.2 @@ -1,108 +1,111 @@ -?xml version=1.0 standalone=no? -!DOCTYPE document PUBLIC -//APACHE//DTD Documentation V1.1//EN - http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd; - -document - header -titlePDF encryption./title - /header - body -section - titleOverview/title - p -FOP supports encryption of PDF output, thanks to Patrick -C. Lankswert. This feature is commonly used to prevent unauthorized -printing, editing and copying text from the document or to forbid -annotations. It is also possible to ask the user for a password in order -to view the contents. Note that there already exist third party -applications which can decrypt an encrypted PDF without effort and allow -the aforementioned operations, therefore the degree of protection is -limited. - /p - p -For further information about features and restrictions regarrding PDFF -encryption, look at the documentation coming with Adobe Acrobat or the -technial documentation on the Adobe web site. - /p -/section -section - titleUsage/title - p -Encryption is enabled by supplying an owner password with the -code-o/code option. The owner password can be used to disregard -any restriction imposed on the PDF document. If no owner password has -been supplied but FOP was asked to apply some restrictions, a random -password is used. - /p - p -A user password, supplied with the code-u/code option, will -cause the PDF display software to ask the reader for this password in -order to view the contents of the document. If no user password was -supplied, viewing the content is not restricted. - /p - p -Further restrictions can be imposed by using the -code-noprint/code, code-nocopy/code, -code-noedit/code and code-noannotations/code options, -which disable printing, copy text, editing in Adobe Acrobat and making -annotations, respectively. - /p -/section -section - titleEnvironment/title - p -In order to use PDF encryption, FOP has to be compiled with cryptography -support. Currently, only link - href=http://java.sun.com/j2se/1.4/docs/guide/security/jce/JCERefGuide.html;JCE/link -is supported. JCE is part of JDK 1.4. For earlier JDKs, it can be -installed separately, however, the build process currently recognizes -JCE from JDK 1.4. - /p - p -Cryptography support must also be present at run time. In particular, a -provider for the RC4 cipher is needed. Unfortunately, the sample JCE -provider in Sun's JDK 1.4 does strongnot/strong provide RC4. If you -get a message saying - /p - sourceCannot find any provider supporting RC4/source - p -you don't have the needed support. - /p - p -There are several commercial and a few Open Source packages which -provide RC4. A pure Java implementation is produced by link -href=http://www.bouncycastle.org/;The Legion of the Bouncy -Castle/link. link -href=http://www.mozilla.org/projects/security/pki/jss/;Mozilla -JSS/link is an interface to a native implementation. - /p -/section -section - titleInstalling a crypto provider/title - p -The pure Java implementation from link -href=http://www.bouncycastle.org/;Bouncy Castle/link is easy to -install. - /p - ol -li - Download the binary distribution for your JDK version. If you have JDK - 1.3 or earlier you must alos download a JCE from the same page. -/li -li - Unpack the distribution. Add the jar file to your classpath. A - convenient way to use the jar on Linux is to simply drop it into the - FOP lib directory, it will be automatically picked up by - codefop.sh/code. If you have JDK 1.3 or earlier don't forget to - install the JCE as well. -
cvs commit: xml-fop/src/documentation/content/xdocs pdfencryption.xml book.xml running.xml
pietsch 2003/03/05 15:15:25 Modified:src/documentation/content/xdocs book.xml running.xml Added: src/documentation/content/xdocs pdfencryption.xml Log: Added documentation for PDF encryption to xdocs. Revision ChangesPath 1.9 +1 -0 xml-fop/src/documentation/content/xdocs/book.xml Index: book.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/book.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- book.xml 27 Jan 2003 20:59:55 - 1.8 +++ book.xml 5 Mar 2003 23:15:25 - 1.9 @@ -38,6 +38,7 @@ menu-item label=SVG href=svg.html/ menu-item label=Extensions href=extensions.html/ menu-item label=Fonts href=fonts.html/ + menu-item label=PDF encryption href=pdfencryption.html/ menu-item label=Configuration href=configuration.html/ /menu 1.5 +68 -62xml-fop/src/documentation/content/xdocs/running.xml Index: running.xml === RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/running.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- running.xml 18 Jan 2003 18:04:58 - 1.4 +++ running.xml 5 Mar 2003 23:15:25 - 1.5 @@ -3,77 +3,83 @@ http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd; document -header - titleRunning FOP/title -/header + header +titleRunning FOP/title + /header -body - section -titleInstallation/title + body section - titleOverview/title - pThe following software must be installed:/p - ul -liJava 1.2.x or later./li -liFOP. The jump href=http://xml.apache.org/fop/download.html;FOP distribution/jump includes all libraries that you will need to run a basic FOP installation. These can be found in the xml-fop/lib directory. These libraries include the following:/li + titleInstallation/title + section +titleOverview/title +pThe following software must be installed:/p ul - liApache jump href=http://xml.apache.org/xerces-j/index.html;Xerces-J/jump for XML parsing. You can use other XML parsers which support SAX and DOM./li - liApache Xalan, an XSLT processor./li - liApache jump href=http://xml.apache.org/batik/;Batik/jump, an SVG library./li + liJava 1.2.x or later./li + liFOP. The jump href=http://xml.apache.org/fop/download.html;FOP distribution/jump includes all libraries that you will need to run a basic FOP installation. These can be found in the xml-fop/lib directory. These libraries include the following:/li + ul +liApache jump href=http://xml.apache.org/xerces-j/index.html;Xerces-J/jump for XML parsing. You can use other XML parsers which support SAX and DOM./li +liApache Xalan, an XSLT processor./li +liApache jump href=http://xml.apache.org/batik/;Batik/jump, an SVG library./li + /ul + liOptional Libraries/li /ul -liOptional Libraries/li - /ul + /section + section +titleInstructions/title +pBasic FOP installation consists of first unzipping the code.gz/code file that is the distribution medium, then unarchiving the resulting code.tar/code file in a directory/folder that is convenient on your system. Please consult your operating system documentation or Zip application software documentation for instructions specific to your site./p + /section + section +titleProblems/title +pSome Mac OSX users have experienced filename truncation problems using Stuffit to unzip and unarchive their distribution media. This is a legacy of older Mac operating systems, which had a 31-character pathname limit. Several Mac OSX users have recommended that Mac OSX users use the shell command codetar -xzf/code instead./p + /section /section section - titleInstructions/title - pBasic FOP installation consists of first unzipping the code.gz/code file that is the distribution medium, then unarchiving the resulting code.tar/code file in a directory/folder that is convenient on your system. Please consult your operating system documentation or Zip application software documentation for instructions specific to your site./p -/section -section - titleProblems/title - pSome Mac OSX users have experienced filename truncation problems using Stuffit to unzip and unarchive their distribution media. This is a legacy of older Mac operating systems, which had a 31-character pathname limit. Several Mac OSX users