Command line tools for packaging content and creating revocations lists

The reference implementation includes the following command line tools:

• Policy Manager: A tool for creating and managing policies
• Policy Update List Manager: A tool for creating and viewing policy update lists
• Revocation List Manager: A tool for creating and viewing revocation lists
• Media Packager: A tool for creating encrypted FLV and F4V files
• AIR Publisher ID
• UtilityLicense Generator
• License Embedder

Requirements

The requirements for using the command line tools available in the reference implementations are as follows:

• All of the command line tools require Java 1.5 or higher.
• Packager and License Server credentials (certificate and password) that are issued by Adobe. You need credentials to encrypt and sign video files, to sign Policy Update and Revocation lists, and to pre-generate licenses.

Configuration file

Several of the command-line tools require a configuration file that contains information for the tools to use for applying policies and encrypting files.

The default configuration file is flashaccesstools.properties. It is located in the working directory; that is, the directory from which you run the tools (see Installing the command line tools). Each tool also contains an option ( -c) that lets you point to the configuration file you want to use if you prefer not to use the default.

The configuration file uses the Java property file format. If values for any of the properties contain special characters, keep in mind the following restrictions:

• Escape backslashes with an additional backslash. For example, to specify the C:\credentials.pfx file, specify it as C:\credentials.pfx or C:/credentials.pfx. To specify a file on a network server, specify \\\\server\\folder\\filename.pfx.
• The configuration file can contain only Latin-1 characters. If you must use non-Latin-1 characters, use the appropriate Unicode escape sequence (using, optionally, the native2ascii tool that comes with Java).

Set values for properties in the configuration file before you run the tools. For some of the command line tools, you can set the values for some options through either the command line or the configuration file. In those cases, values that are set through the command line take precedence over any values in the configuration file.

Installing the command line tools

You can copy the files you need from the \Reference Implementation\Command Line Tools directory on the DVD, which contains the default flashaccesstools.properties configuration file, and a libs directory, which contains the JAR files for the tools.

The samples directory contains several sample Java source files demonstrating usage of the Adobe Access SDK APIs. To build and run the samples, use the build-samples.xml Ant script.