Importing Credentials by using the Trust Manager API

Summary of steps
Import credentials using the Java API

You can programmatically import a credential into LiveCycle by using the Trust Manager API. For example, you can import a credential used to sign a PDF document. (See Digitally Signing PDF Documents).

When importing a credential, you specify an alias for the credential. The alias is used to perform a LiveCycle operation that requires a credential. Once imported, a credential can be viewed in Administration Console, as shown in the following illustration. Notice that the alias for the credential is Secure.

View full size graphic

Note: You cannot import a credential into LiveCycle using web services.

Summary of steps

To import a credential into LiveCycle, perform the following steps:

Include project files.
Create a credential service client.
Reference the credential.
Perform the import operation.

Include project files

Include necessary files into your development project. If you are creating a client application using Java, then include the necessary JAR files. If you are using web services, then make sure that you include the proxy files.

The following JAR files must be added to your project’s classpath:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-truststore-client.jar
adobe-utilities.jar (Required if LiveCycle is deployed on JBoss)
jbossall-client.jar (Required if LiveCycle is deployed on JBoss)

For information about the location of these JAR files, see Including LiveCycle Java library files.

Create a credential service client

Before you can programmatically import a credential into LiveCycle, create a credential service client. For information, see Setting connection properties.

Reference the credential

Reference a credential that you want to import into LiveCycle. The quick start associated with this section references a P12 file located in the file system.

Perform the import operation

After you reference the credential, import the credential into LiveCycle. If the credential is not successfully imported, an exception is thrown. When importing a credential, you specify an alias for the credential.

Import credentials using the Java API

Import a credential into LiveCycle by using the Trust Manager API (Java):

Include project files

Include client JAR files, such as adobe-truststore-client.jar, in your Java project’s class path.
Create a credential service client
- Create a ServiceClientFactory object that contains connection properties.
- Create a CredentialServiceClient object by using its constructor and passing the ServiceClientFactory object.
Reference the credential
- Create a java.io.FileInputStream object by using its constructor. Pass a string value that specifies the location of the credential.
- Create a com.adobe.idp.Document object that stores the credential by using the com.adobe.idp.Document constructor. Pass the java.io.FileInputStream object that contains the credential to the constructor.
Perform the import operation
- Create a string array that holds one element. Assign the value truststore.usage.type.sign to the element.
- Invoke the CredentialServiceClient object’s importCredential method and pass the following values:
  - A string value that specifies the alias value for the credential.
  - The com.adobe.idp.Document instance that stores the credential.
  - A string value that specifies the password that is associated with the credential.
  - The string array that contains the usage value. For example, you can specify this value truststore.usage.type.sign. To import a Reader Extension credential, specify truststore.usage.type.lcre.