Protegendo documentos com políticas protecting-documents-with-policies

Exemplos e exemplos neste documento são somente para 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 configurações de confidencialidade de maneira dinâmica a documentos do Adobe PDF e mantenham o controle sobre os documentos, independentemente da abrangência da sua 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ítica. Um usuário pode especificar quem pode abrir um documento, limitar como usá-lo e monitorar o documento após sua distribuição. Um usuário também pode controlar dinamicamente o acesso a um documento protegido por política e até mesmo revogar dinamicamente o acesso ao documento.

O serviço de 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 (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:

É possível realizar essas tarefas usando o serviço Segurança de documentos:

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Criação de políticas creating-policies

Você pode criar políticas programaticamente usando a API Java de segurança de documentos ou a API de serviço da Web. Uma política é 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 executar estas tarefas:

  • Especifique os indivíduos que podem abrir o documento. Os destinatários podem pertencer à sua 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 do 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 depois de distribuí-lo. Você pode ver como o documento está sendo usado e quem está usando-o. Por exemplo, você pode descobrir quando alguém abriu o documento.

Criação de uma política usando serviços da Web creating-a-policy-using-web-services

Ao criar uma política usando a API do serviço Web, faça referência a um arquivo XML de linguagem PDRL (Portable Document Rights Language) existente que descreva 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>
NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary-of-steps

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Defina os atributos da política.
  4. Criar 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 uma aplicação 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 projeto:

  • adobe-rightsmanagement-client.jar
  • namespace.jar (se o AEM Forms for implantado no JBoss)
  • jaxb-api.jar (se o AEM Forms for implantado no JBoss)
  • jaxb-impl.jar (se o AEM Forms for implantado no JBoss)
  • jaxb-libs.jar (se o AEM Forms for 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 for 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 for 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 do serviço de Segurança de documentos, crie um objeto de cliente desse serviço.

Definir os atributos da política

Para criar uma política, defina atributos de política. Um atributo obrigatório é o nome da política. Os nomes das 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 elas pertencerem a conjuntos de políticas separados. Entretanto, 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 política está acessível aos recipients autorizados. Se você não definir esse atributo, a política será sempre 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 estará acessível a partir do momento em que for publicado
  • Uma data final após a qual o documento não estará 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 final, a política será válida até a data final. No entanto, uma exceção será lançada se uma data de início e uma data de término não estiverem definidas.

Ao definir atributos que pertencem a uma política, você também pode definir configurações de criptografia. Essas configurações de criptografia são aplicadas 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 nenhuma criptografia.

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

NOTE
Para obter informações sobre outros atributos que podem ser definidos, consulte a descrição da interface Policy na Referência da API AEM Forms.

Criar uma entrada de política

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

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

Essas ações fazem com que os recipients possam exibir somente o documento online e não possam 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 ser usada. Depois de registrar uma política, você pode usá-la para proteger documentos.

Criar uma política usando a API Java create-a-policy-using-the-java-api

Crie uma 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. Crie 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. Defina os atributos da política.

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

    • Crie uma entrada de política invocando o método createPolicyEntry estático do objeto InfomodelObjectFactory. Este método retorna um objeto PolicyEntry.
    • Especifique as permissões da política invocando o método createPermission estático do objeto InfomodelObjectFactory. Passe um membro de dados estáticos que pertença à 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 a ser adicionada).
    • Adicione a permissão à entrada de política invocando o método addPermission do objeto PolicyEntry e transmitindo o objeto Permission. (Repita esta etapa para cada objeto do Permission que você criou).
    • Crie a entidade de política invocando o método createSpecialPrincipal estático do objeto InfomodelObjectFactory. Passe um membro de dados que pertença ao objeto InfomodelObjectFactory que representa o principal. Este método retorna um objeto Principal. Por exemplo, para adicionar o editor do documento como entidade de segurança, passe InfomodelObjectFactory.PUBLISHER_PRINCIPAL.
    • Adicione a entidade de segurança à entrada de política invocando o método setPrincipal do objeto PolicyEntry e transmitindo o objeto Principal.
    • Adicione a entrada de política à política invocando o método addPolicyEntry do objeto Policy e transmitindo o objeto PolicyEntry.
  5. Registre a política.

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

    • Registre a política invocando o método registerPolicy do objeto PolicyManager 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 de formulários AEM nas configurações de conexão para criar o objeto DocumentSecurityClient, especifique o nome do conjunto de políticas ao invocar 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 Minhas Políticas dos administradores.

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

    note note
    NOTE
    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, será lançada uma exceção.

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

  • "Início rápido (modo SOAP): criação de uma política usando a API Java"

Criar uma política usando a API do serviço Web create-a-policy-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 cadeia de caracteres ao membro de dados name do objeto PolicySpec.
    • Defina a descrição da política atribuindo um valor de cadeia de caracteres ao membro de dados description do objeto PolicySpec.
    • Especifique o conjunto de políticas ao qual a política pertence, atribuindo um valor de cadeia de caracteres ao membro de dados policySetName do objeto PolicySpec. Especifique um nome de conjunto de políticas existente. (Você pode especificar null para este valor de parâmetro que resulta na adição da política a Minhas Políticas.)
    • Defina o período de concessão offline da política atribuindo um valor inteiro ao membro de dados offlineLeasePeriod do objeto PolicySpec.
    • Defina o membro de dados policyXml do objeto PolicySpec com um valor de cadeia de caracteres que represente dados XML PDRL. Para executar esta 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 ReadLine do objeto StreamReader e atribua o valor de retorno a uma variável de cadeia de caracteres. Repita através do objeto StreamReader até que o método ReadLine retorne um valor nulo. Atribua a variável de cadeia de caracteres ao membro de dados policyXml do objeto PolicySpec.
  4. Criar 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 Web de Segurança de documentos. A entrada de política é definida no documento PDRL.

  5. Registre a política.

    Registre a política invocando o método registerPolicy do objeto DocumentSecurityServiceClient 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 Minhas Políticas.

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

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

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

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

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

Modificação de Políticas modifying-policies

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

É possível modificar uma política quando os requisitos de negócios mudam e a política não reflete mais esses requisitos. Em vez de criar uma política, você pode simplesmente atualizar uma política existente.

Para modificar atributos de política usando um serviço Web (por exemplo, usando classes de proxy Java que foram criadas com JAX-WS), você deve garantir que a política esteja registrada no serviço de Segurança de documentos. 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.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-1

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recuperar 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 uma aplicação 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 documentos, você deve criar um objeto cliente de serviço de Segurança de documentos. Se você estiver usando a API Java, crie um objeto RightsManagementClient. Se você estiver usando a API do serviço Web Segurança de documentos, crie um objeto RightsManagementServiceService.

Recuperar uma política existente

Recupere 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 da política. O único atributo de política que não pode ser alterado é o atributo de nome. 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 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 membro de dados policyXML da interface PolicySpec.

NOTE
Para obter informações sobre outros atributos que podem ser definidos, consulte a descrição da interface Policy na Referência da API AEM Forms.

Atualizar a política

Antes que as alterações feitas em uma política entrem em vigor, é necessário atualizar a política com o serviço de Segurança de documentos. As alterações nas políticas que estão protegendo 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.

Modificar políticas existentes usando a API Java modify-existing-policies-using-the-java-api

Modifique uma política existente 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. Crie 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 uma política existente.

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

    • Crie um objeto Policy que represente a política a ser atualizada chamando o método getPolicy do objeto PolicyManager e passando 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 na utilização do conjunto de políticas MyPolicies.
      • 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 necessidades dos negócios. Por exemplo, para alterar o período de concessão offline da política, chame o método setOfflineLeasePeriod do objeto Policy.

  5. Atualize a política.

    Atualize a política invocando o método updatePolicy do objeto PolicyManager. Transmita 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 documentos, consulte Início rápido (modo SOAP): modificação de uma política usando a seção API do Java.

Modificar políticas existentes usando a API do serviço Web modify-existing-policies-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 uma política existente.

    Crie um objeto PolicySpec que represente a política a ser modificada chamando o método getPolicy do objeto RightsManagementServiceClient 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 na utilização do conjunto de políticas MyPolicies.
    • Um valor de string que especifica o nome da política.
  4. Defina os atributos da política.

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

  5. Atualize a política.

    Atualize a política invocando o método updatePolicyFromSDK do objeto RightsManagementServiceClient 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 documentos, consulte os seguintes Quick Starts:

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

Exclusão de Políticas deleting-policies

Você pode excluir uma política existente usando a API Java de segurança de documentos ou a API de 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ítica que estão usando a política ainda estão protegidos. É possível excluir uma política quando uma mais recente estiver disponível.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-2

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

  1. Incluir arquivos de projeto
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Exclua a política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 documentos, você deve criar um objeto cliente de serviço de Segurança de documentos. Se você estiver usando a API Java, crie um objeto RightsManagementClient. Se você estiver usando a API do serviço Web Segurança de documentos, 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, ocorre uma exceção. Da mesma forma, se você tentar excluir uma política que não existe, ocorre uma exceção.

Excluir políticas usando a API do Java delete-policies-using-the-java-api

Exclua uma 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. Crie 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. Exclua a política.

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

    • Exclua a política chamando o método deletePolicy do objeto PolicyManager 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 na utilização do conjunto de políticas MyPolicies.
      • Um valor de 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 documentos, consulte os seguintes Quick Starts:

  • "Início rápido (modo SOAP): exclusão de uma política usando a API Java"

Excluir políticas usando a API do serviço Web delete-policies-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 invocando o método deletePolicy do objeto RightsManagementServiceClient 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 na utilização do conjunto de políticas MyPolicies.
    • Um valor de 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 documentos, consulte os seguintes Quick Starts:

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

Aplicação de políticas a documentos do PDF applying-policies-to-pdf-documents

Você pode 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 do 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ítica quando não quiser mais que os usuários acessem o documento.

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

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-3

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere um documento PDF ao qual uma política seja 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 uma aplicação 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 APIobject de cliente de segurança de documentos

Antes de executar programaticamente uma operação do serviço de Segurança de documentos, crie um objeto de cliente desse serviço. Se você estiver usando a API Java, crie um objeto DocumentSecurityClient. Se você estiver usando a API do serviço Web Segurança de documentos, 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 ficam restritos ao usar o documento. Por exemplo, se a política não permitir que o documento seja aberto 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, faça referência a uma política existente e especifique a qual política 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 PDF

Depois que o serviço de Segurança de documentos 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

Definindo propriedades de conexão

Revogação do acesso a documentos

Aplicação de uma política a um documento PDF usando a API Java apply-a-policy-to-a-pdf-document-using-the-java-api

Aplique uma política a um documento PDF 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. Crie 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. Recupere um documento PDF.

    • Crie um objeto java.io.FileInputStream que represente o documento PDF usando seu construtor. Transmita 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. Aplique uma política existente ao documento PDF.

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

    • Aplique uma política ao documento PDF invocando o método protectDocument do objeto DocumentManager 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 cadeia de caracteres 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 resulte no uso do conjunto de políticas MyPolicies.
      • 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 publicador do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor de parâmetro deverá ser nulo).
      • Um valor de string que representa o nome canônico do usuário gerente do usuário que é o editor do documento. Este valor de parâmetro é opcional e pode ser null (se este 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.

    • Invoque o método getProtectedDoc do objeto RMSecureDocumentResult 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 do arquivo é PDF.
    • Invoque o método copyToFile do objeto com.adobe.idp.Document 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 documentos, consulte os seguintes Quick Starts:

  • "Início rápido (modo EJB): aplicando uma política a um documento PDF usando a API Java"
  • "Início rápido (modo SOAP): aplicação de uma política a um documento PDF usando a API Java"

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Aplicação de uma política a um documento PDF usando a API de serviço Web apply-a-policy-to-a-pdf-document-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 transmitindo um valor de cadeia de caracteres 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o conteúdo da matriz de bytes.
  4. Aplique uma política existente ao documento PDF.

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

    • O objeto BLOB que contém o documento PDF ao qual a política é aplicada.
    • Um valor de cadeia de caracteres 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 resulte no uso do conjunto de políticas MyPolicies.
    • 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 publicador do documento. Este valor de parâmetro é opcional e pode ser nulo (se este parâmetro for nulo, o próximo valor de parâmetro deverá ser null).
    • Um valor de string que representa o nome canônico do usuário gerente do usuário que é o editor do documento. Este valor de parâmetro é opcional e pode ser nulo (se este parâmetro for nulo, o valor do parâmetro anterior deverá ser null).
    • Um valor RMLocale que especifica o valor da localidade (por exemplo, RMLocale.en).
    • Um parâmetro de saída da string usado para armazenar o valor do identificador da política.
    • Um parâmetro de saída da string usado para armazenar o valor do identificador protegido por política.
    • Um parâmetro de saída da cadeia de caracteres que é 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 transmitindo um valor de cadeia de caracteres 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. Popular a matriz de bytes obtendo o valor do membro de dados MTOM do objeto BLOB.
    • Crie um objeto System.IO.BinaryWriter invocando seu construtor e transmitindo o objeto System.IO.FileStream.
    • Grave o conteúdo da matriz de bytes em um arquivo PDF, chamando o método Write do objeto System.IO.BinaryWriter e transmitindo a matriz de bytes.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

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

Remoção de políticas de documentos do PDF removing-policies-from-pdf-documents

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 você quiser atualizar um documento protegido por política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, será mais eficiente alternar a política.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-4

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

  1. Incluir arquivos de projeto
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere um documento PDF protegido por política.
  4. Remova a política do documento PDF.
  5. Salve o documento PDF não seguro.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 do serviço de Segurança de documentos, crie um objeto de cliente desse serviço.

Recuperar um documento PDF protegido por política

Você pode recuperar um documento de PDF protegido por 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, causará uma exceção.

Remover a política do documento PDF

Você pode remover uma política de um documento PDF 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 deve 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 de PDF não seguro

Depois que o serviço de Segurança de documentos remover uma política de um documento PDF, você poderá salvar o documento PDF não seguro como um arquivo PDF.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Aplicação de políticas a documentos do PDF

Remover uma política de um documento PDF usando a API Java remove-a-policy-from-a-pdf-document-using-the-java-api

Remova uma política de um documento PDF 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. Crie 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. Recupere um documento PDF protegido por política.

    • Crie um objeto java.io.FileInputStream que represente o documento de PDF protegido por política usando seu construtor e transmitindo um valor de cadeia de caracteres que especifique o local do documento de 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 invocando o método getDocumentManager do objeto DocumentSecurityClient.
    • Remova uma política do documento PDF invocando o método removeSecurity do objeto DocumentManager e transmitindo o objeto com.adobe.idp.Document que contém o documento PDF protegido por política. Este método retorna um objeto com.adobe.idp.Document que contém um documento PDF não seguro.
  5. Salve o documento PDF não seguro.

    • Crie um objeto java.io.File e verifique se a extensão do arquivo é PDF.
    • Invoque o método copyToFile do objeto Document 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 documentos, consulte os seguintes Quick Starts:

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

Remover uma política usando a API do serviço Web remove-a-policy-using-the-web-service-api

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. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 transmitindo um valor de cadeia de caracteres 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o conteúdo da matriz de bytes.
  4. Remova a política do documento PDF.

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

  5. Salve o documento PDF não seguro.

    • Crie um objeto System.IO.FileStream chamando seu construtor e transmitindo um valor de cadeia de caracteres 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. Popular a matriz de bytes obtendo o valor do campo MTOM do objeto BLOB.
    • Crie um objeto System.IO.BinaryWriter invocando seu construtor e transmitindo o objeto System.IO.FileStream.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

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

Consulte também

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Revogação do acesso a documentos revoking-access-to-documents

É possível revogar o acesso a um documento de PDF protegido por política, resultando na inacessibilidade de todas as cópias do documento para os usuários. Quando um usuário tenta abrir um documento de PDF revogado, ele é redirecionado para um URL especificado, no qual um documento revisado pode ser visualizado. A URL para onde o usuário é redirecionado deve ser especificada de forma programática. Quando você revoga o acesso a um documento, a alteração entra 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 oferece segurança adicional. Por exemplo, suponha que uma versão mais recente de um documento esteja disponível e você não deseja mais que ninguém visualize a versão desatualizada. Nessa situação, o acesso ao documento mais antigo pode ser revogado, e ninguém poderá ver o documento, a menos que o acesso seja restabelecido.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-5

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere um documento PDF protegido por política.
  4. Revogue o documento protegido por política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 documentos, você deve criar um objeto cliente de serviço de Segurança de documentos.

Recuperar um documento PDF protegido por política

Recupere um documento PDF protegido por política para revogá-lo. Não é possível revogar um documento que já tenha sido revogado ou que não seja um documento protegido por 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, você deve 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 quando 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.

NOTE
Se você tentar revogar um documento já revogado, uma exceção será lançada.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Aplicação de políticas a documentos do PDF

Restauração do Acesso a Documentos Revogados

Revogar acesso a documentos usando a API Java revoke-access-to-documents-using-the-java-api

Revogue o acesso a um documento de PDF 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 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 de PDF protegido por política usando seu construtor e transmitindo um valor de cadeia de caracteres que especifique o local do documento de 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 invocando o método getDocumentManager do objeto DocumentSecurityClient.

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

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

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

      • Um valor de cadeia de caracteres que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno do método getLicenseId do objeto DocumentManager).
      • Um membro de dados estático da interface License que especifica o motivo da revogação do 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 não quiser redirecionar um usuário para outra URL, você poderá passar null.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

  • "Início rápido (modo SOAP): Revogação de um documento usando a API Java"

Revogar acesso a documentos usando a API do serviço Web revoke-access-to-documents-using-the-web-service-api

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

  1. Incluir arquivos de projeto

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

    note note
    NOTE
    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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 transmitindo um valor de cadeia de caracteres que representa o local do arquivo do documento de 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o conteúdo da matriz de bytes.
  4. Revogar o documento protegido por política

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

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

      • Um valor de cadeia de caracteres que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno do método getLicenseId do objeto DocumentSecurityServiceService).
      • Um membro de dados estático 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 da URL onde um documento revisado está localizado. Se não quiser redirecionar um usuário para outra URL, você poderá passar null.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

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

Consulte também

Removendo Políticas de Documentos do Word

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Restauração do Acesso a Documentos Revogados reinstating-access-to-revoked-documents

Você pode restabelecer o acesso a um documento de PDF revogado, fazendo com que todas as cópias do documento revogado fiquem acessíveis aos usuários. Quando um usuário abre um documento restabelecido que foi revogado, ele pode exibir o documento.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-6

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere o identificador de licença do documento de PDF revogado.
  4. Restaure o acesso ao documento de PDF revogado.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 documentos, você deve criar um objeto cliente de serviço de Segurança de documentos. Se você estiver usando a API Java, crie um objeto DocumentSecurityClient. Se você estiver usando a API do serviço Web Segurança de documentos, crie um objeto DocumentSecurityServiceService.

Recuperar o identificador de licença do documento PDF revogado

Recupere o identificador de licença do documento de PDF revogado para restaurar um documento de PDF revogado. Após obter o valor do identificador de licença, é possível restaurar um documento revogado. Se você tentar restabelecer um documento que não foi revogado, causará uma exceção.

Restabelecer acesso ao documento de PDF revogado

Para restabelecer o acesso a um documento de 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, você causará uma exceção.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Aplicação de políticas a documentos do PDF

Revogação do acesso a documentos

Restaurar o acesso a documentos revogados usando a API do Java reinstate-access-to-revoked-documents-using-the-java-api

Restaure o acesso a um documento revogado 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. Crie 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. Recupere o identificador de licença do documento de PDF revogado.

    • Crie um objeto java.io.FileInputStream que represente o documento de PDF revogado usando seu construtor e transmitindo um valor de cadeia de caracteres que especifique o local do documento de PDF.
    • Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo o objeto java.io.FileInputStream.
    • Crie um objeto DocumentManager invocando o método getDocumentManager do objeto DocumentSecurityClient.
    • Recupere o valor do identificador de licença do documento revogado invocando o método getLicenseId do objeto DocumentManager e transmitindo o objeto com.adobe.idp.Document que representa o documento revogado. Este método retorna um valor de string que representa o identificador da licença.
  4. Restaure o acesso ao documento de PDF revogado.

    • Crie um objeto LicenseManager invocando o método getLicenseManager do objeto DocumentSecurityClient.
    • Restaure o acesso ao documento de PDF revogado invocando o método unrevokeLicense do objeto LicenseManager 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 documentos, consulte os seguintes Quick Starts:

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

Restaurar o acesso a documentos revogados usando a API do serviço da Web reinstate-access-to-revoked-documents-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 de licença do documento de PDF revogado.

    • Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar um documento de PDF revogado ao qual o acesso é restabelecido.
    • Crie um objeto System.IO.FileStream chamando seu construtor e transmitindo um valor de cadeia de caracteres que representa o local do arquivo do documento de PDF revogado e o modo no qual 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o conteúdo da matriz de bytes.
  4. Restaure o acesso ao documento de PDF revogado.

    • Recupere o valor do identificador de licença do documento revogado invocando o método getLicenseID do objeto DocumentSecurityServiceClient e transmitindo o objeto BLOB que representa o documento revogado. Este método retorna um valor de string que representa o identificador da licença.
    • Restaure o acesso ao documento de PDF revogado invocando o método unrevokeLicense do objeto DocumentSecurityServiceClient e transmitindo um valor de cadeia de caracteres que especifica o valor do identificador de licença do documento de PDF revogado (transmita o valor de retorno do método getLicenseId do objeto DocumentSecurityServiceClient).

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

  • "Início rápido (MTOM): restabelecendo o acesso a um documento revogado usando a API de serviço Web"
  • "Início Rápido (SwaRef): restabelecimento do acesso a um documento revogado usando a API de serviço Web"

Consulte também

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Inspeção de Documentos PDF Protegidos por Política inspecting-policy-protected-pdf-documents

Você pode usar a API do serviço de segurança de documentos (Java e serviço da Web) para inspecionar documentos de PDF protegidos por política. A inspeção de 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 sua versão do LiveCycle for 8.x ou anterior. O suporte para inspecionar documentos protegidos por política foi adicionado no AEM Forms. Se você tentar inspecionar um documento protegido por política usando o LiveCycle 8.x (ou anterior), ocorrerá uma exceção.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-7

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere um documento protegido por política para inspecionar.
  4. Obter informações sobre o documento protegido por política.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 do serviço de Segurança de documentos, crie um objeto de cliente desse serviço. Se você estiver usando a API Java, crie um objeto RightsManagementClient. Se você estiver usando a API do serviço Web Segurança de documentos, crie um objeto RightsManagementServiceService.

Recupere 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 é seguro com uma política ou que foi revogado, uma exceção será lançada.

Inspect o documento

Após recuperar um documento protegido por política, você pode inspecioná-lo.

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

Depois de inspecionar um documento de PDF protegido por política, 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 chamar RMInspectResult.getPolicysetName ou RMInspectResult.getPolicysetId, um valor nulo 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ão cadeias de caracteres válidas.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Documentos do Inspect Policy Protected PDF usando a API Java inspect-policy-protected-pdf-documents-using-the-java-api

O Inspect é um documento PDF protegido por política usando a API do serviço 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. Para obter informações sobre o local desses arquivos, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

  2. Crie um objeto de API do cliente de Segurança de documentos.

    • 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. Transmita 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. Inspect o documento.

    • Crie um objeto DocumentManager invocando o método getDocumentManager do objeto RightsManagementClient.
    • Inspect o documento protegido por política invocando o método inspectDocument do objeto LicenseManager. Transmita 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. Obter informações sobre o documento protegido por política.

    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 getPolicyName do objeto RMInspectResult.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

  • "Início rápido (modo SOAP): inspeção de documentos PDF protegidos por política usando a API Java"

Documentos do Inspect Policy Protected PDF usando a API de serviço Web inspect-policy-protected-pdf-documents-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 para inspeção.
    • Crie um objeto System.IO.FileStream invocando seu construtor. Transmita um valor de string que represente o local do arquivo do documento PDF e o modo em que 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o conteúdo da matriz de bytes.
  4. Inspect o documento.

    Inspect o documento protegido por política invocando o método inspectDocument do objeto RightsManagementServiceClient. Transmita 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. Obter informações sobre o documento protegido por política.

    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 policyName do objeto RMInspectResult.

Exemplos de código

Para obter exemplos de código usando o serviço Segurança de documentos, consulte os seguintes Quick Starts:

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

Consulte também

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Criação de marcas d'água creating-watermarks

As marcas d'água ajudam a garantir a segurança de um documento, identificando exclusivamente o documento e controlando a violação de direitos autorais. Por exemplo, você pode criar e colocar uma marca d'água que digite Confidencial em todas as páginas de um documento. Depois que uma marca d'água é criada, você pode 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 é exibida no documento protegido por política.

NOTE
Somente usuários com privilégios administrativos de Segurança de documentos podem criar marcas d'água. Ou seja, você deve especificar esse usuário ao definir as configurações de conexão necessárias para criar um objeto cliente do serviço de Segurança de documentos.
NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-8

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  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 uma aplicação 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 documentos, você deve criar um objeto cliente de serviço de Segurança de documentos. Se você estiver usando a API Java, crie um objeto RightsManagementClient. Se você estiver usando a API do serviço Web Segurança de documentos, crie um objeto RightsManagementServiceService.

Definir os atributos de marca d'água

Para criar uma 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
  • NomeUsuárioIncluído

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-359.
WaterBackCmd:SCALE
Se este 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 será ajustar à página.
Um valor maior que 0,0 e menor ou igual a 1,0.
WaterBackCmd:HORIZ_ALIGN
Especifica o alinhamento horizontal da marca d'água. O valor padrão é center.
esquerda, centro ou direita
WaterBackCmd:VERT_ALIGN
Especifica o alinhamento vertical da marca d'água. O valor padrão é center.
superior, centro 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
Verdadeiro se uma escala personalizada for especificada. Se esse valor for true, SCALE também deverá ser especificado. Se esse valor for falso, o padrão será Ajustar à página.
Verdadeiro ou falso
WaterBackCmd:SRCTEXT
Especifica o texto personalizado de uma marca d'água. Se este valor estiver presente, então WaterBackCmd:IS_CUSTOMTEXT_ENABLED também deve estar presente e definido como verdadeiro.
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 ser usada. Depois de registrar uma marca d'água, você pode usá-la em políticas.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Aplicação de políticas a documentos do PDF

Criar marcas d'água usando a API Java create-watermarks-using-the-java-api

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

  1. Incluir arquivos de projeto.

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

  2. Crie 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. Definir os atributos da marca d'água

    • Crie um objeto Watermark invocando o método createWatermark estático do objeto InfomodelObjectFactory. Este método retorna um objeto Watermark.
    • Defina o atributo de nome da marca d'água chamando o método setName do objeto Watermark e transmitindo um valor de cadeia de caracteres que especifica o nome da política.
    • Defina o atributo de plano de fundo da marca d'água invocando o método setBackground do objeto Watermark e transmitindo true. Ao configurar 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 setCustomText do objeto Watermark e transmitindo um valor de cadeia de caracteres que representa o texto da marca d'água.
    • Defina o atributo de opacidade da marca d'água invocando o método setOpacity do objeto Watermark e transmitindo 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 invocando o método getWatermarkManager do objeto RightsManagementClient. Este método retorna um objeto WatermarkManager.
    • Registre a marca d'água invocando o método registerWatermark do objeto WatermarkManager 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 documentos, consulte os seguintes Quick Starts:

  • "Início rápido (modo SOAP): criação de uma marca d'água usando a API Java"

Criar marcas d'água usando a API do serviço Web create-watermarks-using-the-web-service-api

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

  1. Crie um objeto de API do cliente de Segurança de documentos.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 marca d'água.

    • Crie um objeto WatermarkSpec invocando o construtor WatermarkSpec.
    • Defina o nome da marca d'água atribuindo um valor de cadeia de caracteres ao membro de dados name do objeto WatermarkSpec.
    • Defina o atributo id da marca d'água atribuindo um valor de cadeia de caracteres ao membro de dados id do objeto WatermarkSpec.
    • 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 membro de dados key do objeto MyMapOf_xsd_string_To_xsd_anyType_Item (por exemplo, WaterBackCmd:OPACITY).
    • Defina o valor atribuindo um valor ao membro de dados value do objeto MyMapOf_xsd_string_To_xsd_anyType_Item (por exemplo, .25).
    • Crie um objeto MyArrayOf_xsd_anyType. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item, chame o método Add do objeto MyArrayOf_xsd_anyType. Passar o objeto MyMapOf_xsd_string_To_xsd_anyType_Item.
    • Atribua o objeto MyArrayOf_xsd_anyType ao membro de dados values do objeto WatermarkSpec.
  4. Registre a marca d'água.

    Registre a marca d'água invocando o método registerWatermark do objeto RightsManagementServiceClient 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 documentos, consulte os seguintes Quick Starts:

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

Consulte também

Chamar o AEM Forms usando MTOM

Chamar o AEM Forms usando SwaRef

Modificação de Marcas D'Água modifying-watermarks

Você pode modificar uma marca d'água existente usando a API Java de Segurança de documentos ou a API de serviço da Web. Para alterar 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 da alteração entrar em vigor, você deve atualizar a marca d'água.

Quando você modifica uma marca d'água, a alteração afeta documentos futuros que têm 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.

NOTE
Somente usuários com privilégios administrativos de Segurança de documentos podem modificar marcas d'água. Ou seja, você deve especificar esse usuário ao definir as configurações de conexão necessárias para criar um objeto cliente do serviço de Segurança de documentos.
NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-9

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere a marca d'água a ser modificada.
  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 uma aplicação 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 documentos, você deve criar um objeto cliente de serviço de Segurança de documentos. Se você estiver usando a API Java, crie um objeto DocumentSecurityClient. Se você estiver usando a API do serviço Web Segurança de documentos, 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 seu valor de identificador.

Definir os atributos de marca 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 outros valores bem.

NOTE
Ao usar a API Java para modificar uma marca d'água, não é necessário especificar todos os atributos. Defina o atributo de marca d'água que você deseja modificar.
NOTE
Para obter informações sobre os nomes de atributos de marca d'água, consulte Criando Marcas D'Água.

Atualizar a marca d'água

Depois de modificar os atributos de uma marca d'água, você deve atualizar a marca d'água.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Criação de marcas d'água

Modificar marcas d'água usando a API Java modify-watermarks-using-the-java-api

Modifique uma marca d'água 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. Crie 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. Recupere a marca d'água a ser modificada.

    Crie um objeto WatermarkManager invocando o método getWatermarkManager do objeto DocumentSecurityClient e passe um valor de cadeia de caracteres que especifique o nome da marca d'água. Este método retorna um objeto Watermark que representa a marca d'água a ser modificada.

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

    Defina o atributo de opacidade da marca d'água invocando o método setOpacity do objeto Watermark e transmitindo 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.

    note note
    NOTE
    Esse exemplo modifica somente o atributo de opacidade.
  5. Atualize a marca d'água.

    • Atualize a marca d'água invocando o método updateWatermark do objeto WatermarkManager 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 documentos, consulte Início rápido (modo SOAP): modificação de uma marca d'água usando a seção API Java.

Modificar marcas d'água usando a API do serviço Web modify-watermarks-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie um objeto de API do cliente de Segurança de documentos.

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

    • Crie um objeto RightsManagementServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 a ser modificada.

    Recupere a marca d'água a ser modificada invocando o método getWatermarkByName do objeto DocumentSecurityServiceClient. Transmita um valor de string que especifique o nome da marca d'água. Este método retorna um objeto WatermarkSpec que representa a marca d'água a ser modificada.

  4. Defina os atributos da 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 membro de dados key do objeto MyMapOf_xsd_string_To_xsd_anyType_Item (por exemplo, WaterBackCmd:OPACITY).
    • Defina o valor atribuindo um valor ao membro de dados value do objeto MyMapOf_xsd_string_To_xsd_anyType_Item (por exemplo, .50).
    • Crie um objeto MyArrayOf_xsd_anyType. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item, chame o método Add do objeto MyArrayOf_xsd_anyType. Passar o objeto MyMapOf_xsd_string_To_xsd_anyType_Item.
    • Atribua o objeto MyArrayOf_xsd_anyType ao membro de dados values do objeto WatermarkSpec.
  5. Atualize a marca d'água.

    Atualize a marca d'água invocando o método updateWatermark do objeto DocumentSecurityServiceClient 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 documentos, 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 Web"

Pesquisando Eventos searching-for-events

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 habilitada para o serviço Rights Management ou os eventos não são rastreados.

Os eventos se enquadram em uma das seguintes categorias:

  • Eventos de administrador são ações relacionadas a um administrador, como a criação de uma 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 política.
  • Eventos de serviço são ações relacionadas ao serviço Rights Management, como sincronização com o diretório de usuário.

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

NOTE
Para obter mais informações sobre o serviço Rights Management, consulte Referência de serviços para AEM Forms.

Resumo das etapas summary_of_steps-10

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto Rights Management Client API.
  3. Especifique o evento que deseja pesquisar.
  4. Procure o evento.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 Rights Management

Antes de executar programaticamente uma operação de serviço de Rights Management, você deve criar um objeto cliente de serviço de Rights Management. Se você estiver usando a API Java, crie um objeto DocumentSecurityClient. Se você estiver usando a API de serviço Web Rights Management, crie um objeto DocumentSecurityServiceService.

Especificar os eventos a serem pesquisados

Especifique o evento a ser pesquisado. Por exemplo, você pode pesquisar pelo evento de criação de política, que ocorre quando uma nova política é criada.

Pesquisar o evento

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

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Pesquisar eventos usando a API Java search-for-events-using-the-java-api

Procure eventos usando a API de 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 da 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 a serem pesquisados

    • Crie um objeto EventManager invocando o método getEventManager do objeto DocumentSecurityClient. Este método retorna um objeto EventManager.
    • Crie um objeto EventSearchFilter invocando seu construtor.
    • Especifique o evento a ser pesquisado chamando o método setEventCode do objeto EventSearchFilter e transmitindo um membro de dados estático que pertença à classe EventManager que representa o evento a ser pesquisado. Por exemplo, para procurar o evento de criação de política, passe EventManager.POLICY_CREATE_EVENT.
    note note
    NOTE
    Você pode definir critérios de pesquisa adicionais invocando métodos de objeto EventSearchFilter. Por exemplo, chame o método setUserName para especificar um usuário associado ao evento.
  4. Pesquisar o evento

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

Exemplos de código

Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Quick Starts:

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

Pesquisar eventos usando a API de serviço Web search-for-events-using-the-web-service-api

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

  1. Incluir arquivos de projeto

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Criar um objeto da 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 a serem pesquisados

    • Crie um objeto EventSpec usando seu construtor.
    • Especifique o início do período durante o qual o evento ocorreu definindo o membro de dados firstTime.date do objeto EventSpec com a instância DataTime que representa o início do intervalo de datas em que o evento ocorreu.
    • Atribua o valor true ao membro de dados firstTime.dateSpecified do objeto EventSpec.
    • Especifique o fim do período durante o qual o evento ocorreu definindo o membro de dados lastTime.date do objeto EventSpec com a instância DataTime que representa o fim do intervalo de datas em que o evento ocorreu.
    • Atribua o valor true ao membro de dados lastTime.dateSpecified do objeto EventSpec.
    • Defina o evento a ser pesquisado atribuindo um valor de cadeia de caracteres ao membro de dados eventCode do objeto EventSpec. A tabela a seguir lista os valores numéricos que você pode atribuir a essa propriedade:
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2
    Tipo de evento Valor
    ALL_EVENTS 999
    USER_CHANGE_PASSWORD_EVENT 1000
    USER_REGISTER_EVENT 1001
    USER_PREREGISTER_EVENT 1002
    USER_ACTIVATE_EVENT 1003
    USER_DEACTIVATE_EVENT 1004
    USER_AUTHENTICATE_EVENT 1005
    USER_AUTHENTICATE_DENY_EVENT 1006
    USER_ACCOUNT_LOCK_EVENT 1007
    USER_DELETE_EVENT 1008
    USER_UPDATE_PROFILE_EVENT 1009
    DOCUMENT_VIEW_EVENT 2000
    DOCUMENT_PRINT_LOW_EVENT 2001
    DOCUMENT_PRINT_HIGH_EVENT 2002
    DOCUMENT_SIGN_EVENT 2003
    DOCUMENT_ADD_ANNOTATION_EVENT 2004
    DOCUMENT_FORM_FILL_EVENT 2005
    DOCUMENT_CLOSE_EVENT 2006
    DOCUMENT_MODIFY_EVENT 2007
    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT 2008
    DOCUMENT_SWITCH_POLICY_EVENT 2009
    DOCUMENT_REVOKE_EVENT 2010
    $1 2011
    DOCUMENT_SECURE_EVENT 2012
    DOCUMENT_UNKNOWN_CLIENT_EVENT 2013
    DOCUMENT_CHANGE_REVOKE_URL_EVENT 2014
    POLICY_CHANGE_EVENT 3000
    POLICY_ENABLE_EVENT 3001
    POLICY_DISABLE_EVENT 3002
    POLICY_CREATE_EVENT 3003
    POLICY_DELETE_EVENT 3004
    POLICY_CHANGE_OWNER_EVENT 3005
    SERVER_CLIENT_SYNC_EVENT 4000
    SERVER_SYNC_DIR_INFO_EVENT 4001
    SERVER_SYNC_DIR_COMPLETE_EVENT 4002
    SERVER_VERSION_MISMATCH_EVENT 4003
    SERVER_CONFIG_CHANGE_EVENT 4004
    SERVER_ENABLE_OFFLINE_ACCESS_EVENT 4005
    ADMIN_ADD_EVENT 5000
    ADMIN_DELETE_EVENT 5001
    ADMIN_EDIT_EVENT 5002
    ADMIN_ACTIVATE_EVENT 5003
    ADMIN_DEACTIVATE_EVENT 5004
    ERROR_DIRECTORY_SERVICE_EVENT 6000
    CREATED_POLICYSET_EVENT 7000
    DELETED_POLICYSET_EVENT 7001
    MODIFIED_POLICYSET_EVENT 7002
  4. Pesquisar o evento

    Procure o evento chamando o método searchForEvents do objeto DocumentSecurityServiceClient e transmitindo o objeto EventSpec que representa o evento pelo qual pesquisar e o número máximo de resultados. Este 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 Quick Starts:

  • "Início rápido (MTOM): procurando eventos usando a API de serviço da Web"
  • "Início rápido (SwaRef): procurando eventos usando a API de 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 applying-policies-to-word-documents

Além de documentos PDF, o serviço Rights Management suporta 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 após distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem está usando-o. Por exemplo, você pode descobrir quando alguém abriu o documento.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-11

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

  1. Incluir arquivos de projeto.
  2. Crie um objeto de API do cliente de Segurança de documentos.
  3. Recupere um documento do Word ao qual uma política é aplicada.
  4. Aplicar 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 uma aplicação 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 APIobject de cliente de segurança de documentos

Antes de executar programaticamente uma operação de serviço de Segurança de documentos, você deve criar um objeto cliente de serviço de Segurança de documentos.

Recuperar um documento do Word

Recupere um documento do Word para aplicar uma política. Depois de aplicar uma política ao documento do Word, os usuários ficam restritos ao usar o documento. Por exemplo, se a política não permitir que o documento seja aberto 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, você deve fazer referência a uma política existente e especificar a qual política 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 documentos 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

Definindo propriedades de conexão

Revogação do acesso a documentos

Aplicar uma política a um documento do Word usando a API Java apply-a-policy-to-a-word-document-using-the-java-api

Aplique uma política a um documento do Word 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. Crie 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. Recupere um documento do Word.

    • Crie um objeto java.io.FileInputStream que represente o documento do Word usando seu construtor e transmitindo um valor de cadeia de caracteres 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. Aplicar uma política existente ao documento do Word.

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

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

      • O objeto com.adobe.idp.Document que contém o documento do Word ao qual a política é aplicada.
      • Um valor de cadeia de caracteres 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 resulte no uso do conjunto de políticas MyPolicies.
      • 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 publicador do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor de parâmetro deverá ser nulo).
      • Um valor de string que representa o nome canônico do usuário gerente do usuário que é o editor do documento. Este valor de parâmetro é opcional e pode ser null (se este parâmetro for null, 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. Este 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.

    • Invoque o método getProtectedDoc do objeto RMSecureDocumentResult 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 do arquivo é DOC.
    • Invoque o método copyToFile do objeto com.adobe.idp.Document 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 documentos, consulte o seguinte Início rápido:

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

Aplicar uma política a um documento do Word usando a API de serviço Web apply-a-policy-to-a-word-document-using-the-web-service-api

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

  1. Incluir arquivos de projeto.

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

    note note
    NOTE
    Substitua localhost pelo endereço IP do servidor que hospeda o AEM Forms.
  2. Crie 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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 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 transmitindo um valor de cadeia de caracteres 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o conteúdo da matriz de bytes.
  4. Aplicar uma política existente ao documento do Word.

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

    • O objeto BLOB que contém o documento do Word ao qual a política é aplicada.
    • Um valor de cadeia de caracteres 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 resulte no uso do conjunto de políticas MyPolicies.
    • 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 publicador do documento. Este valor de parâmetro é opcional e pode ser nulo (se este parâmetro for nulo, o próximo valor de parâmetro deverá ser null).
    • Um valor de string que representa o nome canônico do usuário gerente do usuário que é o editor do documento. Este valor de parâmetro é opcional e pode ser nulo (se este parâmetro for nulo, o valor do parâmetro anterior deverá ser null).
    • Um valor RMLocale que especifica o valor da localidade (por exemplo, RMLocale.en).
    • Um parâmetro de saída da string usado para armazenar o valor do identificador da política.
    • Um parâmetro de saída da string usado para armazenar o valor do identificador protegido por política.
    • Um parâmetro de saída da cadeia de caracteres que é 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 transmitindo um valor de cadeia de caracteres 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. Popular a matriz de bytes obtendo o valor do membro de dados MTOM do objeto BLOB.
    • Crie um objeto System.IO.BinaryWriter invocando seu construtor e transmitindo o objeto System.IO.FileStream.
    • Grave o conteúdo da matriz de bytes em um arquivo do Word invocando o método Write do objeto System.IO.BinaryWriter e transmitindo a matriz de bytes.

Exemplos de código

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

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

Removendo Políticas de Documentos do Word removing-policies-from-word-documents

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, será mais eficiente alternar a política.

NOTE
Para obter mais informações sobre o serviço de Segurança de documentos, consulte Referência de serviços para o AEM Forms.

Resumo das etapas summary_of_steps-12

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 de API do cliente de Segurança de documentos.
  3. Recupere 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 protegido

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 do serviço de Segurança de documentos, crie um objeto de cliente desse serviço.

Recuperar um documento do Word protegido por política

Recupere um documento do Word protegido por política para remover uma política. Se você tentar remover uma política de um documento do Word que não esteja protegido por uma política, causará 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 deve 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 remover uma política de um documento do Word, você poderá salvar o documento do Word não protegido como um arquivo DOC.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Aplicando Políticas a Documentos do Word

Remover uma política de um documento do Word usando a API Java remove-a-policy-from-a-word-document-using-the-java-api

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 cadeia de caracteres 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 invocando o método getDocumentManager do objeto RightsManagementClient.
    • Remova uma política do documento do Word chamando o método removeSecurity do objeto DocumentManager 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 protegido

    • Crie um objeto java.io.File e verifique se a extensão do arquivo é DOC.
    • Invoque o método copyToFile do objeto Document 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 documentos, consulte o seguinte Início rápido:

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

Remover uma política de um documento do Word usando a API do serviço Web remove-a-policy-from-a-word-document-using-the-web-service-api

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 Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    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. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

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

    • Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

    • 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 de senha correspondente 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 foi removida.
    • Crie um objeto System.IO.FileStream chamando seu construtor e transmitindo um valor de cadeia de caracteres 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 Length do objeto System.IO.FileStream.
    • Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
    • Preencha o objeto BLOB atribuindo seu campo MTOM com o 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 removePolicySecurity do objeto RightsManagementServiceClient 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 protegido

    • Crie um objeto System.IO.FileStream chamando seu construtor e transmitindo um valor de cadeia de caracteres 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. Popular a matriz de bytes obtendo o valor do campo MTOM do objeto BLOB.
    • Crie um objeto System.IO.BinaryWriter invocando seu construtor e transmitindo o objeto System.IO.FileStream.

Exemplos de código

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

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

Consulte também

Chamar o AEM Forms usando MTOM

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2