Show Menu
TEMAS×

Protección de Documentos con políticas

Acerca del servicio de seguridad de Documento
El servicio de seguridad de Documento 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 la amplia distribución que se distribuyan.
El servicio de seguridad de Documento 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 PDF protegido por políticas. Un usuario puede especificar quién puede abrir un documento, limitar su uso y supervisar el documento después de distribuirlo. Un usuario también puede controlar dinámicamente el acceso a un documento protegido por una política e incluso puede anular dinámicamente el acceso al documento.
El servicio de seguridad de Documento también protege otros tipos de archivos, como los archivos de Microsoft Word (DOC). Puede utilizar la API del cliente de seguridad de Documento para trabajar con estos tipos de archivos. 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 mayor claridad, en las dos secciones siguientes se explica cómo trabajar con documentos de Word:
Puede realizar estas tareas mediante el servicio de seguridad de Documento:
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Creación de políticas

Puede crear políticas mediante programación mediante la API de Java de Documento Security o la API de servicio web. Una directiva es una colección de información que incluye la configuración de seguridad de documento, los usuarios autorizados y los 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 le 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 una política.
  • Monitoree el uso del documento después de distribuirlo. Puede ver cómo se usa el documento y quién lo utiliza. Por ejemplo, puede averiguar cuándo alguien ha abierto el documento.

Creación de una directiva mediante servicios Web

Al crear una directiva mediante la API de servicio web, haga referencia a un archivo XML existente del lenguaje de derechos de Documento portátil (PDRL) que describa la política. Los permisos de directivas y el principal se definen en el documento PDRL. El siguiente documento XML es un ejemplo de un documento de 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>
 

Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para crear una directiva, realice los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Defina los atributos de la política.
  4. Cree una entrada de directiva.
  5. Registre la directiva.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Se deben agregar los siguientes archivos JAR a la ruta de clases del proyecto:
  • adobe-rightsmanagement-client.jar
  • Área de nombres.jar (si se despliegan AEM Forms en JBoss)
  • jaxb-api.jar (si hay AEM Forms desplegados en JBoss)
  • jaxb-impl.jar (si hay AEM Forms desplegados en JBoss)
  • jaxb-libs.jar (si los AEM Forms están desplegados en JBoss)
  • jaxb-xjc.jar (si los AEM Forms están desplegados en JBoss)
  • relajngDataType.jar (si AEM Forms está implementado en JBoss)
  • xsdlib.jar (si hay AEM Forms implementados en JBoss)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar (utilice un archivo JAR diferente si los AEM Forms no están implementados en JBoss)
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java para AEM Forms.
Creación de un objeto API de cliente de seguridad de Documento
Antes de realizar una operación de servicio de seguridad de Documento mediante programación, cree un objeto cliente de servicio de seguridad de Documento.
Definir los atributos de la política
Para crear una directiva, defina 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 un conjunto 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 para establecer es el período de validez. Un período de validez es el período durante el cual los destinatarios autorizados pueden acceder a un documento protegido por una política. Si no establece este atributo, la política siempre es válida.
Se puede establecer un período de validez en una de estas opciones:
  • Número de días que se puede acceder al documento desde el momento en que se publica el documento
  • Una fecha de finalización 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
Puede especificar sólo una fecha de inicio, lo que resulta en que la directiva sea válida después de la fecha de inicio. Si sólo especifica una fecha de finalización, la política será 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 fecha de finalización.
Al establecer atributos que pertenecen a una política, también puede definir la configuración de codificación. Esta configuración de cifrado se ve afectada cuando la política se aplica a un documento. Puede especificar los siguientes valores de codificación:
  • AES256 : Representa el algoritmo de codificación AES con una clave de 256 bits.
  • AES128 : Representa el algoritmo de codificación AES con una clave de 128 bits.
  • SinCifrado: No representa cifrado.
Al especificar la NoEncryption opción, no se puede establecer la PlaintextMetadata opción en false . Si intenta hacerlo, se genera una excepción.
Para obtener información sobre otros atributos que puede definir, consulte la descripción de la Policy interfaz en la Referencia de API de AEM Forms.
Crear una entrada de directiva
Una entrada de directiva adjunta entidades principales, que son grupos y usuarios, y permisos a una directiva. Una política debe tener al menos una entrada de política. Supongamos, por ejemplo, que realiza estas tareas:
  • Cree y registre una entrada de directiva que permita que un grupo solo realice vistas de un documento mientras esté en línea y prohíba que los destinatarios la copien.
  • Adjunte la entrada de directiva a la directiva.
  • Proteja un documento con la directiva mediante Acrobat.
Estas acciones resultan en destinatarios que solo pueden vista del documento en línea y no pueden copiarlo. El documento permanece seguro hasta que se elimina la seguridad.
Registrar la directiva
Se debe registrar una nueva directiva antes de poder utilizarla. Después de registrar una política, puede utilizarla para proteger documentos.

Creación de una directiva mediante la API de Java

Cree una directiva mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un DocumentSecurityClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Defina los atributos de la política.
    • Cree un Policy objeto invocando el InfomodelObjectFactory método estático createPolicy del objeto. Este método devuelve un Policy objeto.
    • Establezca el atributo name de la política invocando el Policy método del setName objeto y pasando un valor de cadena que especifica el nombre de la política.
    • Defina la descripción de la política invocando el Policy método del setDescription objeto y pasando un valor de cadena que especifica la descripción de la política.
    • Defina el conjunto de directivas al que pertenece la nueva directiva invocando el Policy método setPolicySetName del objeto y pasando un valor de cadena que especifica el nombre del conjunto de directivas. (Puede especificar null para este valor de parámetro que resulte en que la directiva se agregue al conjunto de directivas Mis políticas ).
    • Cree el período de validez de la política invocando el InfomodelObjectFactory método estático del createValidityPeriod objeto. Este método devuelve un ValidityPeriod objeto.
    • Establezca el número de días para el que se puede acceder a un documento protegido por una política invocando el ValidityPeriod método del setRelativeExpirationDays objeto y pasando un valor entero que especifique el número de días.
    • Establezca el período de validez de la política invocando el Policy método del setValidityPeriod objeto y pasando el ValidityPeriod objeto.
  4. Cree una entrada de directiva.
    • Cree una entrada de política invocando el InfomodelObjectFactory método estático del createPolicyEntry objeto. Este método devuelve un PolicyEntry objeto.
    • Especifique los permisos de la directiva invocando el InfomodelObjectFactory método estático del createPermission objeto. Pase un miembro de datos estático que pertenezca a la Permission interfaz que representa el permiso. Este método devuelve un Permission objeto. Por ejemplo, para agregar el permiso que permite a los usuarios copiar datos de un documento PDF protegido por una política, pase Permission.COPY . (Repita este paso para cada permiso que desee agregar).
    • Añada el permiso para la entrada de política invocando el PolicyEntry método del addPermission objeto y pasando el Permission objeto. (Repita este paso para cada Permission objeto que haya creado).
    • Cree el principal de directiva invocando el InfomodelObjectFactory método estático del createSpecialPrincipal objeto. Pase un miembro de datos que pertenezca al InfomodelObjectFactory objeto que representa el principal. Este método devuelve un Principal objeto. Por ejemplo, para agregar el publicador del documento como principal, pase InfomodelObjectFactory.PUBLISHER_PRINCIPAL .
    • Añada el principal a la entrada de directiva invocando el PolicyEntry método del setPrincipal objeto y pasando el Principal objeto.
    • Añada la entrada de política a la política invocando el Policy método del addPolicyEntry objeto y pasando el PolicyEntry objeto.
  5. Registre la directiva.
    • Cree un PolicyManager objeto invocando el DocumentSecurityClient método getPolicyManager del objeto.
    • Registre la directiva invocando el PolicyManager método del registerPolicy objeto y pasando los siguientes valores:
      • El Policy objeto que representa la directiva que se va a registrar.
    • 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 el DocumentSecurityClient objeto, especifique el nombre del conjunto de políticas al invocar el registerPolicy método. Si pasa un null valor para el conjunto de directivas, la directiva se crea en el conjunto de directivas Mis políticas de administradores.
    Si utiliza un usuario de Seguridad de Documento en la configuración de la conexión, puede invocar el registerPolicy método de sobrecarga que solo acepta la directiva. Es decir, no es necesario especificar el nombre del conjunto de directivas. Sin embargo, la política 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 el registerPolicy método.
    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 utilizan el servicio de seguridad de Documento, consulte lo siguiente:
  • "Inicio rápido (modo SOAP): Creación de una directiva mediante la API de Java"

Creación de una directiva mediante la API de servicio web

Cree una directiva mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un DocumentSecurityServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Defina los atributos de la política.
    • Cree un PolicySpec objeto con su constructor.
    • Defina el nombre de la política asignando un valor de cadena al miembro de datos del PolicySpec objeto name .
    • Defina la descripción de la política asignando un valor de cadena al miembro de datos del PolicySpec objeto description .
    • Defina el conjunto de directivas al que pertenecerá la directiva asignando un valor de cadena al miembro de PolicySpec datos del policySetName objeto. Debe especificar un nombre de conjunto de directivas existente. (Puede especificar null para este valor de parámetro que resulte en que la directiva se agregue a Mis políticas ).
    • Establezca el período de concesión sin conexión de la política asignando un valor entero al miembro de datos del PolicySpec objeto offlineLeasePeriod .
    • Establezca el miembro de datos del PolicySpec policyXml objeto con un valor de cadena que represente los datos XML de PDRL. Para realizar esta tarea, cree un objeto .NET StreamReader con su constructor. Pase la ubicación de un archivo XML PDRL que represente la directiva al constructor StreamReader . A continuación, invoque el StreamReader método ReadLine del objeto y asigne el valor devuelto a una variable de cadena. Repita el StreamReader objeto hasta que el ReadLine método devuelva null. Asigne la variable de cadena al miembro de PolicySpec datos del policyXml objeto.
  4. Cree una entrada de directiva.
    No es necesario crear una entrada de directiva al crear una directiva mediante la API de servicio web de seguridad de Documento. La entrada de directiva se define en el documento PDRL.
  5. Registre la directiva.
    Registre la directiva invocando el DocumentSecurityServiceClient método del registerPolicy objeto y pasando los siguientes valores:
    • El PolicySpec objeto 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 valor que tenga como resultado que la directiva se agregue al conjunto de directivas MyPolices .
    Si utiliza una cuenta de administrador de formularios AEM en la configuración de conexión para crear el DocumentSecurityClient objeto, especifique el nombre del conjunto de políticas al invocar el registerPolicy método.
    Si utiliza un usuario de Documento SecurityDocument Security en la configuración de la conexión, puede invocar el registerPolicy método de sobrecarga que solo acepta la directiva. Es decir, no es necesario especificar el nombre del conjunto de directivas. Sin embargo, la política 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 el registerPolicy método.
    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.
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (MTOM): Creación de una directiva mediante la API de servicio web"
  • "Inicio rápido (SwaRef): Creación de una directiva mediante la API de servicio web"

Modificación de políticas

Puede modificar una directiva existente mediante la API de Java de seguridad de Documento o la API de servicio web. 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 período de validez. Antes de que el cambio surta efecto, debe actualizar la directiva.
Puede modificar una política cuando cambien los requisitos comerciales y ésta ya no refleje dichos requisitos. En lugar de crear una nueva directiva, 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 que se crearon con JAX-WS), debe asegurarse de que la directiva está registrada en el servicio de seguridad de Documento. A continuación, puede hacer referencia a la directiva existente mediante el PolicySpec.getPolicyXml método y modificar los atributos de la política mediante los métodos aplicables. Por ejemplo, puede modificar el período de concesión sin conexión invocando el PolicySpec.setOfflineLeasePeriod método .
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para modificar una directiva existente, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recuperar una directiva existente.
  4. Cambiar atributos de directivas.
  5. Actualice la directiva.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Antes de realizar una operación de Documento Security Service mediante programación, debe crear un objeto cliente de Documento Security Service. Si utiliza la API de Java, cree un RightsManagementClient objeto. Si utiliza la API de servicio web de Documento 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 valor para el nombre del conjunto de directivas, la directiva se recupera del conjunto de directivas Mis directivas .
Definir los atributos de la política
Para modificar una política, se modifica el valor de los atributos de la política. El único atributo de directiva que no se puede cambiar es el atributo name. Por ejemplo, para cambiar el período de concesión sin conexión de la política, puede modificar el valor del atributo de período de concesión sin conexión de la política.
Al modificar el período de concesión sin conexión de una política mediante un servicio Web, se ignora el offlineLeasePeriod campo de la PolicySpec interfaz. Para actualizar el período de concesión sin conexión, modifique el OfflineLeasePeriod elemento en el documento XML de PDRL. A continuación, haga referencia al documento XML de PDRL actualizado utilizando el miembro de datos de la PolicySpec interfaz policyXML .
Para obtener información sobre otros atributos que puede definir, consulte la descripción de la Policy interfaz en la Referencia de API de AEM Forms.
Actualizar la directiva
Antes de que los cambios que realice en una política tengan efecto, debe actualizar la directiva con el servicio de seguridad de Documento. Los cambios en las políticas que protegen documentos se actualizan la próxima vez que el documento protegido por políticas se sincronice con el servicio de seguridad de Documento.

Modificación de directivas existentes mediante la API de Java

Modifique una directiva existente mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un RightsManagementClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recuperar una directiva existente.
    • Cree un PolicyManager objeto invocando el RightsManagementClient método getPolicyManager del objeto.
    • Cree un Policy objeto que represente la directiva que se va a actualizar invocando el PolicyManager método getPolicy del objeto y pasando los siguientes valores"
      • Un valor de cadena que representa el nombre del conjunto de políticas al que pertenece la directiva. Puede especificar null que el resultado sea el conjunto de MyPolicies directivas que se está utilizando.
      • Un valor de cadena que representa el nombre de la política.
  4. Defina los atributos de la política.
    Cambie los atributos de la directiva para cumplir los requisitos comerciales. Por ejemplo, para cambiar el período de concesión sin conexión de la política, invoque el Policy método del setOfflineLeasePeriod objeto.
  5. Actualice la directiva.
    Actualice la directiva invocando PolicyManager el updatePolicy método del objeto. Pase el Policy objeto que representa la directiva que se va a actualizar.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio de seguridad de Documento, consulte el Inicio rápido (modo SOAP): Modificación de una directiva mediante la sección API de Java.

Modificación de directivas existentes mediante la API de servicio Web

Modifique una directiva existente mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un RightsManagementServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperar una directiva existente.
    Cree un PolicySpec objeto que represente la política que se va a modificar invocando el método del RightsManagementServiceClient getPolicy objeto y pasando los siguientes valores:
    • Un valor de cadena que especifica el nombre del conjunto de políticas al que pertenece la directiva. Puede especificar null que el resultado sea el conjunto de MyPolicies directivas que se está utilizando.
    • Un valor de cadena que especifica el nombre de la directiva.
  4. Defina los atributos de la política.
    Cambie los atributos de la directiva para cumplir los requisitos comerciales.
  5. Actualice la directiva.
    Actualice la directiva invocando el RightsManagementServiceClient método updatePolicyFromSDK del objeto y pasando el PolicySpec objeto que representa la directiva que se va a actualizar.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "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

Puede eliminar una directiva existente mediante la API de Java de seguridad de Documento o la API de servicio web. Una vez eliminada una directiva, ya no se puede usar para proteger documentos. Sin embargo, los documentos existentes protegidos por políticas que utilizan la política siguen estando protegidos. Puede eliminar una directiva cuando haya una más reciente disponible.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para eliminar una directiva existente, realice los siguientes pasos:
  1. Incluir archivos de proyecto
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Elimine la directiva.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Para poder realizar una operación de servicio de seguridad de Documento mediante programación, debe crear un objeto cliente de servicio de seguridad de Documento. Si utiliza la API de Java, cree un RightsManagementClient objeto. Si utiliza la API de servicio web de Documento 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 utiliza 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

Elimine una directiva mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un RightsManagementClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Elimine la directiva.
    • Cree un PolicyManager objeto invocando el RightsManagementClient método getPolicyManager del objeto.
    • Para eliminar la directiva, invoque el PolicyManager método del deletePolicy objeto y pase los valores siguientes:
      • Un valor de cadena que especifica el nombre del conjunto de políticas al que pertenece la directiva. Puede especificar null que el resultado sea el conjunto de MyPolicies directivas que se está utilizando.
      • Un valor de cadena que especifica el nombre de la directiva que se va a eliminar.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (modo SOAP): Eliminación de una directiva mediante la API de Java"

Eliminar directivas mediante la API de servicio Web

Elimine una directiva mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un RightsManagementServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Elimine la directiva.
    Para eliminar una política, invoque el RightsManagementServiceClient método del deletePolicy objeto y pase los valores siguientes:
    • Un valor de cadena que especifica el nombre del conjunto de políticas al que pertenece la directiva. Puede especificar null que el resultado sea el conjunto de MyPolicies directivas que se está utilizando.
    • Un valor de cadena que especifica el nombre de la directiva que se va a eliminar.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "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 políticas a Documentos PDF

Puede aplicar una política a un documento PDF para proteger el documento. Al aplicar una política a un documento PDF, se restringe el acceso al documento. No puede aplicar una política a un documento si el documento ya está asegurado con una política.
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 PDF protegido por una política cuando ya no desee que los usuarios accedan al documento.
Puede supervisar el uso de un documento protegido por una política después de distribuirlo. Es decir, puede ver cómo se usa el documento y quién lo está usando. Por ejemplo, puede averiguar cuándo alguien abrió el documento.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para aplicar una política a un documento PDF, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere un documento PDF al que se aplique una política.
  4. Aplicar una directiva existente al documento PDF.
  5. Guarde el documento PDF protegido por una política.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Antes de realizar una operación de servicio de seguridad de Documento mediante programación, cree un objeto cliente de servicio de seguridad de Documento. Si utiliza la API de Java, cree un DocumentSecurityClient objeto. Si utiliza la API de servicio web de Documento Security, cree un DocumentSecurityServiceService objeto.
Recuperar un documento PDF
Puede recuperar un documento PDF para aplicar una política. Después de aplicar una política al documento PDF, los usuarios se ven restringidos al usar el documento. Por ejemplo, si la política no permite que el documento se abra sin conexión, los usuarios deben estar en línea para abrir el documento.
Aplicar una directiva existente al documento PDF
Para aplicar una política a un documento PDF, haga referencia a una política existente y especifique a qué conjunto de políticas pertenece la política. El usuario que está configurando las propiedades de conexión debe tener acceso a la directiva especificada. De lo contrario, se produce una excepción.
Guardar el documento PDF
Después de que el servicio de seguridad de Documento aplique una política a un documento PDF, puede guardar el documento PDF protegido por una política como archivo PDF.
Consulte también

Aplicar una política a un documento PDF mediante la API de Java

Aplicar una política a un documento PDF mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un RightsManagementClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recupere un documento PDF.
    • Cree un java.io.FileInputStream objeto que represente el documento PDF utilizando su constructor. Pase un valor de cadena que especifique la ubicación del documento PDF.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Aplicar una directiva existente al documento PDF.
    • Cree un DocumentManager objeto invocando el RightsManagementClient método getDocumentManager del objeto.
    • Para aplicar una política al documento PDF, invoque el DocumentManager método del protectDocument objeto y pase los valores siguientes:
      • El com.adobe.idp.Document objeto que contiene el documento PDF al que se aplica la política.
      • 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 valor que resulte en el uso del conjunto de MyPolicies directivas.
      • Un valor de cadena que especifica el nombre de la directiva.
      • Un valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser nulo).
      • Un valor de cadena que representa el nombre canónico del usuario del 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 ser null ).
      • Una com.adobe.livecycle.rightsmanagement.Locale que representa la configuración regional que se utiliza para seleccionar la plantilla de MS Office. Este valor de parámetro es opcional y no se utiliza para documentos PDF. Para proteger un documento PDF, especifique null .
      El protectDocument método devuelve un RMSecureDocumentResult objeto que contiene el documento PDF protegido por una política.
  5. Guarde el documento PDF.
    • Invoque el RMSecureDocumentResult método del getProtectedDoc objeto para obtener el documento PDF protegido por una política. Este método devuelve un com.adobe.idp.Document objeto.
    • Cree un java.io.File objeto y asegúrese de que la extensión del archivo es PDF.
    • Invoque el com.adobe.idp.Document método del copyToFile objeto para copiar el contenido del Document objeto en el archivo (asegúrese de utilizar el Document objeto devuelto por el getProtectedDoc método).
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (modo EJB): Aplicación de una política a un documento PDF mediante la API de Java"
  • "Inicio rápido (modo SOAP): Aplicación de una política a un documento PDF mediante la API de Java"
Consulte también

Aplicar una política a un documento PDF mediante la API de servicio Web

Aplicar una política a un documento PDF mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un RightsManagementServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupere un documento PDF.
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar un documento PDF al que se aplica una política.
    • Cree un System.IO.FileStream objeto 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. Determinar el tamaño de la matriz de bytes obteniendo la System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Aplicar una directiva existente al documento PDF.
    Para aplicar una política al documento PDF, invoque el RightsManagementServiceClient método del protectDocument objeto y pase los valores siguientes:
    • El BLOB objeto que contiene el documento PDF al que se aplica la política.
    • 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 valor que resulte en el uso del conjunto de MyPolicies directivas.
    • Un valor de cadena que especifica el nombre de la directiva.
    • Un valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser null ).
    • Un valor de cadena que representa el nombre canónico del usuario del administrador de usuarios que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el valor del parámetro anterior debe ser null ).
    • Un RMLocale valor que especifica el valor de configuración regional (por ejemplo, RMLocale.en ).
    • Parámetro de salida de cadena que se utiliza para almacenar el valor del identificador de directiva.
    • Parámetro de salida de cadena que se utiliza para almacenar el valor de identificador protegido por una política.
    • Parámetro de salida de cadena que se utiliza para almacenar el tipo MIME (por ejemplo, application/pdf ).
    El protectDocument método devuelve un BLOB objeto que contiene el documento PDF protegido por una política.
  5. Guarde el documento PDF.
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento PDF protegido por una política.
    • Cree una matriz de bytes que almacene el contenido de datos del BLOB objeto devuelto por el protectDocument método. Rellene la matriz de bytes obteniendo el valor del miembro de BLOB datos del MTOM objeto.
    • Cree un System.IO.BinaryWriter objeto invocando su constructor y pasando el System.IO.FileStream objeto.
    • Escriba el contenido de la matriz de bytes en un archivo PDF invocando el System.IO.BinaryWriter método Write del objeto y pasando la matriz de bytes.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (MTOM): Aplicación de una política a un documento PDF mediante la API de servicio web"
  • "Inicio rápido (SwaRef): Aplicación de una política a un documento PDF mediante la API de servicio web"

Eliminación de directivas de Documentos PDF

Puede eliminar una política de un documento protegido por una política para eliminar la seguridad del documento. Es decir, si ya no quiere que el documento esté protegido por una política. Si desea actualizar un documento protegido por una política con una política más reciente, en lugar de eliminar la política y agregar la política actualizada, es más eficaz cambiar la política.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para quitar una política de un documento PDF protegido por una política, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere un documento PDF protegido por una política.
  4. Quite la directiva del documento PDF.
  5. Guarde el documento PDF no seguro.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Antes de realizar una operación de servicio de seguridad de Documento mediante programación, cree un objeto cliente de servicio de seguridad de Documento.
Recuperar un documento PDF protegido por una política
Puede recuperar un documento PDF protegido por una política para eliminar una política. Si intenta eliminar una política de un documento PDF que no esté protegido por una política, provocará una excepción.
Quitar la directiva del documento PDF
Puede quitar una directiva de un documento PDF protegido por una política siempre que se especifique un administrador en la configuración de conexión. Si no es así, la política utilizada para proteger un documento debe contener el SWITCH_POLICY permiso para eliminar una política de un documento 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.
Guardar el documento PDF no seguro
Una vez que el servicio de seguridad de Documento haya eliminado una política de un documento PDF, puede guardar el documento PDF no seguro como archivo PDF.
Consulte también

Quitar una directiva de un documento PDF mediante la API de Java

Elimine una política de un documento PDF protegido por una política mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un DocumentSecurityClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recupere un documento PDF protegido por una política.
    • Cree un java.io.FileInputStream objeto que represente el documento PDF protegido por una política utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Quite la directiva del documento PDF.
    • Cree un DocumentManager objeto invocando el DocumentSecurityClient método getDocumentManager del objeto.
    • Elimine una política del documento PDF invocando el DocumentManager método removeSecurity del objeto y pasando el com.adobe.idp.Document objeto que contiene el documento PDF protegido por una política. Este método devuelve un com.adobe.idp.Document objeto que contiene un documento PDF no seguro.
  5. Guarde el documento PDF no seguro.
    • Cree un java.io.File objeto y asegúrese de que la extensión del archivo es PDF.
    • Invoque el Document método del copyToFile objeto para copiar el contenido del Document objeto en el archivo (asegúrese de utilizar el Document objeto devuelto por el removeSecurity método).
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (modo SOAP): Eliminación de una política de un documento PDF mediante la API de Java"

Eliminar una directiva mediante la API de servicio Web

Elimine una política de un documento PDF protegido por una política mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un DocumentSecurityServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del DocumentSecurityServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupere un documento PDF protegido por una política.
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar el documento PDF protegido por una política del que se ha eliminado la directiva.
    • Cree un System.IO.FileStream objeto 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 System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Quite la directiva del documento PDF.
    Elimine la política del documento PDF invocando el DocumentSecurityServiceClient método removePolicySecurity del objeto y pasando el BLOB objeto que contiene el documento PDF protegido por una política. Este método devuelve un BLOB objeto que contiene un documento PDF no seguro.
  5. Guarde el documento PDF no seguro.
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF no seguro.
    • Cree una matriz de bytes que almacene el contenido de datos del BLOB objeto devuelto por el removePolicySecurity método. Rellene la matriz de bytes obteniendo el valor del BLOB campo del MTOM objeto.
    • Cree un System.IO.BinaryWriter objeto invocando su constructor y pasando el System.IO.FileStream objeto.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (MTOM): Eliminación de una política de un documento PDF mediante la API de servicio web"
  • "Inicio rápido (SwaRef): Eliminación de una política de un documento PDF mediante la API de servicio web"
Consulte también

Revocación del acceso a los Documentos

Puede revocar el acceso a un documento PDF protegido por una política, lo que resulta en que los usuarios no tengan acceso a todas las copias del documento. Cuando un usuario intenta abrir un documento PDF revocado, se le redirige a una dirección URL especificada donde se puede ver un documento revisado. La dirección URL a la que se redirige al usuario debe especificarse mediante programación. Cuando se anula el acceso a un documento, el cambio surte efecto la próxima vez que el usuario se sincronice con el servicio de seguridad de Documento abriendo el documento protegido por una política en línea.
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 vista al documento a menos que se restablezca el acceso.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para revocar un documento protegido por una política, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere un documento PDF protegido por una política.
  4. Revocar el documento protegido por una política.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Para poder realizar una operación de servicio de seguridad de Documento mediante programación, debe crear un objeto cliente de servicio de seguridad de Documento.
Recuperar un documento PDF protegido por una política
Debe recuperar un documento PDF protegido por una política para revocarlo. No puede revocar un documento que ya se ha revocado o que no es un documento protegido por una política.
Si conoce el valor del identificador de licencia del documento protegido por una política, no es necesario recuperar el documento PDF protegido por una política. Sin embargo, en la mayoría de los casos, deberá recuperar el documento PDF para obtener el valor del identificador de licencia.
Revocar el documento protegido por una política
Para revocar un documento protegido por una política, especifique el identificador de licencia del documento protegido por una política. Además, puede especificar la dirección URL de un documento que el usuario puede vista cuando intenta abrir el documento revocado. Es decir, supongamos que se revoca un documento obsoleto. Cuando un usuario intente abrir el documento revocado, verá un documento actualizado en lugar del documento revocado.
Si intenta revocar un documento que ya está revocado, se genera una excepción.
Consulte también

Revocar el acceso a documentos mediante la API de Java

Revocar el acceso a un documento PDF protegido por una política mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Creación de un objeto API de cliente de seguridad de Documento
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un DocumentSecurityClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recuperar un documento PDF protegido por una política
    • Cree un java.io.FileInputStream objeto que represente el documento PDF protegido por una política utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Revocar el documento protegido por una política
    • Cree un DocumentManager objeto invocando el DocumentSecurityClient método getDocumentManager del objeto.
    • Recupere el valor del identificador de licencia del documento protegido por una política invocando el DocumentManager método del getLicenseId objeto. Pase el com.adobe.idp.Document objeto que representa el documento protegido por una política. Este método devuelve un valor de cadena que representa el valor del identificador de licencia.
    • Cree un LicenseManager objeto invocando el DocumentSecurityClient método getLicenseManager del objeto.
    • Para anular el documento protegido por una política, invoque el LicenseManager método revokeLicense del objeto y pase los valores siguientes:
      • Un valor de cadena que especifica el valor del identificador de licencia del documento protegido por una política (especifique el valor devuelto del DocumentManager método del getLicenseId objeto).
      • Miembro de datos estático de la License interfaz que especifica el motivo para revocar el documento. For example, you can specify License.DOCUMENT_REVISED .
      • Un java.net.URL valor que especifica la ubicación en la que se encuentra un documento revisado. Si no desea redirigir a un usuario a otra dirección URL, puede pasar null .
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (modo SOAP): Revocación de un documento mediante la API de Java"

Revocar el acceso a documentos mediante la API de servicio web

Revocar el acceso a un documento PDF protegido por una política mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Creación de un objeto API de cliente de seguridad de Documento
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un DocumentSecurityServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del DocumentSecurityServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperar un documento PDF protegido por una política
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar un documento PDF protegido por una política que se revoque.
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF protegido por una política 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 System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Revocar el documento protegido por una política
    • Recupere el valor del identificador de licencia del documento protegido por una política invocando el DocumentSecurityServiceClient método del getLicenseID objeto y pasando el BLOB objeto que representa el documento protegido por una política. Este método devuelve un valor de cadena que representa el identificador de licencia.
    • Para anular el documento protegido por una política, invoque el DocumentSecurityServiceClient método revokeLicense del objeto y pase los valores siguientes:
      • Un valor de cadena que especifica el valor del identificador de licencia del documento protegido por una política (especifique el valor devuelto del DocumentSecurityServiceService método del getLicenseId objeto).
      • Un miembro de datos estático de la enumeración que especifica el motivo para revocar el documento. Reason For example, you can specify Reason.DOCUMENT_REVISED .
      • Un string valor que especifica la ubicación URL en la que se encuentra un documento revisado. Si no desea redirigir a un usuario a otra dirección URL, puede pasar null .
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "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

Restablecimiento del acceso a Documentos revocados

Puede restablecer el acceso a un documento PDF revocado, lo que permite que todos los usuarios tengan acceso a todas las copias del documento revocado. Cuando un usuario abre un documento restablecido que se ha revocado, puede realizar la vista del documento.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para restablecer el acceso a un documento PDF revocado, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere el identificador de licencia del documento PDF revocado.
  4. Restablece el acceso al documento PDF revocado.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Para poder realizar una operación de servicio de seguridad de Documento mediante programación, debe crear un objeto cliente de servicio de seguridad de Documento. Si utiliza la API de Java, cree un DocumentSecurityClient objeto. Si utiliza la API de servicio web de Documento Security, cree un DocumentSecurityServiceService objeto.
Recuperar el identificador de licencia del documento PDF revocado
Debe recuperar el identificador de licencia del documento PDF revocado para restablecer un documento PDF revocado. Después de obtener el valor del identificador de licencia, puede restablecer un documento revocado. Si intenta restablecer un documento que no está revocado, provocará una excepción.
Restablecer el acceso al documento PDF revocado
Para restablecer el acceso a un documento PDF revocado, debe especificar el identificador de licencia del documento revocado. Si intenta restablecer el acceso a un documento PDF que no se ha revocado, provocará una excepción.
Consulte también

Restablecimiento del acceso a documentos revocados mediante la API de Java

Restablecer el acceso a un documento revocado mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un DocumentSecurityClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recupere el identificador de licencia del documento PDF revocado.
    • Cree un java.io.FileInputStream objeto que represente el documento PDF revocado mediante su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
    • Cree un DocumentManager objeto invocando el DocumentSecurityClient método getDocumentManager del objeto.
    • Recupere el valor del identificador de licencia del documento revocado invocando el DocumentManager método getLicenseId del objeto y pasando el com.adobe.idp.Document objeto que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia.
  4. Restablece el acceso al documento PDF revocado.
    • Cree un LicenseManager objeto invocando el DocumentSecurityClient método getLicenseManager del objeto.
    • Restablezca el acceso al documento PDF revocado invocando el LicenseManager método unrevokeLicense del objeto y pasando el valor del identificador de licencia del documento revocado.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (modo SOAP): Restablecimiento del acceso a un documento revocado mediante la API de servicio web"

Restablecimiento del acceso a documentos revocados mediante la API de servicio web

Restablecer el acceso a un documento revocado mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un DocumentSecurityServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del DocumentSecurityServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupere el identificador de licencia del documento PDF revocado.
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar un documento PDF revocado al que se restablece el acceso.
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento 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 System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Restablece el acceso al documento PDF revocado.
    • Recupere el valor del identificador de licencia del documento revocado invocando el DocumentSecurityServiceClient método getLicenseID del objeto y pasando el BLOB objeto que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia.
    • Restablecer el acceso al documento PDF revocado invocando el DocumentSecurityServiceClient método unrevokeLicense del objeto y pasando un valor de cadena que especifica el valor del identificador de licencia del documento PDF revocado (pase el valor devuelto del DocumentSecurityServiceClient método getLicenseId del objeto).
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "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

Inspección de Documentos PDF protegidos por políticas

Puede utilizar la API del servicio de seguridad de Documento (Java y servicio web) para inspeccionar los documentos PDF protegidos por políticas. La inspección de documentos PDF protegidos por políticas devuelve información sobre el documento 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 aseguró el documento.
No puede realizar esta tarea si la versión de LiveCycle es 8.x o una versión anterior. En los AEM Forms se añade la posibilidad de inspeccionar los documentos protegidos por políticas. Si intenta inspeccionar un documento protegido por una política con LiveCycle 8.x (o anterior), se genera una excepción.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para inspeccionar un documento PDF protegido por una política, realice los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere un documento protegido por una política para inspeccionar.
  4. Obtenga información sobre el documento protegido por políticas.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Antes de realizar una operación de servicio de seguridad de Documento mediante programación, cree un objeto cliente de servicio de seguridad de Documento. Si utiliza la API de Java, cree un RightsManagementClient objeto. Si utiliza la API de servicio web de Documento Security, cree un RightsManagementServiceService objeto.
Recuperar un documento protegido por una política para inspeccionar
Para inspeccionar un documento protegido por una política, recuperarlo. Si intenta inspeccionar un documento que no está asegurado con una política o que está revocado, se genera una excepción.
Inspeccionar el documento
Después de recuperar un documento protegido por una política, puede inspeccionarlo.
Obtener información sobre el documento protegido por políticas
Después de inspeccionar un documento PDF protegido por una política, puede obtener información al respecto. Por ejemplo, puede determinar la política que se utiliza para proteger el documento.
Si protege un documento con una política que pertenece a Mis políticas y luego llama RMInspectResult.getPolicysetName o RMInspectResult.getPolicysetId , se devuelve null.
Si el documento está asegurado mediante una política incluida en un conjunto de políticas (que no sea Mis políticas), entonces RMInspectResult.getPolicysetName y RMInspectResult.getPolicysetId devuelve cadenas válidas.
Consulte también

Inspeccionar Documentos PDF protegidos por políticas mediante la API de Java

Inspeccione un documento PDF protegido por una política mediante la API del servicio de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java. Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java para AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión. (Consulte Configuración de propiedades de conexión).
    • Cree un RightsManagementClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recupere un documento protegido por una política para inspeccionar.
    • Cree un java.io.FileInputStream objeto que represente el documento PDF protegido por una política utilizando su constructor. Pase un valor de cadena que especifique la ubicación del documento PDF.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Revise el documento.
    • Cree un DocumentManager objeto invocando el RightsManagementClient método getDocumentManager del objeto.
    • Inspeccione el documento protegido por una política invocando el LicenseManager método inspectDocument del objeto. Pase el com.adobe.idp.Document objeto que contiene el documento PDF protegido por una política. Este método devuelve un RMInspectResult objeto que contiene información sobre el documento protegido por una política.
  5. Obtenga información sobre el documento protegido por políticas.
    Para obtener información sobre el documento protegido por una política, invoque el método adecuado que pertenece al RMInspectResult objeto. Por ejemplo, para recuperar el nombre de la directiva, invoque el RMInspectResult método del getPolicyName objeto.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (modo SOAP): Inspección de documentos PDF protegidos por políticas mediante la API de Java"

Inspeccionar Documentos PDF protegidos por políticas mediante la API de servicio web

Inspeccione un documento PDF protegido por una política mediante la API del servicio de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un RightsManagementServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupere un documento protegido por una política para inspeccionar.
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar un documento PDF que inspeccionar.
    • Cree un System.IO.FileStream objeto invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento 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 System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Revise el documento.
    Inspeccione el documento protegido por una política invocando el RightsManagementServiceClient método inspectDocument del objeto. Pase el BLOB objeto que contiene el documento PDF protegido por una política. Este método devuelve un RMInspectResult objeto que contiene información sobre el documento protegido por una política.
  5. Obtenga información sobre el documento protegido por políticas.
    Para obtener información sobre el documento protegido por una política, obtenga el valor del campo correspondiente que pertenece al RMInspectResult objeto. Por ejemplo, para recuperar el nombre de la política, obtenga el valor del RMInspectResult campo del policyName objeto.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (MTOM): Inspección de documentos PDF protegidos por políticas mediante la API de servicio web"
  • "Inicio rápido (SwaRef): Inspección de documentos PDF protegidos por políticas mediante la API de servicio web"
Consulte también

Creación de marcas de agua

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 política. Es decir, puede establecer el atributo de marca de agua de la política con la marca de agua recién creada. Una vez aplicada una política que contiene una marca de agua a un documento, la marca de agua aparece en el documento protegido por una política.
Solo los usuarios con privilegios de administrador de Documento Security pueden crear marcas de agua. Es decir, debe especificar dicho usuario al definir la configuración de conexión necesaria para crear un objeto cliente del servicio Documento Security.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para crear una marca de agua, realice los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Defina los atributos de las marcas de agua.
  4. Registre la marca de agua en el servicio de seguridad de Documento.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Para poder realizar una operación de servicio de seguridad de Documento mediante programación, debe crear un objeto cliente de servicio de seguridad de Documento. Si utiliza la API de Java, cree un RightsManagementClient objeto. Si utiliza la API de servicio web de Documento Security, cree un RightsManagementServiceService objeto.
Definir los atributos de las marcas de agua
Para crear una nueva marca de agua, debe definir atributos de marca de agua. Siempre se debe definir el atributo name. Además del atributo name, debe establecer al menos uno de los atributos siguientes:
  • Texto personalizado
  • FechaIncluida
  • UserIdIncluded
  • UserNameIncluded
La tabla siguiente lista los pares de clave y valor que son necesarios al crear una marca de agua mediante servicios Web.
Nombre de clave
Descripción
Value
WaterBackCmd:IS_USERNAME_ENABLED
Especifica si el nombre de usuario del usuario que abre el documento forma parte de la marca de agua.
True o false
WaterBackCmd:IS_USERID_ENABLED
Especifica si la identificación del usuario que abre el documento forma parte de la marca de agua.
True o false
WaterBackCmd:IS_CURRENTDATE_ENABLED
Especifica si la fecha actual forma parte de la marca de agua.
True o false
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Si este valor es true, se debe especificar el valor del texto personalizado mediante WaterBackCmd:SRCTEXT .
True o false
WaterBackCmd:OPACITY
Especifica la opacidad de la marca de agua. El valor predeterminado es 0,5 si no se especifica.
Un valor entre 0,0 y 1,0.
WaterBackCmd:ROTATION
Especifica la rotación de la marca de agua. El valor predeterminado es 0 grados.
Un valor entre 0 y 359.
WaterBackCmd:SCALE
Si se especifica este valor, WaterBackCmd:IS_SIZE_ENABLED debe estar presente y el valor debe ser true. Si no se especifica este atributo, el comportamiento predeterminado se ajusta a la página.
Un valor mayor que 0.0 y menor o igual que 1.0.
WaterBackCmd:HORIZ_ALIGN
Especifica la alineación horizontal de la marca de agua. El valor predeterminado es center.
izquierda, centro o derecha
WaterBackCmd:VERT_ALIGN
Especifica la alineación vertical de la marca de agua. El valor predeterminado es center.
superior, central o inferior
WaterBackCmd:IS_USE_BACKGROUND
Especifica si la marca de agua es un fondo. El valor predeterminado es false.
True o false
WaterBackCmd:IS_SIZE_ENABLED
True si se especifica una escala personalizada. Si este valor es true, también se debe especificar SCALE. Si este valor es false, el valor predeterminado se ajusta a la página.
True o false
WaterBackCmd:SRCTEXT
Especifica el texto personalizado para una marca de agua. Si este valor está presente, también WaterBackCmd:IS_CUSTOMTEXT_ENABLED debe estar presente y definido como verdadero.
True o false
Todas las marcas de agua deben tener uno de los atributos siguientes definidos:
  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Todos los demás atributos son opcionales.
Registro de la marca de agua
Una nueva marca de agua debe registrarse en el servicio de seguridad de Documento para poder utilizarla. Después de registrar una marca de agua, puede utilizarla dentro de políticas.
Consulte también

Creación de marcas de agua mediante la API de Java

Cree una marca de agua mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como el adobe-rightsmanagement-client.jar , en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un RightsManagementClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Definir los atributos de marca de agua
    • Cree un Watermark objeto invocando el InfomodelObjectFactory método estático createWatermark del objeto. Este método devuelve un Watermark objeto.
    • Establezca el atributo name de la marca de agua invocando el Watermark método del setName objeto y pasando un valor de cadena que especifica el nombre de la política.
    • Establezca el atributo de fondo de la marca de agua invocando el Watermark método setBackground del objeto y pasando true . Al configurar este atributo, la marca de agua aparece en el fondo del documento.
    • Establezca el atributo de texto personalizado de la marca de agua invocando el Watermark método setCustomText del objeto y pasando un valor de cadena que represente el texto de la marca de agua.
    • Establezca el atributo de opacidad de la marca de agua invocando el Watermark método setOpacity del objeto 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.
  4. Registre la marca de agua.
    • Cree un WatermarkManager objeto invocando el RightsManagementClient método getWatermarkManager del objeto. Este método devuelve un WatermarkManager objeto.
    • Registre la marca de agua invocando el WatermarkManager método registerWatermark del objeto y pasando el Watermark objeto 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.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "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

Cree una marca de agua mediante la API de seguridad de Documento (servicio web):
  1. Cree un objeto API de cliente de seguridad de Documento.
    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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un RightsManagementServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Defina los atributos de marca de agua.
    • Cree un WatermarkSpec objeto invocando el WatermarkSpec constructor.
    • Defina el nombre de la marca de agua asignando un valor de cadena al miembro de WatermarkSpec datos del name objeto.
    • Defina el atributo de la marca de agua id asignando un valor de cadena al miembro de WatermarkSpec datos del id objeto.
    • Para cada propiedad de marca de agua que se va a establecer, cree un MyMapOf_xsd_string_To_xsd_anyType_Item objeto independiente.
    • Establezca el valor clave asignando un valor al miembro de datos del MyMapOf_xsd_string_To_xsd_anyType_Item objeto (por ejemplo, key WaterBackCmd:OPACITY) ).
    • Establezca el valor asignando un valor al miembro de datos del MyMapOf_xsd_string_To_xsd_anyType_Item objeto (por ejemplo, value .25 ).
    • Create a MyArrayOf_xsd_anyType object. Para cada MyMapOf_xsd_string_To_xsd_anyType_Item objeto, invoque el MyArrayOf_xsd_anyType método Add del objeto. Pase el MyMapOf_xsd_string_To_xsd_anyType_Item objeto.
    • Asigne el MyArrayOf_xsd_anyType objeto al miembro de WatermarkSpec datos values del objeto.
  4. Registre la marca de agua.
    Registre la marca de agua invocando el RightsManagementServiceClient método registerWatermark del objeto y pasando el WatermarkSpec objeto que representa la marca de agua que se va a registrar.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
  • "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

Modificación de marcas de agua

Puede modificar una marca de agua existente mediante la API de Java de Documento Security o la API de servicio web. Para realizar cambios en una marca de agua existente, debe recuperarla, modificar sus atributos y, a continuación, actualizarla en el servidor. Por ejemplo, supongamos que recupera una marca de agua y modifica su atributo de opacidad. Antes de que el cambio surta efecto, debe actualizar la marca de agua.
Cuando se modifica una marca de agua, el cambio afecta a los documentos futuros que tienen la marca de agua aplicada. Es decir, los documentos PDF existentes que contienen la marca de agua no se ven afectados.
Solo los usuarios con privilegios administrativos de seguridad de Documento pueden modificar las marcas de agua. Es decir, debe especificar dicho usuario al definir la configuración de conexión necesaria para crear un objeto cliente del servicio Documento Security.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para modificar una marca de agua, realice los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere la marca de agua que desea modificar.
  4. Defina los atributos de las marcas de agua.
  5. Actualice la marca de agua.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Para poder realizar una operación de servicio de seguridad de Documento mediante programación, debe crear un objeto cliente de servicio de seguridad de Documento. Si utiliza la API de Java, cree un DocumentSecurityClient objeto. Si utiliza la API de servicio web de Documento Security, cree un DocumentSecurityServiceService objeto.
Recuperar la marca de agua para modificar
Para modificar una marca de agua, debe recuperar una ya existente. Puede recuperar una marca de agua especificando su nombre o especificando su valor de identificador.
Definir 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, 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.
Al utilizar la API de Java para modificar una marca de agua, no es necesario especificar todos los atributos. Establezca el atributo de marca de agua que desea modificar.
Para obtener información sobre los nombres de atributos de marca de agua, consulte Creación de marcas de agua .
Actualizar la marca de agua
Después de modificar los atributos de una marca de agua, debe actualizarla.
Consulte también

Modificación de marcas de agua mediante la API de Java

Modifique una marca de agua mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un DocumentSecurityClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recupere la marca de agua que desea modificar.
    Cree un WatermarkManager objeto invocando el DocumentSecurityClient método getWatermarkManager del objeto y pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve un Watermark objeto que representa la marca de agua que se va a modificar.
  4. Defina los atributos de marca de agua.
    Establezca el atributo de opacidad de la marca de agua invocando el Watermark método setOpacity del objeto 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.
    Este ejemplo modifica únicamente el atributo opacity.
  5. Actualice la marca de agua.
    • Actualice la marca de agua invocando el WatermarkManager método updateWatermark del objeto y pasando el Watermark objeto cuyo atributo se modificó.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio de seguridad de Documento, consulte el 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

Modifique una marca de agua mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del DocumentSecurityServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupere la marca de agua que desea modificar.
    Recupere la marca de agua que desea modificar invocando el DocumentSecurityServiceClient método getWatermarkByName del objeto. Pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve un WatermarkSpec objeto que representa la marca de agua que se va a modificar.
  4. Defina los atributos de marca de agua.
    • Para cada propiedad de marca de agua que se va a actualizar, cree un MyMapOf_xsd_string_To_xsd_anyType_Item objeto independiente.
    • Establezca el valor clave asignando un valor al miembro de datos del MyMapOf_xsd_string_To_xsd_anyType_Item objeto (por ejemplo, key WaterBackCmd:OPACITY) ).
    • Establezca el valor asignando un valor al miembro de datos del MyMapOf_xsd_string_To_xsd_anyType_Item objeto (por ejemplo, value .50 ).
    • Create a MyArrayOf_xsd_anyType object. Para cada MyMapOf_xsd_string_To_xsd_anyType_Item objeto, invoque el MyArrayOf_xsd_anyType método Add del objeto. Pase el MyMapOf_xsd_string_To_xsd_anyType_Item objeto.
    • Asigne el MyArrayOf_xsd_anyType objeto al miembro de WatermarkSpec datos values del objeto.
  5. Actualice la marca de agua.
    Actualice la marca de agua invocando el DocumentSecurityServiceClient método updateWatermark del objeto y pasando el WatermarkSpec objeto que representa la marca de agua que se va a modificar.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento 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

El servicio Rights Management rastrea 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 una política y la revocación del acceso a documentos. La auditoría de Evento debe estar habilitada para el servicio Rights Management o no se realiza el seguimiento de los eventos.
Los Eventos se incluyen en una de las siguientes categorías:
  • Los eventos de administrador son acciones relacionadas con un administrador, como crear una nueva cuenta de administrador.
  • Los eventos de Documento son acciones relacionadas con un documento, como cerrar un documento protegido por una política.
  • Los eventos de política son acciones relacionadas con una política, como la creación de una nueva política.
  • Los eventos de servicio son acciones relacionadas con el servicio Rights Management, como sincronizar con el directorio del usuario.
Puede buscar eventos específicos mediante la API de Java de Rights Management o la API de servicio web. Al buscar eventos, puede realizar tareas, como crear un archivo de registro de determinados eventos.
Para obtener más información sobre el servicio Rights Management, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para buscar un evento de Rights Management, realice los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto de API de cliente de Rights Management.
  3. Especifique el evento para el cual buscar.
  4. Busque el evento.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto de API de Rights Management Client
Antes de realizar una operación de servicio de Rights Management mediante programación, debe crear un objeto de cliente de servicio de Rights Management. Si utiliza la API de Java, cree un DocumentSecurityClient objeto. Si utiliza la API de 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 nueva directiva.
Buscar el evento
Después de especificar el evento que desea 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

Buscar eventos mediante la API de Java

Busque eventos mediante la API de Rights Management (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Creación de un objeto de API de Rights Management Client
    Cree un DocumentSecurityClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique los eventos para buscar
    • Cree un EventManager objeto invocando el DocumentSecurityClient método getEventManager del objeto. Este método devuelve un EventManager objeto.
    • Cree un EventSearchFilter objeto invocando su constructor.
    • Especifique el evento para el cual buscar invocando el EventSearchFilter método del setEventCode objeto y pasando un miembro de datos estático que pertenece a la EventManager clase que representa el evento para el cual buscar. Por ejemplo, para buscar el evento de creación de directivas, pase EventManager.POLICY_CREATE_EVENT .
    Puede definir criterios de búsqueda adicionales invocando métodos de EventSearchFilter objeto. Por ejemplo, invoque el setUserName método para especificar un usuario asociado al evento.
  4. Buscar el evento
    Busque el evento invocando el EventManager método del searchForEvents objeto y pasando el EventSearchFilter objeto que define los criterios de búsqueda de evento. Este método devuelve una matriz de Event objetos.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Rights Management, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (SOAP): Búsqueda de eventos mediante la API de Java"

Buscar eventos mediante la API de servicio web

Buscar eventos mediante la API de Rights Management (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Creación de un objeto de API de Rights Management Client
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un DocumentSecurityServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del DocumentSecurityServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Especifique los eventos para buscar
    • Cree un EventSpec objeto con su constructor.
    • Especifique el inicio del período de tiempo durante el cual se produjo el evento estableciendo el miembro de datos del EventSpec objeto con firstTime.date una instancia DataTime que represente el inicio del intervalo de fechas en el que se produjo el evento.
    • Asigne el valor true al miembro de EventSpec datos del firstTime.dateSpecified objeto.
    • Especifique el final del período de tiempo durante el cual se produjo el evento estableciendo el miembro de datos del EventSpec objeto con una lastTime.date DataTime instancia que represente el final del intervalo de fechas en el que se produjo el evento.
    • Asigne el valor true al miembro de EventSpec datos del lastTime.dateSpecified objeto.
    • Defina el evento que se va a buscar asignando un valor de cadena al miembro de EventSpec datos del eventCode objeto. La tabla siguiente lista los valores numéricos que se pueden asignar a esta propiedad:
    Tipo de evento
    Value
    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
  4. Buscar el evento
    Busque el evento invocando el DocumentSecurityServiceClient método searchForEvents del objeto y pasando el EventSpec objeto que representa el evento para el cual buscar y el número máximo de resultados. Este método devuelve una MyArrayOf_xsd_anyType colección donde cada elemento es una AuditSpec instancia. Con una AuditSpec instancia, puede obtener información sobre el evento, como la hora en que se produjo. La AuditSpec instancia contiene un miembro timestamp de datos que especifica esta información.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Rights Management, consulte los siguientes Inicios rápidos:
  • "Inicio rápido (MTOM): Búsqueda de eventos mediante la API de servicio web"
  • "Inicio rápido (SwaRef): Búsqueda de eventos mediante la API de servicio web"
Consulte también

Aplicación de políticas a Documentos de Word

Además de los documentos PDF, el servicio Rights Management admite formatos de documento adicionales, como un documento de Microsoft Word (archivo DOC) y otros formatos de archivo de Microsoft Office. Por ejemplo, puede aplicar una política a un documento de Word para protegerlo. Al aplicar una política a un documento de Word, se restringe el acceso al documento. No puede aplicar una política a un documento si el documento ya está asegurado con una política.
Puede supervisar el uso de un documento de Word protegido por una política después de distribuirlo. Es decir, puede ver cómo se usa el documento y quién lo está usando. Por ejemplo, puede averiguar cuándo alguien abrió el documento.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para aplicar una política a un documento de Word, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere un documento de Word al que se aplica una política.
  4. Aplique una directiva existente al documento de Word.
  5. Guarde el documento de Word protegido por una política.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Para poder realizar una operación de servicio de seguridad de Documento mediante programación, debe crear un objeto cliente de servicio de seguridad de Documento.
Recuperar un documento de Word
Debe recuperar un documento de Word para aplicar una política. Después de aplicar una política al documento de Word, los usuarios se ven restringidos al usar el documento. Por ejemplo, si la política no permite que el documento se abra sin conexión, los usuarios deben estar en línea para abrir el documento.
Aplicar una directiva existente al documento de Word
Para aplicar una política a un documento de Word, debe hacer referencia a una política existente y especificar a qué conjunto de políticas pertenece la política. El usuario que está configurando las propiedades de conexión debe tener acceso a la directiva especificada. De lo contrario, se produce una excepción.
Guardar el documento de Word
Después de que el servicio de seguridad de Documento aplique una política a un documento de Word, puede guardar el documento de Word protegido por una política como archivo DOC.
Consulte también

Aplicar una política a un documento de Word mediante la API de Java

Aplicar una política a un documento de Word mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto.
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un DocumentSecurityClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recuperar un documento de Word.
    • Cree un java.io.FileInputStream objeto que represente el documento de Word utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de Word.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Aplique una directiva existente al documento de Word.
    • Cree un DocumentManager objeto invocando el DocumentSecurityClient método getDocumentManager del objeto.
    • Aplique una política al documento de Word invocando el DocumentManager método del protectDocument objeto y pasando los valores siguientes:
      • El com.adobe.idp.Document objeto que contiene el documento de Word al que se aplica la política.
      • 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 valor que resulte en el uso del conjunto de MyPolicies directivas.
      • Un valor de cadena que especifica el nombre de la directiva.
      • Un valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser nulo).
      • Un valor de cadena que representa el nombre canónico del usuario del 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 null , el valor del parámetro anterior debe ser null ).
      • Una com.adobe.livecycle.rightsmanagement.Locale que representa la configuración regional que se utiliza para seleccionar la plantilla de MS Office. Este valor de parámetro es opcional y se puede especificar null .
      El protectDocument método devuelve un RMSecureDocumentResult objeto que contiene el documento de Word protegido por una política.
  5. Guarde el documento de Word.
    • Invoque el RMSecureDocumentResult método del getProtectedDoc objeto para obtener el documento de Word protegido por una política. Este método devuelve un com.adobe.idp.Document objeto.
    • Cree un java.io.File objeto y asegúrese de que la extensión del archivo sea DOC.
    • Invoque el com.adobe.idp.Document método del copyToFile objeto para copiar el contenido del Document objeto en el archivo (asegúrese de utilizar el Document objeto devuelto por el getProtectedDoc método).
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte el siguiente Inicio rápido:
  • "Inicio rápido (modo SOAP): Aplicación de una política a un documento de Word mediante la API de Java"

Aplicar una política a un documento de Word mediante la API de servicio Web

Aplicar una política a un documento de Word mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Cree un objeto API de cliente de seguridad de Documento.
    • Cree un DocumentSecurityServiceClient objeto utilizando su constructor predeterminado.
    • Cree un DocumentSecurityServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del DocumentSecurityServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperar un documento de Word.
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar un documento de Word al que se aplica una política.
    • Cree un System.IO.FileStream objeto 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. Determinar el tamaño de la matriz de bytes obteniendo la System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Aplique una directiva existente al documento de Word.
    Aplique una política al documento de Word invocando el DocumentSecurityServiceClient método del protectDocument objeto y pasando los valores siguientes:
    • El BLOB objeto que contiene el documento de Word al que se aplica la política.
    • 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 valor que resulte en el uso del conjunto de MyPolicies directivas.
    • Un valor de cadena que especifica el nombre de la directiva.
    • Un valor de cadena que representa el nombre del dominio del administrador de usuarios del usuario que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el siguiente valor de parámetro debe ser null ).
    • Un valor de cadena que representa el nombre canónico del usuario del administrador de usuarios que es el editor del documento. Este valor de parámetro es opcional y puede ser nulo (si este parámetro es nulo, el valor del parámetro anterior debe ser null ).
    • Un RMLocale valor que especifica el valor de configuración regional (por ejemplo, RMLocale.en ).
    • Parámetro de salida de cadena que se utiliza para almacenar el valor del identificador de directiva.
    • Parámetro de salida de cadena que se utiliza para almacenar el valor de identificador protegido por una política.
    • Parámetro de salida de cadena que se utiliza para almacenar el tipo MIME (por ejemplo, application/doc ).
    El protectDocument método devuelve un BLOB objeto que contiene el documento de Word protegido por una política.
  5. Guarde el documento de Word.
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de Word protegido por una política.
    • Cree una matriz de bytes que almacene el contenido de datos del BLOB objeto devuelto por el protectDocument método. Rellene la matriz de bytes obteniendo el valor del miembro de BLOB datos del MTOM objeto.
    • Cree un System.IO.BinaryWriter objeto invocando su constructor y pasando el System.IO.FileStream objeto.
    • Escriba el contenido de la matriz de bytes en un archivo de Word invocando el System.IO.BinaryWriter método Write del objeto y pasando la matriz de bytes.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte el siguiente Inicio rápido:
  • "Inicio rápido (MTOM): Aplicación de una política a un documento de Word mediante la API de servicio Web"

Eliminación de directivas de Documentos de Word

Puede eliminar una política de un documento de Word protegido por una política para eliminar la seguridad del documento. Es decir, si ya no quiere que el documento esté protegido por una política. Si desea actualizar un documento de Word protegido por una política con una política más reciente, en lugar de quitar la política y agregar la política actualizada, es más eficaz cambiar la política.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para eliminar una política de un documento de Word protegido por una política, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto
  2. Cree un objeto API de cliente de seguridad de Documento.
  3. Recupere un documento de Word protegido por una política.
  4. Elimine la directiva del documento de Word.
  5. Guardar los documentos de Word no seguros
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Creación de un objeto API de cliente de seguridad de Documento
Antes de realizar una operación de servicio de seguridad de Documento mediante programación, cree un objeto cliente de servicio de seguridad de Documento.
Recuperar un documento de Word protegido por una política
Debe recuperar un documento de Word protegido por una política para eliminar una política. Si intenta eliminar una política de un documento de Word que no esté protegido por una política, provocará una excepción.
Quitar la directiva del documento de Word
Puede quitar una directiva de un documento de Word protegido por una política siempre que se especifique un administrador en la configuración de conexión. Si no es así, la política utilizada para asegurar un documento debe contener el SWITCH_POLICY permiso para eliminar una política 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 palabras no seguro
Después de que el servicio de seguridad de Documento elimine una política de un documento de Word, puede guardar el documento de Word no seguro como archivo DOC.
Consulte también

Quitar una directiva de un documento de Word mediante la API de Java

Elimine una directiva de un documento de Word protegido por una política mediante la API de seguridad de Documento (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
  2. Creación de un objeto API de cliente de seguridad de Documento
    • Cree un ServiceClientFactory objeto que contenga propiedades de conexión.
    • Cree un RightsManagementClient objeto utilizando su constructor y pasando el ServiceClientFactory objeto.
  3. Recuperar un documento de Word protegido por una política
    • Cree un java.io.FileInputStream objeto que represente el documento de Word protegido por una política utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de Word.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Quitar la directiva del documento de Word
    • Cree un DocumentManager objeto invocando el RightsManagementClient método getDocumentManager del objeto.
    • Elimine una política del documento de Word invocando el DocumentManager método removeSecurity del objeto y pasando el com.adobe.idp.Document objeto que contiene el documento de Word protegido por una política. Este método devuelve un com.adobe.idp.Document objeto que contiene un documento de Word no seguro.
  5. Guardar el documento de palabras no seguro
    • Cree un java.io.File objeto y asegúrese de que la extensión del archivo sea DOC.
    • Invoque el Document método del copyToFile objeto para copiar el contenido del Document objeto en el archivo (asegúrese de utilizar el Document objeto devuelto por el removeSecurity método).
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento 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"

Quitar una directiva de un documento de Word mediante la API de servicio Web

Elimine una directiva de un documento de Word protegido por una política mediante la API de seguridad de Documento (servicio web):
  1. 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 .
    Reemplazar localhost por la dirección IP del servidor que aloja AEM Forms.
  2. Creación de un objeto API de cliente de seguridad de Documento
    • Cree un RightsManagementServiceClient objeto utilizando su constructor predeterminado.
    • Cree un RightsManagementServiceClient.Endpoint.Address objeto mediante el System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL .) No es necesario usar el lc_version atributo. Este atributo se utiliza al crear una referencia de servicio).
    • Cree un System.ServiceModel.BasicHttpBinding objeto obteniendo el valor del RightsManagementServiceClient.Endpoint.Binding campo. Convierta el valor devuelto a BasicHttpBinding .
    • Establezca el System.ServiceModel.BasicHttpBinding campo del MessageEncoding objeto en WSMessageEncoding.Mtom . Este valor garantiza que se utilice MTOM.
    • Habilite la autenticación HTTP básica realizando las siguientes tareas:
      • Asigne el nombre de usuario de los formularios AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Asigne el valor de contraseña correspondiente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperar un documento de Word protegido por una política
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar el documento de Word protegido por una política del que se ha eliminado la directiva.
    • Cree un System.IO.FileStream objeto 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 System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.
    • Rellene el BLOB objeto asignando su MTOM campo con el contenido de la matriz de bytes.
  4. Quitar la directiva del documento de Word
    Elimine la política del documento de Word invocando el RightsManagementServiceClient método removePolicySecurity del objeto y pasando el BLOB objeto que contiene el documento de Word protegido por una política. Este método devuelve un BLOB objeto que contiene un documento de Word no seguro.
  5. Guardar el documento de palabras no seguro
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de Word no seguro.
    • Cree una matriz de bytes que almacene el contenido de datos del BLOB objeto devuelto por el removePolicySecurity método. Rellene la matriz de bytes obteniendo el valor del BLOB campo del MTOM objeto.
    • Cree un System.IO.BinaryWriter objeto invocando su constructor y pasando el System.IO.FileStream objeto.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento 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