Proteger documentos mediante directivas protecting-documents-with-policies
Acerca del servicio de seguridad de documentos
El servicio de seguridad de documentos permite a los usuarios aplicar de forma dinámica la configuración de confidencialidad a los documentos de Adobe PDF y mantener el control sobre los documentos, independientemente de su amplia distribución.
El servicio de seguridad de documentos evita que la información se extienda más allá del alcance del usuario, ya que permite a los usuarios mantener el control sobre cómo los destinatarios utilizan 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 archivos, como los archivos Word de Microsoft (archivos DOC). Puede utilizar la API de cliente de Document Security para trabajar con estos tipos de archivo. Se admiten las siguientes versiones:
- Archivos de Microsoft Office 2003 (DOC, XLS, PPT)
- Archivos de Microsoft Office 2007 (archivos DOCX, XLSX, PPTX)
- Archivos PTC Pro/E
Para una 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 políticas.
- Modificar directivas. Para obtener más información, consulte Modificación de 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, consulte Aplicación de directivas a documentos de PDF.
- Elimine las directivas de los documentos del PDF. Para obtener más información, consulte Eliminación de directivas de documentos de PDF.
- Documentos protegidos por políticas de Inspect. Para obtener más información, consulte Inspección de documentos de PDF protegidos por políticas.
- Revocar el acceso a los documentos del PDF. Para obtener más información, consulte Revocación del acceso a los documentos.
- Restablezca el acceso a los documentos revocados. Para obtener más información, consulte Restablecimiento del acceso a documentos revocados.
- Crear marcas de agua. Para obtener más información, consulte Creación de marcas de agua.
- Busque eventos. Para obtener más información, consulte Búsqueda de eventos.
Creación de políticas creating-policies
Puede crear directivas mediante programación mediante la API Java de Document Security o la API de servicio web. A directiva es una colección de información que incluye configuración de seguridad del documento, 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 funciones 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 políticas.
- Monitorice el uso del documento después de distribuirlo. Puede ver cómo se está utilizando el documento y quién lo está utilizando. 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 de servicio web, haga referencia a un archivo XML existente del lenguaje de derechos de documento portátiles (PDRL) 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 pasos siguientes:
- Incluir archivos de proyecto.
- Cree un objeto de API cliente de Document Security.
- Establezca los atributos de la política.
- Cree 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 utilizando 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)
- relajngDataType.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 cliente de Document Security
Antes de poder realizar una operación de servicio Document Security mediante programación, cree un objeto cliente de servicio Document Security.
Establezca los atributos de la política
Para crear una directiva, establezca los atributos de la directiva. Un atributo obligatorio es el nombre de la política. Los nombres de directiva deben ser únicos para cada conjunto de directivas. Un conjunto de políticas es simplemente una colección de políticas. Puede haber dos directivas con el mismo nombre si las directivas 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 periodo de validez es el periodo durante el cual los destinatarios autorizados pueden acceder a un documento protegido por políticas. Si no establece este atributo, la política siempre es válida.
Se puede establecer un periodo de validez en una de estas opciones:
- Un número determinado de días en los que se puede acceder al documento desde el momento en que se publica
- Una fecha final después de 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
Solo puede especificar una fecha de inicio, lo que hace que la directiva sea válida después de la fecha de inicio. Si solo especifica una fecha de finalización, la política es válida hasta la fecha de finalización. Sin embargo, se genera una excepción si no se definen una fecha de inicio ni una de finalización.
Al establecer atributos que pertenecen a una directiva, también puede definir la configuración de codificación. Esta configuración de codificación se aplica cuando la directiva se aplica a un documento. Puede especificar los siguientes valores de codificación:
- 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.
- Sin cifrado: No representa ningún cifrado.
Al especificar la variable NoEncryption
, no puede establecer la variable PlaintextMetadata
a false
. Si intenta hacerlo, se genera una excepción.
Policy
descripción de la interfaz 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 para 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 únicamente un documento mientras esté en línea y prohíba que los destinatarios lo copien.
- Adjunte la entrada de directiva a la directiva.
- Proteja un documento con la directiva utilizando Acrobat.
Estas acciones hacen que los destinatarios solo puedan ver el documento en línea y no puedan copiarlo. El documento permanece seguro hasta que se elimina la seguridad de él.
Registrar la directiva
Se debe registrar una nueva directiva para poder utilizarla. Después de registrar una directiva, puede utilizarla para proteger documentos.
Crear una directiva mediante la API de Java create-a-policy-using-the-java-api
Cree una directiva utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
DocumentSecurityClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Establezca los atributos de la política.
- Cree un
Policy
invocando el objetoInfomodelObjectFactory
estático del objetocreatePolicy
método. Este método devuelve unPolicy
objeto. - Establezca el atributo de nombre de la política invocando la variable
Policy
del objetosetName
y pasando un valor de cadena que especifica el nombre de la directiva. - Configure la descripción de la directiva invocando la variable
Policy
del objetosetDescription
y pasando un valor de cadena que especifica la descripción de la directiva. - Establezca el conjunto de directivas al que pertenece la nueva directiva invocando la variable
Policy
del objetosetPolicySetName
y pasando un valor de cadena que especifica el nombre del conjunto de directivas. (Puede especificarnull
para este valor de parámetro que resulta en que la directiva se agregue al Mis políticas conjunto de directivas). - Cree el periodo de validez de la directiva invocando la variable
InfomodelObjectFactory
estático del objetocreateValidityPeriod
método. Este método devuelve unValidityPeriod
objeto. - Establezca el número de días durante los cuales se puede acceder a un documento protegido por políticas invocando la variable
ValidityPeriod
del objetosetRelativeExpirationDays
y pasando un valor entero que especifica el número de días. - Establezca el periodo de validez de la política invocando la variable
Policy
del objetosetValidityPeriod
y pasando elValidityPeriod
objeto.
- Cree un
-
Cree una entrada de directiva.
- Cree una entrada de directiva invocando la variable
InfomodelObjectFactory
estático del objetocreatePolicyEntry
método. Este método devuelve unPolicyEntry
objeto. - Especifique los permisos de la directiva invocando la variable
InfomodelObjectFactory
estático del objetocreatePermission
método. Pase un miembro de datos estático que pertenezca a laPermission
que representa el permiso. Este método devuelve unPermission
objeto. Por ejemplo, para agregar el permiso que permite a los usuarios copiar datos de un documento de PDF protegido por políticas, pasePermission.COPY
. (Repita este paso para cada permiso que desee añadir). - Agregue el permiso a la entrada de directiva invocando la variable
PolicyEntry
del objetoaddPermission
y pasando elPermission
objeto. (Repita este paso con cadaPermission
objeto que ha creado). - Cree la entidad de seguridad de directiva invocando la variable
InfomodelObjectFactory
estático del objetocreateSpecialPrincipal
método. Pase un miembro de datos que pertenezca a laInfomodelObjectFactory
que representa el principal. Este método devuelve unPrincipal
objeto. Por ejemplo, para agregar el editor del documento como principal, paseInfomodelObjectFactory.PUBLISHER_PRINCIPAL
. - Agregue la entidad de seguridad a la entrada de directiva invocando la variable
PolicyEntry
del objetosetPrincipal
y pasando elPrincipal
objeto. - Agregue la entrada de directiva a la directiva invocando la variable
Policy
del objetoaddPolicyEntry
y pasando elPolicyEntry
objeto.
- Cree una entrada de directiva invocando la variable
-
Registre la directiva.
-
Cree un
PolicyManager
invocando el objetoDocumentSecurityClient
del objetogetPolicyManager
método. -
Registre la directiva invocando la variable
PolicyManager
del objetoregisterPolicy
y pasando los siguientes valores:- La variable
Policy
que representa la directiva que se va a registrar.
- La variable
-
Un valor de cadena que representa el conjunto de directivas al que pertenece la directiva.
Si utiliza una cuenta de administrador de formularios AEM en la configuración de conexión para crear la variable
DocumentSecurityClient
y, a continuación, especifique el nombre del conjunto de directivas cuando invoque el objetoregisterPolicy
método. Si pasa unnull
para el conjunto de directivas, la directiva se crea en los administradores Mis políticas conjunto de directivas.Si utiliza un usuario de Document Security dentro de la configuración de conexión, puede invocar la sobrecarga
registerPolicy
que acepta únicamente 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 políticas. Si no desea agregar la nueva directiva a este conjunto de directivas, especifique un nombre de conjunto de directivas cuando invoque elregisterPolicy
método.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 genera una excepción. -
Para ver ejemplos de código que utilicen el servicio Document Security, consulte lo siguiente:
- "Inicio rápido (modo SOAP): Creación de una directiva mediante la API de Java"
Crear una directiva mediante la API de servicio web create-a-policy-using-the-web-service-api
Cree una directiva utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
DocumentSecurityServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Establezca los atributos de la política.
- Cree un
PolicySpec
usando su constructor. - Establezca el nombre de la directiva asignando un valor de cadena al
PolicySpec
del objetoname
miembro de datos. - Defina la descripción de la directiva asignando un valor de cadena a la variable
PolicySpec
del objetodescription
miembro de datos. - Para establecer el conjunto de directivas al que pertenecerá la directiva, asigne un valor de cadena a la variable
PolicySpec
del objetopolicySetName
miembro de datos. Debe especificar un nombre de conjunto de directivas existente. (Puede especificarnull
para este valor de parámetro que resulta en que la directiva se agregue a Mis políticas.) - Establezca el periodo de arrendamiento sin conexión de la política asignando un valor entero a la variable
PolicySpec
del objetoofflineLeasePeriod
miembro de datos. - Configure las variables
PolicySpec
del objetopolicyXml
miembro de datos con un valor de cadena que representa los datos XML de PDRL. Para realizar esta tarea, cree un .NETStreamReader
usando su constructor. Pase la ubicación de un archivo XML PDRL que represente la directiva a la variableStreamReader
constructor. A continuación, invoque la funciónStreamReader
del objetoReadLine
y asigne el valor devuelto a una variable de cadena. Iterar a través de la variableStreamReader
hasta queReadLine
devuelve nulo. Asigne la variable de cadena a la variablePolicySpec
del objetopolicyXml
miembro de datos.
- Cree un
-
Cree una entrada de directiva.
No es necesario crear una entrada de directiva al crear una directiva mediante la API del servicio web Document Security. La entrada de directiva se define en el documento PDRL.
-
Registre la directiva.
Registre la directiva invocando la variable
DocumentSecurityServiceClient
del objetoregisterPolicy
y pasando los siguientes valores:- La variable
PolicySpec
que representa la directiva que se va a registrar. - Un valor de cadena que representa el conjunto de directivas al que pertenece la directiva. Puede especificar un
null
que hace que la directiva se agregue al MyPolices conjunto de directivas.
Si utiliza una cuenta de administrador de formularios AEM en la configuración de conexión para crear la variable
DocumentSecurityClient
especifique el nombre del conjunto de directivas cuando invoque el objetoregisterPolicy
método.Si utiliza un usuario de Document SecurityDocument Security dentro de la configuración de conexión, puede invocar la sobrecarga
registerPolicy
que acepta únicamente 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 políticas. Si no desea agregar la nueva directiva a este conjunto de directivas, especifique un nombre de conjunto de directivas cuando invoque elregisterPolicy
método.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 genera una excepción. - La variable
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "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 o la API de servicio web de Document Security. Para realizar cambios en una directiva existente, debe recuperarla, modificarla y, a continuación, actualizar la directiva en el servidor. Por ejemplo, supongamos que recupera una directiva existente y amplía su periodo de validez. Antes de que el cambio surta efecto, debe actualizar la directiva.
Puede modificar una directiva cuando cambien los requisitos comerciales y esta ya no refleje estos requisitos. En lugar de crear una directiva nueva, simplemente puede actualizar una existente.
Para modificar los atributos de directiva mediante un servicio web (por ejemplo, mediante el uso de clases proxy de 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 política existente utilizando la variable PolicySpec.getPolicyXml
y modificar los atributos de directiva utilizando los métodos aplicables. Por ejemplo, puede modificar el periodo de arrendamiento sin conexión invocando la variable PolicySpec.setOfflineLeasePeriod
método.
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 API cliente de Document Security.
- Recupere una directiva existente.
- Cambiar atributos de directivas.
- Actualice la directiva.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Antes de poder realizar mediante programación una operación del servicio Document Security, debe crear un objeto cliente del servicio Document Security. Si utiliza la API de Java, cree un RightsManagementClient
objeto. Si utiliza la API del servicio web de Document Security, cree un RightsManagementServiceService
objeto.
Recuperar una directiva existente
Debe recuperar una directiva existente para modificarla. Para recuperar una directiva, especifique el nombre de la directiva y el conjunto de directivas al que pertenece la directiva. Si especifica un null
para el nombre del conjunto de directivas, la directiva se recupera del Mis políticas conjunto de directivas.
Establezca los atributos de la política
Para modificar una directiva, modifique el valor de los atributos de directiva. El único atributo de política que no puede cambiar es el atributo de nombre. Por ejemplo, para cambiar el periodo de arrendamiento sin conexión de la política, puede modificar el valor del atributo de periodo de arrendamiento sin conexión de la política.
Al modificar el periodo de arrendamiento sin conexión de una política mediante un servicio web, la variable offlineLeasePeriod
en el campo PolicySpec
se ignora. Para actualizar el periodo de arrendamiento sin conexión, modifique el OfflineLeasePeriod
en el documento XML de PDRL. A continuación, haga referencia al documento XML de PDRL actualizado utilizando la variable PolicySpec
del policyXML
miembro de datos.
Policy
descripción de la interfaz en la Referencia de la API de AEM Forms.Actualizar la directiva
Antes de que se apliquen los cambios realizados en una directiva, debe actualizarla con el servicio de seguridad de documentos. Los cambios en las políticas que protegen documentos se actualizan la próxima vez que el documento protegido por políticas se sincroniza con el servicio de seguridad de documentos.
Modificación de directivas existentes mediante la API de Java modify-existing-policies-using-the-java-api
Modifique una directiva existente utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
RightsManagementClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere una directiva existente.
-
Cree un
PolicyManager
invocando el objetoRightsManagementClient
del objetogetPolicyManager
método. -
Cree un
Policy
que representa la directiva que se va a actualizar invocando la variablePolicyManager
del objetogetPolicy
y pasar los siguientes valores"- Un valor de cadena que representa el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que representa el nombre de la directiva.
- Un valor de cadena que representa el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
-
-
Establezca los atributos de la política.
Cambie los atributos de la directiva para satisfacer los requisitos comerciales. Por ejemplo, para cambiar el periodo de arrendamiento sin conexión de la directiva, invoque la variable
Policy
del objetosetOfflineLeasePeriod
método. -
Actualice la directiva.
Actualizar la directiva invocando
PolicyManager
del objetoupdatePolicy
método. Pase elPolicy
que representa la directiva que se va a actualizar.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte Inicio rápido (modo SOAP): Modificación de una directiva mediante la sección API de Java.
Modificación de las directivas existentes mediante la API de servicio web modify-existing-policies-using-the-web-service-api
Modifique una directiva existente utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
RightsManagementServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere una directiva existente.
Cree un
PolicySpec
que representa la directiva que se va a modificar invocando la variableRightsManagementServiceClient
del objetogetPolicy
y pasando los siguientes valores:- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva.
- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
-
Establezca los atributos de la política.
Cambie los atributos de la directiva para satisfacer los requisitos comerciales.
-
Actualice la directiva.
Actualice la directiva invocando la variable
RightsManagementServiceClient
del objetoupdatePolicyFromSDK
y pasando elPolicySpec
que representa la directiva que se va a actualizar.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Modificación de 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 directiva existente mediante la API de Java o la API de servicio web de Document Security. Una vez eliminada una directiva, ya no se puede utilizar para proteger documentos. Sin embargo, los documentos protegidos por políticas existentes que utilizan la política siguen estando protegidos. Puede eliminar una directiva cuando una más reciente esté 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 API 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Para poder realizar una operación de servicio Document Security mediante programación, debe crear un objeto cliente de servicio Document Security. Si utiliza la API de Java, cree un RightsManagementClient
objeto. Si utiliza la API del servicio web de Document Security, cree un RightsManagementServiceService
objeto.
Eliminar la directiva
Para eliminar una directiva, especifique la directiva que desea eliminar y el conjunto de directivas al que pertenece la directiva. El usuario cuya configuración se utilice para invocar a 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 producirá una excepción.
Eliminar directivas mediante la API de Java delete-policies-using-the-java-api
Elimine una directiva utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
RightsManagementClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Elimine la directiva.
-
Cree un
PolicyManager
invocando el objetoRightsManagementClient
del objetogetPolicyManager
método. -
Elimine la directiva invocando la variable
PolicyManager
del objetodeletePolicy
y pasando los siguientes valores:- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva que se va a eliminar.
- Un 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 que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo SOAP): 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
Elimine una directiva utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
RightsManagementServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Elimine la directiva.
Elimine una directiva invocando la variable
RightsManagementServiceClient
del objetodeletePolicy
y pasando los siguientes valores:- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva que se va a eliminar.
- Un 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 que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Eliminación de una directiva mediante la API de servicio web"
- "Inicio rápido (SwaRef): Eliminación de una directiva mediante la API de 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 el documento 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 políticas cuando ya no desee que los usuarios accedan al documento.
Después de distribuirlo, puede supervisar el uso de un documento protegido por políticas. Es decir, puede ver cómo se utiliza el documento y quién lo utiliza. 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 API cliente de Document Security.
- Recupere un documento de PDF al que se aplica una directiva.
- Aplique una política existente al documento de PDF.
- Guarde el documento de PDF protegido por políticas.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Creación de un objeto API cliente de Document Security
Antes de poder realizar una operación de servicio Document Security mediante programación, cree un objeto cliente de servicio Document Security. Si utiliza la API de Java, cree un DocumentSecurityClient
objeto. Si utiliza la API del servicio web de Document Security, cree un DocumentSecurityServiceService
objeto.
Recuperar un documento PDF
Puede recuperar un documento de PDF para aplicar una directiva. Después de aplicar una directiva al documento del PDF, los usuarios se ven restringidos al usar 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 esté configurando 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 de seguridad de documentos aplica una directiva a un documento de PDF, puede guardar el documento de PDF protegido por políticas como un archivo de PDF.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Revocación del acceso a los documentos
Aplicar una directiva a un documento de PDF mediante la API de Java apply-a-policy-to-a-pdf-document-using-the-java-api
Aplique una directiva a un documento de PDF mediante la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
RightsManagementClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere un documento de PDF.
- Cree un
java.io.FileInputStream
objeto que representa el documento del PDF utilizando su constructor. Pase un valor de cadena que especifique la ubicación del documento del PDF. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto.
- Cree un
-
Aplique una política existente al documento de PDF.
-
Cree un
DocumentManager
invocando el objetoRightsManagementClient
del objetogetDocumentManager
método. -
Aplique una directiva al documento del PDF invocando la variable
DocumentManager
del objetoprotectDocument
y pasando los siguientes valores:- La variable
com.adobe.idp.Document
objeto que contiene el documento del PDF al que se aplica la directiva. - Un valor de cadena que especifica el nombre del documento.
- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva.
- Un valor de cadena que representa el nombre del dominio de administrador de usuarios del usuario que es el editor del documento. Este valor del parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor del parámetro debe ser nulo).
- Un 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
). - A
com.adobe.livecycle.rightsmanagement.Locale
que representa la configuración regional que se usa para seleccionar la plantilla MS Office. Este valor de parámetro es opcional y no se utiliza para documentos de PDF. Para proteger un documento de PDF, especifiquenull
.
La variable
protectDocument
el método devuelve unRMSecureDocumentResult
objeto que contiene el documento de PDF protegido por políticas. - La variable
-
-
Guarde el documento del PDF.
- Invocar el
RMSecureDocumentResult
del objetogetProtectedDoc
para obtener el documento de PDF protegido por políticas. Este método devuelve uncom.adobe.idp.Document
objeto. - Cree un
java.io.File
y asegúrese de que la extensión de archivo es PDF. - Invocar el
com.adobe.idp.Document
del objetocopyToFile
para copiar el contenido delDocument
al archivo (asegúrese de usar la variableDocument
objeto devuelto por elgetProtectedDoc
método).
- Invocar el
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo EJB): Aplicación de una directiva a un documento de PDF mediante la API de Java"
- "Inicio rápido (modo SOAP): Aplicación de una directiva a un documento de PDF mediante la API de Java"
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexió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
Aplique una directiva a un documento de PDF mediante la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
RightsManagementServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento de PDF.
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar un documento de PDF al que se aplica una directiva. - Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento PDF y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Determine el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
método. Pase la matriz de bytes, la posición de inicio y la longitud del flujo para leerlos. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Aplique una política existente al documento de PDF.
Aplique una directiva al documento del PDF invocando la variable
RightsManagementServiceClient
del objetoprotectDocument
y pasando los siguientes valores:- La variable
BLOB
objeto que contiene el documento del PDF al que se aplica la directiva. - Un valor de cadena que especifica el nombre del documento.
- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva.
- Un valor de cadena que representa el nombre del dominio de administrador de usuarios del usuario que es el editor del documento. Este valor del parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor del parámetro debe ser
null
). - Un valor de cadena que representa el nombre canónico del usuario administrador de usuarios que es el editor del documento. Este valor del parámetro es opcional y puede ser nulo (si este parámetro es nulo, el valor del parámetro anterior debe ser
null
). - A
RMLocale
valor 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 la política.
- Un parámetro de salida de cadena que se utiliza para almacenar el valor del identificador protegido por políticas.
- Un parámetro de salida de cadena que se utiliza para almacenar el tipo mime (por ejemplo,
application/pdf
).
La variable
protectDocument
el método devuelve unBLOB
objeto que contiene el documento de PDF protegido por políticas. - La variable
-
Guarde el documento del PDF.
- Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF protegido por políticas. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto devuelto por elprotectDocument
método. Rellene la matriz de bytes obteniendo el valor de la variableBLOB
del objetoMTOM
miembro de datos. - Cree un
System.IO.BinaryWriter
invocando su constructor y pasando elSystem.IO.FileStream
objeto. - Escriba el contenido de la matriz de bytes en un archivo de PDF invocando la variable
System.IO.BinaryWriter
del objetoWrite
y pasando la matriz de bytes.
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Aplicación de una directiva a un documento de PDF mediante la API de servicio web"
- "Inicio rápido (SwaRef): Aplicación de una directiva a un documento de PDF mediante la API de servicio web"
Eliminación de directivas de documentos de PDF removing-policies-from-pdf-documents
Puede quitar una directiva de un documento protegido por una directiva para eliminar 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 políticas con una directiva más reciente, en lugar de eliminar la directiva y agregar la directiva actualizada, es más eficiente cambiar la directiva.
Resumen de los pasos summary_of_steps-4
Para quitar una directiva de un documento de PDF protegido por políticas, realice los siguientes pasos:
- Incluir archivos de proyecto
- Cree un objeto de API cliente de Document Security.
- Recupere un documento de PDF protegido por políticas.
- Elimine la directiva del documento del 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Antes de poder realizar una operación de servicio Document Security mediante programación, cree un objeto cliente de servicio Document Security.
Recuperar un documento de PDF protegido por políticas
Puede recuperar un documento de PDF protegido por políticas para eliminar una directiva. Si intenta quitar una directiva de un documento de PDF que no esté protegido por una directiva, provocará una excepción.
Quitar la directiva del documento del PDF
Puede quitar una directiva de un documento de PDF protegido por políticas 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 la variable 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 genera una excepción.
Guarde el documento PDF no protegido
Una vez que el servicio de seguridad de documentos elimina una directiva de un documento de PDF, puede guardar el documento de PDF no protegido como un archivo de PDF.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de directivas a documentos de PDF
Eliminar 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 políticas utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
DocumentSecurityClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere un documento de PDF protegido por políticas.
- Cree un
java.io.FileInputStream
objeto que representa el documento de PDF protegido por políticas utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de PDF. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto.
- Cree un
-
Elimine la directiva del documento del PDF.
- Cree un
DocumentManager
invocando el objetoDocumentSecurityClient
del objetogetDocumentManager
método. - Elimine una directiva del documento del PDF invocando la variable
DocumentManager
del objetoremoveSecurity
y pasando elcom.adobe.idp.Document
objeto que contiene el documento de PDF protegido por políticas. Este método devuelve uncom.adobe.idp.Document
objeto que contiene un documento PDF no protegido.
- Cree un
-
Guarde el documento de PDF no protegido.
- Cree un
java.io.File
y asegúrese de que la extensión de archivo es PDF. - Invocar el
Document
del objetocopyToFile
para copiar el contenido delDocument
al archivo (asegúrese de usar la variableDocument
objeto devuelto por elremoveSecurity
método).
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo SOAP): Eliminación de una directiva de un documento de PDF mediante la API de Java"
Eliminar una directiva mediante la API de servicio web remove-a-policy-using-the-web-service-api
Elimine una directiva de un documento de PDF protegido por políticas mediante la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
DocumentSecurityServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deDocumentSecurityServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento de PDF protegido por políticas.
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar el documento de PDF protegido por políticas del que se ha eliminado la directiva. - Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento PDF y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leer. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Elimine la directiva del documento del PDF.
Elimine la directiva del documento del PDF invocando la variable
DocumentSecurityServiceClient
del objetoremovePolicySecurity
y pasando elBLOB
objeto que contiene el documento de PDF protegido por políticas. Este método devuelve unBLOB
objeto que contiene un documento PDF no protegido. -
Guarde el documento de PDF no protegido.
- Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento PDF no protegido. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto devuelto por elremovePolicySecurity
método. Rellene la matriz de bytes obteniendo el valor de la variableBLOB
del objetoMTOM
campo . - Cree un
System.IO.BinaryWriter
invocando su constructor y pasando elSystem.IO.FileStream
objeto.
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Eliminación de 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
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Revocación del acceso a los documentos revoking-access-to-documents
Puede revocar el acceso a un documento de PDF protegido por políticas, lo que impide que los usuarios tengan acceso a todas las copias del documento. Cuando un usuario intenta abrir un documento de PDF revocado, se le redirige a una dirección URL específica 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 revoca el acceso a un documento, el cambio entra en vigor la próxima vez que el usuario se sincroniza con el servicio de seguridad de documentos abriendo en línea el documento protegido por políticas.
La posibilidad de revocar el acceso a un documento proporciona seguridad adicional. Por ejemplo, supongamos que una versión más reciente de un documento está disponible y que ya no desea que nadie vea la versión obsoleta. En esta situación, el acceso al documento más antiguo 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 políticas, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de API cliente de Document Security.
- Recupere un documento de PDF protegido por políticas.
- Revocar 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Para poder realizar una operación de servicio Document Security mediante programación, debe crear un objeto cliente de servicio Document Security.
Recuperar un documento de PDF protegido por políticas
Debe recuperar un documento de PDF protegido por políticas para revocarlo. No puede revocar un documento que ya se haya revocado o que no sea un documento protegido por políticas.
Si conoce el valor del identificador de licencia del documento protegido por políticas, no es necesario recuperar el documento de PDF protegido por políticas. Sin embargo, en la mayoría de los casos, deberá recuperar el documento del PDF para obtener el valor del identificador de licencia.
Revocar el documento protegido por políticas
Para revocar un documento protegido por políticas, especifique el identificador de licencia del documento protegido por políticas. 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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de directivas a documentos de PDF
Restablecimiento del acceso a documentos revocados
Revocar el acceso a los documentos mediante la API de Java revoke-access-to-documents-using-the-java-api
Revocar el acceso a un documento de PDF protegido por políticas utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Crear un objeto de API cliente de Document Security
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
DocumentSecurityClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recuperar un documento de PDF protegido por políticas
- Cree un
java.io.FileInputStream
que representan el documento de PDF protegido por políticas utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de PDF. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto.
- Cree un
-
Revocar el documento protegido por políticas
-
Cree un
DocumentManager
invocando el objetoDocumentSecurityClient
del objetogetDocumentManager
método. -
Recupere el valor del identificador de licencia del documento protegido por políticas invocando la variable
DocumentManager
del objetogetLicenseId
método. Pase elcom.adobe.idp.Document
que representa el documento protegido por políticas. Este método devuelve un valor de cadena que representa el valor del identificador de licencia. -
Cree un
LicenseManager
invocando el objetoDocumentSecurityClient
del objetogetLicenseManager
método. -
Revocar el documento protegido por políticas invocando la variable
LicenseManager
del objetorevokeLicense
y pasando los siguientes valores:- Un valor de cadena que especifica el valor del identificador de licencia del documento protegido por políticas (especifique el valor devuelto del
DocumentManager
del objetogetLicenseId
método). - Un miembro de datos estáticos de la variable
License
que especifica el motivo para revocar el documento. Por ejemplo, puede especificarLicense.DOCUMENT_REVISED
. - A
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
.
- Un valor de cadena que especifica el valor del identificador de licencia del documento protegido por políticas (especifique el valor devuelto del
-
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo SOAP): Revocación de un documento mediante la API de Java"
Revocar el acceso a los documentos mediante la API de servicio web revoke-access-to-documents-using-the-web-service-api
Revocar el acceso a un documento de PDF protegido por políticas utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Crear un objeto de API cliente de Document Security
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
DocumentSecurityServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deDocumentSecurityServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperar un documento de PDF protegido por políticas
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar un documento de PDF protegido por políticas que se revoque. - Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF protegido por políticas que se va a revocar y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leer. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Revocar el documento protegido por políticas
-
Recupere el valor del identificador de licencia del documento protegido por políticas invocando la variable
DocumentSecurityServiceClient
del objetogetLicenseID
y pasando elBLOB
que representa el documento protegido por políticas. Este método devuelve un valor de cadena que representa el identificador de licencia. -
Revocar el documento protegido por políticas invocando la variable
DocumentSecurityServiceClient
del objetorevokeLicense
y pasando los siguientes valores:- Un valor de cadena que especifica el valor del identificador de licencia del documento protegido por políticas (especifique el valor devuelto del
DocumentSecurityServiceService
del objetogetLicenseId
método). - Un miembro de datos estáticos de la variable
Reason
enumeración que especifica el motivo para revocar el documento. Por ejemplo, puede especificarReason.DOCUMENT_REVISED
. - A
string
que especifica la ubicación URL donde se encuentra un documento revisado. Si no desea redirigir a un usuario a otra dirección URL, puede pasarnull
.
- Un valor de cadena que especifica el valor del identificador de licencia del documento protegido por políticas (especifique el valor devuelto del
-
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Revocación de un documento mediante la API de servicio web"
- "Inicio rápido (SwaRef): Revocación de un documento mediante la API de servicio web"
Consulte también
Eliminación de directivas de documentos de Word
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Restablecimiento del acceso a documentos revocados reinstating-access-to-revoked-documents
Puede restablecer el acceso a un documento de PDF revocado, lo que hace que todos los usuarios tengan acceso a todas las copias del documento revocado. Cuando un usuario abre un documento restablecido que fue 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 API cliente de Document Security.
- Recupere el identificador de licencia del documento del PDF revocado.
- Restablezca el acceso al documento del PDF revocado.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Para poder realizar una operación de servicio Document Security mediante programación, debe crear un objeto cliente de servicio Document Security. Si utiliza la API de Java, cree un DocumentSecurityClient
objeto. Si utiliza la API del servicio web de Document Security, cree un DocumentSecurityServiceService
objeto.
Recupere el identificador de licencia del documento del PDF revocado
Debe recuperar el identificador de licencia del documento del PDF revocado para restablecer un documento del 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 revoque, provocará una excepción.
Restablecer el acceso al documento del 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 PDF que no se revoque, provocará una excepción.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de directivas a documentos de PDF
Revocación del acceso a los documentos
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 documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
DocumentSecurityClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere el identificador de licencia del documento del PDF revocado.
- Cree un
java.io.FileInputStream
objeto que representa el documento del PDF revocado utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento del PDF. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto. - Cree un
DocumentManager
invocando el objetoDocumentSecurityClient
del objetogetDocumentManager
método. - Recupere el valor del identificador de licencia del documento revocado invocando la variable
DocumentManager
del objetogetLicenseId
y pasando elcom.adobe.idp.Document
que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia.
- Cree un
-
Restablezca el acceso al documento del PDF revocado.
- Cree un
LicenseManager
invocando el objetoDocumentSecurityClient
del objetogetLicenseManager
método. - Restablezca el acceso al documento del PDF revocado invocando la variable
LicenseManager
del objetounrevokeLicense
y pasando el valor del identificador de licencia del documento revocado.
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo SOAP): Restablecimiento del acceso a un documento revocado mediante la API de servicio web"
Restablecer el acceso a los documentos revocados mediante la API de 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 documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
DocumentSecurityServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deDocumentSecurityServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere el identificador de licencia del documento del PDF revocado.
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar un documento de PDF revocado al que se restablece el acceso. - Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento del PDF revocado y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leer. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Restablezca el acceso al documento del PDF revocado.
- Recupere el valor del identificador de licencia del documento revocado invocando la variable
DocumentSecurityServiceClient
del objetogetLicenseID
y pasando elBLOB
que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia. - Restablezca el acceso al documento del PDF revocado invocando la variable
DocumentSecurityServiceClient
del objetounrevokeLicense
y pasando un valor de cadena que especifica el valor del identificador de licencia del documento del PDF revocado (pase el valor devuelto de la variableDocumentSecurityServiceClient
del objetogetLicenseId
método).
- Recupere el valor del identificador de licencia del documento revocado invocando la variable
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Restablecimiento del acceso a un documento revocado mediante la API de servicio web"
- "Inicio rápido (SwaRef): Restablecimiento del acceso a un documento revocado mediante la API de servicio web"
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Inspección de documentos de PDF protegidos por políticas inspecting-policy-protected-pdf-documents
Puede utilizar la API del servicio de seguridad de documentos (Java y servicio web) para inspeccionar documentos de PDF protegidos por políticas. La inspección de documentos de PDF protegidos por políticas devuelve información sobre el documento de PDF protegido por políticas. Por ejemplo, puede determinar la política que se utilizó para proteger el documento y la fecha en que se protegió el documento.
No puede realizar esta tarea si la versión de LiveCycle es 8.x o una versión anterior. La compatibilidad con la inspección de documentos protegidos por políticas se agrega en AEM Forms. Si intenta inspeccionar un documento protegido por una política utilizando el LiveCycle 8.x (o anterior), se produce una excepción.
Resumen de los pasos summary_of_steps-7
Para inspeccionar un documento de PDF protegido por políticas, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de API cliente de Document Security.
- Recupere un documento protegido por políticas para inspeccionar.
- 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 cliente de Document Security
Antes de poder realizar una operación de servicio Document Security mediante programación, cree un objeto cliente de servicio Document Security. Si utiliza la API de Java, cree un RightsManagementClient
objeto. Si utiliza la API del servicio web de Document Security, cree un RightsManagementServiceService
objeto.
Recuperar un documento protegido por políticas para inspeccionar
Para inspeccionar un documento protegido por políticas, recuperarlo. Si intenta inspeccionar un documento que no está protegido con una directiva o que está revocado, se genera una excepción.
Inspect el documento
Después de recuperar un documento protegido por políticas, puede inspeccionarlo.
Obtener información sobre el documento protegido por políticas
Después de inspeccionar un documento de PDF protegido por políticas, puede obtener información al respecto. 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
, devuelve null.
Si el documento está protegido mediante una directiva incluida en un conjunto de directivas (distinto de Mis políticas), RMInspectResult.getPolicysetName
y RMInspectResult.getPolicysetId
devuelven cadenas válidas.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Documentos del PDF protegido por políticas de Inspect que utilizan la API de Java inspect-policy-protected-pdf-documents-using-the-java-api
Inspect es un documento de PDF protegido por políticas que utiliza la API del servicio de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del 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 API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. (Consulte Configuración de las propiedades de conexión.) - Cree un
RightsManagementClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere un documento protegido por políticas para inspeccionar.
- Cree un
java.io.FileInputStream
objeto que representa el documento de PDF protegido por políticas utilizando su constructor. Pase un valor de cadena que especifique la ubicación del documento del PDF. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto.
- Cree un
-
Inspect el documento.
- Cree un
DocumentManager
invocando el objetoRightsManagementClient
del objetogetDocumentManager
método. - Inspect el documento protegido por políticas invocando el
LicenseManager
del objetoinspectDocument
método. Pase elcom.adobe.idp.Document
objeto que contiene el documento de PDF protegido por políticas. Este método devuelve unRMInspectResult
que contiene información sobre el documento protegido por políticas.
- Cree un
-
Obtenga información sobre el documento protegido por políticas.
Para obtener información sobre el documento protegido por políticas, invoque el método apropiado que pertenece a
RMInspectResult
objeto. Por ejemplo, para recuperar el nombre de la directiva, invoque la funciónRMInspectResult
del objetogetPolicyName
método.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo SOAP): Inspección de documentos de PDF protegidos por políticas mediante la API de Java"
Documentos de PDF protegidos por políticas de Inspect que utilizan la API de servicio web inspect-policy-protected-pdf-documents-using-the-web-service-api
Inspect es un documento de PDF protegido por políticas que utiliza la API del servicio de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
RightsManagementServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento protegido por políticas para inspeccionar.
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar un documento de PDF que inspeccionar. - Cree un
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento del PDF y el modo en el que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
método. Pase la matriz de bytes, la posición de inicio y la longitud del flujo para leerlos. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Inspect el documento.
Inspect el documento protegido por políticas invocando el
RightsManagementServiceClient
del objetoinspectDocument
método. Pase elBLOB
objeto que contiene el documento de PDF protegido por políticas. Este método devuelve unRMInspectResult
que contiene información sobre el documento protegido por políticas. -
Obtenga información sobre el documento protegido por políticas.
Para obtener información sobre el documento protegido por políticas, obtenga el valor del campo correspondiente que pertenece al
RMInspectResult
objeto. Por ejemplo, para recuperar el nombre de la directiva, obtenga el valor deRMInspectResult
del objetopolicyName
campo .
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Inspección de documentos de PDF protegidos por políticas mediante la API de servicio web"
- "Inicio rápido (SwaRef): Inspección de documentos de PDF protegidos por políticas mediante la API de servicio web"
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Creación de marcas de agua creating-watermarks
Las marcas de agua ayudan a garantizar la seguridad de un documento al identificar de forma exclusiva el documento y controlar la infracción de los derechos de autor. Por ejemplo, puede crear y colocar una marca de agua que indique Confidencial en todas las páginas de un documento. Después de crear una marca de agua, puede incluirla como parte de una directiva. Es decir, puede establecer el atributo de marca de agua de la política 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 políticas.
Resumen de los pasos summary_of_steps-8
Para crear una marca de agua, siga estos pasos:
- Incluir archivos de proyecto.
- Cree un objeto de API cliente de Document Security.
- Establezca los atributos de las marcas de agua.
- Registre la marca de agua en el servicio Document Security.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Para poder realizar una operación de servicio Document Security mediante programación, debe crear un objeto cliente de servicio Document Security. Si utiliza la API de Java, cree un RightsManagementClient
objeto. Si utiliza la API del servicio web de Document Security, cree un RightsManagementServiceService
objeto.
Definición de los atributos de las marcas de agua
Para crear una nueva marca de agua, debe definir los atributos de marca de agua. El atributo name siempre debe estar definido. Además del atributo name , debe establecer al menos uno de los siguientes atributos:
- Texto personalizado
- Fecha de inclusión
- UserIdIncluded
- UserNameIncluded
En la tabla siguiente se enumeran los pares de clave y valor que son necesarios para 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 configurarse como verdadero.Todas las marcas de agua deben tener uno de los siguientes atributos definidos:
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Todos los demás atributos son opcionales.
Registro de la marca de agua
Una nueva marca de agua debe estar registrada en el servicio de seguridad de documentos para poder utilizarse. Después de registrar una marca de agua, puede utilizarla dentro de las directivas.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de directivas a documentos de PDF
Creación de marcas de agua mediante la API de Java create-watermarks-using-the-java-api
Cree una marca de agua utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como el
adobe-rightsmanagement-client.jar
, en la ruta de clase de su proyecto Java. -
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
RightsManagementClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Definición de los atributos de marca de agua
- Cree un
Watermark
invocando el objetoInfomodelObjectFactory
estático del objetocreateWatermark
método. Este método devuelve unWatermark
objeto. - Establezca el atributo de nombre de la marca de agua invocando la variable
Watermark
del objetosetName
y pasando un valor de cadena que especifica el nombre de la directiva. - Establezca el atributo de fondo de la marca de agua invocando la variable
Watermark
del objetosetBackground
método y pasotrue
. Al establecer este atributo, la marca de agua aparece en el fondo del documento. - Establezca el atributo de texto personalizado de la marca de agua invocando la variable
Watermark
del objetosetCustomText
y pasando un valor de cadena que representa el texto de la marca de agua. - Establezca el atributo de opacidad de la marca de agua invocando la variable
Watermark
del objetosetOpacity
y pasando un valor entero que especifica el nivel de opacidad. Un valor de 100 indica que la marca de agua es completamente opaca y un valor de 0 indica que la marca de agua es completamente transparente.
- Cree un
-
Registre la marca de agua.
- Cree un
WatermarkManager
invocando el objetoRightsManagementClient
del objetogetWatermarkManager
método. Este método devuelve unWatermarkManager
objeto. - Registre la marca de agua invocando la variable
WatermarkManager
del objetoregisterWatermark
y pasando elWatermark
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
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (modo SOAP): 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
Cree una marca de agua utilizando la API de seguridad de documentos (servicio web):
-
Cree un objeto de API cliente de Document Security.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
RightsManagementServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Establezca los atributos de marca de agua.
- Cree un
WatermarkSpec
invocando el objetoWatermarkSpec
constructor. - Establezca el nombre de la marca de agua asignando un valor de cadena a la variable
WatermarkSpec
del objetoname
miembro de datos. - Configuración de la marca de agua
id
asignando un valor de cadena a la variableWatermarkSpec
del objetoid
miembro de datos. - Para que establezca cada propiedad de marca de agua, cree una
MyMapOf_xsd_string_To_xsd_anyType_Item
objeto. - Establezca el valor clave asignando un valor a la variable
MyMapOf_xsd_string_To_xsd_anyType_Item
del objetokey
miembro de datos (por ejemplo,WaterBackCmd:OPACITY)
. - Establezca el valor asignando un valor a la variable
MyMapOf_xsd_string_To_xsd_anyType_Item
del objetovalue
miembro de datos (por ejemplo,.25
). - Cree un
MyArrayOf_xsd_anyType
objeto. Para cadaMyMapOf_xsd_string_To_xsd_anyType_Item
objeto, invocarMyArrayOf_xsd_anyType
del objetoAdd
método. Pase elMyMapOf_xsd_string_To_xsd_anyType_Item
objeto. - Asigne la variable
MyArrayOf_xsd_anyType
alWatermarkSpec
del objetovalues
miembro de datos.
- Cree un
-
Registre la marca de agua.
Registre la marca de agua invocando la variable
RightsManagementServiceClient
del objetoregisterWatermark
y pasando elWatermarkSpec
que representa la marca de agua que se va a registrar.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de seguridad de documentos, consulte Inicio rápido siguiente:
- "Inicio rápido (MTOM): Creación de una marca de agua mediante la API de servicio web"
- "Inicio rápido (SwaRef): Creación de una marca de agua mediante la API de servicio web"
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Modificación de marcas de agua modifying-watermarks
Puede modificar una marca de agua existente mediante la API Java de Document Security o la API de servicio web. Para realizar cambios en una marca de agua existente, debe recuperarla, modificar sus atributos y actualizarla en el servidor. Por ejemplo, suponga 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.
Cuando se modifica una marca de agua, el cambio afecta a los documentos futuros que tengan la marca de agua aplicada a ellos. Es decir, los documentos 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, siga estos pasos:
- Incluir archivos de proyecto.
- Cree un objeto de API cliente de Document Security.
- Recupere la marca de agua que desea modificar.
- Establezca los atributos de las 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Para poder realizar una operación de servicio Document Security mediante programación, debe crear un objeto cliente de servicio Document Security. Si utiliza la API de Java, cree un DocumentSecurityClient
objeto. Si utiliza la API del servicio web de Document Security, cree un DocumentSecurityServiceService
objeto.
Recupere 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 especificando su valor identificador.
Definición de los atributos de las 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 definir todos los atributos que se establecieron originalmente, incluso 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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Modificación de marcas de agua mediante la API de Java modify-watermarks-using-the-java-api
Modifique una marca de agua utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
DocumentSecurityClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere la marca de agua que desea modificar.
Cree un
WatermarkManager
invocando el objetoDocumentSecurityClient
del objetogetWatermarkManager
y pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve unWatermark
que representa la marca de agua que se va a modificar. -
Establezca los atributos de marca de agua.
Establezca el atributo de opacidad de la marca de agua invocando la variable
Watermark
del objetosetOpacity
y pasando un valor entero que especifica el nivel de opacidad. Un valor de 100 indica que la marca de agua es completamente opaca y un valor de 0 indica que la marca de agua es completamente transparente.note note NOTE En este ejemplo solo se modifica el atributo de opacidad. -
Actualice la marca de agua.
- Actualice la marca de agua invocando la variable
WatermarkManager
del objetoupdateWatermark
y pase elWatermark
objeto cuyo atributo se modificó.
- Actualice la marca de agua invocando la variable
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte Inicio rápido (modo SOAP): Modificación de una marca de agua mediante la sección API de Java.
Modificación de marcas de agua mediante la API de servicio web modify-watermarks-using-the-web-service-api
Modifique una marca de agua utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deDocumentSecurityServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar 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 la variable
DocumentSecurityServiceClient
del objetogetWatermarkByName
método. Pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve unWatermarkSpec
que representa la marca de agua que se va a modificar. -
Establezca los atributos de marca de agua.
- Para que cada propiedad de marca de agua se actualice, cree una
MyMapOf_xsd_string_To_xsd_anyType_Item
objeto. - Establezca el valor clave asignando un valor a la variable
MyMapOf_xsd_string_To_xsd_anyType_Item
del objetokey
miembro de datos (por ejemplo,WaterBackCmd:OPACITY)
. - Establezca el valor asignando un valor a la variable
MyMapOf_xsd_string_To_xsd_anyType_Item
del objetovalue
miembro de datos (por ejemplo,.50
). - Cree un
MyArrayOf_xsd_anyType
objeto. Para cadaMyMapOf_xsd_string_To_xsd_anyType_Item
objeto, invocarMyArrayOf_xsd_anyType
del objetoAdd
método. Pase elMyMapOf_xsd_string_To_xsd_anyType_Item
objeto. - Asigne la variable
MyArrayOf_xsd_anyType
alWatermarkSpec
del objetovalues
miembro de datos.
- Para que cada propiedad de marca de agua se actualice, cree una
-
Actualice la marca de agua.
Actualice la marca de agua invocando la variable
DocumentSecurityServiceClient
del objetoupdateWatermark
y pasando elWatermarkSpec
que representa la marca de agua que se va a modificar.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (MTOM): Modificación de una marca de agua mediante la API de servicio web"
Búsqueda de eventos searching-for-events
El servicio de Rights Management realiza el seguimiento de las acciones específicas a medida que se producen, como la aplicación de una política a un documento, la apertura de un documento protegido por políticas y la revocación del acceso a los documentos. La auditoría de eventos debe estar habilitada para el servicio de Rights Management o no se debe realizar un seguimiento de los eventos.
Los eventos se dividen en una de las siguientes categorías:
- Los eventos de administrador son acciones relacionadas con un administrador, como la creación de una nueva cuenta de administrador.
- Los eventos de documento son acciones relacionadas con un documento, como cerrar un documento protegido por políticas.
- Los eventos de política son acciones relacionadas con una política, como la creación de una política nueva.
- 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 del Rights Management o la API de servicio web. Al buscar eventos, puede realizar tareas, como 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 pasos siguientes:
- 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Creación de un objeto de API de cliente de Rights Management
Para poder realizar una operación de servicio de Rights Management mediante programación, debe crear un objeto cliente de servicio de Rights Management. Si utiliza la API de Java, cree un DocumentSecurityClient
objeto. Si utiliza la API del servicio web de Rights Management, cree un DocumentSecurityServiceService
objeto.
Especifique los eventos para buscar
Debe especificar el evento que desea buscar. Por ejemplo, puede buscar el evento de creación de directivas, que se produce cuando se crea una política nueva.
Buscar el evento
Después de especificar el evento que se va a buscar, puede utilizar la API de Java de Rights Management o la API de servicio web de Rights Management para buscar el evento.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Buscar 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 del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Creación de un objeto de API de cliente de Rights Management
Cree un
DocumentSecurityClient
usando su constructor y pasando unServiceClientFactory
objeto que contiene propiedades de conexión. -
Especifique los eventos para buscar
- Cree un
EventManager
invocando el objetoDocumentSecurityClient
del objetogetEventManager
método. Este método devuelve unEventManager
objeto. - Cree un
EventSearchFilter
invocando su constructor. - Especifique el evento para el que desea buscar invocando la variable
EventSearchFilter
del objetosetEventCode
y pasando un miembro de datos estático que pertenezca alEventManager
que representa el evento para el que 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 del objeto. Por ejemplo, invoque la funciónsetUserName
para especificar un usuario asociado al evento. - Cree un
-
Buscar el evento
Busque el evento invocando la variable
EventManager
del objetosearchForEvents
y pasando elEventSearchFilter
objeto que define los criterios de búsqueda de eventos. Este método devuelve una matriz deEvent
objetos.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de Rights Management, consulte los siguientes ejemplos de inicio rápido:
- "Inicio rápido (SOAP): Búsqueda de eventos mediante la API de Java"
Buscar 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 WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Creación de un objeto de API de cliente de Rights Management
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
DocumentSecurityServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deDocumentSecurityServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Especifique los eventos para buscar
- Cree un
EventSpec
usando su constructor. - Especifique el inicio del período de tiempo durante el cual se produjo el evento estableciendo la variable
EventSpec
del objetofirstTime.date
miembro de datos conDataTime
instancia que representa el inicio del intervalo de fechas en que se produjo el evento. - Asignar el valor
true
aEventSpec
del objetofirstTime.dateSpecified
miembro de datos. - Especifique el final del período de tiempo durante el cual se produjo el evento estableciendo la variable
EventSpec
del objetolastTime.date
miembro de datos conDataTime
instancia que representa el final del intervalo de fechas en que se produjo el evento. - Asignar el valor
true
aEventSpec
del objetolastTime.dateSpecified
miembro de datos. - Configure el evento para el que desea buscar asignando un valor de cadena a la variable
EventSpec
del objetoeventCode
miembro de datos. La tabla siguiente muestra los valores numéricos que se pueden 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 - Cree un
-
Buscar el evento
Busque el evento invocando la variable
DocumentSecurityServiceClient
del objetosearchForEvents
y pasando elEventSpec
que representa el evento para el que buscar y el número máximo de resultados. Este método devuelve unMyArrayOf_xsd_anyType
colección donde cada elemento es unAuditSpec
instancia. Uso de unAuditSpec
puede obtener información sobre el evento, como la hora en que se produjo. La variableAuditSpec
la instancia contiene untimestamp
miembro de datos que especifica esta información.
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio de Rights Management, consulte los siguientes ejemplos de inicio rápido:
- "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 de servicio web"
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
Aplicación de directivas a documentos de Word applying-policies-to-word-documents
Además de los documentos del PDF, el servicio de gestión de derechos 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 política 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 el documento ya está protegido con una directiva.
Después de distribuirlo, puede supervisar el uso de un documento de Word protegido por políticas. Es decir, puede ver cómo se utiliza el documento y quién lo utiliza. 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 API cliente de Document Security.
- Recupere un documento de Word al que se aplica una política.
- Aplicar una política existente al documento de Word.
- Guarde el documento de Word protegido por políticas.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Creación de un objeto API cliente de Document Security
Para poder realizar una operación de servicio Document Security mediante programación, debe crear un objeto cliente de servicio Document Security.
Recuperar un documento de Word
Debe recuperar un documento de Word para aplicar una directiva. Después de aplicar una directiva al documento de Word, los usuarios se ven restringidos al usar 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 política 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 esté configurando 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
Después de que el servicio de seguridad de documentos aplique una directiva a un documento de Word, puede guardar el documento de Word protegido por políticas como un archivo DOC.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Revocación del acceso a los documentos
Aplicar una directiva a un documento de Word mediante la API de Java apply-a-policy-to-a-word-document-using-the-java-api
Aplique una directiva a un documento de Word utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto de API cliente de Document Security.
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
DocumentSecurityClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recupere un documento de Word.
- Cree un
java.io.FileInputStream
objeto que representa el documento de Word utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de Word. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto.
- Cree un
-
Aplicar una política existente al documento de Word.
-
Cree un
DocumentManager
invocando el objetoDocumentSecurityClient
del objetogetDocumentManager
método. -
Aplicar una directiva al documento de Word invocando la variable
DocumentManager
del objetoprotectDocument
y pasando los siguientes valores:- La variable
com.adobe.idp.Document
objeto que contiene el documento de Word al que se aplica la directiva. - Un valor de cadena que especifica el nombre del documento.
- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva.
- Un valor de cadena que representa el nombre del dominio de administrador de usuarios del usuario que es el editor del documento. Este valor del parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor del parámetro debe ser nulo).
- Un 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
). - A
com.adobe.livecycle.rightsmanagement.Locale
que representa la configuración regional que se usa para seleccionar la plantilla MS Office. Este valor de parámetro es opcional y puede especificarnull
.
La variable
protectDocument
el método devuelve unRMSecureDocumentResult
objeto que contiene el documento de Word protegido por políticas. - La variable
-
-
Guarde el documento de Word.
- Invocar el
RMSecureDocumentResult
del objetogetProtectedDoc
para obtener el documento de Word protegido por políticas. Este método devuelve uncom.adobe.idp.Document
objeto. - Cree un
java.io.File
y asegúrese de que la extensión de archivo es DOC. - Invocar el
com.adobe.idp.Document
del objetocopyToFile
para copiar el contenido delDocument
al archivo (asegúrese de usar la variableDocument
objeto devuelto por elgetProtectedDoc
método).
- Invocar el
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (modo SOAP): Aplicación de 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
Aplique una política a un documento de Word utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Cree un objeto de API cliente de Document Security.
-
Cree un
DocumentSecurityServiceClient
usando su constructor predeterminado. -
Cree un
DocumentSecurityServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deDocumentSecurityServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recupere un documento de Word.
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar un documento de Word al que se aplica una directiva. - Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de Word y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Determine el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
método. Pase la matriz de bytes, la posición de inicio y la longitud del flujo para leerlos. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Aplicar una política existente al documento de Word.
Aplicar una directiva al documento de Word invocando la variable
DocumentSecurityServiceClient
del objetoprotectDocument
y pasando los siguientes valores:- La variable
BLOB
objeto que contiene el documento de Word al que se aplica la directiva. - Un valor de cadena que especifica el nombre del documento.
- Un valor de cadena que especifica el nombre del conjunto de directivas al que pertenece la directiva. Puede especificar un
null
que resulta en la variableMyPolicies
conjunto de directivas que se está utilizando. - Un valor de cadena que especifica el nombre de la directiva.
- Un valor de cadena que representa el nombre del dominio de administrador de usuarios del usuario que es el editor del documento. Este valor del parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor del parámetro debe ser
null
). - Un valor de cadena que representa el nombre canónico del usuario administrador de usuarios que es el editor del documento. Este valor del parámetro es opcional y puede ser nulo (si este parámetro es nulo, el valor del parámetro anterior debe ser
null
). - A
RMLocale
valor 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 la política.
- Un parámetro de salida de cadena que se utiliza para almacenar el valor del identificador protegido por políticas.
- Un parámetro de salida de cadena que se utiliza para almacenar el tipo mime (por ejemplo,
application/doc
).
La variable
protectDocument
el método devuelve unBLOB
objeto que contiene el documento de Word protegido por políticas. - La variable
-
Guarde el documento de Word.
- Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de Word protegido por políticas. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto devuelto por elprotectDocument
método. Rellene la matriz de bytes obteniendo el valor de la variableBLOB
del objetoMTOM
miembro de datos. - Cree un
System.IO.BinaryWriter
invocando su constructor y pasando elSystem.IO.FileStream
objeto. - Escriba el contenido de la matriz de bytes en un archivo de Word invocando la variable
System.IO.BinaryWriter
del objetoWrite
y pasando la matriz de bytes.
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (MTOM): Aplicación de una directiva a un documento de Word mediante la API de servicio Web"
Eliminación de directivas de documentos de Word removing-policies-from-word-documents
Puede quitar una directiva de un documento de Word protegido por políticas 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 políticas 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 políticas, realice los siguientes pasos:
- Incluir archivos de proyecto
- Cree un objeto de API cliente de Document Security.
- Recupere un documento de Word protegido por políticas.
- Elimine la directiva del documento de Word.
- Guarde 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de API cliente de Document Security
Antes de poder realizar una operación de servicio Document Security mediante programación, cree un objeto cliente de servicio Document Security.
Recuperar un documento de Word protegido por políticas
Debe recuperar un documento de Word protegido por políticas para eliminar una directiva. Si intenta quitar una directiva de un documento de Word que no esté protegido por una directiva, provocará una excepción.
Quitar la directiva del documento de Word
Puede quitar una directiva de un documento de Word protegido por políticas 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 la variable 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 genera una excepción.
Guardar el documento de Word no protegido
Una vez que el servicio de seguridad de documentos elimina una directiva de un documento de Word, puede guardar el documento de Word no protegido como un archivo DOC.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de directivas a documentos de Word
Eliminar una directiva de un documento de Word mediante la API de Java remove-a-policy-from-a-word-document-using-the-java-api
Elimine una directiva de un documento de Word protegido por políticas utilizando la API de seguridad de documentos (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR del cliente, como adobe-rightsmanagement-client.jar, en la ruta de clase del proyecto Java.
-
Crear un objeto de API cliente de Document Security
- Cree un
ServiceClientFactory
objeto que contiene propiedades de conexión. - Cree un
RightsManagementClient
usando su constructor y pasando elServiceClientFactory
objeto.
- Cree un
-
Recuperar un documento de Word protegido por políticas
- Cree un
java.io.FileInputStream
objeto que representa el documento de Word protegido por políticas utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de Word. - Cree un
com.adobe.idp.Document
usando su constructor y pasando eljava.io.FileInputStream
objeto.
- Cree un
-
Quitar la directiva del documento de Word
- Cree un
DocumentManager
invocando el objetoRightsManagementClient
del objetogetDocumentManager
método. - Elimine una directiva del documento de Word invocando la variable
DocumentManager
del objetoremoveSecurity
y pasando elcom.adobe.idp.Document
objeto que contiene el documento de Word protegido por políticas. Este método devuelve uncom.adobe.idp.Document
objeto que contiene un documento de Word no protegido.
- Cree un
-
Guardar el documento de Word no protegido
- Cree un
java.io.File
y asegúrese de que la extensión de archivo es DOC. - Invocar el
Document
del objetocopyToFile
para copiar el contenido delDocument
al archivo (asegúrese de usar la variableDocument
objeto devuelto por elremoveSecurity
método).
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (modo SOAP): Eliminación de una directiva de un documento de Word mediante la API de Java"
Eliminar 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
Elimine una directiva de un documento de Word protegido por políticas utilizando la API de seguridad de documentos (servicio web):
-
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que hospeda AEM Forms. -
Crear un objeto de API cliente de Document Security
-
Cree un
RightsManagementServiceClient
usando su constructor predeterminado. -
Cree un
RightsManagementServiceClient.Endpoint.Address
usando la variableSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL
.) No es necesario que use la variablelc_version
atributo. Este atributo se utiliza al crear una referencia de servicio). -
Cree un
System.ServiceModel.BasicHttpBinding
obteniendo el valor deRightsManagementServiceClient.Endpoint.Binding
campo . Conversión del valor devuelto aBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
campo aWSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- Asignar el nombre de usuario de los formularios AEM al campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName
. - Asignar el valor de contraseña correspondiente al campo
RightsManagementServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Asignar el nombre de usuario de los formularios AEM al campo
-
Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
-
-
Recuperar un documento de Word protegido por políticas
- Cree un
BLOB
usando su constructor. La variableBLOB
se utiliza para almacenar el documento de Word protegido por políticas del que se quita la directiva. - Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de Word y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la variableSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con los datos de flujo invocando la variable
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de flujo para leer. - Rellene el
BLOB
asignando suMTOM
con el contenido de la matriz de bytes.
- Cree un
-
Quitar la directiva del documento de Word
Elimine la directiva del documento de Word invocando la variable
RightsManagementServiceClient
del objetoremovePolicySecurity
y pasando elBLOB
objeto que contiene el documento de Word protegido por políticas. Este método devuelve unBLOB
objeto que contiene un documento de Word no protegido. -
Guardar el documento de Word no protegido
- Cree un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de Word no protegido. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto devuelto por elremovePolicySecurity
método. Rellene la matriz de bytes obteniendo el valor de la variableBLOB
del objetoMTOM
campo . - Cree un
System.IO.BinaryWriter
invocando su constructor y pasando elSystem.IO.FileStream
objeto.
- Cree un
Ejemplos de código
Para ver ejemplos de código que utilicen el servicio Document Security, consulte el siguiente Inicio rápido:
- "Inicio rápido (MTOM): Eliminación de una directiva de un documento de Word mediante la API de servicio Web"
Consulte también
Invocación de AEM Forms mediante MTOM