Acerca del servicio de cifrado
El servicio Encryption permite cifrar y descifrar documentos. Cuando se cifra un documento, su contenido se vuelve ilegible. Un usuario autorizado puede descifrar el documento para obtener acceso al contenido. Si un documento PDF está cifrado con una contraseña, el usuario debe especificar la contraseña de apertura antes de que el documento se pueda ver en Adobe Reader o Adobe Acrobat. Del mismo modo, si un documento PDF está cifrado con un certificado, el usuario debe descifrar el documento PDF con la clave pública correspondiente al certificado (clave privada) que se utilizó para codificar el documento PDF.
Puede realizar estas tareas mediante el servicio de cifrado:
Codificar un documento PDF con una contraseña. (Consulte Codificación de documentos PDF con una contraseña).
Codificar un documento PDF con un certificado. (Consulte Codificación de documentos PDF con certificados).
Elimine el cifrado basado en contraseña de un documento PDF. (Consulte Eliminación del cifrado de contraseña).
Elimine el cifrado basado en certificados de un documento PDF. (Consulte Eliminación del cifrado basado en certificados).
Desbloquee el documento PDF para que se puedan realizar otras operaciones de servicio. Por ejemplo, después de desbloquear un documento PDF con contraseña cifrada, puede aplicarle una firma digital. (Consulte Desbloqueo de documentos PDF cifrados).
Determine el tipo de cifrado de un documento PDF protegido. (Consulte Determinación del tipo de codificación).
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Cuando se cifra un documento PDF con contraseña, el usuario debe especificar la contraseña para abrir el documento PDF en Adobe Reader o Acrobat. Además, antes de que se pueda realizar otra operación de AEM Forms, como firmar digitalmente el documento PDF, un documento PDF con contraseña cifrada debe desbloquearse.
Si carga un documento PDF cifrado en el repositorio de AEM Forms, no podrá descifrar el documento PDF ni extraer el contenido XDP. Se recomienda no cifrar un documento antes de cargarlo en el repositorio de AEM Forms. (Consulte Escritura de recursos).
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Para codificar un documento PDF con una contraseña, realice los siguientes pasos:
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 agregarse a la ruta de clase del proyecto:
Creación de un objeto de API de cliente de cifrado
Para realizar una operación de servicio de cifrado mediante programación, debe crear un cliente de servicio de cifrado.
Obtener un documento PDF para codificar
Debe obtener un documento PDF sin encriptar para codificar el documento con una contraseña. Si intenta proteger un documento PDF que ya está cifrado, provocará una excepción.
Establecer opciones de tiempo de ejecución de cifrado
Para codificar un documento PDF con contraseña, debe especificar cuatro valores, incluidos dos valores de contraseña. El primer valor de contraseña se utiliza para codificar el documento PDF y debe especificarse al abrir el documento PDF. El segundo valor de contraseña, denominado el valor de la contraseña maestra, se utiliza para eliminar el cifrado del documento PDF. Los valores de contraseña distinguen entre mayúsculas y minúsculas y estos dos valores de contraseña no pueden ser los mismos.
Debe especificar los recursos del documento PDF que desea codificar. Puede cifrar todo el documento PDF, todo menos los metadatos del documento o solo los archivos adjuntos del documento. Si sólo cifra los archivos adjuntos del documento, se solicita al usuario una contraseña cuando intente acceder a los archivos adjuntos.
Al cifrar un documento PDF, puede especificar los permisos asociados al documento protegido. Si especifica permisos, puede controlar las acciones que puede realizar un usuario que abre un documento PDF con contraseña cifrada. Por ejemplo, para extraer correctamente los datos del formulario, debe definir los siguientes permisos:
Los permisos se especifican como valores de enumeración PasswordEncryptionPermission
.
Agregar la contraseña
Después de recuperar un documento PDF no protegido y establecer valores de tiempo de ejecución de cifrado, puede agregar una contraseña al documento PDF.
Guardar el documento PDF cifrado como un archivo PDF
Puede guardar el documento PDF cifrado con contraseña como un archivo PDF.
Consulte también
Codificación de un documento PDF mediante la API de Java
Codificación de un documento PDF mediante la API de servicio Web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inicio rápido de la API del servicio de cifrado
Codificación de documentos PDF con certificados
Cifrar un documento PDF con una contraseña utilizando la API de cifrado (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-encryption-client.jar, en la ruta de clase de su proyecto Java.
Cree una API de cliente de cifrado.
ServiceClientFactory
que contenga propiedades de conexión.EncryptionServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Obtenga un documento PDF para cifrar.
java.io.FileInputStream
que represente el documento PDF que va a codificar utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Establezca las opciones de tiempo de ejecución del cifrado.
PasswordEncryptionOptionSpec
invocando su constructor.PasswordEncryptionOptionSpec
del objeto setEncryptOption
y pasando un valor de enumeración PasswordEncryptionOption
que especifica los recursos del documento que se van a cifrar. Por ejemplo, para cifrar todo el documento PDF, incluidos sus metadatos y sus archivos adjuntos, especifique PasswordEncryptionOption.ALL
.java.util.List
que almacene los permisos de codificación utilizando el constructor ArrayList
.java.util.List
del objeto ‘s add
y pasando un valor de enumeración que corresponda al permiso que desea establecer. Por ejemplo, para establecer el permiso que permite a un usuario copiar datos ubicados en el documento PDF, especifique PasswordEncryptionPermission.PASSWORD_EDIT_COPY
. (Repita este paso para cada permiso que desee establecer).PasswordEncryptionOptionSpec
del objeto setCompatability
y pasando un valor de enumeración que especifica el nivel de compatibilidad con Acrobat. Por ejemplo, puede especificar PasswordEncryptionCompatability.ACRO_7
.PasswordEncryptionOptionSpec
del objeto setDocumentOpenPassword
y pasando un valor de cadena que representa la contraseña abierta.PasswordEncryptionOptionSpec
del objeto setPermissionPassword
y pasando un valor de cadena que represente la contraseña maestra.Agregue la contraseña.
Codifique el documento PDF invocando el método EncryptionServiceClient
del objeto encryptPDFUsingPassword
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF que se va a codificar con la contraseña.PasswordEncryptionOptionSpec
que contiene opciones de tiempo de ejecución de cifrado.El método encryptPDFUsingPassword
devuelve un objeto com.adobe.idp.Document
que contiene un documento PDF con contraseña cifrada.
Guarde el documento PDF cifrado como archivo PDF.
java.io.File
y asegúrese de que la extensión del archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto com.adobe.idp.Document
en el archivo. Asegúrese de utilizar el objeto com.adobe.idp.Document
que el método encryptPDFUsingPassword
devolvió.Consulte también
Inicio rápido (modo SOAP): Codificación de un documento PDF mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Cifre un documento PDF con una contraseña utilizando la API de cifrado (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un objeto de API de cliente de cifrado.
Cree un objeto EncryptionServiceClient
utilizando su constructor predeterminado.
Cree un objeto EncryptionServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/EncryptionService?WSDL
). No es necesario utilizar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo EncryptionServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Obtenga un documento PDF para cifrar.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF cifrado con una contraseña.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF que desea cifrar y el modo en que desea abrir el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando el contenido de la matriz de bytes al miembro de datos MTOM
del objeto BLOB
.Establezca las opciones de tiempo de ejecución del cifrado.
PasswordEncryptionOptionSpec
utilizando su constructor.PasswordEncryptionOption
al miembro de datos PasswordEncryptionOptionSpec
del objeto encryptOption
. Para cifrar todo el PDF, incluidos sus metadatos y sus archivos adjuntos, asigne PasswordEncryptionOption.ALL
a este miembro de datos.PasswordEncryptionCompatability
al miembro de datos PasswordEncryptionOptionSpec
del objeto compatability
. Por ejemplo, asigne PasswordEncryptionCompatability.ACRO_7
a este miembro de datos.PasswordEncryptionOptionSpec
del objeto documentOpenPassword
.PasswordEncryptionOptionSpec
del objeto permissionPassword
.Agregue la contraseña.
Codifique el documento PDF invocando el método EncryptionServiceClient
del objeto encryptPDFUsingPassword
y pasando los siguientes valores:
BLOB
que contiene el documento PDF que se va a codificar con la contraseña.PasswordEncryptionOptionSpec
que contiene opciones de tiempo de ejecución de cifrado.El método encryptPDFUsingPassword
devuelve un objeto BLOB
que contiene un documento PDF con contraseña cifrada.
Guarde el documento PDF cifrado como archivo PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF protegido.BLOB
que el método encryptPDFUsingPassword
devolvió. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
El cifrado basado en certificados permite cifrar un documento para destinatarios específicos mediante tecnología de clave pública. Se pueden otorgar a varios destinatarios diferentes permisos para el documento. Muchos aspectos del cifrado son posibles gracias a la tecnología de claves públicas. Un algoritmo se utiliza para generar dos números grandes, conocidos como keys, que tienen las siguientes propiedades:
Una de las claves actúa como clave privada de un usuario. Es importante que solo el usuario tenga acceso a esta clave. La otra clave es la clave pública del usuario, que se puede compartir con otros usuarios.
Un certificado de clave pública contiene la clave pública y la información de identificación del usuario. El formato X.509 se utiliza para almacenar certificados. Los certificados suelen ser emitidos y firmados digitalmente por una autoridad de certificación (CA), que es una entidad reconocida que proporciona una medida de confianza en la validez del certificado. Los certificados tienen una fecha de caducidad tras la cual ya no son válidos. Además, las listas de revocación de certificados (CRL) proporcionan información sobre los certificados revocados antes de su fecha de caducidad. Las listas CRL se publican periódicamente por las autoridades certificadoras. El estado de revocación de un certificado también se puede recuperar mediante el Protocolo de estado de certificado en línea (OCSP) a través de la red.
Si carga un documento PDF cifrado en el repositorio de AEM Forms, no podrá descifrar el documento PDF ni extraer el contenido XDP. Se recomienda no cifrar un documento antes de cargarlo en el repositorio de AEM Forms. (Consulte Escritura de recursos).
Para poder cifrar un documento PDF con un certificado, debe asegurarse de agregar el certificado a AEM Forms. Se agrega un certificado mediante la consola de administración o mediante programación mediante la API del administrador de confianza. (Consulte Importación de credenciales mediante la API del administrador de confianza).
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Para codificar un documento PDF con un certificado, realice los siguientes pasos:
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 agregarse a la ruta de clase del proyecto:
Creación de un objeto de API de cliente de cifrado
Para realizar una operación de servicio de cifrado mediante programación, debe crear un cliente de servicio de cifrado. Si utiliza la API del servicio de cifrado de Java, cree un objeto EncrytionServiceClient
. Si utiliza la API del servicio de cifrado de servicio web, cree un objeto EncryptionServiceService
.
Obtener un documento PDF para codificar
Debe obtener un documento PDF no cifrado para codificarlo. Si intenta proteger un documento PDF que ya está cifrado, se genera una excepción.
Referencia al certificado
Para codificar un documento PDF con un certificado, haga referencia a un certificado que se utilice para codificar un documento PDF. El certificado es un archivo .cer, un archivo .crt o un archivo .pem. Se utiliza un archivo PKCS#12 para almacenar claves privadas con los certificados correspondientes.
Al cifrar un documento PDF con un certificado, especifique los permisos asociados al documento protegido. Si especifica permisos, puede controlar las acciones que puede realizar un usuario que abra un documento PDF cifrado con certificado.
Establecer opciones de tiempo de ejecución de cifrado
Especifique los recursos del documento PDF que desea codificar. Puede cifrar todo el documento PDF, todo menos los metadatos del documento o solo los archivos adjuntos del documento.
Creación de un documento PDF cifrado por certificado
Después de recuperar un documento PDF no protegido, hacer referencia al certificado y establecer las opciones de tiempo de ejecución, puede crear un documento PDF cifrado con certificado. Una vez cifrado el documento PDF, se necesita la clave pública correspondiente para descifrarlo.
Guardar el documento PDF cifrado como un archivo PDF
Puede guardar el documento PDF cifrado como un archivo PDF.
Consulte también
Codificación de un documento PDF con un certificado mediante la API de Java
Codificación de un documento PDF con un certificado mediante la API de servicio web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inicio rápido de la API del servicio de cifrado
Codificación de documentos PDF con contraseña
Cifrar un documento PDF con un certificado mediante la API de cifrado (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-encryption-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de API de cliente de cifrado.
ServiceClientFactory
que contenga propiedades de conexión.EncryptionServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Obtenga un documento PDF para cifrar.
java.io.FileInputStream
que represente el documento PDF que va a codificar utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Haga referencia al certificado.
java.util.List
que almacene información de permisos usando su constructor.java.util.List
del objeto add
y pasando un valor de enumeración CertificateEncryptionPermissions
que representa los permisos otorgados al usuario que abre el documento PDF protegido. Por ejemplo, para especificar todos los permisos, pase CertificateEncryptionPermissions.PKI_ALL_PERM
.Recipient
utilizando su constructor.java.io.FileInputStream
que represente el certificado que se utiliza para cifrar el documento PDF utilizando su constructor y pasando un valor de cadena que especifique la ubicación del certificado.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
que representa el certificado.Recipient
del objeto setX509Cert
y pase el objeto com.adobe.idp.Document
que contiene el certificado. (Además, el objeto Recipient
puede tener un alias de certificado Truststore o una URL LDAP como origen de certificado).CertificateEncryptionIdentity
que almacene información de permisos y certificados usando su constructor.CertificateEncryptionIdentity
del objeto setPerms
y pase el objeto java.util.List
que almacena la información de permisos.CertificateEncryptionIdentity
del objeto setRecipient
y pase el objeto Recipient
que almacena la información del certificado.java.util.List
que almacene información de certificado usando su constructor.java.util.List
y pase el objeto CertificateEncryptionIdentity
. (Este objeto java.util.List
se pasa como parámetro al método encryptPDFUsingCertificates
).Establezca las opciones de tiempo de ejecución del cifrado.
CertificateEncryptionOptionSpec
invocando su constructor.CertificateEncryptionOptionSpec
del objeto setOption
y pasando un valor de enumeración CertificateEncryptionOption
que especifica los recursos del documento que se van a cifrar. Por ejemplo, para cifrar todo el documento PDF, incluidos sus metadatos y sus archivos adjuntos, especifique CertificateEncryptionOption.ALL
.CertificateEncryptionOptionSpec
del objeto setCompat
y pasando un valor de enumeración CertificateEncryptionCompatibility
que especifica el nivel de compatibilidad con Acrobat. Por ejemplo, puede especificar CertificateEncryptionCompatibility.ACRO_7
.Cree un documento PDF con cifrado de certificado.
Codifique el documento PDF con un certificado invocando el método EncryptionServiceClient
del objeto encryptPDFUsingCertificates
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF que se va a codificar.java.util.List
que almacena información del certificado.CertificateEncryptionOptionSpec
que contiene opciones de tiempo de ejecución de cifrado.El método encryptPDFUsingCertificates
devuelve un objeto com.adobe.idp.Document
que contiene un documento PDF cifrado por certificado.
Guarde el documento PDF cifrado como archivo PDF.
java.io.File
y asegúrese de que la extensión del nombre del archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto com.adobe.idp.Document
en el archivo. Asegúrese de utilizar el objeto com.adobe.idp.Document
que el método encryptPDFUsingCertificates
devolvió.Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Codificar un documento PDF con un certificado mediante la API de codificación (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un objeto de API de cliente de cifrado.
Cree un objeto EncryptionServiceClient
utilizando su constructor predeterminado.
Cree un objeto EncryptionServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/EncryptionService?WSDL
). No es necesario utilizar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo EncryptionServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Obtenga un documento PDF para cifrar.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF cifrado con un certificado.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF que desea cifrar y el modo en que desea abrir el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando su propiedad MTOM
con el contenido de la matriz de bytes.Haga referencia al certificado.
Recipient
utilizando su constructor. Este objeto almacenará información de certificado.BLOB
utilizando su constructor. Este objeto BLOB
almacenará el certificado que codifica el documento PDF.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del certificado y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando el contenido de la matriz de bytes al miembro de datos MTOM
del objeto BLOB
.BLOB
que almacena el certificado al miembro de datos Recipient
del objeto x509Cert
.CertificateEncryptionIdentity
que almacene información de certificado usando su constructor.Recipient
que almacena el certificado al miembro de datos del destinatario del objeto CertificateEncryptionIdentity
.Object
y asigne el objeto CertificateEncryptionIdentity
al primer elemento de la matriz Object
. Esta matriz Object
se pasa como parámetro al método encryptPDFUsingCertificates
.Establezca las opciones de tiempo de ejecución del cifrado.
CertificateEncryptionOptionSpec
utilizando su constructor.CertificateEncryptionOption
al miembro de datos CertificateEncryptionOptionSpec
del objeto option
. Para cifrar todo el documento PDF, incluidos sus metadatos y sus archivos adjuntos, asigne CertificateEncryptionOption.ALL
a este miembro de datos.CertificateEncryptionCompatibility
al miembro de datos CertificateEncryptionOptionSpec
del objeto compat
. Por ejemplo, asigne CertificateEncryptionCompatibility.ACRO_7
a este miembro de datos.Cree un documento PDF con cifrado de certificado.
Codifique el documento PDF con un certificado invocando el método EncryptionServiceService
del objeto encryptPDFUsingCertificates
y pasando los siguientes valores:
BLOB
que contiene el documento PDF que se va a codificar.Object
que almacena información de certificado.CertificateEncryptionOptionSpec
que contiene opciones de tiempo de ejecución de cifrado.El método encryptPDFUsingCertificates
devuelve un objeto BLOB
que contiene un documento PDF cifrado por certificado.
Guarde el documento PDF cifrado como archivo PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF protegido.BLOB
que el método encryptPDFUsingCertificates
devolvió. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto binaryData
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
El cifrado basado en certificados se puede eliminar de un documento PDF para que los usuarios puedan abrir el documento PDF en Adobe Reader o Acrobat. Para eliminar el cifrado de un documento PDF cifrado con un certificado, se debe hacer referencia a una clave pública. Una vez eliminado el cifrado de un documento PDF, ya no es seguro.
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Para eliminar el cifrado basado en certificados de un documento PDF, realice los siguientes pasos:
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 agregarse a la ruta de clase del proyecto:
Crear un cliente de servicio de cifrado
Para realizar una operación de servicio de cifrado mediante programación, debe crear un cliente de servicio de cifrado. Si utiliza la API del servicio de cifrado de Java, cree un objeto EncrytionServiceClient
. Si utiliza la API del servicio de cifrado de servicio web, cree un objeto EncryptionServiceService
.
Obtener el documento PDF cifrado
Debe obtener un documento PDF cifrado para eliminar el cifrado basado en certificados. Si intenta eliminar el cifrado de un documento PDF que no está cifrado, se genera una excepción. Del mismo modo, si intenta eliminar el cifrado basado en certificados de un documento cifrado con contraseña, se genera una excepción.
Eliminar cifrado
Para eliminar el cifrado basado en certificados de un documento PDF cifrado, se requiere un documento PDF cifrado y la clave privada que corresponda a la clave utilizada para codificar el documento PDF. El valor de alias de la clave privada se especifica al quitar el cifrado basado en certificado de un documento PDF cifrado. Para obtener información sobre la clave pública, consulte Codificación de documentos PDF con certificados.
Se almacena una clave privada en el almacén de confianza de AEM Forms. Cuando se coloca un certificado allí, se especifica un valor de alias.
Guardar el documento PDF
Una vez eliminado el cifrado basado en certificados de un documento PDF cifrado, puede guardar el documento PDF como archivo PDF. Los usuarios pueden abrir el documento PDF en Adobe Reader o Acrobat.
Consulte también
Eliminación del cifrado basado en certificados mediante la API de Java
Eliminación del cifrado basado en certificados mediante la API de servicio web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inicio rápido de la API del servicio de cifrado
Elimine el cifrado basado en certificados de un documento PDF mediante la API de cifrado (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-encryption-client.jar, en la ruta de clase de su proyecto Java.
Cree un cliente de servicio de cifrado.
ServiceClientFactory
que contenga propiedades de conexión.EncryptionServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Obtenga el documento PDF cifrado.
java.io.FileInputStream
que represente el documento PDF cifrado empleando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF cifrado.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Elimine el cifrado.
Elimine el cifrado basado en certificados del documento PDF invocando el método EncryptionServiceClient
del objeto removePDFCertificateSecurity
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF cifrado.El método removePDFCertificateSecurity
devuelve un objeto com.adobe.idp.Document
que contiene un documento PDF no protegido.
Guarde el documento PDF.
java.io.File
y asegúrese de que la extensión del archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo. Asegúrese de utilizar el objeto com.adobe.idp.Document
que el método removePDFCredentialSecurity
devolvió.Consulte también
Inicio rápido (modo SOAP): Eliminación del cifrado basado en certificados mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Elimine el cifrado basado en certificados mediante la API de cifrado (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un cliente de servicio de cifrado.
Cree un objeto EncryptionServiceClient
utilizando su constructor predeterminado.
Cree un objeto EncryptionServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/EncryptionService?WSDL
). No es necesario utilizar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo EncryptionServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Obtenga el documento PDF cifrado.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar el documento PDF cifrado.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF cifrado y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando el contenido de la matriz de bytes al miembro de datos MTOM
del objeto BLOB
.Elimine el cifrado.
Invoque el método EncryptionServiceClient
del objeto removePDFCertificateSecurity
y pase los siguientes valores:
BLOB
que contiene datos de flujo de archivos que representan un documento PDF cifrado.El método removePDFCredentialSecurity
devuelve un objeto BLOB
que contiene un documento PDF no protegido.
Guarde el documento PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF no protegido.BLOB
que el método removePDFPasswordSecurity
devolvió. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
El cifrado basado en contraseña se puede eliminar de un documento PDF para que los usuarios puedan abrir el documento PDF en Adobe Reader o Acrobat sin tener que especificar una contraseña. Después de eliminar el cifrado basado en contraseña de un documento PDF, el documento ya no es seguro.
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Para eliminar el cifrado basado en contraseña de un documento PDF, realice los siguientes pasos:
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 agregarse a la ruta de clase del proyecto:
Crear un cliente de servicio de cifrado
Para realizar una operación de servicio de cifrado mediante programación, debe crear un cliente de servicio de cifrado. Si utiliza la API del servicio de cifrado de Java, cree un objeto EncrytionServiceClient
. Si utiliza la API del servicio de cifrado de servicio web, cree un objeto EncryptionServiceService
.
Obtener el documento PDF cifrado
Debe obtener un documento PDF cifrado para eliminar el cifrado basado en contraseña. Si intenta eliminar el cifrado de un documento PDF que no está cifrado, se genera una excepción.
Quitar la contraseña
Para eliminar el cifrado basado en contraseña de un documento PDF cifrado, se requiere un documento PDF cifrado y un valor de contraseña principal que se utilicen para eliminar el cifrado del documento PDF. La contraseña utilizada para abrir un documento PDF con contraseña cifrada no se puede utilizar para eliminar el cifrado. Se especifica una contraseña maestra cuando el documento PDF está cifrado con una contraseña. (Consulte Codificación de documentos PDF con una contraseña).
Guardar el documento PDF
Una vez que el servicio de cifrado elimina el cifrado basado en contraseña de un documento PDF, puede guardar el documento PDF como archivo PDF. Los usuarios pueden abrir el documento PDF en Adobe Reader o Acrobat sin especificar una contraseña.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inicio rápido de la API del servicio de cifrado
Codificación de documentos PDF con contraseña
Elimine el cifrado basado en contraseña de un documento PDF mediante la API de cifrado (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-encryption-client.jar, en la ruta de clase de su proyecto Java.
Cree un cliente de servicio de cifrado.
ServiceClientFactory
que contenga propiedades de conexión.EncryptionServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Obtenga el documento PDF cifrado.
java.io.FileInputStream
que represente el documento PDF cifrado empleando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Elimine la contraseña.
Elimine el cifrado basado en contraseña del documento PDF invocando el método EncryptionServiceClient
del objeto removePDFPasswordSecurity
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF cifrado.El método removePDFPasswordSecurity
devuelve un objeto com.adobe.idp.Document
que contiene un documento PDF no protegido.
Guarde el documento PDF.
java.io.File
y asegúrese de que la extensión del nombre del archivo sea .pdf.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo. Asegúrese de utilizar el objeto Document
que el método removePDFPasswordSecurity
devolvió.Consulte también
Inicio rápido (modo SOAP): Eliminación del cifrado basado en contraseña mediante la API de Java
Elimine el cifrado basado en contraseña mediante la API de cifrado (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un cliente de servicio de cifrado.
Cree un objeto EncryptionServiceClient
utilizando su constructor predeterminado.
Cree un objeto EncryptionServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/EncryptionService?WSDL
). No es necesario utilizar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo EncryptionServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Obtenga el documento PDF cifrado.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF cifrado con contraseña.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF cifrado y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando el contenido de la matriz de bytes al miembro de datos MTOM
del objeto BLOB
.Elimine la contraseña.
Invoque el método EncryptionServiceService
del objeto removePDFPasswordSecurity
y pase los siguientes valores:
BLOB
que contiene datos de flujo de archivos que representan un documento PDF cifrado.El método removePDFPasswordSecurity
devuelve un objeto BLOB
que contiene un documento PDF no protegido.
Guarde el documento PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF no protegido.BLOB
que el método removePDFPasswordSecurity
devolvió. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Un documento PDF cifrado con contraseña o con cifrado de certificado debe desbloquearse antes de poder realizar otra operación de AEM Forms en él. Si intenta realizar una operación en un documento PDF cifrado, generará una excepción. Después de desbloquear un documento PDF cifrado, puede realizar una o más operaciones en él. Estas operaciones pueden pertenecer a otros servicios, como el servicio de extensiones de Acrobat Reader DC.
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Para desbloquear un documento PDF cifrado, realice los siguientes pasos:
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 agregarse a la ruta de clase del proyecto:
Crear un cliente de servicio de cifrado
Para realizar una operación de servicio de cifrado mediante programación, debe crear un cliente de servicio de cifrado. Si utiliza la API del servicio de cifrado de Java, cree un objeto EncrytionServiceClient
. Si utiliza la API del servicio de cifrado de servicio web, cree un objeto EncryptionServiceService
.
Obtener el documento PDF cifrado
Debe obtener un documento PDF cifrado para desbloquearlo. Si intenta desbloquear un documento PDF que no está cifrado, se genera una excepción.
Desbloquear el documento
Para desbloquear un documento PDF con contraseña cifrada, se requiere un documento PDF cifrado y un valor de contraseña que se utilicen para abrir un documento PDF con contraseña cifrada. Este valor se especifica al codificar el documento PDF con una contraseña. (Consulte Codificación de documentos PDF con una contraseña).
Para desbloquear un documento PDF con cifrado de certificado, se requiere un documento PDF cifrado y el valor de alias de la clave pública correspondiente a la clave privada que se utilizó para codificar el documento PDF.
Realizar una operación de AEM Forms
Una vez desbloqueado un documento PDF cifrado, puede realizar otra operación de servicio, como aplicarle derechos de uso. Esta operación pertenece al servicio Acrobat Reader DC Extensions.
Consulte también
Desbloquear un documento PDF cifrado mediante la API de Java
Desbloquear un documento PDF cifrado mediante la API de servicio Web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inicio rápido de la API del servicio de cifrado
Desbloquee un documento PDF cifrado mediante la API de cifrado (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-encryption-client.jar, en la ruta de clase de su proyecto Java.
Cree un cliente de servicio de cifrado.
ServiceClientFactory
que contenga propiedades de conexión.EncryptionServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Obtenga el documento PDF cifrado.
java.io.FileInputStream
que represente el documento PDF cifrado empleando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF cifrado.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Desbloquee el documento.
Desbloquee un documento PDF cifrado invocando el método EncryptionServiceClient
o unlockPDFUsingCredential
del objeto unlockPDFUsingPassword
.
Para desbloquear un documento PDF cifrado con una contraseña, invoque el método unlockPDFUsingPassword
y pase los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF cifrado con contraseña.Para desbloquear un documento PDF cifrado con un certificado, invoque el método unlockPDFUsingCredential
y pase los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF cifrado con certificado.Los métodos unlockPDFUsingPassword
y unlockPDFUsingCredential
devuelven un objeto com.adobe.idp.Document
que se pasa a otro método Java de AEM Forms para realizar una operación.
Realice una operación AEM Forms.
Realice una operación de AEM Forms en el documento PDF desbloqueado para satisfacer los requisitos empresariales. Por ejemplo, suponiendo que desea aplicar derechos de uso a un documento PDF desbloqueado, pase el objeto com.adobe.idp.Document
que devolvieron los métodos unlockPDFUsingPassword
o unlockPDFUsingCredential
al método ReaderExtensionsServiceClient
del objeto applyUsageRights
.
Consulte también
Inicio rápido (modo SOAP): Desbloqueo de un documento PDF cifrado mediante la API de Java (modo SOAP)
Aplicación de derechos de uso a documentos PDF
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Desbloquee un documento PDF cifrado mediante la API de cifrado (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un cliente de servicio de cifrado.
Cree un objeto EncryptionServiceClient
utilizando su constructor predeterminado.
Cree un objeto EncryptionServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/EncryptionService?WSDL
). No es necesario utilizar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo EncryptionServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Obtenga un documento PDF cifrado.
BLOB
utilizando su constructor.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF cifrado y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando el contenido de la matriz de bytes al miembro de datos MTOM
del objeto BLOB
.Desbloquee el documento.
Desbloquee un documento PDF cifrado invocando el método EncryptionServiceClient
o unlockPDFUsingCredential
del objeto unlockPDFUsingPassword
.
Para desbloquear un documento PDF cifrado con una contraseña, invoque el método unlockPDFUsingPassword
y pase los siguientes valores:
BLOB
que contiene el documento PDF cifrado con contraseña.Para desbloquear un documento PDF cifrado con un certificado, invoque el método unlockPDFUsingCredential
y pase los siguientes valores:
BLOB
que contiene el documento PDF cifrado con certificado.Los métodos unlockPDFUsingPassword
y unlockPDFUsingCredential
devuelven un objeto com.adobe.idp.Document
que se pasa a otro método de AEM Forms para realizar una operación.
Realice una operación AEM Forms.
Realice una operación de AEM Forms en el documento PDF desbloqueado para satisfacer los requisitos empresariales. Por ejemplo, suponiendo que desea aplicar derechos de uso al documento PDF desbloqueado, pase el objeto BLOB
que devolvieron los métodos unlockPDFUsingPassword
o unlockPDFUsingCredential
al método ReaderExtensionsServiceClient
del objeto applyUsageRights
.
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Puede determinar mediante programación el tipo de cifrado que protege un documento PDF mediante la API del servicio de cifrado de Java o la API del servicio de cifrado de servicio Web. A veces es necesario determinar dinámicamente si un documento PDF está cifrado y, en caso afirmativo, el tipo de codificación. Por ejemplo, puede determinar si un documento PDF está protegido con cifrado basado en contraseña o con una directiva de Rights Management.
Un documento PDF puede estar protegido por los siguientes tipos de codificación:
Para obtener más información sobre el servicio de cifrado, consulte Referencia de servicios para AEM Forms.
Para determinar el tipo de cifrado que protege un documento PDF, realice los siguientes pasos:
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 agregarse a la ruta de clase del proyecto:
Crear un cliente de servicio
Para realizar una operación de servicio de cifrado mediante programación, debe crear un cliente de servicio de cifrado. Si utiliza la API del servicio de cifrado de Java, cree un objeto EncrytionServiceClient
. Si utiliza la API del servicio de cifrado de servicio web, cree un objeto EncryptionServiceService
.
Obtener el documento PDF cifrado
Debe obtener un documento PDF para determinar el tipo de cifrado que lo protege.
Determinar el tipo de codificación
Puede determinar el tipo de codificación que protege un documento PDF. Si el documento PDF no está protegido, el servicio Encryption le informa de que el documento PDF no está protegido.
Consulte también
Determinar el tipo de cifrado mediante la API de Java
Determinar el tipo de cifrado mediante la API de servicio web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inicio rápido de la API del servicio de cifrado
Protección de documentos con directivas
Determine el tipo de cifrado que protege un documento PDF mediante la API de cifrado (Java):
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-encryption-client.jar, en la ruta de clase de su proyecto Java.
Cree un cliente de servicio.
ServiceClientFactory
que contenga propiedades de conexión.EncryptionServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Obtenga el documento PDF cifrado.
java.io.FileInputStream
que represente el documento PDF utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Determine el tipo de cifrado.
EncryptionServiceClient
del objeto getPDFEncryption
y pasando el objeto com.adobe.idp.Document
que contiene el documento PDF. Este método devuelve un objeto EncryptionTypeResult
.EncryptionTypeResult
del objeto getEncryptionType
. Este método devuelve un valor de enumeración EncryptionType
que especifica el tipo de cifrado. Por ejemplo, si el documento PDF está protegido con cifrado basado en contraseña, este método devuelve EncryptionType.PASSWORD
.Consulte también
Inicio rápido (modo SOAP): Determinación del tipo de cifrado mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Determine el tipo de cifrado que protege un documento PDF mediante la API de cifrado (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/EncryptionService?WSDL&lc_version=9.0.1
.
Sustituya localhost
por la dirección IP del servidor que hospeda AEM Forms.
Cree un cliente de servicio.
Cree un objeto EncryptionServiceClient
utilizando su constructor predeterminado.
Cree un objeto EncryptionServiceClient.Endpoint.Address
utilizando el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/EncryptionService?WSDL
). No es necesario utilizar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo EncryptionServiceClient.Endpoint.Binding
. Establezca el valor devuelto en BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
EncryptionServiceClient.ClientCredentials.UserName.UserName
.EncryptionServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Obtenga el documento PDF cifrado.
BLOB
utilizando su constructor.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF cifrado y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando el contenido de la matriz de bytes al miembro de datos MTOM
del objeto BLOB
.Determine el tipo de cifrado.
EncryptionServiceClient
del objeto getPDFEncryption
y pase el objeto BLOB
que contiene el documento PDF. Este método devuelve un objeto EncryptionTypeResult
.EncryptionTypeResult
del objeto encryptionType
. Por ejemplo, si el documento PDF está protegido con cifrado basado en contraseña, el valor de este miembro de datos es EncryptionType.PASSWORD
.Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef