Protegendo documentos com políticas

Exemplos e exemplos neste documento são apenas para o AEM Forms no ambiente JEE.

Sobre o serviço de segurança de documentos

O serviço de segurança de documentos permite que os usuários apliquem dinamicamente configurações de confidencialidade a documentos da Adobe PDF e mantenham o controle sobre os documentos, independentemente da extensão de distribuição.

O serviço de segurança de documentos impede que as informações se espalhem além do alcance do usuário, permitindo que os usuários mantenham o controle sobre como os recipients usam o documento PDF protegido por políticas. Um usuário pode especificar quem pode abrir um documento, limitar como ele pode usá-lo e monitorar o documento após a distribuição. Um usuário também pode controlar dinamicamente o acesso a um documento protegido por políticas e pode até mesmo revogar dinamicamente o acesso ao documento.

O serviço Segurança de documentos também protege outros tipos de arquivos, como arquivos do Microsoft Word (arquivos DOC). Você pode usar a API do cliente de segurança de documentos para trabalhar com esses tipos de arquivos. As seguintes versões são compatíveis:

• Arquivos do Microsoft Office 2003 (arquivos DOC, XLS, PPT)
• Arquivos do Microsoft Office 2007 (arquivos DOCX, XLSX, PPTX)
• Arquivos PTC Pro/E

Para maior clareza, as duas seções a seguir discutem como trabalhar com documentos do Word:

• Aplicando Políticas a Documentos do Word
• Remover Políticas de Documentos do Word

Você pode realizar essas tarefas usando o serviço Segurança de documentos:

• Criar políticas. Para obter informações, consulte Criando Políticas.
• Modificar políticas. Para obter informações, consulte Modificando Políticas.
• Excluir políticas. Para obter informações, consulte Excluindo Políticas.
• Aplicar políticas a documentos PDF. Para obter informações, consulte Aplicando Políticas a Documentos PDF.
• Remova políticas de documentos PDF. Para obter informações, consulte Removendo Políticas de Documentos PDF.
• Documentos protegidos por políticas da Inspect. Para obter informações, consulte Inspecionando documentos PDF protegidos por política.
• Revogar o acesso a documentos PDF. Para obter informações, consulte Revogando acesso a documentos.
• Retomar o acesso aos documentos revogados. Para obter informações, consulte Reinstalando o Acesso a Documentos Revogados.
• Criar marcas d'água. Para obter informações, consulte Criando Marcas D'Água.
• Procure por eventos. Para obter informações, consulte Procurando Eventos.

Criando Políticas

Você pode criar políticas programaticamente usando a API do Java de segurança de documentos ou a API do serviço da Web. Uma policy é uma coleção de informações que inclui configurações de segurança de documentos, usuários autorizados e direitos de uso. Você pode criar e salvar qualquer número de políticas, usando configurações de segurança apropriadas para diferentes situações e usuários.

As políticas permitem que você execute estas tarefas:

• Especifique os indivíduos que podem abrir o documento. Os recipients podem pertencer à organização ou ser externos a ela.
• Especifique como os destinatários podem usar o documento. Você pode restringir o acesso a diferentes recursos do Acrobat e Adobe Reader. Esses recursos incluem a capacidade de imprimir e copiar texto, adicionar assinaturas e adicionar comentários a um documento.
• Altere as configurações de acesso e segurança a qualquer momento, mesmo depois de distribuir o documento protegido por política.
• Monitore o uso do documento após distribuí-lo. Você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.

Criação de uma política usando serviços da Web

Ao criar uma política usando a API do serviço da Web, consulte um arquivo XML da Linguagem de direitos de documento portátil (PDRL) existente que descreve a política. As permissões de política e o principal são definidos no documento PDRL. O documento XML a seguir é um exemplo de um documento PDRL.

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
       <PolicyEntry>
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>

             <PrincipalName>all_internal_users</PrincipalName>
          </Principal>
       </PolicyEntry>
       <PolicyEntry>
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />

          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />

          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />

          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>

             <PrincipalName>publisher</PrincipalName>
          </Principal>
       </PolicyEntry>

       <OfflineLeasePeriod>
          <Duration>P31D</Duration>
       </OfflineLeasePeriod>

       <AuditSettings isTracked="true" />

       <PolicyValidityPeriod isAbsoluteTime="false">
          <ValidityPeriodRelative>
             <NotBeforeRelative>PT0S</NotBeforeRelative>

             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>

Resumo das etapas

Para criar uma política, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Defina os atributos da política.
4. Crie uma entrada de política.
5. Registre a política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Os seguintes arquivos JAR devem ser adicionados ao classpath do seu projeto:

• adobe-rightsmanagement-client.jar
• namespace.jar (se o AEM Forms estiver implantado no JBoss)
• jaxb-api.jar (se o AEM Forms estiver implantado no JBoss)
• jaxb-impl.jar (se o AEM Forms estiver implantado no JBoss)
• jaxb-libs.jar (se o AEM Forms estiver implantado no JBoss)
• jaxb-xjc.jar (se o AEM Forms for implantado no JBoss)
• relaxngDatatype.jar (se o AEM Forms for implantado no JBoss)
• xsdlib.jar (se o AEM Forms estiver implantado no JBoss)
• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-utilities.jar
• jbossall-client.jar (use um arquivo JAR diferente se o AEM Forms não estiver implantado no JBoss)

Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar um objeto de API do Cliente de segurança de documentos

Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.

Definir os atributos da política

Para criar uma política, defina os atributos da política. Um atributo obrigatório é o nome da política. Os nomes de políticas devem ser exclusivos para cada conjunto de políticas. Um conjunto de políticas é simplesmente uma coleção de políticas. Pode haver duas políticas com o mesmo nome se as políticas pertencerem a conjuntos de políticas separados. No entanto, duas políticas em um único conjunto de políticas não podem ter o mesmo nome de política.

Outro atributo útil a ser definido é o período de validade. Um período de validade é o período durante o qual um documento protegido por uma política é acessível aos destinatários autorizados. Se você não definir esse atributo, a política sempre será válida.

Um período de validade pode ser definido como uma destas opções:

• Um número definido de dias em que o documento é acessível a partir do momento em que o documento é publicado
• Uma data final após a qual o documento não está acessível
• Um intervalo de datas específico para o qual o documento está acessível
• Sempre válido

Você pode especificar apenas uma data de início, o que resulta na validade da política após a data de início. Se você especificar apenas uma data de término, a política será válida até a data de término. No entanto, uma exceção é lançada se uma data inicial e uma data final não estiverem definidas.

Ao definir atributos que pertencem a uma política, também é possível definir configurações de criptografia. Essas configurações de criptografia ocorrem quando a política é aplicada a um documento. Você pode especificar os seguintes valores de criptografia:

• AES256: Representa o algoritmo de criptografia AES com uma chave de 256 bits.
• AES128: Representa o algoritmo de criptografia AES com uma chave de 128 bits.
• NoEncryption: não representa criptografia.

Ao especificar a opção NoEncryption, não é possível definir a opção PlaintextMetadata como false. Se você tentar fazer isso, uma exceção será lançada.

Criar uma entrada de política

Uma entrada de política anexa entidades principais, que são grupos e usuários, e permissões a uma política. Uma política deve ter pelo menos uma entrada política. Considere, por exemplo, que você executa essas tarefas:

• Crie e registre uma entrada de política que permita que um grupo exiba apenas um documento enquanto estiver online e proíba os destinatários de copiá-lo.
• Anexe a entrada de política à política.
• Proteja um documento com a política usando o Acrobat.

Essas ações resultam em recipients serem capazes apenas de exibir o documento online e não poderem copiá-lo. O documento permanece seguro até que a segurança seja removida dele.

Registrar a política

Uma nova política deve ser registrada antes de poder ser usada. Depois de registrar uma política, você pode usá-la para proteger documentos.

Crie uma política usando a API Java

Crie uma política usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Defina os atributos da política.

   • Crie um objeto Policy chamando o método InfomodelObjectFactory estático createPolicy do objeto. Este método retorna um objeto Policy.
   • Defina o atributo de nome da política chamando o método Policy do objeto setName e passando um valor de string que especifica o nome da política.
   • Defina a descrição da política chamando o método Policy do objeto setDescription e passando um valor de string que especifica a descrição da política.
   • Defina o conjunto de políticas ao qual a nova política pertence, chamando o método Policy do objeto e passando um valor de string que especifica o nome do conjunto de políticas. setPolicySetName (Você pode especificar null para esse valor de parâmetro que resulta na política sendo adicionada ao conjunto de políticas Minhas políticas.)
   • Crie o período de validade da política chamando o método InfomodelObjectFactory estático createValidityPeriod do objeto. Este método retorna um objeto ValidityPeriod.
   • Defina o número de dias para os quais um documento protegido por política é acessível, chamando o método ValidityPeriod do objeto setRelativeExpirationDays e passando um valor inteiro que especifica o número de dias.
   • Defina o período de validade da política chamando o método Policy do objeto e transmitindo o objeto ValidityPeriod.setValidityPeriod

4. Crie uma entrada de política.

   • Crie uma entrada de política chamando o método InfomodelObjectFactory estático createPolicyEntry do objeto. Este método retorna um objeto PolicyEntry.
   • Especifique as permissões da política chamando o método InfomodelObjectFactory estático createPermission do objeto. Passe um membro de dados estáticos que pertence à interface Permission que representa a permissão. Este método retorna um objeto Permission. Por exemplo, para adicionar a permissão que permite aos usuários copiar dados de um documento PDF protegido por política, passe Permission.COPY. (Repita essa etapa para cada permissão para adicionar).
   • Adicione a permissão à entrada da política chamando o método PolicyEntry do objeto addPermission e transmitindo o objeto Permission. (Repita essa etapa para cada objeto Permission que você criou).
   • Crie o principal da política chamando o método InfomodelObjectFactory estático createSpecialPrincipal do objeto. Passe um membro de dados que pertence ao objeto InfomodelObjectFactory que representa o principal. Este método retorna um objeto Principal. Por exemplo, para adicionar o editor do documento como principal, passe InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
   • Adicione o principal à entrada da política, chamando o método PolicyEntry do objeto e passando o objeto Principal.setPrincipal
   • Adicione a entrada da política à política chamando o método Policy do objeto addPolicyEntry e transmitindo o objeto PolicyEntry.

5. Registre a política.

   • Crie um objeto PolicyManager chamando o método DocumentSecurityClient getPolicyManager do objeto.

   • Registre a política chamando o método PolicyManager do objeto registerPolicy e transmitindo os seguintes valores:

     • O objeto Policy que representa a política a ser registrada.

   • Um valor de string que representa o conjunto de políticas ao qual a política pertence.

   Se você usar uma conta de administrador do AEM forms nas configurações de conexão para criar o objeto DocumentSecurityClient, especifique o nome do conjunto de políticas ao chamar o método registerPolicy. Se você passar um valor null para o conjunto de políticas, a política será criada no conjunto de políticas de administradores Minhas Políticas.

   Se você usar um usuário de Segurança de documento nas configurações de conexão, poderá invocar o método sobrecarregado registerPolicy que aceita apenas a política. Ou seja, você não precisa especificar o nome do conjunto de políticas. No entanto, a política é adicionada ao conjunto de políticas chamado Minhas Políticas. Se não quiser adicionar a nova política a esse conjunto de políticas, especifique um nome de conjunto de políticas ao chamar o método registerPolicy.

   OBSERVAÇÃO

   Ao criar uma política, faça referência a um conjunto de políticas existente. Se você especificar um conjunto de políticas que não existe, uma exceção será lançada.

Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte:

• "Início rápido (modo SOAP): Criar uma política usando a API do Java"

Criar uma política usando a API do serviço da Web

Crie uma política usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto DocumentSecurityServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Defina os atributos da política.

   • Crie um objeto PolicySpec usando seu construtor.
   • Defina o nome da política atribuindo um valor de string ao membro de dados PolicySpec do objeto name.
   • Defina a descrição da política atribuindo um valor de string ao membro de dados PolicySpec do objeto description.
   • Defina o conjunto de políticas ao qual a política pertencerá, atribuindo um valor de string ao PolicySpec membro de dados policySetName do objeto. Você deve especificar um nome de conjunto de políticas existente. (Você pode especificar null para esse valor de parâmetro que resulta na política sendo adicionada a Minhas Políticas.)
   • Defina o período de concessão offline da política atribuindo um valor inteiro ao membro de dados PolicySpec do objeto offlineLeasePeriod.
   • Defina o membro de dados PolicySpec do objeto policyXml com um valor de string que represente dados XML de PDRL. Para executar essa tarefa, crie um objeto .NET StreamReader usando seu construtor. Passe o local de um arquivo XML PDRL que representa a política para o construtor StreamReader. Em seguida, chame o método StreamReader do objeto e atribua o valor de retorno a uma variável de string. ReadLine Itere pelo objeto StreamReader até que o método ReadLine retorne nulo. Atribua a variável da string ao membro de dados PolicySpec do objeto.policyXml

4. Crie uma entrada de política.

   Não é necessário criar uma entrada de política ao criar uma política usando a API do serviço da Web Document Security. A entrada de política é definida no documento PDRL.

5. Registre a política.

   Registre a política chamando o método DocumentSecurityServiceClient do objeto registerPolicy e transmitindo os seguintes valores:

   • O objeto PolicySpec que representa a política a ser registrada.
   • Um valor de string que representa o conjunto de políticas ao qual a política pertence. Você pode especificar um valor null que resulta na adição da política ao conjunto de políticas MyPolices.

   Se você usar uma conta de administrador do AEM forms nas configurações de conexão para criar o objeto DocumentSecurityClient , especifique o nome do conjunto de políticas ao chamar o método registerPolicy.

   Se você usar um usuário de Segurança de documento nas configurações de conexão, poderá invocar o método sobrecarregado registerPolicy que aceita somente a política. Ou seja, você não precisa especificar o nome do conjunto de políticas. No entanto, a política é adicionada ao conjunto de políticas chamado Minhas Políticas. Se não quiser adicionar a nova política a esse conjunto de políticas, especifique um nome de conjunto de políticas ao chamar o método registerPolicy.

   OBSERVAÇÃO

   Ao criar uma política e especificar um conjunto de políticas, especifique um conjunto de políticas existente. Se você especificar um conjunto de políticas que não existe, uma exceção será lançada.

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Criação de uma política usando a API do serviço da Web"
• "Início rápido (SwaRef): Criação de uma política usando a API do serviço da Web"

Modificando Políticas

Você pode modificar uma política existente usando a API do Java de segurança de documentos ou a API do serviço da Web. Para fazer alterações em uma política existente, você a recupera, a modifica e então atualiza a política no servidor. Por exemplo, suponha que você recupere uma política existente e estenda seu período de validade. Antes que a alteração entre em vigor, você deve atualizar a política.

Você pode modificar uma política quando os requisitos da empresa mudarem e a política não refletir mais esses requisitos. Em vez de criar uma nova política, você pode simplesmente atualizar uma política existente.

Para modificar atributos de política usando um serviço da Web (por exemplo, usando classes proxy Java criadas com JAX-WS), é necessário garantir que a política seja registrada no serviço de Segurança de documento. Você pode fazer referência à política existente usando o método PolicySpec.getPolicyXml e modificar os atributos da política usando os métodos aplicáveis. Por exemplo, você pode modificar o período de concessão offline chamando o método PolicySpec.setOfflineLeasePeriod.

Resumo das etapas

Para modificar uma política existente, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere uma política existente.
4. Alterar atributos de políticas.
5. Atualize a política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService.

Recuperar uma política existente

Você deve recuperar uma política existente para modificá-la. Para recuperar uma política, especifique o nome da política e o conjunto de políticas ao qual a política pertence. Se você especificar um valor null para o nome do conjunto de políticas, a política será recuperada do conjunto de políticas Minhas Políticas.

Definir os atributos da política

Para modificar uma política, você modifica o valor dos atributos de política. O único atributo de política que não pode ser alterado é o atributo name. Por exemplo, para alterar o período de concessão offline da política, você pode modificar o valor do atributo de período de concessão offline da política.

Ao modificar o período de concessão offline de uma política usando um serviço da Web, o campo offlineLeasePeriod na interface PolicySpec é ignorado. Para atualizar o período de concessão offline, modifique o elemento OfflineLeasePeriod no documento XML PDRL. Em seguida, faça referência ao documento XML PDRL atualizado usando o PolicySpec membro de dados policyXML da interface.

Atualizar a política

Antes que as alterações feitas em uma política sejam aplicadas, é necessário atualizar a política com o serviço de Segurança de documentos. As alterações nas políticas que protegem documentos são atualizadas na próxima vez que o documento protegido por política for sincronizado com o serviço de Segurança de documentos.

Modifique as políticas existentes usando a API Java

Modifique uma política existente usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto RightsManagementClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recupere uma política existente.

   • Crie um objeto PolicyManager chamando o método RightsManagementClient getPolicyManager do objeto.

   • Crie um objeto Policy que represente a política a ser atualizada chamando o método PolicyManager do objeto getPolicy e transmitindo os seguintes valores"

     • Um valor de string que representa o nome do conjunto de políticas ao qual a política pertence. Você pode especificar null que resulta no conjunto de políticas MyPolicies sendo usado.
     • Um valor de string que representa o nome da política.

4. Defina os atributos da política.

   Altere os atributos da política para atender às suas necessidades de negócios. Por exemplo, para alterar o período de concessão offline da política, chame o método Policy do objeto setOfflineLeasePeriod.

5. Atualize a política.

   Atualize a política chamando o método PolicyManager do objeto updatePolicy. Passe o objeto Policy que representa a política a ser atualizada.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o Início rápido (modo SOAP): Modificação de uma política usando a seção API do Java .

Modifique as políticas existentes usando a API do serviço da Web

Modifique uma política existente usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto RightsManagementServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recupere uma política existente.

   Crie um objeto PolicySpec que represente a política a ser modificada chamando o método RightsManagementServiceClient do objeto getPolicy e transmitindo os seguintes valores:

   • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar null que resulta no conjunto de políticas MyPolicies sendo usado.
   • Um valor da string que especifica o nome da política.

4. Defina os atributos da política.

   Altere os atributos da política para atender às suas necessidades de negócios.

5. Atualize a política.

   Atualize a política chamando o método RightsManagementServiceClient do objeto updatePolicyFromSDK e transmitindo o objeto PolicySpec que representa a política a ser atualizada.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Modificação de uma política usando a API do serviço da Web"
• "Início rápido (SwaRef): Modificação de uma política usando a API do serviço da Web"

Excluindo Políticas

É possível excluir uma política existente usando a API do Java de segurança de documento ou a API do serviço da Web. Depois que uma política é excluída, ela não pode mais ser usada para proteger documentos. No entanto, os documentos protegidos por políticas que estão usando a política ainda estão protegidos. É possível excluir uma política quando uma nova estiver disponível.

Resumo das etapas

Para excluir uma política existente, execute as seguintes etapas:

1. Incluir arquivos de projeto
2. Crie um objeto da API do Cliente de segurança de documento.
3. Exclua a política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService.

Excluir a política

Para excluir uma política, especifique a política a ser excluída e o conjunto de políticas ao qual a política pertence. O usuário cujas configurações são usadas para chamar o AEM Forms deve ter permissão para excluir a política; caso contrário, ocorrerá uma exceção. Da mesma forma, se você tentar excluir uma política que não existe, ocorrerá uma exceção.

Excluir políticas usando a API Java

Exclua uma política usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto RightsManagementClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Exclua a política.

   • Crie um objeto PolicyManager chamando o método RightsManagementClient getPolicyManager do objeto.

   • Exclua a política chamando o método PolicyManager do objeto deletePolicy e passando os seguintes valores:

     • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar null que resulta no conjunto de políticas MyPolicies sendo usado.
     • Um valor da string que especifica o nome da política a ser excluída.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo SOAP): Excluir uma política usando a API do Java"

Excluir políticas usando a API do serviço da Web

Exclua uma política usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto RightsManagementServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Exclua a política.

   Exclua uma política chamando o método RightsManagementServiceClient do objeto deletePolicy e passando os seguintes valores:

   • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar null que resulta no conjunto de políticas MyPolicies sendo usado.
   • Um valor da string que especifica o nome da política a ser excluída.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Exclusão de uma política usando a API do serviço da Web"
• "Início rápido (SwaRef): Exclusão de uma política usando a API do serviço da Web"

Aplicação de políticas a documentos PDF

É possível aplicar uma política a um documento PDF para proteger o documento. Ao aplicar uma política a um documento PDF, você restringe o acesso ao documento. Não é possível aplicar uma política a um documento se ele já estiver protegido por uma política.

Enquanto o documento estiver aberto, você também poderá restringir o acesso aos recursos do Acrobat e Adobe Reader, incluindo a capacidade de imprimir e copiar texto, fazer alterações e adicionar assinaturas e comentários a um documento. Além disso, você pode revogar um documento PDF protegido por políticas quando não quiser mais que os usuários acessem o documento.

Você pode monitorar o uso de um documento protegido por políticas depois de distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.

Resumo das etapas

Para aplicar uma política a um documento PDF, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere um documento PDF ao qual uma política é aplicada.
4. Aplique uma política existente ao documento PDF.
5. Salve o documento PDF protegido por política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto da API do cliente de segurança de documentos

Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto DocumentSecurityServiceService.

Recuperar um documento PDF

Você pode recuperar um documento PDF para aplicar uma política. Depois de aplicar uma política ao documento PDF, os usuários são restritos ao usar o documento. Por exemplo, se a política não habilitar a abertura do documento offline, os usuários deverão estar online para abrir o documento.

Aplicar uma política existente ao documento PDF

Para aplicar uma política a um documento PDF, consulte uma política existente e especifique a que conjunto de políticas a política pertence. O usuário que está definindo as propriedades de conexão deve ter acesso à política especificada. Caso contrário, ocorrerá uma exceção.

Salvar o documento PDF

Depois que o serviço de segurança de documento aplicar uma política a um documento PDF, você poderá salvar o documento PDF protegido por política como um arquivo PDF.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Revogando o acesso aos documentos

Aplicar uma política a um documento PDF usando a API Java

Aplique uma política a um documento PDF usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto RightsManagementClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recupere um documento PDF.

   • Crie um objeto java.io.FileInputStream que represente o documento PDF usando seu construtor. Passe um valor de string que especifica o local do documento PDF.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

4. Aplique uma política existente ao documento PDF.

   • Crie um objeto DocumentManager chamando o método RightsManagementClient getDocumentManager do objeto.

   • Aplique uma política ao documento PDF chamando o método DocumentManager do objeto protectDocument e transmitindo os seguintes valores:

     • O objeto com.adobe.idp.Document que contém o documento PDF ao qual a política é aplicada.
     • Um valor de string que especifica o nome do documento.
     • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar um valor null que resulta no conjunto de políticas MyPolicies sendo usado.
     • Um valor de string que especifica o nome da política.
     • Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser nulo).
     • Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser null (se esse parâmetro for nulo, o valor do parâmetro anterior deverá ser null).
     • Um com.adobe.livecycle.rightsmanagement.Locale que representa a localidade usada para selecionar o modelo do MS Office. Esse valor de parâmetro é opcional e não é usado para documentos PDF. Para proteger um documento PDF, especifique null.

     O método protectDocument retorna um objeto RMSecureDocumentResult que contém o documento PDF protegido por política.

5. Salve o documento PDF.

   • Chame o método RMSecureDocumentResult do objeto getProtectedDoc para obter o documento PDF protegido por política. Este método retorna um objeto com.adobe.idp.Document.
   • Crie um objeto java.io.File e verifique se a extensão de arquivo é PDF.
   • Chame o método com.adobe.idp.Document do objeto copyToFile para copiar o conteúdo do objeto Document para o arquivo (certifique-se de usar o objeto Document retornado pelo método getProtectedDoc).

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo EJB): Aplicar uma política a um documento PDF usando a API do Java"
• "Início rápido (modo SOAP): Aplicar uma política a um documento PDF usando a API do Java"

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicar uma política a um documento PDF usando a API do serviço da Web

Aplique uma política a um documento PDF usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto RightsManagementServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recupere um documento PDF.

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento PDF ao qual uma política é aplicada.
   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Determine o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Aplique uma política existente ao documento PDF.

   Aplique uma política ao documento PDF chamando o método RightsManagementServiceClient do objeto protectDocument e transmitindo os seguintes valores:

   • O objeto BLOB que contém o documento PDF ao qual a política é aplicada.
   • Um valor de string que especifica o nome do documento.
   • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar um valor null que resulta no conjunto de políticas MyPolicies sendo usado.
   • Um valor de string que especifica o nome da política.
   • Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser null).
   • Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o valor do parâmetro anterior deve ser null).
   • Um valor RMLocale que especifica o valor do local (por exemplo, RMLocale.en).
   • Um parâmetro de saída da string usado para armazenar o valor do identificador de política.
   • Um parâmetro de saída de string usado para armazenar o valor do identificador protegido por política.
   • Um parâmetro de saída de string usado para armazenar o tipo MIME (por exemplo, application/pdf).

   O método protectDocument retorna um objeto BLOB que contém o documento PDF protegido por política.

5. Salve o documento PDF.

   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF protegido por política.
   • Crie uma matriz de bytes que armazene o conteúdo de dados do objeto BLOB retornado pelo método protectDocument. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB do objeto MTOM.
   • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.
   • Grave o conteúdo da matriz de bytes em um arquivo PDF chamando o método System.IO.BinaryWriter do objeto Write e transmitindo a matriz de bytes.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Aplicar uma política a um documento PDF usando a API do serviço da Web"
• "Início rápido (SwaRef): Aplicar uma política a um documento PDF usando a API do serviço da Web"

Removendo políticas de documentos PDF

Você pode remover uma política de um documento protegido por política para remover a segurança do documento. Ou seja, se você não quiser mais que o documento seja protegido por uma política. Se quiser atualizar um documento protegido por uma política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, é mais eficiente mudar a política.

Resumo das etapas

Para remover uma política de um documento PDF protegido por política, execute as seguintes etapas:

1. Incluir arquivos de projeto
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere um documento PDF protegido por política.
4. Remova a política do documento PDF.
5. Salve o documento PDF inseguro.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.

Recuperar um documento PDF protegido por política

Você pode recuperar um documento PDF protegido por uma política para remover uma política. Se você tentar remover uma política de um documento PDF que não está protegido por uma política, ocorrerá uma exceção.

Remover a política do documento PDF

É possível remover uma política de um documento PDF protegido por políticas, desde que um administrador seja especificado nas configurações de conexão. Caso contrário, a política usada para proteger um documento deverá conter a permissão SWITCH_POLICY para remover uma política de um documento PDF. Além disso, o usuário especificado nas configurações de conexão do AEM Forms também deve ter essa permissão. Caso contrário, uma exceção será lançada.

Salvar o documento PDF não seguro

Depois que o serviço de segurança de documentos remove uma política de um documento PDF, é possível salvar o documento PDF não seguro como um arquivo PDF.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicação de políticas a documentos PDF

Remova uma política de um documento PDF usando a API Java

Remova uma política de um documento PDF protegido por políticas usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recupere um documento PDF protegido por política.

   • Crie um objeto java.io.FileInputStream que represente o documento PDF protegido por política usando seu construtor e transmitindo um valor de string que especifique o local do documento PDF.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

4. Remova a política do documento PDF.

   • Crie um objeto DocumentManager chamando o método DocumentSecurityClient getDocumentManager do objeto.
   • Remova uma política do documento PDF chamando o método DocumentManager do objeto e transmitindo o objeto com.adobe.idp.Document que contém o documento PDF protegido por política. removeSecurity Esse método retorna um objeto com.adobe.idp.Document que contém um documento PDF inseguro.

5. Salve o documento PDF inseguro.

   • Crie um objeto java.io.File e verifique se a extensão de arquivo é PDF.
   • Chame o método Document do objeto copyToFile para copiar o conteúdo do objeto Document para o arquivo (certifique-se de usar o objeto Document retornado pelo método removeSecurity).

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo SOAP): Remover uma política de um documento PDF usando a API Java"

Remova uma política usando a API do serviço da Web

Remova uma política de um documento PDF protegido por política usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto DocumentSecurityServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recupere um documento PDF protegido por política.

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar o documento PDF protegido por política do qual a política é removida.
   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Remova a política do documento PDF.

   Remova a política do documento PDF chamando o método DocumentSecurityServiceClient do objeto removePolicySecurity e transmitindo o objeto BLOB que contém o documento PDF protegido por política. Esse método retorna um objeto BLOB que contém um documento PDF inseguro.

5. Salve o documento PDF inseguro.

   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF não seguro.
   • Crie uma matriz de bytes que armazene o conteúdo de dados do objeto BLOB retornado pelo método removePolicySecurity. Preencha a matriz de bytes obtendo o valor do campo BLOB do objeto MTOM.
   • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Remover uma política de um documento PDF usando a API do serviço da Web"
• "Início rápido (SwaRef): Remover uma política de um documento PDF usando a API do serviço da Web"

Consulte também:

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Revogando o acesso aos documentos

Você pode revogar o acesso a um documento PDF protegido por políticas, resultando em todas as cópias do documento serem inacessíveis aos usuários. Quando um usuário tenta abrir um documento PDF revogado, ele é redirecionado para um URL especificado, onde um documento revisado pode ser visualizado. O URL para onde o usuário é redirecionado deve ser especificado de forma programática. Quando você revoga o acesso a um documento, a alteração entrará em vigor na próxima vez que o usuário sincronizar com o serviço de Segurança de documentos, abrindo o documento protegido por política online.

A capacidade de revogar o acesso a um documento fornece segurança adicional. Por exemplo, suponha que uma versão mais recente de um documento esteja disponível e você não quer mais que ninguém visualize a versão desatualizada. Nessa situação, o acesso ao documento mais antigo pode ser revogado e ninguém pode exibi-lo a menos que o acesso seja recriado.

Resumo das etapas

Para revogar um documento protegido por política, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere um documento PDF protegido por política.
4. Revogar o documento protegido por política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento.

Recuperar um documento PDF protegido por política

Você deve recuperar um documento PDF protegido por política para revogá-lo. Não é possível revogar um documento que já foi revogado ou que não é um documento protegido por uma política.

Se você souber o valor do identificador de licença do documento protegido por política, não será necessário recuperar o documento PDF protegido por política. No entanto, na maioria dos casos, será necessário recuperar o documento PDF para obter o valor do identificador de licença.

Revogar o documento protegido por política

Para revogar um documento protegido por política, especifique o identificador de licença do documento protegido por política. Além disso, você pode especificar o URL de um documento que o usuário pode visualizar ao tentar abrir o documento revogado. Ou seja, suponha que um documento desatualizado seja revogado. Quando um usuário tenta abrir o documento revogado, ele verá um documento atualizado em vez do documento revogado.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicação de políticas a documentos PDF

Reposição do acesso a documentos revisados

Revogar o acesso a documentos usando a API Java

Revogar o acesso a um documento PDF protegido por políticas usando a API de segurança de documentos (Java):

1. Incluir arquivos de projeto

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Criar um objeto de API do Cliente de segurança de documentos

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recuperar um documento PDF protegido por política

   • Crie um objeto java.io.FileInputStream que represente o documento PDF protegido por política usando seu construtor e transmitindo um valor de string que especifique o local do documento PDF.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

4. Revogar o documento protegido por política

   • Crie um objeto DocumentManager chamando o método DocumentSecurityClient getDocumentManager do objeto.

   • Recupere o valor do identificador da licença do documento protegido por política, chamando o método DocumentManager do objeto getLicenseId. Passe o objeto com.adobe.idp.Document que representa o documento protegido por política. Esse método retorna um valor de string que representa o valor do identificador de licença.

   • Crie um objeto LicenseManager chamando o método DocumentSecurityClient getLicenseManager do objeto.

   • Revoge o documento protegido por política, chamando o método LicenseManager do objeto revokeLicense e transmitindo os seguintes valores:

     • Um valor de string que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno do método DocumentManager do objeto getLicenseId).
     • Um membro de dados estáticos da interface License que especifica o motivo para revogar o documento. Por exemplo, você pode especificar License.DOCUMENT_REVISED.
     • Um valor java.net.URL que especifica o local onde um documento revisado está localizado. Se você não deseja redirecionar um usuário para outro URL, é possível enviar null.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo SOAP): Revogar um documento usando a API do Java"

Revogar o acesso a documentos usando a API do serviço da Web

Revogar o acesso a um documento PDF protegido por políticas usando a API de segurança de documentos (serviço da Web):

1. Incluir arquivos de projeto

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Criar um objeto de API do Cliente de segurança de documentos

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto DocumentSecurityServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recuperar um documento PDF protegido por política

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento PDF protegido por política que é revogado.
   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF protegido por política a ser revogado e o modo no qual o arquivo será aberto.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Revogar o documento protegido por política

   • Recupere o valor do identificador da licença do documento protegido por política, chamando o método DocumentSecurityServiceClient do objeto getLicenseID e transmitindo o objeto BLOB que representa o documento protegido por política. Esse método retorna um valor de string que representa o identificador de licença.

   • Revoge o documento protegido por política, chamando o método DocumentSecurityServiceClient do objeto revokeLicense e transmitindo os seguintes valores:

     • Um valor de string que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno do método DocumentSecurityServiceService do objeto getLicenseId).
     • Um membro de dados estáticos do enum Reason que especifica o motivo para revogar o documento. Por exemplo, você pode especificar Reason.DOCUMENT_REVISED.
     • Um valor string que especifica o local do URL para onde um documento revisado está localizado. Se você não deseja redirecionar um usuário para outro URL, é possível enviar null.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Revogar um documento usando a API de serviço da Web"
• "Início rápido (SwaRef): Revogar um documento usando a API de serviço da Web"

Consulte também:

Remover Políticas de Documentos do Word

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Reinstalando o acesso aos documentos revogados

Você pode restabelecer o acesso a um documento PDF revogado, resultando em todas as cópias do documento revogado serem acessíveis aos usuários. Quando um usuário abre um documento recriado que foi revogado, ele pode visualizar o documento.

Resumo das etapas

Para restabelecer o acesso a um documento PDF revogado, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere o identificador da licença do documento PDF revogado.
4. Retomar o acesso ao documento PDF revogado.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto DocumentSecurityServiceService.

Recuperar o identificador de licença do documento PDF revogado

Você deve recuperar o identificador de licença do documento PDF revogado para restabelecer um documento PDF revogado. Após obter o valor do identificador de licença, é possível reinstalar um documento revogado. Se tentar reinstalar um documento que não foi revogado, ocorrerá uma exceção.

Retomar o acesso ao documento PDF revogado

Para restabelecer o acesso a um documento PDF revogado, você deve especificar o identificador de licença do documento revogado. Se você tentar restabelecer o acesso a um documento PDF que não foi revogado, ocorrerá uma exceção.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicação de políticas a documentos PDF

Revogando o acesso aos documentos

Retomar o acesso a documentos revogados usando a API Java

Instale novamente o acesso a um documento revogado usando a API de segurança de documento (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recupere o identificador da licença do documento PDF revogado.

   • Crie um objeto java.io.FileInputStream que represente o documento PDF revogado usando seu construtor e passando um valor de string que especifica o local do documento PDF.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.
   • Crie um objeto DocumentManager chamando o método DocumentSecurityClient getDocumentManager do objeto.
   • Recupere o valor do identificador da licença do documento revogado, chamando o método DocumentManager do objeto getLicenseId e transmitindo o objeto com.adobe.idp.Document que representa o documento revogado. Esse método retorna um valor de string que representa o identificador de licença.

4. Retomar o acesso ao documento PDF revogado.

   • Crie um objeto LicenseManager chamando o método DocumentSecurityClient getLicenseManager do objeto.
   • Reinstale o acesso ao documento PDF revogado chamando o método LicenseManager do objeto unrevokeLicense e transmitindo o valor do identificador de licença do documento revogado.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo SOAP): Reposição do acesso a um documento revogado usando a API do serviço da Web"

Retomar o acesso a documentos revogados usando a API do serviço da Web

Instale novamente o acesso a um documento revogado usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto DocumentSecurityServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recupere o identificador da licença do documento PDF revogado.

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento PDF revogado para o qual o acesso é restabelecido.
   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF revogado e o modo no qual o arquivo será aberto.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Retomar o acesso ao documento PDF revogado.

   • Recupere o valor do identificador da licença do documento revogado, chamando o método DocumentSecurityServiceClient do objeto getLicenseID e transmitindo o objeto BLOB que representa o documento revogado. Esse método retorna um valor de string que representa o identificador de licença.
   • Reinstale o acesso ao documento PDF revogado chamando o método DocumentSecurityServiceClient do objeto e passando um valor de string que especifica o valor do identificador de licença do documento PDF revogado (passe o valor de retorno do método DocumentSecurityServiceClient do objeto getLicenseId).unrevokeLicense

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Reposição do acesso a um documento revogado usando a API do serviço da Web"
• "Início rápido (SwaRef): Reposição do acesso a um documento revogado usando a API do serviço da Web"

Consulte também:

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Como inspecionar Documentos PDF Protegidos pela Política

Você pode usar a API do Serviço de segurança de documentos (Java e serviço da Web) para inspecionar documentos PDF protegidos por políticas. Inspecionar documentos PDF protegidos por política retorna informações sobre o documento PDF protegido por política. Você pode, por exemplo, determinar a política usada para proteger o documento e a data em que o documento foi protegido.

Não é possível executar essa tarefa se a versão do LiveCycle for 8.x ou anterior. O suporte para inspecionar documentos protegidos por políticas é adicionado no AEM Forms. Se você tentar inspecionar um documento protegido por uma política usando o LiveCycle 8.x (ou anterior), uma exceção será lançada.

Resumo das etapas

Para inspecionar um documento PDF protegido por uma política, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere um documento protegido por política para inspecionar.
4. Obtenha informações sobre o documento protegido por políticas.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService.

Recuperar um documento protegido por política para inspecionar

Para inspecionar um documento protegido por política, recupere-o. Se você tentar inspecionar um documento que não está protegido com uma política ou que foi revogado, uma exceção será lançada.

Inspect o documento

Depois de recuperar um documento protegido por políticas, você pode inspecioná-lo.

Obter informações sobre o documento protegido por políticas

Após inspecionar um documento PDF protegido por políticas, você pode obter informações sobre ele. Por exemplo, você pode determinar a política usada para proteger o documento.

Se você proteger um documento com uma política que pertence a Minhas Políticas e, em seguida, chamar RMInspectResult.getPolicysetName ou RMInspectResult.getPolicysetId, null será retornado.

Se o documento estiver protegido usando uma política contida em um conjunto de políticas (diferente de Minhas Políticas), RMInspectResult.getPolicysetName e RMInspectResult.getPolicysetId retornará sequências de caracteres válidas.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Documentos PDF protegidos pela política Inspect usando a API Java

Inspect um documento PDF protegido por políticas usando a API do Serviço de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como o adobe-rights-management-client.jar, no caminho de classe do seu projeto Java. Para obter informações sobre a localização desses arquivos, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão. (Consulte Definindo propriedades de conexão.)
   • Crie um objeto RightsManagementClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recupere um documento protegido por política para inspecionar.

   • Crie um objeto java.io.FileInputStream que represente o documento PDF protegido por política usando seu construtor. Passe um valor de string que especifica o local do documento PDF.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

4. Inspect o documento.

   • Crie um objeto DocumentManager chamando o método RightsManagementClient getDocumentManager do objeto.
   • Inspect o documento protegido por política, chamando o método LicenseManager do objeto inspectDocument. Passe o objeto com.adobe.idp.Document que contém o documento PDF protegido por política. Este método retorna um objeto RMInspectResult que contém informações sobre o documento protegido por política.

5. Obtenha informações sobre o documento protegido por políticas.

   Para obter informações sobre o documento protegido por política, chame o método apropriado que pertence ao objeto RMInspectResult. Por exemplo, para recuperar o nome da política, chame o método RMInspectResult do objeto getPolicyName.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo SOAP): Como inspecionar documentos PDF protegidos por política usando a API Java"

Documentos PDF protegidos pela política do Inspect usando a API de serviço da Web

Inspect um documento PDF protegido por políticas usando a API do Serviço de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto RightsManagementServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recupere um documento protegido por política para inspecionar.

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento PDF a ser inspecionado.
   • Crie um objeto System.IO.FileStream chamando seu construtor. Passe um valor de string que representa o local do arquivo do documento PDF e o modo para abrir o arquivo.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Inspect o documento.

   Inspect o documento protegido por política, chamando o método RightsManagementServiceClient do objeto inspectDocument. Passe o objeto BLOB que contém o documento PDF protegido por política. Este método retorna um objeto RMInspectResult que contém informações sobre o documento protegido por política.

5. Obtenha informações sobre o documento protegido por políticas.

   Para obter informações sobre o documento protegido por política, obtenha o valor do campo apropriado que pertence ao objeto RMInspectResult. Por exemplo, para recuperar o nome da política, obtenha o valor do campo RMInspectResult do objeto policyName.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Como inspecionar documentos PDF protegidos por política usando a API de serviço da Web"
• "Início rápido (SwaRef): Como inspecionar documentos PDF protegidos por política usando a API de serviço da Web"

Consulte também:

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Criação de marcas d'água

As marcas d'água ajudam a garantir a segurança de um documento, identificando-o exclusivamente e controlando a violação de direitos autorais. Por exemplo, você pode criar e colocar uma marca d'água que declare Confidencial em todas as páginas de um documento. Depois que uma marca d'água é criada, é possível incluí-la como parte de uma política. Ou seja, você pode definir o atributo de marca d'água da política com a marca d'água recém-criada. Depois que uma política que contém uma marca d'água é aplicada a um documento, a marca d'água aparece no documento protegido por política.

Resumo das etapas

Para criar uma marca d'água, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Defina os atributos de marca d'água.
4. Registre a marca d'água no serviço de segurança de documentos.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService.

Definir os atributos de marcas d'água

Para criar uma nova marca d'água, você deve definir atributos de marca d'água. O atributo name deve ser sempre definido. Além do atributo name, você deve definir pelo menos um dos seguintes atributos:

• Texto personalizado
• DateIncluded
• UserIdIncluded
• UserNameIncluded

A tabela a seguir lista os pares de chaves e valores necessários ao criar uma marca d'água usando serviços da Web.

Nome da chave	Descrição	Valor
WaterBackCmd:IS_USERNAME_ENABLED	Especifica se o nome de usuário do usuário que abre o documento faz parte da marca d'água.	Verdadeiro ou Falso
WaterBackCmd:IS_USERID_ENABLED	Especifica se a identificação do usuário que abre o documento faz parte da marca d'água.	Verdadeiro ou Falso
WaterBackCmd:IS_CURRENTDATE_ENABLED	Especifica se a data atual faz parte da marca d'água.	Verdadeiro ou Falso
WaterBackCmd:IS_CUSTOMTEXT_ENABLED	Se esse valor for true, o valor do texto personalizado deverá ser especificado usando WaterBackCmd:SRCTEXT.	Verdadeiro ou Falso
WaterBackCmd:OPACITY	Especifica a opacidade da marca d'água. O valor padrão é 0,5 se não for especificado.	Um valor entre 0,0 e 1,0.
WaterBackCmd:ROTATION	Especifica a rotação da marca d'água. O valor padrão é 0 graus.	Um valor entre 0 e 359.
WaterBackCmd:SCALE	Se esse valor for especificado, WaterBackCmd:IS_SIZE_ENABLED deverá estar presente e o valor deverá ser verdadeiro. Se esse atributo não for especificado, o comportamento padrão se ajustará à página.	Um valor superior a 0.0 e inferior ou igual a 1.0.
WaterBackCmd:HORIZ_ALIGN	Especifica o alinhamento horizontal da marca d'água. O valor padrão é central.	esquerda, central ou direita
WaterBackCmd:VERT_ALIGN	Especifica o alinhamento vertical da marca d'água. O valor padrão é central.	superior, central ou inferior
WaterBackCmd:IS_USE_BACKGROUND	Especifica se a marca d'água é um plano de fundo. O valor padrão é false.	Verdadeiro ou Falso
WaterBackCmd:IS_SIZE_ENABLED	True se uma escala personalizada for especificada. Se este valor for verdadeiro, SCALE também deverá ser especificado. Se esse valor for falso, o padrão se ajusta à página.	Verdadeiro ou Falso
WaterBackCmd:SRCTEXT	Especifica o texto personalizado de uma marca d'água. Se esse valor estiver presente, WaterBackCmd:IS_CUSTOMTEXT_ENABLED também deverá estar presente e definido como true.	Verdadeiro ou Falso

Todas as marcas d'água devem ter um dos seguintes atributos definidos:

• WaterBackCmd:IS_USERNAME_ENABLED
• WaterBackCmd:IS_USERID_ENABLED
• WaterBackCmd:IS_CURRENTDATE_ENABLED
• WaterBackCmd:IS_CUSTOMTEXT_ENABLED

Todos os outros atributos são opcionais.

Registrar a marca d'água

Uma nova marca d'água deve ser registrada no serviço de segurança de documentos antes de poder ser usada. Depois de registrar uma marca d'água, você pode usá-la nas políticas.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicação de políticas a documentos PDF

Criar marcas d'água usando a API Java

Crie uma marca d'água usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rightsmanagement-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto RightsManagementClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Definir os atributos de marca d'água

   • Crie um objeto Watermark chamando o método InfomodelObjectFactory estático createWatermark do objeto. Este método retorna um objeto Watermark.
   • Defina o atributo name da marca d'água chamando o método Watermark do objeto setName e passando um valor de string que especifica o nome da política.
   • Defina o atributo de plano de fundo da marca d'água chamando o método Watermark do objeto setBackground e transmitindo true. Ao definir esse atributo, a marca d'água aparece no plano de fundo do documento.
   • Defina o atributo de texto personalizado da marca d'água chamando o método Watermark do objeto setCustomText e passando um valor de string que representa o texto da marca d'água.
   • Defina o atributo de opacidade da marca d'água chamando o método Watermark do objeto setOpacity e passando um valor inteiro que especifica o nível de opacidade. Um valor de 100 indica que a marca d'água é completamente opaca e um valor de 0 indica que a marca d'água é completamente transparente.

4. Registre a marca d'água.

   • Crie um objeto WatermarkManager chamando o método RightsManagementClient getWatermarkManager do objeto. Este método retorna um objeto WatermarkManager.
   • Registre a marca d'água chamando o método WatermarkManager do objeto registerWatermark e transmitindo o objeto Watermark que representa a marca d'água a ser registrada. Esse método retorna um valor de string que representa o valor de identificação da marca d'água.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (modo SOAP): Criar uma marca d'água usando a API do Java"

Criar marcas d'água usando a API do serviço da Web

Crie uma marca d'água usando a API de segurança de documentos (serviço da Web):

1. Crie um objeto da API do Cliente de segurança de documento.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto RightsManagementServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Defina os atributos de marca d'água.

   • Crie um objeto WatermarkSpec chamando o construtor WatermarkSpec.
   • Defina o nome da marca d'água atribuindo um valor de string ao WatermarkSpec membro de dados name do objeto.
   • Defina o atributo id da marca d'água atribuindo um valor de string ao WatermarkSpec membro de dados id do objeto.
   • Para cada propriedade de marca d'água a ser definida, crie um objeto MyMapOf_xsd_string_To_xsd_anyType_Item separado.
   • Defina o valor da chave atribuindo um valor ao MyMapOf_xsd_string_To_xsd_anyType_Item membro de dados key do objeto (por exemplo, WaterBackCmd:OPACITY).
   • Defina o valor atribuindo um valor ao MyMapOf_xsd_string_To_xsd_anyType_Item membro de dados value do objeto (por exemplo, .25).
   • Crie um objeto MyArrayOf_xsd_anyType. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item, chame o método MyArrayOf_xsd_anyType do objeto Add. Passe o objeto MyMapOf_xsd_string_To_xsd_anyType_Item.
   • Atribua o objeto MyArrayOf_xsd_anyType ao membro de dados WatermarkSpec do objeto values.

4. Registre a marca d'água.

   Registre a marca d'água chamando o método RightsManagementServiceClient do objeto registerWatermark e transmitindo o objeto WatermarkSpec que representa a marca d'água a ser registrada.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Criação de uma marca d'água usando a API do serviço da Web"
• "Início rápido (SwaRef): Criação de uma marca d'água usando a API do serviço da Web"

Consulte também:

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Modificação de Marcas D'Água

Você pode modificar uma marca d'água existente usando a API do Java de segurança de documento ou a API do serviço da Web. Para fazer alterações em uma marca d'água existente, você a recupera, modifica seus atributos e a atualiza no servidor. Por exemplo, suponha que você recupere uma marca d'água e modifique seu atributo de opacidade. Antes que a alteração entre em vigor, você deve atualizar a marca d'água.

Quando você modifica uma marca d'água, a alteração afeta documentos futuros que tenham a marca d'água aplicada a eles. Ou seja, os documentos PDF existentes que contêm a marca d'água não são afetados.

Resumo das etapas

Para modificar uma marca d'água, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupere a marca d'água para modificar.
4. Defina os atributos de marca d'água.
5. Atualize a marca d'água.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient . Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto DocumentSecurityServiceService.

Recuperar a marca d'água para modificar

Para modificar uma marca d'água, você deve recuperar uma marca d'água existente. Você pode recuperar uma marca d'água especificando seu nome ou especificando seu valor de identificador.

Definir os atributos de marcas d'água

Para modificar uma marca d'água existente, altere o valor de um ou mais atributos de marca d'água. Ao atualizar programaticamente uma marca d'água usando um serviço da Web, você deve definir todos os atributos que foram originalmente definidos, mesmo que o valor não seja alterado. Por exemplo, suponha que os seguintes atributos de marca d'água estejam definidos: WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY e WaterBackCmd:SRCTEXT. Embora o único atributo que você deseja modificar seja WaterBackCmd:OPACITY, você deve definir os outros valores corretamente.

Atualizar a marca d'água

Depois de modificar os atributos de uma marca d'água, atualize a marca d'água.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Criação de marcas d'água

Modifique marcas d'água usando a API Java

Modifique uma marca d'água usando a API de segurança de documentos (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como o adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recupere a marca d'água para modificar.

   Crie um objeto WatermarkManager chamando o método DocumentSecurityClient do objeto e transmita um valor de string que especifica o nome da marca d'água. getWatermarkManager Esse método retorna um objeto Watermark que representa a marca d'água a ser modificada.

4. Defina os atributos de marca d'água.

   Defina o atributo de opacidade da marca d'água chamando o método Watermark do objeto setOpacity e passando um valor inteiro que especifica o nível de opacidade. Um valor de 100 indica que a marca d'água é completamente opaca e um valor de 0 indica que a marca d'água é completamente transparente.

   OBSERVAÇÃO

   Este exemplo modifica somente o atributo de opacidade.

5. Atualize a marca d'água.

   • Atualize a marca d'água chamando o método WatermarkManager do objeto updateWatermark e passe o objeto Watermark cujo atributo foi modificado.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o Início rápido (modo SOAP): Modificação de uma marca d'água usando a seção API do Java .

Modifique marcas d'água usando a API do serviço da Web

Modifique uma marca d'água usando a API de segurança de documentos (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recupere a marca d'água para modificar.

   Recupere a marca d'água para modificar, chamando o método DocumentSecurityServiceClient do objeto getWatermarkByName. Passe um valor de string que especifica o nome da marca d'água. Esse método retorna um objeto WatermarkSpec que representa a marca d'água a ser modificada.

4. Defina os atributos de marca d'água.

   • Para cada propriedade de marca d'água a ser atualizada, crie um objeto MyMapOf_xsd_string_To_xsd_anyType_Item separado.
   • Defina o valor da chave atribuindo um valor ao MyMapOf_xsd_string_To_xsd_anyType_Item membro de dados key do objeto (por exemplo, WaterBackCmd:OPACITY).
   • Defina o valor atribuindo um valor ao MyMapOf_xsd_string_To_xsd_anyType_Item membro de dados value do objeto (por exemplo, .50).
   • Crie um objeto MyArrayOf_xsd_anyType. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item, chame o método MyArrayOf_xsd_anyType do objeto Add. Passe o objeto MyMapOf_xsd_string_To_xsd_anyType_Item.
   • Atribua o objeto MyArrayOf_xsd_anyType ao membro de dados WatermarkSpec do objeto values.

5. Atualize a marca d'água.

   Atualize a marca d'água chamando o método DocumentSecurityServiceClient do objeto updateWatermark e transmitindo o objeto WatermarkSpec que representa a marca d'água a ser modificada.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:

• "Início rápido (MTOM): Modificação de uma marca d'água usando a API do serviço da Web"

Pesquisar eventos

O serviço Rights Management rastreia ações específicas à medida que ocorrem, como aplicar uma política a um documento, abrir um documento protegido por política e revogar o acesso a documentos. A auditoria de eventos deve ser ativada para o serviço Rights Management ou os eventos não são rastreados.

Os eventos são incluídos em uma das seguintes categorias:

• Os eventos de administrador são ações relacionadas a um administrador, como a criação de uma nova conta de administrador.
• Eventos de documento são ações relacionadas a um documento, como fechar um documento protegido por política.
• Eventos de política são ações relacionadas a uma política, como a criação de uma nova política.
• Os eventos de serviço são ações relacionadas ao serviço do Rights Management, como a sincronização com o diretório do usuário.

Você pode pesquisar por eventos específicos usando a API do Java do Rights Management ou a API do serviço da Web. Ao procurar por eventos, você pode executar tarefas, como criar um arquivo de log de determinados eventos.

Resumo das etapas

Para procurar um evento Rights Management, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto de API do cliente do Rights Management.
3. Especifique o evento para o qual pesquisar.
4. Procure o evento .

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do cliente do Rights Management

Antes de executar programaticamente uma operação de serviço Rights Management, é necessário criar um objeto de cliente de serviço Rights Management. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient . Se estiver usando a API do serviço da Web do Rights Management , crie um objeto DocumentSecurityServiceService .

Especifique os eventos que serão pesquisados

Você deve especificar o evento a ser procurado. Por exemplo, você pode pesquisar o evento de criação de política, que ocorre quando uma nova política é criada.

Pesquisar pelo evento

Depois de especificar o evento que será pesquisado, você pode usar a API do Java do Rights Management ou a API do serviço da Web do Rights Management para pesquisar o evento.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Procure eventos usando a API do Java

Procure eventos usando a API do Rights Management (Java):

1. Incluir arquivos de projeto

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Criar um objeto de API do cliente do Rights Management

   Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

3. Especifique os eventos que serão pesquisados

   • Crie um objeto EventManager chamando o método DocumentSecurityClient getEventManager do objeto. Este método retorna um objeto EventManager.
   • Crie um objeto EventSearchFilter chamando seu construtor.
   • Especifique o evento para o qual pesquisar, chamando o método EventSearchFilter do objeto setEventCode e passando um membro de dados estáticos que pertence à classe EventManager que representa o evento para o qual pesquisar. Por exemplo, para procurar pelo evento de criação de política, passe EventManager.POLICY_CREATE_EVENT.
   OBSERVAÇÃO

   Você pode definir critérios de pesquisa adicionais chamando métodos de objeto EventSearchFilter. Por exemplo, chame o método setUserName para especificar um usuário associado ao evento.

4. Pesquisar pelo evento

   Procure o evento chamando o método EventManager do objeto searchForEvents e transmitindo o objeto EventSearchFilter que define os critérios de pesquisa do evento. Esse método retorna uma matriz de objetos Event.

Exemplos de código

Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Inícios rápidos:

• "Início rápido (SOAP): Pesquisar eventos usando a API do Java"

Procure eventos usando a API de serviço da Web

Procure eventos usando a API do Rights Management (serviço da Web):

1. Incluir arquivos de projeto

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Criar um objeto de API do cliente do Rights Management

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto DocumentSecurityServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Especifique os eventos que serão pesquisados

   • Crie um objeto EventSpec usando seu construtor.
   • Especifique o início do período de tempo durante o qual o evento ocorreu, definindo o membro de dados EventSpec do objeto firstTime.date com a instância DataTime que representa o início do intervalo de datas quando o evento ocorreu.
   • Atribua o valor true ao membro de dados EventSpec do objeto firstTime.dateSpecified.
   • Especifique o fim do período de tempo durante o qual o evento ocorreu, definindo o membro de dados EventSpec do objeto lastTime.date com a instância DataTime que representa o fim do intervalo de datas quando o evento ocorreu.
   • Atribua o valor true ao membro de dados EventSpec do objeto lastTime.dateSpecified.
   • Defina o evento para pesquisar atribuindo um valor de string ao EventSpec membro de dados eventCode do objeto. A tabela a seguir lista os valores numéricos que você pode atribuir a essa propriedade:

   Tipo de evento	Valor
   ALL_EVENTS	999
   USER_CHANGE_PASSWORD_EVENT	1000
   USER_REGISTER_EVENT	1001
   USER_PREREGISTER_EVENT	1002
   USER_ACTIVATE_EVENT	1003
   USER_DEACTIVATE_EVENT	1004
   USER_AUTHENTICATE_EVENT	1005
   USER_AUTHENTICATE_DENY_EVENT	1006
   USER_ACCOUNT_LOCK_EVENT	1007
   USER_DELETE_EVENT	1008
   USER_UPDATE_PROFILE_EVENT	1009
   DOCUMENT_VIEW_EVENT	2000
   DOCUMENT_PRINT_LOW_EVENT	2001
   DOCUMENT_PRINT_HIGH_EVENT	2002
   DOCUMENT_SIGN_EVENT	2003
   DOCUMENT_ADD_ANNOTATION_EVENT	2004
   DOCUMENT_FORM_FILL_EVENT	2005
   DOCUMENT_CLOSE_EVENT	2006
   DOCUMENT_MODIFY_EVENT	2007
   DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT	2008
   DOCUMENT_SWITCH_POLICY_EVENT	2009
   DOCUMENT_REVOKE_EVENT	2010
   $1	2011
   DOCUMENT_SECURE_EVENT	2012
   DOCUMENT_UNKNOWN_CLIENT_EVENT	2013
   DOCUMENT_CHANGE_REVOKE_URL_EVENT	2014
   POLICY_CHANGE_EVENT	3000
   POLICY_ENABLE_EVENT	3001
   POLICY_DISABLE_EVENT	3002
   POLICY_CREATE_EVENT	3003
   POLICY_DELETE_EVENT	3004
   POLICY_CHANGE_OWNER_EVENT	3005
   SERVER_CLIENT_SYNC_EVENT	4000
   SERVER_SYNC_DIR_INFO_EVENT	4001
   SERVER_SYNC_DIR_COMPLETE_EVENT	4002
   SERVER_VERSION_MISMATCH_EVENT	4003
   SERVER_CONFIG_CHANGE_EVENT	4004
   SERVER_ENABLE_OFFLINE_ACCESS_EVENT	4005
   ADMIN_ADD_EVENT	5000
   ADMIN_DELETE_EVENT	5001
   ADMIN_EDIT_EVENT	5002
   ADMIN_ACTIVATE_EVENT	5003
   ADMIN_DEACTIVATE_EVENT	5004
   ERROR_DIRECTORY_SERVICE_EVENT	6000
   CREATED_POLICYSET_EVENT	7000
   DELETED_POLICYSET_EVENT	7001
   MODIFIED_POLICYSET_EVENT	7002

4. Pesquisar pelo evento

   Procure o evento chamando o método DocumentSecurityServiceClient do objeto searchForEvents e passando o objeto EventSpec que representa o evento para o qual pesquisar e o número máximo de resultados. Esse método retorna uma coleção MyArrayOf_xsd_anyType em que cada elemento é uma instância AuditSpec. Usando uma instância AuditSpec, você pode obter informações sobre o evento, como a hora em que ele ocorreu. A instância AuditSpec contém um membro de dados timestamp que especifica essas informações.

Exemplos de código

Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Inícios rápidos:

• "Início rápido (MTOM): Procurar eventos usando a API do serviço da Web"
• "Início rápido (SwaRef): Procurar eventos usando a API do serviço da Web"

Consulte também:

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Aplicando Políticas a Documentos do Word

Além de documentos PDF, o serviço Gerenciamento de Direitos oferece suporte a formatos de documento adicionais, como um documento do Microsoft Word (arquivo DOC) e outros formatos de arquivo do Microsoft Office. Por exemplo, você pode aplicar uma política a um documento do Word para protegê-lo. Ao aplicar uma política a um documento do Word, você restringe o acesso ao documento. Não é possível aplicar uma política a um documento se ele já estiver protegido por uma política.

Você pode monitorar o uso de um documento do Word protegido por política depois de distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.

Resumo das etapas

Para aplicar uma política a um documento do Word, execute as seguintes etapas:

1. Inclua arquivos de projeto.
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recupera um documento do Word ao qual uma política é aplicada.
4. Aplique uma política existente ao documento do Word.
5. Salve o documento do Word protegido por política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto da API do cliente de segurança de documentos

Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento.

Recuperar um documento do Word

Você deve recuperar um documento do Word para aplicar uma política. Depois de aplicar uma política ao documento do Word, os usuários são restritos ao usar o documento. Por exemplo, se a política não habilitar a abertura do documento offline, os usuários deverão estar online para abrir o documento.

Aplicar uma política existente ao documento do Word

Para aplicar uma política a um documento do Word, é necessário referenciar uma política existente e especificar a qual conjunto de políticas a política pertence. O usuário que está definindo as propriedades de conexão deve ter acesso à política especificada. Caso contrário, ocorrerá uma exceção.

Salvar o documento do Word

Depois que o serviço de segurança de documento aplicar uma política a um documento do Word, você poderá salvar o documento do Word protegido por política como um arquivo DOC.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Revogando o acesso aos documentos

Aplicar uma política a um documento do Word usando a API Java

Aplique uma política a um documento do Word usando a API de segurança de documento (Java):

1. Inclua arquivos de projeto.

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto DocumentSecurityClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recuperar um documento do Word.

   • Crie um objeto java.io.FileInputStream que represente o documento do Word usando seu construtor e passando um valor de string que especifica o local do documento do Word.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

4. Aplique uma política existente ao documento do Word.

   • Crie um objeto DocumentManager chamando o método DocumentSecurityClient getDocumentManager do objeto.

   • Aplique uma política ao documento do Word chamando o método DocumentManager do objeto e transmitindo os seguintes valores:protectDocument

     • O objeto com.adobe.idp.Document que contém o documento do Word ao qual a política é aplicada.
     • Um valor de string que especifica o nome do documento.
     • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar um valor null que resulta no conjunto de políticas MyPolicies sendo usado.
     • Um valor de string que especifica o nome da política.
     • Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser nulo).
     • Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser null (se esse parâmetro for null, o valor de parâmetro anterior deverá ser null).
     • Um com.adobe.livecycle.rightsmanagement.Locale que representa a localidade usada para selecionar o modelo do MS Office. Esse valor de parâmetro é opcional e você pode especificar null.

     O método protectDocument retorna um objeto RMSecureDocumentResult que contém o documento do Word protegido por política.

5. Salve o documento do Word.

   • Chame o método RMSecureDocumentResult do objeto getProtectedDoc para obter o documento do Word protegido por política. Este método retorna um objeto com.adobe.idp.Document.
   • Crie um objeto java.io.File e verifique se a extensão de arquivo é DOC.
   • Chame o método com.adobe.idp.Document do objeto copyToFile para copiar o conteúdo do objeto Document para o arquivo (certifique-se de usar o objeto Document retornado pelo método getProtectedDoc).

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:

• "Início rápido (modo SOAP): Aplicar uma política a um documento do Word usando a API do Java"

Aplicar uma política a um documento do Word usando a API do serviço da Web

Aplique uma política a um documento do Word usando a API de segurança de documento (serviço da Web):

1. Inclua arquivos de projeto.

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Crie um objeto da API do Cliente de segurança de documento.

   • Crie um objeto DocumentSecurityServiceClient usando seu construtor padrão.

   • Crie um objeto DocumentSecurityServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recuperar um documento do Word.

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento do Word ao qual uma política é aplicada.
   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word e o modo no qual o arquivo será aberto.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Determine o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Aplique uma política existente ao documento do Word.

   Aplique uma política ao documento do Word chamando o método DocumentSecurityServiceClient do objeto e transmitindo os seguintes valores:protectDocument

   • O objeto BLOB que contém o documento do Word ao qual a política é aplicada.
   • Um valor de string que especifica o nome do documento.
   • Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar um valor null que resulta no conjunto de políticas MyPolicies sendo usado.
   • Um valor de string que especifica o nome da política.
   • Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser null).
   • Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o valor do parâmetro anterior deve ser null).
   • Um valor RMLocale que especifica o valor do local (por exemplo, RMLocale.en).
   • Um parâmetro de saída da string usado para armazenar o valor do identificador de política.
   • Um parâmetro de saída de string usado para armazenar o valor do identificador protegido por política.
   • Um parâmetro de saída de string usado para armazenar o tipo MIME (por exemplo, application/doc).

   O método protectDocument retorna um objeto BLOB que contém o documento do Word protegido por política.

5. Salve o documento do Word.

   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word protegido por política.
   • Crie uma matriz de bytes que armazene o conteúdo de dados do objeto BLOB retornado pelo método protectDocument. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB do objeto MTOM.
   • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.
   • Grave o conteúdo da matriz de bytes em um arquivo do Word chamando o método System.IO.BinaryWriter do objeto Write e transmitindo a matriz de bytes.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:

• "Início rápido (MTOM): Aplicar uma política a um documento do Word usando a API do serviço da Web"

Removendo Políticas de Documentos do Word

Você pode remover uma política de um documento do Word protegido por política para remover a segurança do documento. Ou seja, se você não quiser mais que o documento seja protegido por uma política. Se você quiser atualizar um documento do Word protegido por política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, é mais eficiente mudar a política.

Resumo das etapas

Para remover uma política de um documento do Word protegido por política, execute as seguintes etapas:

1. Incluir arquivos de projeto
2. Crie um objeto da API do Cliente de segurança de documento.
3. Recuperar um documento do Word protegido por política.
4. Remova a política do documento do Word.
5. Salve o documento do Word não seguro.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.

Criar um objeto de API do Cliente de segurança de documentos

Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.

Recuperar um documento do Word protegido por política

Você deve recuperar um documento do Word protegido por política para remover uma política. Se tentar remover uma política de um documento do Word que não está protegido por uma política, ocorrerá uma exceção.

Remover a política do documento do Word

Você pode remover uma política de um documento do Word protegido por política, desde que um administrador seja especificado nas configurações de conexão. Caso contrário, a política usada para proteger um documento deverá conter a permissão SWITCH_POLICY para remover uma política de um documento do Word. Além disso, o usuário especificado nas configurações de conexão do AEM Forms também deve ter essa permissão. Caso contrário, uma exceção será lançada.

Salvar o documento do Word não seguro

Depois que o serviço de segurança de documentos remove uma política de um documento do Word, você pode salvar o documento do Word não seguro como um arquivo DOC.

Consulte também:

Inclusão de arquivos da biblioteca Java do AEM Forms

Configuração das propriedades de conexão

Aplicando Políticas a Documentos do Word

Remova uma política de um documento do Word usando a API Java

Remova uma política de um documento do Word protegido por política usando a API de segurança de documentos (Java):

1. Incluir arquivos de projeto

   Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.

2. Criar um objeto de API do Cliente de segurança de documentos

   • Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
   • Crie um objeto RightsManagementClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

3. Recuperar um documento do Word protegido por política

   • Crie um objeto java.io.FileInputStream que represente o documento do Word protegido por política usando seu construtor e transmitindo um valor de string que especifique o local do documento do Word.
   • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.

4. Remover a política do documento do Word

   • Crie um objeto DocumentManager chamando o método RightsManagementClient getDocumentManager do objeto.
   • Remova uma política do documento do Word chamando o método DocumentManager do objeto removeSecurity e transmitindo o objeto com.adobe.idp.Document que contém o documento do Word protegido por política. Este método retorna um objeto com.adobe.idp.Document que contém um documento do Word não seguro.

5. Salvar o documento do Word não seguro

   • Crie um objeto java.io.File e verifique se a extensão de arquivo é DOC.
   • Chame o método Document do objeto copyToFile para copiar o conteúdo do objeto Document para o arquivo (certifique-se de usar o objeto Document retornado pelo método removeSecurity).

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:

• "Início rápido (modo SOAP): Remover uma política de um documento do Word usando a API do Java"

Remover uma política de um documento do Word usando a API do serviço da Web

Remova uma política de um documento do Word protegido por política usando a API de segurança de documentos (serviço da Web):

1. Incluir arquivos de projeto

   Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

   OBSERVAÇÃO

   Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.

2. Criar um objeto de API do Cliente de segurança de documentos

   • Crie um objeto RightsManagementServiceClient usando seu construtor padrão.

   • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Este atributo é usado ao criar uma referência de serviço.)

   • Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding. Converta o valor de retorno em BasicHttpBinding.

   • Defina o campo System.ServiceModel.BasicHttpBinding MessageEncoding do objeto para WSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado.

   • Ative a autenticação HTTP básica executando as seguintes tarefas:

     • Atribua o nome de usuário dos formulários AEM ao campo RightsManagementServiceClient.ClientCredentials.UserName.UserName.
     • Atribua o valor correspondente da senha ao campo RightsManagementServiceClient.ClientCredentials.UserName.Password.
     • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

   • Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

3. Recuperar um documento do Word protegido por política

   • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar o documento do Word protegido por política do qual a política é removida.
   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word e o modo no qual o arquivo será aberto.
   • Crie uma matriz de bytes que armazene o conteúdo do objeto System.IO.FileStream. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream do objeto Length.
   • Preencha a matriz de bytes com dados de fluxo chamando o método System.IO.FileStream do objeto Read e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.
   • Preencha o objeto BLOB atribuindo seu campo MTOM ao conteúdo da matriz de bytes.

4. Remover a política do documento do Word

   Remova a política do documento do Word chamando o método RightsManagementServiceClient do objeto removePolicySecurity e transmitindo o objeto BLOB que contém o documento do Word protegido por política. Este método retorna um objeto BLOB que contém um documento do Word não seguro.

5. Salvar o documento do Word não seguro

   • Crie um objeto System.IO.FileStream chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word não seguro.
   • Crie uma matriz de bytes que armazene o conteúdo de dados do objeto BLOB retornado pelo método removePolicySecurity. Preencha a matriz de bytes obtendo o valor do campo BLOB do objeto MTOM.
   • Crie um objeto System.IO.BinaryWriter chamando seu construtor e passando o objeto System.IO.FileStream.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:

• "Início rápido (MTOM): Remover uma política de um documento do Word usando a API do serviço da Web"

Consulte também:

Chamar o AEM Forms usando MTOM