Proteger documentos mediante directivas protecting-documents-with-policies
Las muestras y los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
Acerca del servicio Document Security
El servicio Document Security permite a los usuarios aplicar dinámicamente la configuración de confidencialidad a los documentos de Adobe PDF y mantener el control sobre los documentos, independientemente de su distribución.
El servicio Document Security evita que la información se propague más allá del alcance del usuario, ya que permite a los usuarios mantener el control sobre cómo utilizan los destinatarios el documento de PDF protegido por políticas. Un usuario puede especificar quién puede abrir un documento, limitar cómo puede utilizarlo y supervisar el documento después de distribuirlo. Un usuario también puede controlar dinámicamente el acceso a un documento protegido por políticas e incluso puede revocar dinámicamente el acceso al documento.
El servicio Document Security también protege otros tipos de archivo, como archivos de Microsoft Word (archivos DOC). Puede utilizar la API de cliente de Document Security para trabajar con estos tipos de archivos. Se admiten las siguientes versiones:
- Archivos de Microsoft Office 2003 (archivos DOC, XLS, PPT)
- Archivos de Microsoft Office 2007 (archivos DOCX, XLSX, PPTX)
- Archivos de PTC Pro/E
Para mayor claridad, las dos secciones siguientes tratan sobre cómo trabajar con documentos de Word:
Puede realizar estas tareas mediante el servicio Document Security:
- Crear directivas. Para obtener más información, consulte Creación de directivas.
- Modificar directivas. Para obtener más información, consulte Modificar directivas.
- Eliminar directivas. Para obtener más información, consulte Eliminación de directivas.
- Aplicar directivas a documentos de PDF. Para obtener más información, vea Aplicar directivas a documentos de PDF.
- Quitar directivas de documentos de PDF. Para obtener más información, consulte Quitar directivas de los documentos del PDF.
- Documentos protegidos por directivas de Inspect. Para obtener más información, consulte Inspección de documentos de PDF protegidos por directivas.
- Revocar acceso a documentos de PDF. Para obtener más información, vea Revocar acceso a documentos.
- Restablecer el acceso a los documentos revocados. Para obtener más información, consulte Restablecer el acceso a documentos revocados.
- Crear marcas de agua. Para obtener más información, consulte Creación de marcas de agua.
- Buscar eventos. Para obtener más información, consulte Búsqueda de eventos.
Creación de directivas creating-policies
Puede crear directivas mediante programación utilizando la API de Java de Document Security o la API del servicio web. Una directiva es una colección de información que incluye la configuración de seguridad de documentos, usuarios autorizados y derechos de uso. Puede crear y guardar cualquier número de directivas, utilizando la configuración de seguridad adecuada para diferentes situaciones y usuarios.
Las directivas permiten realizar estas tareas:
- Especifique las personas que pueden abrir el documento. Los destinatarios pueden pertenecer a su organización o ser externos a ella.
- Especifique cómo pueden utilizar el documento los destinatarios. Puede restringir el acceso a diferentes funciones de Acrobat y Adobe Reader. Estas características incluyen la capacidad de imprimir y copiar texto, agregar firmas y agregar comentarios a un documento.
- Cambie la configuración de acceso y seguridad en cualquier momento, incluso después de distribuir el documento protegido por una directiva.
- Supervise el uso del documento después de distribuirlo. Puede ver cómo se utiliza el documento y quién lo utiliza. Por ejemplo, puede averiguar cuándo alguien ha abierto el documento.
Creación de una directiva mediante servicios web creating-a-policy-using-web-services
Al crear una directiva mediante la API del servicio web, haga referencia a un archivo XML del lenguaje de derechos de documentos portátiles (PDRL) existente que describa la directiva. Los permisos de directiva y el principal se definen en el documento PDRL. El siguiente documento XML es un ejemplo de documento PDRL.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
<PolicyEntry>
<ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>all_internal_users</PrincipalName>
</Principal>
</PolicyEntry>
<PolicyEntry>
<ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
<ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
<ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>publisher</PrincipalName>
</Principal>
</PolicyEntry>
<OfflineLeasePeriod>
<Duration>P31D</Duration>
</OfflineLeasePeriod>
<AuditSettings isTracked="true" />
<PolicyValidityPeriod isAbsoluteTime="false">
<ValidityPeriodRelative>
<NotBeforeRelative>PT0S</NotBeforeRelative>
<NotAfterRelative>P20D</NotAfterRelative>
</ValidityPeriodRelative>
</PolicyValidityPeriod>
</Policy>
Resumen de los pasos summary-of-steps
Para crear una directiva, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Establezca los atributos de la directiva.
- Crear una entrada de directiva.
- Registre la directiva.
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:
- adobe-rightsmanagement-client.jar
- namespace.jar (si AEM Forms está implementado en JBoss)
- jaxb-api.jar (si AEM Forms está implementado en JBoss)
- jaxb-impl.jar (si AEM Forms está implementado en JBoss)
- jaxb-libs.jar (si AEM Forms está implementado en JBoss)
- jaxb-xjc.jar (si AEM Forms está implementado en JBoss)
- refreshDatatype.jar (si AEM Forms está implementado en JBoss)
- xsdlib.jar (si AEM Forms está implementado en JBoss)
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar
- jbossall-client.jar (utilice un archivo JAR diferente si AEM Forms no está implementado 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 objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, cree un objeto de cliente del servicio Document Security.
Establecer los atributos de la directiva
Para crear una directiva, establezca los atributos de la directiva. Un atributo obligatorio es el nombre de la política. Los nombres de las directivas deben ser únicos para cada conjunto de directivas. Un conjunto de directivas es simplemente una colección de directivas. Puede haber dos directivas con el mismo nombre si pertenecen a conjuntos de directivas independientes. Sin embargo, dos directivas dentro de un único conjunto de directivas no pueden tener el mismo nombre de directiva.
Otro atributo útil que se debe establecer es el periodo de validez. Un período de validez es el período de tiempo durante el cual un documento protegido por una directiva es accesible para los destinatarios autorizados. Si no establece este atributo, la directiva siempre es válida.
Un periodo de validez se puede establecer en una de estas opciones:
- Se establece el número de días durante los cuales se puede acceder al documento desde el momento en que se publica
- Una fecha final tras la cual no se puede acceder al documento
- Un intervalo de fechas específico para el que se puede acceder al documento
- Siempre válido
Puede especificar simplemente una fecha de inicio, lo que hace que la directiva sea válida después de la fecha de inicio. Si especifica solamente una fecha de finalización, la directiva es válida hasta la fecha de finalización. Sin embargo, se produce una excepción si no se definen una fecha de inicio y una fecha de finalización.
Al establecer atributos que pertenecen a una directiva, también puede establecer la configuración de cifrado. Esta configuración de cifrado se aplica cuando la directiva se aplica a un documento. Puede especificar los siguientes valores de cifrado:
- AES256: representa el algoritmo de cifrado AES con una clave de 256 bits.
- AES128: representa el algoritmo de cifrado AES con una clave de 128 bits.
- NoEncryption: no representa ningún cifrado.
Al especificar la opción NoEncryption
, no puede establecer la opción PlaintextMetadata
en false
. Si intenta hacerlo, se produce una excepción.
Policy
en la Referencia de la API de AEM Forms.Crear una entrada de directiva
Una entrada de directiva adjunta entidades principales, que son grupos y usuarios, y permisos a una directiva. Una directiva debe tener al menos una entrada de directiva. Supongamos, por ejemplo, que realiza estas tareas:
- Cree y registre una entrada de directiva que permita a un grupo ver un documento únicamente mientras está en línea y que prohíba a los destinatarios copiarlo.
- Adjunte la entrada de directiva a la directiva.
- Proteja un documento con la directiva mediante Acrobat.
Estas acciones hacen que los destinatarios solo puedan ver el documento en línea y no puedan copiarlo. El documento permanecerá seguro hasta que se quite la seguridad del mismo.
Registrar la directiva
Se debe registrar una nueva directiva para poder utilizarla. Después de registrar una directiva, puede utilizarla para proteger documentos.
Creación de una política con la API de Java create-a-policy-using-the-java-api
Cree una directiva mediante la API de seguridad de los documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Establezca los atributos de la directiva.
- Cree un objeto
Policy
invocando el métodocreatePolicy
estático del objetoInfomodelObjectFactory
. Este método devuelve un objetoPolicy
. - Establezca el atributo name de la directiva invocando el método
setName
del objetoPolicy
y pasando un valor de cadena que especifique el nombre de la directiva. - Establezca la descripción de la directiva invocando el método
setDescription
del objetoPolicy
y pasando un valor de cadena que especifica la descripción de la directiva. - Especifique el conjunto de directivas al que pertenece la nueva directiva invocando el método
setPolicySetName
del objetoPolicy
y pasando un valor de cadena que especifica el nombre del conjunto de directivas. (Puede especificarnull
para este valor de parámetro que hace que la directiva se agregue al conjunto de directivas Mis directivas). - Cree el período de validez de la directiva invocando el método
createValidityPeriod
estático del objetoInfomodelObjectFactory
. Este método devuelve un objetoValidityPeriod
. - Establezca el número de días durante los cuales se puede obtener acceso a un documento protegido por una directiva invocando el método
setRelativeExpirationDays
del objetoValidityPeriod
y pasando un valor entero que especifique el número de días. - Establezca el período de validez de la directiva invocando el método
setValidityPeriod
del objetoPolicy
y pasando el objetoValidityPeriod
.
- Cree un objeto
-
Crear una entrada de directiva.
- Cree una entrada de directiva invocando el método
createPolicyEntry
estático del objetoInfomodelObjectFactory
. Este método devuelve un objetoPolicyEntry
. - Especifique los permisos de la directiva invocando el método
createPermission
estático del objetoInfomodelObjectFactory
. Pase un miembro de datos estáticos que pertenezca a la interfazPermission
que representa el permiso. Este método devuelve un objetoPermission
. Por ejemplo, para agregar el permiso que permite a los usuarios copiar datos de un documento de PDF protegido por una directiva, pasePermission.COPY
. (Repita este paso para cada permiso que desee agregar). - Agregue el permiso a la entrada de directiva invocando el método
addPermission
del objetoPolicyEntry
y pasando el objetoPermission
. (Repita este paso para cada objetoPermission
que haya creado). - Cree la entidad de seguridad de directiva invocando el método
createSpecialPrincipal
estático del objetoInfomodelObjectFactory
. Pase un miembro de datos que pertenezca al objetoInfomodelObjectFactory
que representa el principal. Este método devuelve un objetoPrincipal
. Por ejemplo, para agregar al editor del documento como principal, paseInfomodelObjectFactory.PUBLISHER_PRINCIPAL
. - Agregue el principal a la entrada de directiva invocando el método
setPrincipal
del objetoPolicyEntry
y pasando el objetoPrincipal
. - Agregue la entrada de directiva a la directiva invocando el método
addPolicyEntry
del objetoPolicy
y pasando el objetoPolicyEntry
.
- Cree una entrada de directiva invocando el método
-
Registre la directiva.
-
Cree un objeto
PolicyManager
invocando el métodogetPolicyManager
del objetoDocumentSecurityClient
. -
Registre la directiva invocando el método
registerPolicy
del objetoPolicyManager
y pasando los siguientes valores:- El objeto
Policy
que representa la directiva que se va a registrar.
- El objeto
-
Valor de cadena que representa el conjunto de directivas al que pertenece la directiva.
AEM Si usa una cuenta de administrador de formularios de la cuenta de usuario en la configuración de conexión para crear el objeto
DocumentSecurityClient
, especifique el nombre del conjunto de directivas cuando invoque el métodoregisterPolicy
. Si pasa un valornull
para el conjunto de directivas, la directiva se crea en el conjunto de directivas Mis directivas de los administradores.Si utiliza un usuario de Document Security en la configuración de conexión, puede invocar el método
registerPolicy
sobrecargado que solo acepta la directiva. Es decir, no es necesario especificar el nombre del conjunto de directivas. Sin embargo, la directiva se agrega al conjunto de directivas denominado Mis directivas. Si no desea agregar la nueva directiva a este conjunto de directivas, especifique un nombre de conjunto de directivas cuando invoque el métodoregisterPolicy
.note note NOTE Al crear una directiva, haga referencia a un conjunto de directivas existente. Si especifica un conjunto de directivas que no existe, se produce una excepción. -
Para ver ejemplos de código utilizando el servicio Document Security, consulte lo siguiente:
- SOAP "Inicio rápido (modo de): Creación de una directiva mediante la API de Java"
Creación de una directiva mediante la API de servicio web create-a-policy-using-the-web-service-api
Cree una directiva mediante la API de seguridad de los documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DocumentSecurityServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Establezca los atributos de la directiva.
- Crear un objeto
PolicySpec
mediante su constructor. - Establezca el nombre de la directiva asignando un valor de cadena al miembro de datos
name
del objetoPolicySpec
. - Establezca la descripción de la directiva asignando un valor de cadena al miembro de datos
description
del objetoPolicySpec
. - Especifique el conjunto de directivas al que pertenece la directiva asignando un valor de cadena al miembro de datos
policySetName
del objetoPolicySpec
. Especifique un nombre de conjunto de directivas existente. (Puede especificarnull
para este valor de parámetro, lo que hace que la directiva se agregue a Mis directivas.) - Establezca el período de concesión sin conexión de la directiva asignando un valor entero al miembro de datos
offlineLeasePeriod
del objetoPolicySpec
. - Establezca el miembro de datos
policyXml
del objetoPolicySpec
con un valor de cadena que represente los datos XML de PDRL. Para realizar esta tarea, cree un objetoStreamReader
de .NET mediante su constructor. Pase la ubicación de un archivo XML de PDRL que represente la directiva al constructorStreamReader
. A continuación, invoque el métodoReadLine
del objetoStreamReader
y asigne el valor devuelto a una variable de cadena. Recorra en iteración el objetoStreamReader
hasta que el métodoReadLine
devuelva un valor nulo. Asigne la variable de cadena al miembro de datospolicyXml
del objetoPolicySpec
.
- Crear un objeto
-
Crear una entrada de directiva.
No es necesario crear una entrada de directiva al crear una directiva mediante la API del servicio web de Document Security. La entrada de directiva se define en el documento PDRL.
-
Registre la directiva.
Registre la directiva invocando el método
registerPolicy
del objetoDocumentSecurityServiceClient
y pasando los siguientes valores:- El objeto
PolicySpec
que representa la directiva que se va a registrar. - Valor de cadena que representa el conjunto de directivas al que pertenece la directiva. Puede especificar un valor
null
que haga que la directiva se agregue al conjunto de directivas MyPolices.
AEM Si usa una cuenta de administrador de formularios de la cuenta de usuario en la configuración de conexión para crear el objeto
DocumentSecurityClient
, especifique el nombre del conjunto de directivas cuando invoque el métodoregisterPolicy
.Si utiliza un usuario de Document SecurityDocument Security en la configuración de conexión, puede invocar el método
registerPolicy
sobrecargado que solo acepta la directiva. Es decir, no es necesario especificar el nombre del conjunto de directivas. Sin embargo, la directiva se agrega al conjunto de directivas denominado Mis directivas. Si no desea agregar la nueva directiva a este conjunto de directivas, especifique un nombre de conjunto de directivas cuando invoque el métodoregisterPolicy
.note note NOTE Al crear una directiva y especificar un conjunto de directivas, asegúrese de especificar un conjunto de directivas existente. Si especifica un conjunto de directivas que no existe, se produce una excepción. - El objeto
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Creación de una directiva mediante la API de servicio web"
- "Inicio rápido (SwaRef): Creación de una directiva mediante la API de servicio web"
Modificación de directivas modifying-policies
Puede modificar una directiva existente mediante la API de Java de Document Security o la API del servicio web. Para cambiar una directiva existente, puede recuperarla, modificarla y, a continuación, actualizar la directiva en el servidor. Por ejemplo, supongamos que recupera una política existente y amplía su periodo de validez. Antes de que el cambio surta efecto, debe actualizar la directiva.
Puede modificar una política cuando cambien los requisitos de la empresa y la política ya no refleje estos requisitos. En lugar de crear una política, simplemente puede actualizar una política existente.
Para modificar atributos de directiva mediante un servicio web (por ejemplo, mediante clases de proxy Java creadas con JAX-WS), debe asegurarse de que la directiva esté registrada en el servicio Document Security. A continuación, puede hacer referencia a la directiva existente mediante el método PolicySpec.getPolicyXml
y modificar los atributos de la directiva mediante los métodos aplicables. Por ejemplo, puede modificar el período de concesión sin conexión invocando el método PolicySpec.setOfflineLeasePeriod
.
Resumen de los pasos summary_of_steps-1
Para modificar una directiva existente, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recuperar una directiva existente.
- Cambiar directivas y atributos.
- Actualice la directiva.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto RightsManagementClient
. Si utiliza la API del servicio web de Document Security, cree un objeto RightsManagementServiceService
.
Recuperar una directiva existente
Recupere una directiva existente para modificarla. Para recuperar una directiva, especifique el nombre de la directiva y el conjunto de directivas al que pertenece. Si especifica un valor null
para el nombre del conjunto de directivas, la directiva se recupera del conjunto de directivas Mis directivas.
Establecer los atributos de la directiva
Para modificar una directiva, modifique el valor de sus atributos. El único atributo de directiva que no se puede cambiar es el atributo de nombre. Por ejemplo, para cambiar el período de concesión sin conexión de la política, puede modificar el valor del atributo de período de concesión sin conexión de la política.
Al modificar el período de concesión sin conexión de una directiva mediante un servicio web, se omite el campo offlineLeasePeriod
en la interfaz PolicySpec
. Para actualizar el período de concesión sin conexión, modifique el elemento OfflineLeasePeriod
en el documento XML PDRL. A continuación, haga referencia al documento XML PDRL actualizado mediante el miembro de datos policyXML
de la interfaz PolicySpec
.
Policy
en la Referencia de la API de AEM Forms.Actualizar la directiva
Antes de que los cambios que realice en una directiva surtan efecto, debe actualizar la directiva con el servicio Document Security. Los cambios en las directivas que protegen documentos se actualizan la próxima vez que el documento protegido por directivas se sincronice con el servicio Document Security.
Modificación de directivas existentes mediante la API de Java modify-existing-policies-using-the-java-api
Modifique una directiva existente mediante la API de seguridad de los documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
RightsManagementClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recuperar una directiva existente.
-
Cree un objeto
PolicyManager
invocando el métodogetPolicyManager
del objetoRightsManagementClient
. -
Cree un objeto
Policy
que represente la directiva que se va a actualizar invocando el métodogetPolicy
del objetoPolicyManager
y pasando los siguientes valores"- Valor de cadena que representa el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
de modo que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que representa el nombre de la directiva.
- Valor de cadena que representa el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
-
-
Establezca los atributos de la directiva.
Cambie los atributos de la póliza para satisfacer sus necesidades comerciales. Por ejemplo, para cambiar el período de concesión sin conexión de la directiva, invoque el método
setOfflineLeasePeriod
del objetoPolicy
. -
Actualice la directiva.
Actualice la directiva invocando el método
updatePolicy
del objetoPolicyManager
. Pase el objetoPolicy
que representa la directiva que desea actualizar.
Ejemplos de código
SOAP Para obtener ejemplos de código utilizando el servicio Document Security, consulte la sección Inicio rápido (modo de): Modificación de una directiva mediante la API de Java.
Modificar directivas existentes mediante la API de servicio web modify-existing-policies-using-the-web-service-api
Modifique una directiva existente mediante la API de seguridad de los documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
RightsManagementServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperar una directiva existente.
Cree un objeto
PolicySpec
que represente la directiva que se va a modificar invocando el métodogetPolicy
del objetoRightsManagementServiceClient
y pasando los siguientes valores:- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
de modo que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
-
Establezca los atributos de la directiva.
Cambie los atributos de la póliza para satisfacer sus necesidades comerciales.
-
Actualice la directiva.
Actualice la directiva invocando el método
updatePolicyFromSDK
del objetoRightsManagementServiceClient
y pasando el objetoPolicySpec
que representa la directiva que desea actualizar.
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Modificar una directiva mediante la API de servicio web"
- "Inicio rápido (SwaRef): Modificación de una directiva mediante la API de servicio web"
Eliminación de directivas deleting-policies
Puede eliminar una política existente mediante la API de Java de Document Security o la API del servicio web. Una vez eliminada una directiva, ya no se puede utilizar para proteger documentos. Sin embargo, los documentos protegidos por directivas existentes que utilizan la directiva siguen protegidos. Puede eliminar una directiva cuando haya una más reciente disponible.
Resumen de los pasos summary_of_steps-2
Para eliminar una directiva existente, realice los siguientes pasos:
- Incluir archivos de proyecto
- Cree un objeto de la API de cliente de Document Security.
- Elimine la directiva.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto RightsManagementClient
. Si utiliza la API del servicio web de Document Security, cree un objeto RightsManagementServiceService
.
Eliminar la directiva
Para eliminar una directiva, especifique la directiva que desea eliminar y el conjunto de directivas al que pertenece. El usuario cuya configuración se utilice para invocar AEM Forms debe tener permiso para eliminar la directiva; de lo contrario, se produce una excepción. Del mismo modo, si intenta eliminar una directiva que no existe, se produce una excepción.
Eliminación de directivas mediante la API de Java delete-policies-using-the-java-api
Eliminar una directiva mediante la API de Document Security (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
RightsManagementClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Elimine la directiva.
-
Cree un objeto
PolicyManager
invocando el métodogetPolicyManager
del objetoRightsManagementClient
. -
Elimine la directiva invocando el método
deletePolicy
del objetoPolicyManager
y pasando los siguientes valores:- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
de modo que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva que se va a eliminar.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
-
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (modo de): Eliminación de una directiva mediante la API de Java"
Eliminar directivas mediante la API de servicio web delete-policies-using-the-web-service-api
Eliminar una directiva mediante la API de Document Security (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
RightsManagementServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Elimine la directiva.
Elimine una directiva invocando el método
deletePolicy
del objetoRightsManagementServiceClient
y pasando los siguientes valores:- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
de modo que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva que se va a eliminar.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Eliminación de una directiva mediante la API del servicio web"
- "Inicio rápido (SwaRef): Eliminación de una directiva mediante la API del servicio web"
Aplicación de directivas a documentos de PDF applying-policies-to-pdf-documents
Puede aplicar una directiva a un documento de PDF para proteger el documento. Al aplicar una directiva a un documento de PDF, se restringe el acceso al documento. No puede aplicar una directiva a un documento si éste ya está protegido con una directiva.
Mientras el documento esté abierto, también puede restringir el acceso a las funciones de Acrobat y Adobe Reader, incluida la capacidad de imprimir y copiar texto, realizar cambios y agregar firmas y comentarios a un documento. Además, puede revocar un documento de PDF protegido por una directiva cuando ya no desee que los usuarios accedan al documento.
Puede monitorizar el uso de un documento protegido por políticas después de distribuirlo. Es decir, puede ver cómo se utiliza el documento y quién lo está utilizando. Por ejemplo, puede averiguar cuándo alguien ha abierto el documento.
Resumen de los pasos summary_of_steps-3
Para aplicar una directiva a un documento de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recupere un documento de PDF al que se aplique una directiva.
- Aplicar una directiva existente al documento de PDF.
- Guarde el documento de PDF protegido por una directiva.
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.
Crear un objeto API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, cree un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto DocumentSecurityClient
. Si utiliza la API del servicio web de Document Security, cree un objeto DocumentSecurityServiceService
.
Recuperar un documento de PDF
Puede recuperar un documento de PDF para aplicar una directiva. Después de aplicar una directiva al documento de PDF, los usuarios están restringidos al utilizar el documento. Por ejemplo, si la directiva no permite abrir el documento sin conexión, los usuarios deben estar en línea para abrirlo.
Aplicar una directiva existente al documento del PDF
Para aplicar una directiva a un documento de PDF, haga referencia a una directiva existente y especifique a qué conjunto de directivas pertenece la directiva. El usuario que configura las propiedades de conexión debe tener acceso a la directiva especificada. Si no es así, se produce una excepción.
Guardar el documento del PDF
Una vez que el servicio Document Security aplica una directiva a un documento de PDF, puede guardar el documento de PDF protegido por una directiva como archivo de PDF.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Aplicación de una directiva a un documento de PDF mediante la API de Java apply-a-policy-to-a-pdf-document-using-the-java-api
Aplicar una directiva a un documento de PDF mediante la API de Document Security (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
RightsManagementClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere un documento de PDF.
- Cree un objeto
java.io.FileInputStream
que represente el documento del PDF mediante su constructor. Pase un valor de cadena que especifique la ubicación del documento del PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Aplicar una directiva existente al documento de PDF.
-
Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoRightsManagementClient
. -
Aplique una directiva al documento de PDF invocando el método
protectDocument
del objetoDocumentManager
y pasando los siguientes valores:- El objeto
com.adobe.idp.Document
que contiene el documento de PDF al que se aplica la directiva. - Valor de cadena que especifica el nombre del documento.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un valor
null
que haga que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva.
- Valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser nulo).
- Valor de cadena que representa el nombre canónico del usuario administrador de usuarios que es el editor del documento. Este valor de parámetro es opcional y puede ser
null
(si este parámetro es nulo, el valor del parámetro anterior debe sernull
). com.adobe.livecycle.rightsmanagement.Locale
que representa la configuración regional utilizada para seleccionar la plantilla de MS Office. Este valor de parámetro es opcional y no se utiliza para documentos de PDF. Para proteger un documento de PDF, especifiquenull
.
El método
protectDocument
devuelve un objetoRMSecureDocumentResult
que contiene el documento de PDF protegido por una directiva. - El objeto
-
-
Guarde el documento del PDF.
- Invoque el método
getProtectedDoc
del objetoRMSecureDocumentResult
para obtener el documento de PDF protegido por directivas. Este método devuelve un objetocom.adobe.idp.Document
. - Cree un objeto
java.io.File
y asegúrese de que la extensión de archivo sea PDF. - Invoque el método
copyToFile
del objetocom.adobe.idp.Document
para copiar el contenido del objetoDocument
en el archivo (asegúrese de utilizar el objetoDocument
devuelto por el métodogetProtectedDoc
).
- Invoque el método
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (modo EJB): Aplicar una directiva a un documento de PDF mediante la API de Java"
- SOAP "Inicio rápido (modo de): Aplicar una directiva a un documento de PDF mediante la API de Java"
Consulte también
Aplicar una directiva a un documento de PDF mediante la API de servicio web apply-a-policy-to-a-pdf-document-using-the-web-service-api
Aplicar una directiva a un documento de PDF mediante la API de Document Security (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
RightsManagementServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento de PDF.
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar un documento de PDF al que se aplica una directiva. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF y el modo en que se abrirá el archivo. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Determine el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Aplicar una directiva existente al documento de PDF.
Aplique una directiva al documento de PDF invocando el método
protectDocument
del objetoRightsManagementServiceClient
y pasando los siguientes valores:- El objeto
BLOB
que contiene el documento de PDF al que se aplica la directiva. - Valor de cadena que especifica el nombre del documento.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un valor
null
que haga que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva.
- Valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser
null
). - Valor de cadena que representa el nombre canónico del usuario administrador de usuarios que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el valor del parámetro anterior debe ser
null
). - Un valor
RMLocale
que especifica el valor de configuración regional (por ejemplo,RMLocale.en
). - Un parámetro de salida de cadena que se utiliza para almacenar el valor del identificador de directiva.
- Un parámetro de salida de cadena que se utiliza para almacenar el valor del identificador protegido por una directiva.
- Un parámetro de salida de cadena que se usa para almacenar el tipo MIME (por ejemplo,
application/pdf
).
El método
protectDocument
devuelve un objetoBLOB
que contiene el documento de PDF protegido por una directiva. - El objeto
-
Guarde el documento del PDF.
- Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF protegido por una directiva. - Cree una matriz de bytes que almacene el contenido de datos del objeto
BLOB
devuelto por el métodoprotectDocument
. Rellene la matriz de bytes obteniendo el valor del miembro de datosMTOM
del objetoBLOB
. - Cree un objeto
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
. - Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método
Write
del objetoSystem.IO.BinaryWriter
y pasando la matriz de bytes.
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Aplicar una directiva a un documento de PDF mediante la API de servicio web"
- "Inicio rápido (SwaRef): Aplicar una directiva a un documento de PDF mediante la API de servicio web"
Quitar directivas de documentos de PDF removing-policies-from-pdf-documents
Puede quitar una directiva de un documento protegido por una directiva para quitar la seguridad del documento. Es decir, si ya no desea que el documento esté protegido por una directiva. Si desea actualizar un documento protegido por una directiva con una directiva más reciente, en lugar de quitar la directiva y agregar la directiva actualizada, es más eficaz cambiar la directiva.
Resumen de los pasos summary_of_steps-4
Para quitar una directiva de un documento de PDF protegido por una directiva, realice los siguientes pasos:
- Incluir archivos de proyecto
- Cree un objeto de la API de cliente de Document Security.
- Recupere un documento de PDF protegido por una directiva.
- Quite la directiva del documento de PDF.
- Guarde el documento de PDF no protegido.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, cree un objeto de cliente del servicio Document Security.
Recuperar un documento de PDF protegido por una directiva
Puede recuperar un documento de PDF protegido por una directiva para quitar una directiva. Si intenta quitar una directiva de un documento de PDF que no está protegido por una directiva, se producirá una excepción.
Quitar la directiva del documento de PDF
Puede quitar una directiva de un documento de PDF protegido por una directiva siempre que se especifique un administrador en la configuración de conexión. Si no es así, la directiva utilizada para proteger un documento debe contener el permiso SWITCH_POLICY
para quitar una directiva de un documento de PDF. Además, el usuario especificado en la configuración de conexión de AEM Forms también debe tener ese permiso. De lo contrario, se produce una excepción.
Guardar el documento de PDF no protegido
Una vez que el servicio Document Security quita una directiva de un documento de PDF, puede guardar el documento de PDF no protegido como archivo de PDF.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Eliminación de una directiva de un documento de PDF mediante la API de Java remove-a-policy-from-a-pdf-document-using-the-java-api
Elimine una directiva de un documento de PDF protegido por una directiva mediante la API de Document Security (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere un documento de PDF protegido por una directiva.
- Cree un objeto
java.io.FileInputStream
que represente el documento de PDF protegido por directivas utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Quite la directiva del documento de PDF.
- Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoDocumentSecurityClient
. - Quite una directiva del documento de PDF invocando el método
removeSecurity
del objetoDocumentManager
y pasando el objetocom.adobe.idp.Document
que contiene el documento de PDF protegido por directivas. Este método devuelve un objetocom.adobe.idp.Document
que contiene un documento de PDF no protegido.
- Cree un objeto
-
Guarde el documento de PDF no protegido.
- Cree un objeto
java.io.File
y asegúrese de que la extensión de archivo sea PDF. - Invoque el método
copyToFile
del objetoDocument
para copiar el contenido del objetoDocument
en el archivo (asegúrese de utilizar el objetoDocument
devuelto por el métodoremoveSecurity
).
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (modo de): Eliminación de una directiva de un documento de PDF mediante la API de Java"
Eliminación de una directiva mediante la API de servicio web remove-a-policy-using-the-web-service-api
Quitar una directiva de un documento de PDF protegido por una directiva mediante la API de Document Security (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DocumentSecurityServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoDocumentSecurityServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento de PDF protegido por una directiva.
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar el documento de PDF protegido por una directiva del que se quita la directiva. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF y el modo en que se abrirá el archivo. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Quite la directiva del documento de PDF.
Quite la directiva del documento de PDF invocando el método
removePolicySecurity
del objetoDocumentSecurityServiceClient
y pasando el objetoBLOB
que contiene el documento de PDF protegido por directivas. Este método devuelve un objetoBLOB
que contiene un documento de PDF no protegido. -
Guarde el documento de PDF no protegido.
- Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF no protegido. - Cree una matriz de bytes que almacene el contenido de datos del objeto
BLOB
devuelto por el métodoremovePolicySecurity
. Rellene la matriz de bytes obteniendo el valor del campoMTOM
del objetoBLOB
. - Cree un objeto
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
.
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Quitar una directiva de un documento de PDF mediante la API de servicio web"
- "Inicio rápido (SwaRef): eliminación de una directiva de un documento de PDF mediante la API de servicio web"
Consulte también
Revocar acceso a documentos revoking-access-to-documents
Puede revocar el acceso a un documento PDF protegido por una directiva, lo que hace que todas las copias del documento sean inaccesibles para los usuarios. Cuando un usuario intenta abrir un documento de PDF revocado, se le redirige a una URL especificada donde se puede ver un documento revisado. La dirección URL a la que se redirige al usuario debe especificarse mediante programación. Cuando se anula el acceso a un documento, el cambio surte efecto la próxima vez que el usuario se sincronice con el servicio de Document Security abriendo el documento protegido por políticas en línea.
La capacidad de revocar el acceso a un documento proporciona seguridad adicional. Por ejemplo, supongamos que hay disponible una versión más reciente de un documento y que ya no desea que nadie vea la versión obsoleta. En este caso, el acceso al documento anterior se puede revocar y nadie puede ver el documento a menos que se restablezca el acceso.
Resumen de los pasos summary_of_steps-5
Para revocar un documento protegido por una directiva, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recupere un documento de PDF protegido por una directiva.
- Revocar el documento protegido por una directiva.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security.
Recuperar un documento de PDF protegido por una directiva
Recupere un documento de PDF protegido por una directiva para revocarlo. No puede revocar un documento que ya se haya revocado o que no sea un documento protegido por una directiva.
Si conoce el valor del identificador de licencia del documento protegido por una directiva, no es necesario recuperar el documento de PDF protegido por una directiva. Sin embargo, en la mayoría de los casos, debe recuperar el documento del PDF para obtener el valor del identificador de licencia.
Revocar el documento protegido por una directiva
Para revocar un documento protegido por una directiva, especifique el identificador de licencia del documento protegido por una directiva. Además, puede especificar la dirección URL de un documento que el usuario puede ver cuando intenta abrir el documento revocado. Es decir, supongamos que se revoca un documento obsoleto. Cuando un usuario intenta abrir el documento revocado, verá un documento actualizado en lugar del documento revocado.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Revocar acceso a documentos mediante la API de Java revoke-access-to-documents-using-the-java-api
Revocar acceso a un documento de PDF protegido por una directiva mediante la API de Document Security (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Crear un objeto de API de cliente de Document Security
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recuperar un documento de PDF protegido por una directiva
- Cree un objeto
java.io.FileInputStream
que represente el documento de PDF protegido por directivas utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Revocar el documento protegido por una directiva
-
Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoDocumentSecurityClient
. -
Recupere el valor del identificador de licencia del documento protegido por directivas invocando el método
getLicenseId
del objetoDocumentManager
. Pase el objetocom.adobe.idp.Document
que representa el documento protegido por directivas. Este método devuelve un valor de cadena que representa el valor del identificador de licencia. -
Cree un objeto
LicenseManager
invocando el métodogetLicenseManager
del objetoDocumentSecurityClient
. -
Revocar el documento protegido por una directiva invocando el método
revokeLicense
del objetoLicenseManager
y pasando los siguientes valores:- Valor de cadena que especifica el valor del identificador de licencia del documento protegido por una directiva (especifique el valor devuelto del método
getLicenseId
del objetoDocumentManager
). - Un miembro de datos estáticos de la interfaz
License
que especifica el motivo para revocar el documento. Por ejemplo, puede especificarLicense.DOCUMENT_REVISED
. - Un valor
java.net.URL
que especifica la ubicación donde se encuentra un documento revisado. Si no desea redirigir a un usuario a otra dirección URL, puede pasarnull
.
- Valor de cadena que especifica el valor del identificador de licencia del documento protegido por una directiva (especifique el valor devuelto del método
-
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (modo de): Revocar un documento mediante la API de Java"
Revocar acceso a documentos mediante la API de servicio web revoke-access-to-documents-using-the-web-service-api
Revocar acceso a un documento de PDF protegido por una directiva mediante la API de Document Security (servicio web):
-
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Crear un objeto de API de cliente de Document Security
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DocumentSecurityServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoDocumentSecurityServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperar un documento de PDF protegido por una directiva
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar un documento de PDF protegido por una directiva que se ha revocado. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF protegido por una directiva que se va a revocar y el modo en que se va a abrir el archivo. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Revocar el documento protegido por una directiva
-
Recupere el valor del identificador de licencia del documento protegido por directivas invocando el método
getLicenseID
del objetoDocumentSecurityServiceClient
y pasando el objetoBLOB
que representa el documento protegido por directivas. Este método devuelve un valor de cadena que representa el identificador de licencia. -
Revocar el documento protegido por una directiva invocando el método
revokeLicense
del objetoDocumentSecurityServiceClient
y pasando los siguientes valores:- Valor de cadena que especifica el valor del identificador de licencia del documento protegido por una directiva (especifique el valor devuelto del método
getLicenseId
del objetoDocumentSecurityServiceService
). - Un miembro de datos estáticos de la enumeración
Reason
que especifica el motivo para revocar el documento. Por ejemplo, puede especificarReason.DOCUMENT_REVISED
. - Valor de
string
que especifica la ubicación de la dirección URL donde se encuentra un documento revisado. Si no desea redirigir a un usuario a otra dirección URL, puede pasarnull
.
- Valor de cadena que especifica el valor del identificador de licencia del documento protegido por una directiva (especifique el valor devuelto del método
-
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Revocar un documento mediante la API de servicio web"
- "Inicio rápido (SwaRef): Revocar un documento mediante la API de servicio web"
Consulte también
Quitar directivas de documentos de Word
Restablecer el acceso a los documentos revocados reinstating-access-to-revoked-documents
Puede restablecer el acceso a un documento de PDF revocado, lo que hace que todas las copias del documento revocado sean accesibles a los usuarios. Cuando un usuario abre un documento rehabilitado que se ha revocado, puede ver el documento.
Resumen de los pasos summary_of_steps-6
Para restablecer el acceso a un documento de PDF revocado, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recupere el identificador de licencia del documento de PDF revocado.
- Restablezca el acceso al documento de PDF revocado.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto DocumentSecurityClient
. Si utiliza la API del servicio web de Document Security, cree un objeto DocumentSecurityServiceService
.
Recuperar el identificador de licencia del documento de PDF revocado
Recupere el identificador de licencia del documento de PDF revocado para restablecer un documento de PDF revocado. Después de obtener el valor del identificador de licencia, puede restablecer un documento revocado. Si intenta restablecer un documento que no se ha revocado, se producirá una excepción.
Restablecer el acceso al documento de PDF revocado
Para restablecer el acceso a un documento de PDF revocado, debe especificar el identificador de licencia del documento revocado. Si intenta restablecer el acceso a un documento de PDF que no se ha revocado, se producirá una excepción.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Restablecer el acceso a los documentos revocados mediante la API de Java reinstate-access-to-revoked-documents-using-the-java-api
Restablezca el acceso a un documento revocado mediante la API de seguridad de los documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere el identificador de licencia del documento de PDF revocado.
- Cree un objeto
java.io.FileInputStream
que represente el documento de PDF revocado utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
. - Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoDocumentSecurityClient
. - Recupere el valor del identificador de licencia del documento revocado invocando el método
getLicenseId
del objetoDocumentManager
y pasando el objetocom.adobe.idp.Document
que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia.
- Cree un objeto
-
Restablezca el acceso al documento de PDF revocado.
- Cree un objeto
LicenseManager
invocando el métodogetLicenseManager
del objetoDocumentSecurityClient
. - Restablezca el acceso al documento de PDF revocado invocando el método
unrevokeLicense
del objetoLicenseManager
y pasando el valor del identificador de licencia del documento revocado.
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (modo de): Restablecimiento del acceso a un documento revocado mediante la API del servicio web"
Restablecer el acceso a los documentos revocados mediante la API del servicio web reinstate-access-to-revoked-documents-using-the-web-service-api
Restablezca el acceso a un documento revocado mediante la API de seguridad de los documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DocumentSecurityServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoDocumentSecurityServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere el identificador de licencia del documento de PDF revocado.
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar un documento de PDF revocado al que se restablece el acceso. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de PDF revocado y el modo en que se abrirá el archivo. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Restablezca el acceso al documento de PDF revocado.
- Recupere el valor del identificador de licencia del documento revocado invocando el método
getLicenseID
del objetoDocumentSecurityServiceClient
y pasando el objetoBLOB
que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia. - Restablezca el acceso al documento de PDF revocado invocando el método
unrevokeLicense
del objetoDocumentSecurityServiceClient
y pasando un valor de cadena que especifique el valor del identificador de licencia del documento de PDF revocado (pase el valor devuelto del métodogetLicenseId
del objetoDocumentSecurityServiceClient
).
- Recupere el valor del identificador de licencia del documento revocado invocando el método
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Restablecer el acceso a un documento revocado mediante la API de servicio web"
- "Inicio rápido (SwaRef): Restablecer el acceso a un documento revocado mediante la API de servicio web"
Consulte también
Inspección de documentos de PDF protegidos por directivas inspecting-policy-protected-pdf-documents
Puede utilizar la API del servicio de seguridad de los documentos (Java y servicio web) para inspeccionar documentos de PDF protegidos por políticas. La inspección de documentos de PDF protegidos por directivas devuelve información sobre el documento de PDF protegido por directivas. Por ejemplo, puede determinar la directiva que se utilizó para proteger el documento y la fecha en la que se protegió.
No puede realizar esta tarea si la versión del LiveCycle es 8.x o una versión anterior. La compatibilidad con la inspección de documentos protegidos por directivas se agrega en AEM Forms. Si intenta inspeccionar un documento protegido por una directiva mediante el LiveCycle 8.x (o una versión anterior), se genera una excepción.
Resumen de los pasos summary_of_steps-7
Para inspeccionar un documento de PDF protegido por una directiva, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recupere un documento protegido por una directiva para inspeccionarlo.
- Obtenga información sobre el documento protegido por políticas.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, cree un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto RightsManagementClient
. Si utiliza la API del servicio web de Document Security, cree un objeto RightsManagementServiceService
.
Recuperar un documento protegido por una directiva para inspeccionar
Para inspeccionar un documento protegido por una directiva, recupere el documento. Si intenta inspeccionar un documento que no está protegido con una directiva o que está revocado, se produce una excepción.
Inspect el documento
Después de recuperar un documento protegido por una directiva, puede inspeccionarlo.
Obtener información acerca del documento protegido por directivas
Después de inspeccionar un documento de PDF protegido por una directiva, puede obtener información sobre él. Por ejemplo, puede determinar la directiva que se utiliza para proteger el documento.
Si protege un documento con una directiva que pertenece a Mis directivas y luego llama a RMInspectResult.getPolicysetName
o RMInspectResult.getPolicysetId
, se devuelve nulo.
Si el documento está protegido mediante una directiva contenida en un conjunto de directivas (que no sea Mis directivas), RMInspectResult.getPolicysetName
y RMInspectResult.getPolicysetId
devuelven cadenas válidas.
Consulte también
Documentos de PDF protegidos por directivas de Inspect que utilizan la API de Java inspect-policy-protected-pdf-documents-using-the-java-api
Inspect crea un documento de PDF protegido por políticas mediante la API del servicio de seguridad de los documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java. Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. (Consulte Establecimiento de propiedades de conexión.) - Cree un objeto
RightsManagementClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere un documento protegido por una directiva para inspeccionarlo.
- Cree un objeto
java.io.FileInputStream
que represente el documento de PDF protegido por directivas mediante su constructor. Pase un valor de cadena que especifique la ubicación del documento del PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Inspect el documento.
- Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoRightsManagementClient
. - Inspect el documento protegido por directivas invocando el método
inspectDocument
del objetoLicenseManager
. Pase el objetocom.adobe.idp.Document
que contiene el documento de PDF protegido por directivas. Este método devuelve un objetoRMInspectResult
que contiene información sobre el documento protegido por una directiva.
- Cree un objeto
-
Obtenga información sobre el documento protegido por políticas.
Para obtener información acerca del documento protegido por una directiva, invoque el método apropiado que pertenece al objeto
RMInspectResult
. Por ejemplo, para recuperar el nombre de directiva, invoque el métodogetPolicyName
del objetoRMInspectResult
.
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (modo de): Inspección de documentos de PDF protegidos por directivas mediante la API de Java"
Documentos de PDF protegidos por directivas de Inspect que utilizan la API de servicio web inspect-policy-protected-pdf-documents-using-the-web-service-api
Inspect crea un documento de PDF protegido por políticas mediante la API del servicio de seguridad de los documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
RightsManagementServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento protegido por una directiva para inspeccionarlo.
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar un documento de PDF para inspeccionar. - Cree un objeto
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento de PDF y el modo para abrir el archivo en. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
. Pase la matriz de bytes, la posición inicial y la longitud de la secuencia a leer. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Inspect el documento.
Inspect el documento protegido por directivas invocando el método
inspectDocument
del objetoRightsManagementServiceClient
. Pase el objetoBLOB
que contiene el documento de PDF protegido por directivas. Este método devuelve un objetoRMInspectResult
que contiene información sobre el documento protegido por una directiva. -
Obtenga información sobre el documento protegido por políticas.
Para obtener información acerca del documento protegido por una directiva, obtenga el valor del campo correspondiente que pertenece al objeto
RMInspectResult
. Por ejemplo, para recuperar el nombre de la directiva, obtenga el valor del campopolicyName
del objetoRMInspectResult
.
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Inspección de documentos de PDF protegidos por directivas mediante la API del servicio web"
- "Inicio rápido (SwaRef): Inspección de documentos de PDF protegidos por directivas mediante la API del servicio web"
Consulte también
Creación de marcas de agua creating-watermarks
Las marcas de agua ayudan a garantizar la seguridad de un documento al identificarlo de forma única y controlar la infracción de derechos de autor. Por ejemplo, puede crear y colocar una marca de agua que indique Confidencial en todas las páginas de un documento. Una vez creada una marca de agua, puede incluirla como parte de una directiva. Es decir, puede establecer el atributo de marca de agua de la directiva con la marca de agua recién creada. Después de aplicar a un documento una directiva que contiene una marca de agua, esta aparece en el documento protegido por una directiva.
Resumen de los pasos summary_of_steps-8
Para crear una marca de agua, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Establezca los atributos de marcas de agua.
- Registre la marca de agua con el servicio Document Security.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto RightsManagementClient
. Si utiliza la API del servicio web de Document Security, cree un objeto RightsManagementServiceService
.
Establecer los atributos de marcas de agua
Para crear una marca de agua, debe establecer los atributos de la marca de agua. El atributo name siempre debe estar definido. Además del atributo name, debe establecer al menos uno de los atributos siguientes:
- Texto personalizado
- DateIncluded
- UserIdIncluded
- UserNameIncluded
En la tabla siguiente se enumeran los pares de clave y valor necesarios al crear una marca de agua mediante servicios web.
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
WaterBackCmd:SRCTEXT
.WaterBackCmd:OPACITY
WaterBackCmd:ROTATION
WaterBackCmd:SCALE
WaterBackCmd:IS_SIZE_ENABLED
debe estar presente y el valor debe ser verdadero. Si no se especifica este atributo, el comportamiento predeterminado se ajusta a la página.WaterBackCmd:HORIZ_ALIGN
WaterBackCmd:VERT_ALIGN
WaterBackCmd:IS_USE_BACKGROUND
WaterBackCmd:IS_SIZE_ENABLED
WaterBackCmd:SRCTEXT
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
también debe estar presente y debe establecerse como verdadero.Todas las marcas de agua deben tener uno de los atributos siguientes definidos:
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Todos los demás atributos son opcionales.
Registrar la marca de agua
Se debe registrar una nueva marca de agua con el servicio Document Security para poder utilizarla. Después de registrar una marca de agua, puede utilizarla dentro de las directivas.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Creación de marcas de agua mediante la API de Java create-watermarks-using-the-java-api
Crear una marca de agua mediante la API de seguridad de los documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como
adobe-rightsmanagement-client.jar
, en la ruta de clase del proyecto Java. -
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
RightsManagementClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Definir los atributos de filigrana
- Cree un objeto
Watermark
invocando el métodocreateWatermark
estático del objetoInfomodelObjectFactory
. Este método devuelve un objetoWatermark
. - Establezca el atributo name de la marca de agua invocando el método
setName
del objetoWatermark
y pasando un valor de cadena que especifique el nombre de la directiva. - Establezca el atributo background de la marca de agua invocando el método
setBackground
del objetoWatermark
y pasandotrue
. Al establecer este atributo, la marca de agua aparece en segundo plano del documento. - Establezca el atributo de texto personalizado de la marca de agua invocando el método
setCustomText
del objetoWatermark
y pasando un valor de cadena que represente el texto de la marca de agua. - Establezca el atributo opacity de la marca de agua invocando el método
setOpacity
del objetoWatermark
y pasando un valor entero que especifique el nivel de opacidad. El valor 100 indica que la marca de agua es completamente opaca y el valor 0 indica que es completamente transparente.
- Cree un objeto
-
Registre la marca de agua.
- Cree un objeto
WatermarkManager
invocando el métodogetWatermarkManager
del objetoRightsManagementClient
. Este método devuelve un objetoWatermarkManager
. - Registre la marca de agua invocando el método
registerWatermark
del objetoWatermarkManager
y pasando el objetoWatermark
que representa la marca de agua que se va a registrar. Este método devuelve un valor de cadena que representa el valor de identificación de la marca de agua.
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (modo de): Creación de una marca de agua mediante la API de Java"
Creación de marcas de agua mediante la API de servicio web create-watermarks-using-the-web-service-api
Crear una marca de agua mediante la API de Document Security (servicio web):
-
Cree un objeto de la API de cliente de Document Security.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
RightsManagementServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Establezca los atributos de marca de agua.
- Cree un objeto
WatermarkSpec
invocando el constructorWatermarkSpec
. - Establezca el nombre de la marca de agua asignando un valor de cadena al miembro de datos
name
del objetoWatermarkSpec
. - Establezca el atributo
id
de la marca de agua asignando un valor de cadena al miembro de datosid
del objetoWatermarkSpec
. - Para que se establezca cada propiedad de filigrana, cree un objeto
MyMapOf_xsd_string_To_xsd_anyType_Item
independiente. - Establezca el valor clave asignando un valor al miembro de datos
key
del objetoMyMapOf_xsd_string_To_xsd_anyType_Item
(por ejemplo,WaterBackCmd:OPACITY)
. - Establezca el valor asignando un valor al miembro de datos
value
del objetoMyMapOf_xsd_string_To_xsd_anyType_Item
(por ejemplo,.25
). - Crear un objeto
MyArrayOf_xsd_anyType
. Para cada objetoMyMapOf_xsd_string_To_xsd_anyType_Item
, invoque el métodoAdd
del objetoMyArrayOf_xsd_anyType
. Pase el objetoMyMapOf_xsd_string_To_xsd_anyType_Item
. - Asigne el objeto
MyArrayOf_xsd_anyType
al miembro de datosvalues
del objetoWatermarkSpec
.
- Cree un objeto
-
Registre la marca de agua.
Registre la marca de agua invocando el método
registerWatermark
del objetoRightsManagementServiceClient
y pasando el objetoWatermarkSpec
que representa la marca de agua que se va a registrar.
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Creación de una marca de agua mediante la API del servicio web"
- "Inicio rápido (SwaRef): Creación de una marca de agua mediante la API del servicio web"
Consulte también
Modificación de marcas de agua modifying-watermarks
Puede modificar una marca de agua existente mediante la API de Java o la API del servicio web de Document Security. Para cambiar una marca de agua existente, debe recuperarla, modificar sus atributos y, a continuación, actualizarla en el servidor. Por ejemplo, supongamos que recupera una marca de agua y modifica su atributo de opacidad. Antes de que el cambio surta efecto, debe actualizar la marca de agua.
Al modificar una marca de agua, el cambio afecta a los documentos futuros a los que se les haya aplicado dicha marca. Es decir, los documentos de PDF existentes que contienen la marca de agua no se ven afectados.
Resumen de los pasos summary_of_steps-9
Para modificar una marca de agua, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recupere la marca de agua que desea modificar.
- Establezca los atributos de marcas de agua.
- Actualice la marca de agua.
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security. Si está usando la API de Java, cree un objeto DocumentSecurityClient
. Si utiliza la API del servicio web de Document Security, cree un objeto DocumentSecurityServiceService
.
Recuperar la marca de agua para modificar
Para modificar una marca de agua, debe recuperar una marca de agua existente. Puede recuperar una marca de agua especificando su nombre o su valor identificador.
Establecer los atributos de marcas de agua
Para modificar una marca de agua existente, cambie el valor de uno o varios atributos de marca de agua. Al actualizar mediante programación una marca de agua mediante un servicio web, debe establecer todos los atributos que se establecieron originalmente, aunque el valor no cambie. Por ejemplo, supongamos que se establecen los siguientes atributos de marca de agua: WaterBackCmd:IS_USERID_ENABLED
, WaterBackCmd:IS_CUSTOMTEXT_ENABLED
, WaterBackCmd:OPACITY
y WaterBackCmd:SRCTEXT
. Aunque el único atributo que desea modificar es WaterBackCmd:OPACITY
, debe establecer que los demás valores estén bien.
Actualizar la marca de agua
Después de modificar los atributos de una marca de agua, debe actualizarla.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Modificación de marcas de agua mediante la API de Java modify-watermarks-using-the-java-api
Modifique una marca de agua mediante la API de seguridad de los documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere la marca de agua que desea modificar.
Cree un objeto
WatermarkManager
invocando el métodogetWatermarkManager
del objetoDocumentSecurityClient
y pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve un objetoWatermark
que representa la marca de agua que se va a modificar. -
Establezca los atributos de marca de agua.
Establezca el atributo opacity de la marca de agua invocando el método
setOpacity
del objetoWatermark
y pasando un valor entero que especifique el nivel de opacidad. El valor 100 indica que la marca de agua es completamente opaca y el valor 0 indica que es completamente transparente.note note NOTE En este ejemplo se modifica únicamente el atributo opacity. -
Actualice la marca de agua.
- Actualice la marca de agua invocando el método
updateWatermark
del objetoWatermarkManager
y pase el objetoWatermark
cuyo atributo se modificó.
- Actualice la marca de agua invocando el método
Ejemplos de código
SOAP Para obtener ejemplos de código utilizando el servicio Document Security, consulte la sección Inicio rápido (modo de): Modificación de una marca de agua mediante la API de Java.
Modificación de marcas de agua mediante la API de servicio web modify-watermarks-using-the-web-service-api
Modificar una marca de agua mediante la API de seguridad de los documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/DocumentSecurityService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoDocumentSecurityServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere la marca de agua que desea modificar.
Recupere la marca de agua que desea modificar invocando el método
getWatermarkByName
del objetoDocumentSecurityServiceClient
. Pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve un objetoWatermarkSpec
que representa la marca de agua que se va a modificar. -
Establezca los atributos de marca de agua.
- Para actualizar cada propiedad de marca de agua, cree un objeto
MyMapOf_xsd_string_To_xsd_anyType_Item
independiente. - Establezca el valor clave asignando un valor al miembro de datos
key
del objetoMyMapOf_xsd_string_To_xsd_anyType_Item
(por ejemplo,WaterBackCmd:OPACITY)
. - Establezca el valor asignando un valor al miembro de datos
value
del objetoMyMapOf_xsd_string_To_xsd_anyType_Item
(por ejemplo,.50
). - Crear un objeto
MyArrayOf_xsd_anyType
. Para cada objetoMyMapOf_xsd_string_To_xsd_anyType_Item
, invoque el métodoAdd
del objetoMyArrayOf_xsd_anyType
. Pase el objetoMyMapOf_xsd_string_To_xsd_anyType_Item
. - Asigne el objeto
MyArrayOf_xsd_anyType
al miembro de datosvalues
del objetoWatermarkSpec
.
- Para actualizar cada propiedad de marca de agua, cree un objeto
-
Actualice la marca de agua.
Actualice la marca de agua invocando el método
updateWatermark
del objetoDocumentSecurityServiceClient
y pasando el objetoWatermarkSpec
que representa la marca de agua que se va a modificar.
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (MTOM): Modificación de una marca de agua mediante la API del servicio web"
Búsqueda de eventos searching-for-events
El servicio Rights Management realiza un seguimiento de acciones específicas a medida que se producen, como aplicar una directiva a un documento, abrir un documento protegido por una directiva y revocar el acceso a documentos. La auditoría de eventos debe estar habilitada para el servicio de Rights Management o no se realiza un seguimiento de los eventos.
Los eventos se clasifican en una de las siguientes categorías:
- Los eventos de administrador son acciones relacionadas con un administrador, como crear una cuenta de administrador.
- Los eventos de documento son acciones relacionadas con un documento, como cerrar un documento protegido por una directiva.
- Los eventos de directiva son acciones relacionadas con una directiva, como crear una directiva.
- Los eventos de servicio son acciones relacionadas con el servicio de Rights Management, como la sincronización con el directorio de usuario.
Puede buscar eventos específicos utilizando la API de Java de Rights Management o la API del servicio web. Al buscar eventos, puede realizar tareas como, por ejemplo, crear un archivo de registro de ciertos eventos.
Resumen de los pasos summary_of_steps-10
Para buscar un evento de Rights Management, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de API de cliente de Rights Management.
- Especifique el evento para el que desea buscar.
- Busque el evento.
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.
Crear un objeto de API de cliente de Rights Management
Para poder realizar mediante programación una operación de servicio de Rights Management, debe crear un objeto de cliente de servicio de Rights Management. Si está usando la API de Java, cree un objeto DocumentSecurityClient
. Si está usando la API del servicio web de Rights Management, cree un objeto DocumentSecurityServiceService
.
Especifique los eventos que desea buscar
Especifique el evento que desea buscar. Por ejemplo, puede buscar el evento de creación de directivas, que se produce cuando se crea una directiva nueva.
Buscar el evento
Una vez especificado el evento que se va a buscar, se puede utilizar la API de Java de Rights Management o la API del servicio web de Rights Management para buscar el evento.
Consulte también
Búsqueda de eventos mediante la API de Java search-for-events-using-the-java-api
Busque eventos mediante la API de Rights Management (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Crear un objeto de API de cliente de Rights Management
Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando un objetoServiceClientFactory
que contenga propiedades de conexión. -
Especifique los eventos que desea buscar
- Cree un objeto
EventManager
invocando el métodogetEventManager
del objetoDocumentSecurityClient
. Este método devuelve un objetoEventManager
. - Cree un objeto
EventSearchFilter
invocando su constructor. - Especifique el evento que desea buscar invocando el método
setEventCode
del objetoEventSearchFilter
y pasando un miembro de datos estáticos que pertenece a la claseEventManager
que representa el evento que desea buscar. Por ejemplo, para buscar el evento de creación de directivas, paseEventManager.POLICY_CREATE_EVENT
.
note note NOTE Puede definir criterios de búsqueda adicionales invocando EventSearchFilter
métodos de objeto. Por ejemplo, invoque el métodosetUserName
para especificar un usuario asociado con el evento. - Cree un objeto
-
Buscar el evento
Busque el evento invocando el método
searchForEvents
del objetoEventManager
y pasando el objetoEventSearchFilter
que define los criterios de búsqueda del evento. Este método devuelve una matriz deEvent
objetos.
Ejemplos de código
Para obtener ejemplos de código utilizando el servicio Rights Management, consulte los siguientes tutoriales rápidos:
- SOAP "Inicio rápido (): Búsqueda de eventos mediante la API de Java"
Búsqueda de eventos mediante la API de servicio web search-for-events-using-the-web-service-api
Busque eventos mediante la API de Rights Management (servicio web):
-
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Crear un objeto de API de cliente de Rights Management
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DocumentSecurityServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoDocumentSecurityServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Especifique los eventos que desea buscar
- Crear un objeto
EventSpec
mediante su constructor. - Especifique el inicio del período de tiempo durante el cual se produjo el evento estableciendo el miembro de datos
firstTime.date
del objetoEventSpec
con la instanciaDataTime
que representa el inicio del intervalo de fecha cuando se produjo el evento. - Asigne el valor
true
al miembro de datosfirstTime.dateSpecified
del objetoEventSpec
. - Especifique el final del período de tiempo durante el cual se produjo el evento estableciendo el miembro de datos
lastTime.date
del objetoEventSpec
con la instanciaDataTime
que representa el final del intervalo de fecha cuando se produjo el evento. - Asigne el valor
true
al miembro de datoslastTime.dateSpecified
del objetoEventSpec
. - Configure el evento que desea buscar asignando un valor de cadena al miembro de datos
eventCode
del objetoEventSpec
. En la tabla siguiente se enumeran los valores numéricos que puede asignar a esta propiedad:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2 Tipo de evento Valor ALL_EVENTS
999 USER_CHANGE_PASSWORD_EVENT
1000 USER_REGISTER_EVENT
1001 USER_PREREGISTER_EVENT
1002 USER_ACTIVATE_EVENT
1003 USER_DEACTIVATE_EVENT
1004 USER_AUTHENTICATE_EVENT
1005 USER_AUTHENTICATE_DENY_EVENT
1006 USER_ACCOUNT_LOCK_EVENT
1007 USER_DELETE_EVENT
1008 USER_UPDATE_PROFILE_EVENT
1009 DOCUMENT_VIEW_EVENT
2000 DOCUMENT_PRINT_LOW_EVENT
2001 DOCUMENT_PRINT_HIGH_EVENT
2002 DOCUMENT_SIGN_EVENT
2003 DOCUMENT_ADD_ANNOTATION_EVENT
2004 DOCUMENT_FORM_FILL_EVENT
2005 DOCUMENT_CLOSE_EVENT
2006 DOCUMENT_MODIFY_EVENT
2007 DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT
2008 DOCUMENT_SWITCH_POLICY_EVENT
2009 DOCUMENT_REVOKE_EVENT
2010 $1
2011 DOCUMENT_SECURE_EVENT
2012 DOCUMENT_UNKNOWN_CLIENT_EVENT
2013 DOCUMENT_CHANGE_REVOKE_URL_EVENT
2014 POLICY_CHANGE_EVENT
3000 POLICY_ENABLE_EVENT
3001 POLICY_DISABLE_EVENT
3002 POLICY_CREATE_EVENT
3003 POLICY_DELETE_EVENT
3004 POLICY_CHANGE_OWNER_EVENT
3005 SERVER_CLIENT_SYNC_EVENT
4000 SERVER_SYNC_DIR_INFO_EVENT
4001 SERVER_SYNC_DIR_COMPLETE_EVENT
4002 SERVER_VERSION_MISMATCH_EVENT
4003 SERVER_CONFIG_CHANGE_EVENT
4004 SERVER_ENABLE_OFFLINE_ACCESS_EVENT
4005 ADMIN_ADD_EVENT
5000 ADMIN_DELETE_EVENT
5001 ADMIN_EDIT_EVENT
5002 ADMIN_ACTIVATE_EVENT
5003 ADMIN_DEACTIVATE_EVENT
5004 ERROR_DIRECTORY_SERVICE_EVENT
6000 CREATED_POLICYSET_EVENT
7000 DELETED_POLICYSET_EVENT
7001 MODIFIED_POLICYSET_EVENT
7002 - Crear un objeto
-
Buscar el evento
Busque el evento invocando el método
searchForEvents
del objetoDocumentSecurityServiceClient
y pasando el objetoEventSpec
que representa el evento para el que desea buscar y el número máximo de resultados. Este método devuelve una colecciónMyArrayOf_xsd_anyType
donde cada elemento es una instanciaAuditSpec
. Con una instancia deAuditSpec
, puede obtener información sobre el evento, como la hora en que se produjo. La instanciaAuditSpec
contiene un miembro de datostimestamp
que especifica esta información.
Ejemplos de código
Para obtener ejemplos de código utilizando el servicio Rights Management, consulte los siguientes tutoriales rápidos:
- "Inicio rápido (MTOM): Búsqueda de eventos mediante la API de servicio web"
- "Inicio rápido (SwaRef): Búsqueda de eventos mediante la API del servicio web"
Consulte también
Aplicar directivas a documentos de Word applying-policies-to-word-documents
Además de los documentos de PDF, el servicio Rights Management admite formatos de documento adicionales, como un documento de Microsoft Word (archivo DOC) y otros formatos de archivo de Microsoft Office. Por ejemplo, puede aplicar una directiva a un documento de Word para protegerlo. Al aplicar una directiva a un documento de Word, se restringe el acceso al documento. No puede aplicar una directiva a un documento si éste ya está protegido con una directiva.
Puede supervisar el uso de un documento de Word protegido por una directiva después de distribuirlo. Es decir, puede ver cómo se utiliza el documento y quién lo está utilizando. Por ejemplo, puede averiguar cuándo alguien ha abierto el documento.
Resumen de los pasos summary_of_steps-11
Para aplicar una directiva a un documento de Word, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de la API de cliente de Document Security.
- Recuperar un documento de Word al que se aplica una directiva.
- Aplicar una directiva existente al documento de Word.
- Guarde el documento de Word protegido por una directiva.
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.
Crear un objeto API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto de cliente del servicio Document Security.
Recuperar un documento de Word
Recuperar un documento de Word para aplicar una directiva. Después de aplicar una directiva al documento de Word, los usuarios están restringidos al utilizar el documento. Por ejemplo, si la directiva no permite abrir el documento sin conexión, los usuarios deben estar en línea para abrirlo.
Aplicar una directiva existente al documento de Word
Para aplicar una directiva a un documento de Word, debe hacer referencia a una directiva existente y especificar a qué conjunto de directivas pertenece la directiva. El usuario que configura las propiedades de conexión debe tener acceso a la directiva especificada. Si no es así, se produce una excepción.
Guardar el documento de Word
Una vez que el servicio Document Security aplica una directiva a un documento de Word, puede guardar el documento de Word protegido por directivas como un archivo DOC.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Aplicar una directiva a un documento de Word mediante la API de Java apply-a-policy-to-a-word-document-using-the-java-api
Aplicar una directiva a un documento de Word mediante la API de Document Security (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de la API de cliente de Document Security.
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
DocumentSecurityClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recupere un documento de Word.
- Cree un objeto
java.io.FileInputStream
que represente el documento de Word utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de Word. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Aplicar una directiva existente al documento de Word.
-
Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoDocumentSecurityClient
. -
Aplique una directiva al documento de Word invocando el método
protectDocument
del objetoDocumentManager
y pasando los siguientes valores:- El objeto
com.adobe.idp.Document
que contiene el documento de Word al que se aplica la directiva. - Valor de cadena que especifica el nombre del documento.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un valor
null
que haga que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva.
- Valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser nulo).
- Valor de cadena que representa el nombre canónico del usuario administrador de usuarios que es el editor del documento. Este valor de parámetro es opcional y puede ser
null
(si este parámetro esnull
, el valor del parámetro anterior debe sernull
). com.adobe.livecycle.rightsmanagement.Locale
que representa la configuración regional utilizada para seleccionar la plantilla de MS Office. Este valor de parámetro es opcional y puede especificarnull
.
El método
protectDocument
devuelve un objetoRMSecureDocumentResult
que contiene el documento de Word protegido por directivas. - El objeto
-
-
Guarde el documento de Word.
- Invoque el método
getProtectedDoc
del objetoRMSecureDocumentResult
para obtener el documento de Word protegido por directivas. Este método devuelve un objetocom.adobe.idp.Document
. - Cree un objeto
java.io.File
y asegúrese de que la extensión del archivo sea DOC. - Invoque el método
copyToFile
del objetocom.adobe.idp.Document
para copiar el contenido del objetoDocument
en el archivo (asegúrese de utilizar el objetoDocument
devuelto por el métodogetProtectedDoc
).
- Invoque el método
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte el siguiente Inicio rápido:
- SOAP "Inicio rápido (modo de): Aplicar una directiva a un documento de Word mediante la API de Java"
Aplicar una directiva a un documento de Word mediante la API de servicio web apply-a-policy-to-a-word-document-using-the-web-service-api
Aplicar una directiva a un documento de Word mediante la API de Document Security (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de la API de cliente de Document Security.
-
Cree un objeto
DocumentSecurityServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
DocumentSecurityServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/DocumentSecurityService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoDocumentSecurityServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento de Word.
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar un documento de Word al que se aplica una directiva. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de Word y el modo en que se abrirá el archivo. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Determine el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Aplicar una directiva existente al documento de Word.
Aplique una directiva al documento de Word invocando el método
protectDocument
del objetoDocumentSecurityServiceClient
y pasando los siguientes valores:- El objeto
BLOB
que contiene el documento de Word al que se aplica la directiva. - Valor de cadena que especifica el nombre del documento.
- Valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un valor
null
que haga que se utilice el conjunto de directivasMyPolicies
. - Valor de cadena que especifica el nombre de la directiva.
- Valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser
null
). - Valor de cadena que representa el nombre canónico del usuario administrador de usuarios que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el valor del parámetro anterior debe ser
null
). - Un valor
RMLocale
que especifica el valor de configuración regional (por ejemplo,RMLocale.en
). - Un parámetro de salida de cadena que se utiliza para almacenar el valor del identificador de directiva.
- Un parámetro de salida de cadena que se utiliza para almacenar el valor del identificador protegido por una directiva.
- Un parámetro de salida de cadena que se usa para almacenar el tipo MIME (por ejemplo,
application/doc
).
El método
protectDocument
devuelve un objetoBLOB
que contiene el documento de Word protegido por directivas. - El objeto
-
Guarde el documento de Word.
- Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de Word protegido por directivas. - Cree una matriz de bytes que almacene el contenido de datos del objeto
BLOB
devuelto por el métodoprotectDocument
. Rellene la matriz de bytes obteniendo el valor del miembro de datosMTOM
del objetoBLOB
. - Cree un objeto
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
. - Escriba el contenido de la matriz de bytes en un archivo de Word invocando el método
Write
del objetoSystem.IO.BinaryWriter
y pasando la matriz de bytes.
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (MTOM): Aplicar una directiva a un documento de Word mediante la API de servicio web"
Quitar directivas de documentos de Word removing-policies-from-word-documents
Puede quitar una directiva de un documento de Word protegido por una directiva para quitar la seguridad del documento. Es decir, si ya no desea que el documento esté protegido por una directiva. Si desea actualizar un documento de Word protegido por una directiva con una directiva más reciente, en lugar de quitar la directiva y agregar la directiva actualizada, es más eficaz cambiar la directiva.
Resumen de los pasos summary_of_steps-12
Para quitar una directiva de un documento de Word protegido por una directiva, realice los siguientes pasos:
- Incluir archivos de proyecto
- Cree un objeto de la API de cliente de Document Security.
- Recupere un documento de Word protegido por una directiva.
- Quitar la directiva del documento de Word.
- Guardar los documentos de Word no protegidos
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.
Crear un objeto de API de cliente de Document Security
Para poder realizar mediante programación una operación del servicio Document Security, cree un objeto de cliente del servicio Document Security.
Recuperar un documento de Word protegido por una directiva
Recupere un documento de Word protegido por una directiva para quitar una directiva. Si intenta quitar una directiva de un documento de Word que no está protegido por una directiva, se producirá una excepción.
Quitar la directiva del documento de Word
Puede quitar una directiva de un documento de Word protegido por una directiva siempre que se especifique un administrador en la configuración de conexión. Si no es así, la directiva utilizada para proteger un documento debe contener el permiso SWITCH_POLICY
para quitar una directiva de un documento de Word. Además, el usuario especificado en la configuración de conexión de AEM Forms también debe tener ese permiso. De lo contrario, se produce una excepción.
Guardar el documento de Word no protegido
Una vez que el servicio Document Security quita una directiva de un documento de Word, puede guardar el documento de Word no protegido como un archivo DOC.
Consulte también
Incluir archivos de biblioteca Java de AEM Forms
Quitar una directiva de un documento de Word mediante la API de Java remove-a-policy-from-a-word-document-using-the-java-api
Quitar una directiva de un documento de Word protegido por una directiva mediante la API de Document Security (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Crear un objeto de API de cliente de Document Security
- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. - Cree un objeto
RightsManagementClient
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Recuperar un documento de Word protegido por una directiva
- Cree un objeto
java.io.FileInputStream
que represente el documento de Word protegido por directivas utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de Word. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Quitar la directiva del documento de Word
- Cree un objeto
DocumentManager
invocando el métodogetDocumentManager
del objetoRightsManagementClient
. - Quite una directiva del documento de Word invocando el método
removeSecurity
del objetoDocumentManager
y pasando el objetocom.adobe.idp.Document
que contiene el documento de Word protegido por directivas. Este método devuelve un objetocom.adobe.idp.Document
que contiene un documento de Word no protegido.
- Cree un objeto
-
Guardar el documento de Word no protegido
- Cree un objeto
java.io.File
y asegúrese de que la extensión del archivo sea DOC. - Invoque el método
copyToFile
del objetoDocument
para copiar el contenido del objetoDocument
en el archivo (asegúrese de utilizar el objetoDocument
devuelto por el métodoremoveSecurity
).
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte el siguiente Inicio rápido:
- SOAP "Inicio rápido (modo de): Quitar una directiva de un documento de Word mediante la API de Java"
Quitar una directiva de un documento de Word mediante la API de servicio web remove-a-policy-from-a-word-document-using-the-web-service-api
Quitar una directiva de un documento de Word protegido por una directiva mediante la API de Document Security (servicio web):
-
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplace localhost
por la dirección IP del servidor que hospeda AEM Forms. -
Crear un objeto de API de cliente de Document Security
-
Cree un objeto
RightsManagementServiceClient
utilizando su constructor predeterminado. -
Cree un objeto
RightsManagementServiceClient.Endpoint.Address
mediante el constructorSystem.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
). No necesita usar el atributolc_version
. Este atributo se utiliza al crear una referencia de servicio). -
Cree un objeto
System.ServiceModel.BasicHttpBinding
obteniendo el valor del campoRightsManagementServiceClient.Endpoint.Binding
. Convertir el valor devuelto enBasicHttpBinding
. -
Establezca el campo
MessageEncoding
del objetoSystem.ServiceModel.BasicHttpBinding
enWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario de los formularios de la al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asigne el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- AEM Asigne el nombre de usuario de los formularios de la al campo
-
Asigne el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperar un documento de Word protegido por una directiva
- Crear un objeto
BLOB
mediante su constructor. El objetoBLOB
se usa para almacenar el documento de Word protegido por una directiva del que se quita la directiva. - Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de Word y el modo en que se abrirá el archivo. - Cree una matriz de bytes que almacene el contenido del objeto
System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedadLength
del objetoSystem.IO.FileStream
. - Rellene la matriz de bytes con datos de secuencia invocando el método
Read
del objetoSystem.IO.FileStream
y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea. - Rellene el objeto
BLOB
asignando su campoMTOM
con el contenido de la matriz de bytes.
- Crear un objeto
-
Quitar la directiva del documento de Word
Quite la directiva del documento de Word invocando el método
removePolicySecurity
del objetoRightsManagementServiceClient
y pasando el objetoBLOB
que contiene el documento de Word protegido por directivas. Este método devuelve un objetoBLOB
que contiene un documento de Word no protegido. -
Guardar el documento de Word no protegido
- Cree un objeto
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación de archivo del documento de Word no protegido. - Cree una matriz de bytes que almacene el contenido de datos del objeto
BLOB
devuelto por el métodoremovePolicySecurity
. Rellene la matriz de bytes obteniendo el valor del campoMTOM
del objetoBLOB
. - Cree un objeto
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
.
- Cree un objeto
Ejemplos de código
Para ver ejemplos de código utilizando el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (MTOM): Quitar una directiva de un documento de Word mediante la API de servicio web"
Consulte también
Invocar AEM Forms mediante MTOM