Show Menu
TEMAS×

Trabajar con credenciales

Acerca del servicio de credenciales
Las credenciales contienen 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:
  • Las extensiones de Acrobat Reader DC utilizan una credencial para activar los derechos de uso de Adobe Reader en documentos PDF. (Consulte Aplicación de derechos de uso a documentos PDF).
  • El servicio Signature accede a certificados y credenciales mientras realiza operaciones como la firma digital de documentos PDF. (Consulte Firma digital de documentos PDF).
Puede interactuar mediante programación con el servicio de credenciales mediante la API de Java del Administrador de confianza. Puede realizar las siguientes tareas:
También puede importar y eliminar certificados mediante la consola de administración. (Consulte la ayuda de administración. )

Importación de credenciales mediante la API del Administrador de confianza

Puede importar mediante programación una credencial en AEM Forms mediante la API del administrador de confianza. Por ejemplo, puede importar las credenciales utilizadas para firmar un documento PDF. (Consulte Firma digital de documentos 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 una credencial. 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 seguro .
No se pueden importar credenciales en AEM Forms mediante servicios web.

Resumen de los pasos

Para importar una credencial en AEM Forms, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio de credenciales.
  3. Haga referencia a las credenciales.
  4. Realice la operación de importación.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Se deben agregar los siguientes archivos JAR a la ruta de clases del proyecto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-trust-store-client.jar
  • adobe-utilities.jar (obligatorio si AEM Forms se implementa en JBoss)
  • jbossall-client.jar (obligatorio si AEM Forms se implementa en JBoss)
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de 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 Configuración de propiedades de conexión.
Hacer referencia a las credenciales
Haga referencia a una credencial que desee importar en AEM Forms. El inicio rápido asociado con esta sección hace referencia a un archivo P12 ubicado en el sistema de archivos.
Realizar la operación de importación
Después de hacer referencia a las credenciales, importe las credenciales en AEM Forms. Si la credencial no se importa correctamente, se genera una excepción. Al importar una credencial, se especifica un alias para la credencial.
Consulte también

Importar credenciales mediante la API de Java

Importar una credencial en AEM Forms mediante la API del administrador de confianza (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-trust-store.jar, en la ruta de clases del proyecto Java.
  2. Crear un cliente de servicio de credenciales
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un CredentialServiceClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Hacer referencia a las credenciales
    • Cree un java.io.FileInputStream objeto con su constructor. Pase un valor de cadena que especifique la ubicación de la credencial.
    • Cree un com.adobe.idp.Document objeto que almacene las credenciales mediante el com.adobe.idp.Document constructor. Pase el java.io.FileInputStream objeto que contiene la credencial al constructor.
  4. Realizar la operación de importación
    • Cree una matriz de cadenas que contenga un elemento. Asigne el valor truststore.usage.type.sign al elemento.
    • Invoque el CredentialServiceClient método del importCredential objeto y pase los valores siguientes:
      • Un valor de cadena que especifica el valor de alias de la credencial.
      • La com.adobe.idp.Document instancia que almacena las credenciales.
      • Un 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 Reader Extension, especifique truststore.usage.type.lcre .
Consulte también

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

Puede eliminar mediante programación una credencial mediante la API del Administrador de confianza. Al eliminar una credencial, se especifica un alias que corresponde a la credencial. Una vez eliminadas, las credenciales no se pueden utilizar para realizar una operación.
No puede eliminar una credencial en AEM Forms mediante servicios web.

Resumen de los pasos

Para eliminar una credencial, lleve a cabo 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 va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Se deben agregar los siguientes archivos JAR a la ruta de clases del proyecto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-trust-store-client.jar
  • adobe-utilities.jar (obligatorio si AEM Forms se implementa en JBoss)
  • jbossall-client.jar (obligatorio si AEM Forms se implementa en JBoss)
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un cliente de servicio de credenciales
Antes de poder eliminar mediante programación una credencial, cree un cliente del servicio de integración de datos. Al crear un cliente de servicio, se define la configuración de conexión necesaria para invocar un servicio. Para obtener más información, consulte Configuración de propiedades de conexión.
Realizar la operación de eliminación
Para eliminar una credencial, especifique el alias que corresponde a la credencial. Si especifica un alias que no existe, se genera una excepción.
Consulte también

Eliminación de credenciales mediante la API de Java

Elimine una credencial de AEM Forms mediante la API del administrador de confianza (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-trust-store.jar, en la ruta de clases del proyecto Java.
  2. Crear un cliente de servicio de credenciales
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un CredentialServiceClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Realizar la operación de eliminación
    Invoque el CredentialServiceClient método del deleteCredential objeto y pase un valor de cadena que especifique el valor de alias.
Consulte también