Los ejemplos y ejemplos de este documento son solo para AEM Forms en el entorno JEE.
Acerca del servicio de seguridad de Documento
El servicio de seguridad de Documento permite a los usuarios aplicar de forma dinámica parámetros 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:
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.
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:
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.
Para crear una directiva, realice los siguientes pasos:
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:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de 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:
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:
Al especificar la opción NoEncryption
, no puede establecer la opción PlaintextMetadata
en false
. Si intenta hacerlo, se genera una excepción.
Para obtener información sobre otros atributos que puede establecer, consulte la descripción de la interfaz Policy
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:
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.
Cree una directiva mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.DocumentSecurityClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Defina los atributos de la política.
Policy
invocando el método estático InfomodelObjectFactory
del objeto createPolicy
. Este método devuelve un objeto Policy
.Policy
del objeto setName
y pasando un valor de cadena que especifique el nombre de la política.Policy
del objeto setDescription
y pasando un valor de cadena que especifica la descripción de la política.Policy
del objeto setPolicySetName
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 directivas).InfomodelObjectFactory
del objeto createValidityPeriod
. Este método devuelve un objeto ValidityPeriod
.ValidityPeriod
del objeto setRelativeExpirationDays
y pasando un valor entero que especifique el número de días.Policy
del objeto setValidityPeriod
y pasando el objeto ValidityPeriod
.Cree una entrada de directiva.
InfomodelObjectFactory
del objeto createPolicyEntry
. Este método devuelve un objeto PolicyEntry
.InfomodelObjectFactory
del objeto createPermission
. Pase un miembro de datos estático que pertenezca a la interfaz Permission
que represente el permiso. Este método devuelve un objeto Permission
. 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).PolicyEntry
del objeto addPermission
y pasando el objeto Permission
. (Repita este paso para cada objeto Permission
que haya creado).InfomodelObjectFactory
del objeto createSpecialPrincipal
. Pase un miembro de datos que pertenezca al objeto InfomodelObjectFactory
que representa el principal. Este método devuelve un objeto Principal
. Por ejemplo, para agregar el publicador del documento como principal, pase InfomodelObjectFactory.PUBLISHER_PRINCIPAL
.PolicyEntry
del objeto setPrincipal
y pasando el objeto Principal
.Policy
del objeto addPolicyEntry
y pasando el objeto PolicyEntry
.Registre la directiva.
Cree un objeto PolicyManager
invocando el método DocumentSecurityClient
del objeto getPolicyManager
.
Registre la directiva invocando el método PolicyManager
del objeto registerPolicy
y pasando los siguientes valores:
Policy
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 la conexión para crear el objeto DocumentSecurityClient
, especifique el nombre del conjunto de directivas al invocar el método registerPolicy
. Si pasa un valor null
para el conjunto de directivas, la directiva se crea en el conjunto de directivas Mis directivas de administradores.
Si utiliza un usuario de Seguridad de Documento en la configuración de la conexión, puede invocar el método registerPolicy
sobrecargado que solo acepta la directiva. Es decir, no es necesario especificar el nombre del conjunto de directivas. Sin embargo, la directiva se agrega al conjunto de directivas denominado Mis directivas. Si no desea agregar la nueva directiva a este conjunto de directivas, especifique un nombre de conjunto de directivas cuando invoque el método registerPolicy
.
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:
Cree una directiva mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto DocumentSecurityServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Defina los atributos de la política.
PolicySpec
utilizando su constructor.PolicySpec
del objeto name
.PolicySpec
del objeto description
.PolicySpec
del objeto policySetName
. Debe especificar un nombre de conjunto de directivas existente. (Puede especificar null
para este valor de parámetro que resulta en que la directiva se agregue a Mis directivas).PolicySpec
del objeto offlineLeasePeriod
.PolicySpec
del objeto policyXml
con un valor de cadena que represente los datos XML de PDRL. Para realizar esta tarea, cree un objeto .NET StreamReader
utilizando su constructor. Pase la ubicación de un archivo XML PDRL que represente la directiva al constructor StreamReader
. A continuación, invoque el método StreamReader
del objeto ReadLine
y asigne el valor devuelto a una variable de cadena. Repita el objeto StreamReader
hasta que el método ReadLine
devuelva null. Asigne la variable de cadena al miembro de datos PolicySpec
del objeto policyXml
.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.
Registre la directiva.
Registre la directiva invocando el método DocumentSecurityServiceClient
del objeto registerPolicy
y pasando los siguientes valores:
PolicySpec
que representa la directiva que se va a registrar.null
que resulte en que la directiva se agregue al conjunto de directivas MyPolices.Si utiliza una cuenta de administrador de formularios AEM en la configuración de la conexión para crear el objeto DocumentSecurityClient
, especifique el nombre del conjunto de directivas al invocar el método registerPolicy
.
Si utiliza un usuario de Documento SecurityDocument Security en la configuración de la conexión, puede invocar el método sobrecargado registerPolicy
que acepta únicamente la directiva. Es decir, no es necesario especificar el nombre del conjunto de directivas. Sin embargo, la directiva se agrega al conjunto de directivas denominado Mis directivas. Si no desea agregar la nueva directiva a este conjunto de directivas, especifique un nombre de conjunto de directivas cuando invoque el método registerPolicy
.
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:
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 método PolicySpec.getPolicyXml
y modificar los atributos de la directiva mediante los métodos aplicables. Por ejemplo, puede modificar el período de concesión sin conexión invocando el método PolicySpec.setOfflineLeasePeriod
.
Para obtener más información sobre el servicio de seguridad de Documento, consulte Referencia de servicios para AEM Forms.
Para modificar una directiva existente, lleve a cabo los siguientes pasos:
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 objeto RightsManagementClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto RightsManagementServiceService
.
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 valor null
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 campo offlineLeasePeriod
de la interfaz PolicySpec
. Para actualizar el período de concesión sin conexión, modifique el elemento OfflineLeasePeriod
en el documento XML de PDRL. A continuación, haga referencia al documento XML de PDRL actualizado mediante el miembro de datos PolicySpec
de la interfaz policyXML
.
Para obtener información sobre otros atributos que puede establecer, consulte la descripción de la interfaz Policy
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.
Modifique una directiva existente mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.RightsManagementClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recuperar una directiva existente.
Cree un objeto PolicyManager
invocando el método RightsManagementClient
del objeto getPolicyManager
.
Cree un objeto Policy
que represente la directiva que se debe actualizar invocando el método PolicyManager
del objeto getPolicy
y pasando los siguientes valores"
null
que resulte en el uso del conjunto de directivas MyPolicies
.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 directiva, invoque el método Policy
del objeto setOfflineLeasePeriod
.
Actualice la directiva.
Actualice la directiva invocando el método PolicyManager
del objeto updatePolicy
. Pase el objeto Policy
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.
Modifique una directiva existente mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto RightsManagementServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperar una directiva existente.
Cree un objeto PolicySpec
que represente la directiva que se va a modificar invocando el método RightsManagementServiceClient
del objeto getPolicy
y pasando los valores siguientes:
null
que resulte en el uso del conjunto de directivas MyPolicies
.Defina los atributos de la política.
Cambie los atributos de la directiva para cumplir los requisitos comerciales.
Actualice la directiva.
Actualice la directiva invocando el método RightsManagementServiceClient
del objeto updatePolicyFromSDK
y pasando el objeto PolicySpec
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:
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.
Para eliminar una directiva existente, realice los siguientes pasos:
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 objeto RightsManagementClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto RightsManagementServiceService
.
Eliminar la directiva
Para eliminar una directiva, especifique la directiva que desea eliminar y el conjunto de directivas al que pertenece la directiva. El usuario cuya configuración se utiliza para invocar AEM Forms debe tener permiso para eliminar la directiva; de lo contrario, se produce una excepción. Del mismo modo, si intenta eliminar una directiva que no existe, se producirá una excepción.
Elimine una directiva mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.RightsManagementClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Elimine la directiva.
Cree un objeto PolicyManager
invocando el método RightsManagementClient
del objeto getPolicyManager
.
Para eliminar la directiva, invoque el método PolicyManager
del objeto deletePolicy
y pase los valores siguientes:
null
que resulte en el uso del conjunto de directivas MyPolicies
.Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Elimine una directiva mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto RightsManagementServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Elimine la directiva.
Para eliminar una directiva, invoque el método RightsManagementServiceClient
del objeto deletePolicy
y pase los valores siguientes:
null
que resulte en el uso del conjunto de directivas MyPolicies
.Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
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.
Para aplicar una política a un documento PDF, lleve a cabo los siguientes pasos:
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 objeto DocumentSecurityClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto DocumentSecurityServiceService
.
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Revocación del acceso a los Documentos
Aplicar una política a un documento PDF mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.RightsManagementClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recupere un documento PDF.
java.io.FileInputStream
que represente el documento PDF mediante su constructor. Pase un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Aplicar una directiva existente al documento PDF.
Cree un objeto DocumentManager
invocando el método RightsManagementClient
del objeto getDocumentManager
.
Aplique una política al documento PDF invocando el método DocumentManager
del objeto protectDocument
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento PDF al que se aplica la política.null
que resulte en el uso del conjunto de directivas MyPolicies
.null
(si este parámetro es nulo, el valor del parámetro anterior debe ser null
).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 método protectDocument
devuelve un objeto RMSecureDocumentResult
que contiene el documento PDF protegido por una política.
Guarde el documento PDF.
RMSecureDocumentResult
del objeto getProtectedDoc
para obtener el documento PDF protegido por políticas. Este método devuelve un objeto com.adobe.idp.Document
.java.io.File
y asegúrese de que la extensión del archivo sea PDF.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo (asegúrese de utilizar el objeto Document
devuelto por el método getProtectedDoc
).Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicar una política a un documento PDF mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto RightsManagementServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. 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 atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupere un documento PDF.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF al que se aplica una política.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF y el modo en que se abre el archivo.System.IO.FileStream
. Para determinar el tamaño de la matriz de bytes, obtenga la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Aplicar una directiva existente al documento PDF.
Aplique una política al documento PDF invocando el método RightsManagementServiceClient
del objeto protectDocument
y pasando los siguientes valores:
BLOB
que contiene el documento PDF al que se aplica la política.null
que resulte en el uso del conjunto de directivas MyPolicies
.null
).null
).RMLocale
que especifica el valor de configuración regional (por ejemplo, RMLocale.en
).application/pdf
).El método protectDocument
devuelve un objeto BLOB
que contiene el documento PDF protegido por una política.
Guarde el documento PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF protegido por una política.BLOB
devuelto por el método protectDocument
. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
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.
Para quitar una política de un documento PDF protegido por una política, lleve a cabo los siguientes pasos:
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 directiva utilizada para asegurar un documento debe contener el permiso SWITCH_POLICY
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de políticas a Documentos PDF
Elimine una política de un documento PDF protegido por una política mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.DocumentSecurityClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recupere un documento PDF protegido por una política.
java.io.FileInputStream
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.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Quite la directiva del documento PDF.
DocumentManager
invocando el método DocumentSecurityClient
del objeto getDocumentManager
.DocumentManager
del objeto removeSecurity
y pasando el objeto com.adobe.idp.Document
que contiene el documento PDF protegido por una política. Este método devuelve un objeto com.adobe.idp.Document
que contiene un documento PDF no seguro.Guarde el documento PDF no seguro.
java.io.File
y asegúrese de que la extensión del archivo sea PDF.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo (asegúrese de utilizar el objeto Document
devuelto por el método removeSecurity
).Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Elimine una política de un documento PDF protegido por una política mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto DocumentSecurityServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo DocumentSecurityServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupere un documento PDF protegido por una política.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar el documento PDF protegido por una política del que se elimina la directiva.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Quite la directiva del documento PDF.
Elimine la directiva del documento PDF invocando el método DocumentSecurityServiceClient
del objeto removePolicySecurity
y pasando el objeto BLOB
que contiene el documento PDF protegido por una política. Este método devuelve un objeto BLOB
que contiene un documento PDF no seguro.
Guarde el documento PDF no seguro.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF no seguro.BLOB
devuelto por el método removePolicySecurity
. Rellene la matriz de bytes obteniendo el valor del campo BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
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.
Para revocar un documento protegido por una política, lleve a cabo los siguientes pasos:
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de políticas a Documentos PDF
Restablecimiento del acceso a Documentos revocados
Revocar el acceso a un documento PDF protegido por una política mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Creación de un objeto API de cliente de seguridad de Documento
ServiceClientFactory
que contenga propiedades de conexión.DocumentSecurityClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recuperar un documento PDF protegido por una política
java.io.FileInputStream
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.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Revocar el documento protegido por una política
Cree un objeto DocumentManager
invocando el método DocumentSecurityClient
del objeto getDocumentManager
.
Recupere el valor del identificador de licencia del documento protegido por una política invocando el método DocumentManager
del objeto getLicenseId
. Pase el objeto com.adobe.idp.Document
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 objeto LicenseManager
invocando el método DocumentSecurityClient
del objeto getLicenseManager
.
Revocar el documento protegido por una política invocando el método LicenseManager
del objeto revokeLicense
y pasando los siguientes valores:
DocumentManager
del objeto getLicenseId
).License
que especifica el motivo para revocar el documento. Por ejemplo, puede especificar License.DOCUMENT_REVISED
.java.net.URL
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:
Revocar el acceso a un documento PDF protegido por una política mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Creación de un objeto API de cliente de seguridad de Documento
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto DocumentSecurityServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo DocumentSecurityServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperar un documento PDF protegido por una política
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF protegido por una política que se revoca.System.IO.FileStream
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.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Revocar el documento protegido por una política
Recupere el valor del identificador de licencia del documento protegido por una política invocando el método DocumentSecurityServiceClient
del objeto getLicenseID
y pasando el objeto BLOB
que representa el documento protegido por una política. Este método devuelve un valor de cadena que representa el identificador de licencia.
Revocar el documento protegido por una política invocando el método DocumentSecurityServiceClient
del objeto revokeLicense
y pasando los siguientes valores:
DocumentSecurityServiceService
del objeto getLicenseId
).Reason
que especifica el motivo para revocar el documento. Por ejemplo, puede especificar Reason.DOCUMENT_REVISED
.string
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:
Consulte también
Eliminación de directivas de Documentos de Word
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
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.
Para restablecer el acceso a un documento PDF revocado, lleve a cabo los siguientes pasos:
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 objeto DocumentSecurityClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto DocumentSecurityServiceService
.
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de políticas a Documentos PDF
Revocación del acceso a los Documentos
Restablecer el acceso a un documento revocado mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.DocumentSecurityClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recupere el identificador de licencia del documento PDF revocado.
java.io.FileInputStream
que represente el documento PDF revocado mediante su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.DocumentManager
invocando el método DocumentSecurityClient
del objeto getDocumentManager
.DocumentManager
del objeto getLicenseId
y pasando el objeto com.adobe.idp.Document
que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia.Restablece el acceso al documento PDF revocado.
LicenseManager
invocando el método DocumentSecurityClient
del objeto getLicenseManager
.LicenseManager
del objeto unrevokeLicense
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:
Restablecer el acceso a un documento revocado mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto DocumentSecurityServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo DocumentSecurityServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupere el identificador de licencia del documento PDF revocado.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF revocado al que se restablece el acceso.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF revocado y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Restablece el acceso al documento PDF revocado.
DocumentSecurityServiceClient
del objeto getLicenseID
y pasando el objeto BLOB
que representa el documento revocado. Este método devuelve un valor de cadena que representa el identificador de licencia.DocumentSecurityServiceClient
del objeto unrevokeLicense
y pasando un valor de cadena que especifica el valor del identificador de licencia del documento PDF revocado (pase el valor devuelto del método DocumentSecurityServiceClient
del objeto getLicenseId
).Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
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 AEM Forms se añade compatibilidad con la inspección de 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.
Para inspeccionar un documento PDF protegido por una política, realice los siguientes pasos:
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 objeto RightsManagementClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto RightsManagementServiceService
.
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.
Inspect 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 a 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), RMInspectResult.getPolicysetName
y RMInspectResult.getPolicysetId
devuelven cadenas válidas.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Inspect es un documento PDF protegido por una política mediante la API del servicio de seguridad de Documento (Java):
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 de AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión. (Consulte Configuración de propiedades de conexión.)RightsManagementClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recupere un documento protegido por una política para inspeccionar.
java.io.FileInputStream
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.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Inspect el documento.
DocumentManager
invocando el método RightsManagementClient
del objeto getDocumentManager
.LicenseManager
del objeto inspectDocument
. Pase el objeto com.adobe.idp.Document
que contiene el documento PDF protegido por una política. Este método devuelve un objeto RMInspectResult
que contiene información sobre el documento protegido por una política.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 apropiado que pertenece al objeto RMInspectResult
. Por ejemplo, para recuperar el nombre de la directiva, invoque el método RMInspectResult
del objeto getPolicyName
.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Inspect es un documento PDF protegido por una política mediante la API del servicio de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto RightsManagementServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupere un documento protegido por una política para inspeccionar.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF que inspeccionar.System.IO.FileStream
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.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Inspect el documento.
Inspect el documento protegido por una política invocando el método RightsManagementServiceClient
del objeto inspectDocument
. Pase el objeto BLOB
que contiene el documento PDF protegido por una política. Este método devuelve un objeto RMInspectResult
que contiene información sobre el documento protegido por una política.
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 objeto RMInspectResult
. Por ejemplo, para recuperar el nombre de la directiva, obtenga el valor del campo RMInspectResult
del objeto policyName
.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte los siguientes Inicios rápidos:
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
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.
Para crear una marca de agua, realice los siguientes pasos:
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 objeto RightsManagementClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto RightsManagementServiceService
.
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:
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 |
---|---|---|
|
Especifica si el nombre de usuario del usuario que abre el documento forma parte de la marca de agua. |
True o false |
|
Especifica si la identificación del usuario que abre el documento forma parte de la marca de agua. |
True o false |
|
Especifica si la fecha actual forma parte de la marca de agua. |
True o false |
|
Si este valor es true, el valor del texto personalizado debe especificarse utilizando |
True o false |
|
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. |
|
Especifica la rotación de la marca de agua. El valor predeterminado es 0 grados. |
Un valor entre 0 y 359. |
|
Si se especifica este valor, |
Un valor mayor que 0.0 y menor o igual que 1.0. |
|
Especifica la alineación horizontal de la marca de agua. El valor predeterminado es center. |
izquierda, centro o derecha |
|
Especifica la alineación vertical de la marca de agua. El valor predeterminado es center. |
superior, central o inferior |
|
Especifica si la marca de agua es un fondo. El valor predeterminado es false. |
True o false |
|
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 |
|
Especifica el texto personalizado para una marca de agua. Si este valor está presente, |
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de políticas a Documentos PDF
Cree una marca de agua mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar
, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.RightsManagementClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Definir los atributos de marca de agua
Watermark
invocando el método estático InfomodelObjectFactory
del objeto createWatermark
. Este método devuelve un objeto Watermark
.Watermark
del objeto setName
y pasando un valor de cadena que especifica el nombre de la directiva.Watermark
del objeto setBackground
y pasando true
. Al configurar este atributo, la marca de agua aparece en el fondo del documento.Watermark
del objeto setCustomText
y pase un valor de cadena que represente el texto de la marca de agua.Watermark
del objeto setOpacity
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.Registre la marca de agua.
WatermarkManager
invocando el método RightsManagementClient
del objeto getWatermarkManager
. Este método devuelve un objeto WatermarkManager
.WatermarkManager
del objeto registerWatermark
y pasando el objeto Watermark
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:
Cree una marca de agua mediante la API de seguridad de Documento (servicio web):
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
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto RightsManagementServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Defina los atributos de marca de agua.
WatermarkSpec
invocando el constructor WatermarkSpec
.WatermarkSpec
del objeto name
.id
de la marca de agua asignando un valor de cadena al miembro de datos WatermarkSpec
del objeto id
.MyMapOf_xsd_string_To_xsd_anyType_Item
independiente.MyMapOf_xsd_string_To_xsd_anyType_Item
del objeto key
(por ejemplo, WaterBackCmd:OPACITY)
.MyMapOf_xsd_string_To_xsd_anyType_Item
del objeto value
(por ejemplo, .25
).MyArrayOf_xsd_anyType
. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item
, invoque el método MyArrayOf_xsd_anyType
del objeto Add
. Pase el objeto MyMapOf_xsd_string_To_xsd_anyType_Item
.MyArrayOf_xsd_anyType
al miembro de datos WatermarkSpec
del objeto values
.Registre la marca de agua.
Registre la marca de agua invocando el método RightsManagementServiceClient
del objeto registerWatermark
y pasando el objeto WatermarkSpec
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:
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
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.
Para modificar una marca de agua, realice los siguientes pasos:
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 objeto DocumentSecurityClient
. Si está utilizando la API de servicio Web de Documento Security, cree un objeto DocumentSecurityServiceService
.
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Modifique una marca de agua mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.DocumentSecurityClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recupere la marca de agua que desea modificar.
Cree un objeto WatermarkManager
invocando el método DocumentSecurityClient
del objeto getWatermarkManager
y pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve un objeto Watermark
que representa la marca de agua que se va a modificar.
Defina los atributos de marca de agua.
Establezca el atributo de opacidad de la marca de agua invocando el método Watermark
del objeto setOpacity
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.
Actualice la marca de agua.
WatermarkManager
del objeto updateWatermark
y pase el objeto Watermark
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.
Modifique una marca de agua mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo DocumentSecurityServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recupere la marca de agua que desea modificar.
Recupere la marca de agua que desea modificar invocando el método DocumentSecurityServiceClient
del objeto getWatermarkByName
. Pase un valor de cadena que especifique el nombre de la marca de agua. Este método devuelve un objeto WatermarkSpec
que representa la marca de agua que se va a modificar.
Defina los atributos de marca de agua.
MyMapOf_xsd_string_To_xsd_anyType_Item
independiente.MyMapOf_xsd_string_To_xsd_anyType_Item
del objeto key
(por ejemplo, WaterBackCmd:OPACITY)
.MyMapOf_xsd_string_To_xsd_anyType_Item
del objeto value
(por ejemplo, .50
).MyArrayOf_xsd_anyType
. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item
, invoque el método MyArrayOf_xsd_anyType
del objeto Add
. Pase el objeto MyMapOf_xsd_string_To_xsd_anyType_Item
.MyArrayOf_xsd_anyType
al miembro de datos WatermarkSpec
del objeto values
.Actualice la marca de agua.
Actualice la marca de agua invocando el método DocumentSecurityServiceClient
del objeto updateWatermark
y pasando el objeto WatermarkSpec
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:
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 de Rights Management o no se realiza el seguimiento de eventos.
Los eventos se incluyen en una de las siguientes categorías:
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.
Para buscar un evento de Rights Management, realice los siguientes pasos:
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 Rights Management
Antes de realizar una operación de servicio Rights Management mediante programación, debe crear un objeto cliente de servicio Rights Management. Si utiliza la API de Java, cree un objeto DocumentSecurityClient
. Si utiliza la API de servicio Web de Rights Management, cree un objeto DocumentSecurityServiceService
.
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 se va a buscar, puede utilizar la API de Java de Rights Management o la API de servicio web de Rights Management para buscar el evento.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Buscar eventos mediante la API de Rights Management (Java):
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Creación de un objeto API de cliente Rights Management
Cree un objeto DocumentSecurityClient
utilizando su constructor y pasando un objeto ServiceClientFactory
que contenga propiedades de conexión.
Especifique los eventos para buscar
EventManager
invocando el método DocumentSecurityClient
del objeto getEventManager
. Este método devuelve un objeto EventManager
.EventSearchFilter
invocando su constructor.EventSearchFilter
del objeto setEventCode
y pasando un miembro de datos estático que pertenece a la clase EventManager
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 objeto EventSearchFilter
. Por ejemplo, invoque el método setUserName
para especificar un usuario asociado al evento.
Buscar el evento
Busque el evento invocando el método EventManager
del objeto searchForEvents
y pasando el objeto EventSearchFilter
que define los criterios de búsqueda de evento. Este método devuelve una matriz de objetos Event
.
Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Rights Management, consulte los siguientes Inicios rápidos:
Buscar eventos mediante la API de Rights Management (servicio web):
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Creación de un objeto API de cliente Rights Management
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto DocumentSecurityServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo DocumentSecurityServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Especifique los eventos para buscar
EventSpec
utilizando su constructor.EventSpec
del objeto firstTime.date
con la instancia DataTime
que representa el inicio del intervalo de fechas cuando se produjo el evento.true
al miembro de datos EventSpec
del objeto firstTime.dateSpecified
.EventSpec
del objeto lastTime.date
con la instancia DataTime
que representa el final del intervalo de fechas cuando se produjo el evento.true
al miembro de datos EventSpec
del objeto lastTime.dateSpecified
.EventSpec
del objeto eventCode
. La tabla siguiente lista los valores numéricos que se pueden asignar a esta propiedad:Tipo de evento |
Valor |
---|---|
|
999 |
|
1000 |
|
1001 |
|
1002 |
|
1003 |
|
1004 |
|
1005 |
|
1006 |
|
1007 |
|
1008 |
|
1009 |
|
2000 |
|
2001 |
|
2002 |
|
2003 |
|
2004 |
|
2005 |
|
2006 |
|
2007 |
|
2008 |
|
2009 |
|
2010 |
|
2011 |
|
2012 |
|
2013 |
|
2014 |
|
3000 |
|
3001 |
|
3002 |
|
3003 |
|
3004 |
|
3005 |
|
4000 |
|
4001 |
|
4002 |
|
4003 |
|
4004 |
|
4005 |
|
5000 |
|
5001 |
|
5002 |
|
5003 |
|
5004 |
|
6000 |
|
7000 |
|
7001 |
|
7002 |
Buscar el evento
Busque el evento invocando el método DocumentSecurityServiceClient
del objeto searchForEvents
y pasando el objeto EventSpec
que representa el evento para el cual buscar y el número máximo de resultados. Este método devuelve una colección MyArrayOf_xsd_anyType
donde cada elemento es una instancia AuditSpec
. Mediante una instancia AuditSpec
, puede obtener información sobre el evento, como la hora en que se produjo. La instancia AuditSpec
contiene un miembro de datos timestamp
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:
Consulte también
Invocación de AEM Forms mediante MTOM
Invocación de AEM Forms mediante SwaRef
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.
Para aplicar una política a un documento de Word, lleve a cabo los siguientes pasos:
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Revocación del acceso a los Documentos
Aplicar una política a un documento de Word mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Cree un objeto API de cliente de seguridad de Documento.
ServiceClientFactory
que contenga propiedades de conexión.DocumentSecurityClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recuperar un documento de Word.
java.io.FileInputStream
que represente el documento de Word utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento de Word.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Aplique una directiva existente al documento de Word.
Cree un objeto DocumentManager
invocando el método DocumentSecurityClient
del objeto getDocumentManager
.
Aplique una directiva al documento de Word invocando el método DocumentManager
del objeto protectDocument
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el documento de Word al que se aplica la directiva.null
que resulte en el uso del conjunto de directivas MyPolicies
.null
(si este parámetro es null
, el valor del parámetro anterior debe ser null
).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 puede especificar null
.El método protectDocument
devuelve un objeto RMSecureDocumentResult
que contiene el documento de Word protegido por una política.
Guarde el documento de Word.
RMSecureDocumentResult
del objeto getProtectedDoc
para obtener el documento de Word protegido por políticas. Este método devuelve un objeto com.adobe.idp.Document
.java.io.File
y asegúrese de que la extensión del archivo sea DOC.com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo (asegúrese de utilizar el objeto Document
devuelto por el método getProtectedDoc
).Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte el siguiente Inicio rápido:
Aplicar una política a un documento de Word mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Cree un objeto API de cliente de seguridad de Documento.
Cree un objeto DocumentSecurityServiceClient
utilizando su constructor predeterminado.
Cree un objeto DocumentSecurityServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo DocumentSecurityServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperar un documento de Word.
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento de Word al que se aplica una política.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento de Word y el modo en que se abre el archivo.System.IO.FileStream
. Para determinar el tamaño de la matriz de bytes, obtenga la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
. Pase la matriz de bytes, la posición inicial y la longitud del flujo para leerlos.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Aplique una directiva existente al documento de Word.
Aplique una directiva al documento de Word invocando el método DocumentSecurityServiceClient
del objeto protectDocument
y pasando los siguientes valores:
BLOB
que contiene el documento de Word al que se aplica la directiva.null
que resulte en el uso del conjunto de directivas MyPolicies
.null
).null
).RMLocale
que especifica el valor de configuración regional (por ejemplo, RMLocale.en
).application/doc
).El método protectDocument
devuelve un objeto BLOB
que contiene el documento de Word protegido por una política.
Guarde el documento de Word.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento de Word protegido por una política.BLOB
devuelto por el método protectDocument
. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte el siguiente Inicio rápido:
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.
Para eliminar una política de un documento de Word protegido por una política, lleve a cabo los siguientes pasos:
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 directiva utilizada para asegurar un documento debe contener el permiso SWITCH_POLICY
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
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Aplicación de políticas a Documentos de Word
Elimine una directiva de un documento de Word protegido por una política mediante la API de seguridad de Documento (Java):
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-rightsmanagement-client.jar, en la ruta de clases del proyecto Java.
Creación de un objeto API de cliente de seguridad de Documento
ServiceClientFactory
que contenga propiedades de conexión.RightsManagementClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recuperar un documento de Word protegido por una política
java.io.FileInputStream
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.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Quitar la directiva del documento de Word
DocumentManager
invocando el método RightsManagementClient
del objeto getDocumentManager
.DocumentManager
del objeto removeSecurity
y pasando el objeto com.adobe.idp.Document
que contiene el documento de Word protegido por una política. Este método devuelve un objeto com.adobe.idp.Document
que contiene un documento de Word no seguro.Guardar el documento de palabras no seguro
java.io.File
y asegúrese de que la extensión del archivo sea DOC.Document
del objeto copyToFile
para copiar el contenido del objeto Document
en el archivo (asegúrese de utilizar el objeto Document
devuelto por el método removeSecurity
).Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte el siguiente Inicio rápido:
Elimine una directiva de un documento de Word protegido por una política mediante la API de seguridad de Documento (servicio web):
Incluir archivos de proyecto
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Reemplace localhost
por la dirección IP del servidor que aloja AEM Forms.
Creación de un objeto API de cliente de seguridad de Documento
Cree un objeto RightsManagementServiceClient
utilizando su constructor predeterminado.
Cree un objeto RightsManagementServiceClient.Endpoint.Address
mediante el constructor System.ServiceModel.EndpointAddress
. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
). No es necesario usar el atributo lc_version
. Este atributo se utiliza al crear una referencia de servicio).
Cree un objeto System.ServiceModel.BasicHttpBinding
obteniendo el valor del campo RightsManagementServiceClient.Endpoint.Binding
. Convierta el valor devuelto a BasicHttpBinding
.
Establezca el campo System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
en WSMessageEncoding.Mtom
. Este valor garantiza que se utilice MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Recuperar un documento de Word protegido por una política
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar el documento de Word protegido por una política del que se elimina la directiva.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento de Word y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.BLOB
asignando su campo MTOM
con el contenido de la matriz de bytes.Quitar la directiva del documento de Word
Elimine la directiva del documento de Word invocando el método RightsManagementServiceClient
del objeto removePolicySecurity
y pasando el objeto BLOB
que contiene el documento de Word protegido por una política. Este método devuelve un objeto BLOB
que contiene un documento de Word no seguro.
Guardar el documento de palabras no seguro
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento de Word no seguro.BLOB
devuelto por el método removePolicySecurity
. Rellene la matriz de bytes obteniendo el valor del campo BLOB
del objeto MTOM
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.Ejemplos de código
Para ver ejemplos de código que utilizan el servicio Documento Security, consulte el siguiente Inicio rápido:
Consulte también
Invocación de AEM Forms mediante MTOM