Trabajar con credenciales

Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.

Acerca del servicio de credenciales

Una credencial contiene la información de clave privada necesaria para firmar o identificar documentos. Un certificado es información de clave pública que se configura para la confianza. AEM Forms utiliza certificados y credenciales para varios fines:

Puede interactuar mediante programación con el servicio de credenciales mediante la API de Java de Administrador de confianza. Puede realizar las siguientes tareas:

NOTA

También puede importar y eliminar certificados mediante la consola de administración. (Consulte ayuda de administración.)

Importación de credenciales mediante la API de Trust Manager

Puede importar mediante programación una credencial en AEM Forms mediante la API de Administrador de confianza. Por ejemplo, puede importar una credencial utilizada para firmar un documento de PDF. (Consulte Firma digital de documentos de PDF).

Al importar una credencial, se especifica un alias para la credencial. El alias se utiliza para realizar una operación de Forms que requiere credenciales. Una vez importadas, las credenciales se pueden ver en la consola de administración, como se muestra en la siguiente ilustración. Observe que el alias de la credencial es Secure.

ww_ww_truststore

NOTA

No puede importar una credencial en AEM Forms mediante servicios web.

Resumen de los pasos

Para importar una credencial en AEM Forms, realice los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio de credenciales.
  3. Haga referencia a la credencial.
  4. Realice la operación de importación.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.

Los siguientes archivos JAR deben añadirse a la ruta de clase del proyecto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (obligatorio si AEM Forms está implementado en JBoss)
  • jbossall-client.jar (requerido si AEM Forms está implementado en JBoss)

Para obtener información sobre la ubicación de estos archivos JAR, consulte Incluir archivos de biblioteca Java de AEM Forms.

Crear un cliente de servicio de credenciales

Para poder importar mediante programación una credencial en AEM Forms, cree un cliente de servicio de credenciales. Para obtener más información, consulte Estableciendo propiedades de conexión.

Hacer referencia a la credencial

Haga referencia a una credencial que desee importar en AEM Forms. El inicio rápido asociado a esta sección hace referencia a un archivo P12 ubicado en el sistema de archivos.

Realice la operación de importación

Después de hacer referencia a la credencial, impórtela a AEM Forms. Si la credencial no se importa correctamente, se produce una excepción. Al importar una credencial, se especifica un alias para la credencial.

Consulte también

Importar credenciales mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Inicios rápidos de API de servicio de credenciales

Eliminación de credenciales mediante la API de Administrador de confianza

Importar credenciales mediante la API de Java

Importe una credencial en AEM Forms mediante la API de Trust Manager (Java):

  1. Incluir archivos de proyecto

    Incluya archivos JAR de cliente, como adobe-truststore-client.jar, en la ruta de clase del proyecto Java.

  2. Crear un cliente de servicio de credenciales

    • Crear un ServiceClientFactory que contiene las propiedades de conexión.
    • Crear un CredentialServiceClient usando su constructor y pasando el objeto ServiceClientFactory objeto.

  3. Hacer referencia a la credencial

    • Crear un java.io.FileInputStream mediante su constructor. Pase un valor de cadena que especifique la ubicación de la credencial.
    • Crear un com.adobe.idp.Document que almacena la credencial utilizando el objeto com.adobe.idp.Document constructor. Pase el java.io.FileInputStream que contiene la credencial al constructor.

  4. Realice la operación de importación

    • Cree una matriz de cadenas que contenga un elemento. Asignar el valor truststore.usage.type.sign al elemento.

    • Invoque el CredentialServiceClient del objeto importCredential y pasar los siguientes valores:

      • Valor de cadena que especifica el valor de alias de la credencial.
      • El com.adobe.idp.Document instancia que almacena las credenciales.
      • Valor de cadena que especifica la contraseña asociada a la credencial.
      • Matriz de cadenas que contiene el valor de uso. Por ejemplo, puede especificar este valor truststore.usage.type.sign. Para importar una credencial de extensión de Reader, especifique truststore.usage.type.lcre.

Consulte también

Importación de credenciales mediante la API de Trust Manager

Inicio rápido (modo SOAP): Importación de credenciales mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Eliminación de credenciales mediante la API de Administrador de confianza

Puede eliminar una credencial mediante programación utilizando la API de Administrador de confianza. Al eliminar una credencial, debe especificar un alias que corresponda a la credencial. Una vez eliminada, no se puede utilizar una credencial para realizar una operación.

NOTA

No puede eliminar una credencial en AEM Forms mediante servicios web.

Resumen de los pasos

Para eliminar una credencial, realice los siguientes pasos:

  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio de credenciales.
  3. Realice la operación de eliminación.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Los siguientes archivos JAR deben añadirse a la ruta de clase del proyecto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-truststore-client.jar
  • adobe-utilities.jar (obligatorio si AEM Forms está implementado en JBoss)
  • jbossall-client.jar (requerido si AEM Forms está implementado en JBoss)

Para obtener información sobre la ubicación de estos archivos JAR, consulte Incluir archivos de biblioteca Java de AEM Forms.

Crear un cliente de servicio de credenciales

Para poder eliminar una credencial mediante programación, cree un cliente del servicio de integración de datos. Al crear un cliente de servicios, define la configuración de conexión necesaria para invocar un servicio. Para obtener más información, consulte Estableciendo propiedades de conexión.

Realice la operación de eliminación

Para eliminar una credencial, especifique el alias que corresponda a la credencial. Si especifica un alias que no existe, se produce una excepción.

Consulte también

Importar credenciales mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Importar credenciales mediante la API de Java

Eliminación de credenciales mediante la API de Java

Eliminar una credencial de AEM Forms mediante la API de Administrador de confianza (Java):

  1. Incluir archivos de proyecto

    Incluya archivos JAR de cliente, como adobe-truststore-client.jar, en la ruta de clase del proyecto Java.

  2. Crear un cliente de servicio de credenciales

    • Crear un ServiceClientFactory que contiene las propiedades de conexión.
    • Crear un CredentialServiceClient usando su constructor y pasando el objeto ServiceClientFactory objeto.

  3. Realice la operación de eliminación

    Invoque el CredentialServiceClient del objeto deleteCredential y pasan un valor de cadena que especifica el valor del alias.

Consulte también

Eliminación de credenciales mediante la API de Administrador de confianza

Inicio rápido (modo SOAP): Eliminación de credenciales mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

En esta página