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

Incluir arquivos de projeto.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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.

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.

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.

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.

Defina os atributos da política.

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

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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.

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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).

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.

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.

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.

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.

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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).

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.

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.

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.

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.

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.

Incluir arquivos de projeto

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

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.

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.

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.

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.

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.

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.

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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.

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.

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.

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).

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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.

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.

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.

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

Incluir arquivos de projeto

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

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.

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.

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.

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.

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.

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:

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.

Incluir arquivos de projeto.

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

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.

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.

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.

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).

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.

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.

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.

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.

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.

Incluir arquivos de projeto

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

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.

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.

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.

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).

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.

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.

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.

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.

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.