Exemplos e exemplos neste documento são apenas para o AEM Forms no ambiente JEE.
Sobre o serviço de segurança de documentos
O serviço de segurança de documentos permite que os usuários apliquem dinamicamente configurações de confidencialidade a documentos da Adobe PDF e mantenham o controle sobre os documentos, independentemente da extensão de distribuição.
O serviço de segurança de documentos impede que as informações se espalhem além do alcance do usuário, permitindo que os usuários mantenham o controle sobre como os recipients usam o documento PDF protegido por políticas. Um usuário pode especificar quem pode abrir um documento, limitar como ele pode usá-lo e monitorar o documento após a distribuição. Um usuário também pode controlar dinamicamente o acesso a um documento protegido por políticas e pode até mesmo revogar dinamicamente o acesso ao documento.
O serviço Segurança de documentos também protege outros tipos de arquivos, como arquivos do Microsoft Word (arquivos DOC). Você pode usar a API do cliente de segurança de documentos para trabalhar com esses tipos de arquivos. As seguintes versões são compatíveis:
Para maior clareza, as duas seções a seguir discutem como trabalhar com documentos do Word:
Você pode realizar essas tarefas usando o serviço Segurança de documentos:
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Você pode criar políticas programaticamente usando a API do Java de segurança de documentos ou a API do serviço da Web. Uma policy é uma coleção de informações que inclui configurações de segurança de documentos, usuários autorizados e direitos de uso. Você pode criar e salvar qualquer número de políticas, usando configurações de segurança apropriadas para diferentes situações e usuários.
As políticas permitem que você execute estas tarefas:
Ao criar uma política usando a API do serviço da Web, consulte um arquivo XML da Linguagem de direitos de documento portátil (PDRL) existente que descreve a política. As permissões de política e o principal são definidos no documento PDRL. O documento XML a seguir é um exemplo de um documento PDRL.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
<PolicyEntry>
<ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>all_internal_users</PrincipalName>
</Principal>
</PolicyEntry>
<PolicyEntry>
<ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
<ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
<ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>publisher</PrincipalName>
</Principal>
</PolicyEntry>
<OfflineLeasePeriod>
<Duration>P31D</Duration>
</OfflineLeasePeriod>
<AuditSettings isTracked="true" />
<PolicyValidityPeriod isAbsoluteTime="false">
<ValidityPeriodRelative>
<NotBeforeRelative>PT0S</NotBeforeRelative>
<NotAfterRelative>P20D</NotAfterRelative>
</ValidityPeriodRelative>
</PolicyValidityPeriod>
</Policy>
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para criar uma política, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao classpath do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.
Definir os atributos da política
Para criar uma política, defina os atributos da política. Um atributo obrigatório é o nome da política. Os nomes de políticas devem ser exclusivos para cada conjunto de políticas. Um conjunto de políticas é simplesmente uma coleção de políticas. Pode haver duas políticas com o mesmo nome se as políticas pertencerem a conjuntos de políticas separados. No entanto, duas políticas em um único conjunto de políticas não podem ter o mesmo nome de política.
Outro atributo útil a ser definido é o período de validade. Um período de validade é o período durante o qual um documento protegido por uma política é acessível aos destinatários autorizados. Se você não definir esse atributo, a política sempre será válida.
Um período de validade pode ser definido como uma destas opções:
Você pode especificar apenas uma data de início, o que resulta na validade da política após a data de início. Se você especificar apenas uma data de término, a política será válida até a data de término. No entanto, uma exceção é lançada se uma data inicial e uma data final não estiverem definidas.
Ao definir atributos que pertencem a uma política, também é possível definir configurações de criptografia. Essas configurações de criptografia ocorrem quando a política é aplicada a um documento. Você pode especificar os seguintes valores de criptografia:
Ao especificar a opção NoEncryption
, não é possível definir a opção PlaintextMetadata
como false
. Se você tentar fazer isso, uma exceção será lançada.
Para obter informações sobre outros atributos que podem ser definidos, consulte a descrição da interface Policy
no AEM Forms API Reference.
Criar uma entrada de política
Uma entrada de política anexa entidades principais, que são grupos e usuários, e permissões a uma política. Uma política deve ter pelo menos uma entrada política. Considere, por exemplo, que você executa essas tarefas:
Essas ações resultam em recipients serem capazes apenas de exibir o documento online e não poderem copiá-lo. O documento permanece seguro até que a segurança seja removida dele.
Registrar a política
Uma nova política deve ser registrada antes de poder ser usada. Depois de registrar uma política, você pode usá-la para proteger documentos.
Crie uma política usando a API de segurança de documentos (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.DocumentSecurityClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Defina os atributos da política.
Policy
chamando o método InfomodelObjectFactory
estático createPolicy
do objeto. Este método retorna um objeto Policy
.Policy
do objeto setName
e passando um valor de string que especifica o nome da política.Policy
do objeto setDescription
e passando um valor de string que especifica a descrição da política.Policy
do objeto e passando um valor de string que especifica o nome do conjunto de políticas. setPolicySetName
(Você pode especificar null
para esse valor de parâmetro que resulta na política sendo adicionada ao conjunto de políticas Minhas políticas.)InfomodelObjectFactory
estático createValidityPeriod
do objeto. Este método retorna um objeto ValidityPeriod
.ValidityPeriod
do objeto setRelativeExpirationDays
e passando um valor inteiro que especifica o número de dias.Policy
do objeto e transmitindo o objeto ValidityPeriod
.setValidityPeriod
Crie uma entrada de política.
InfomodelObjectFactory
estático createPolicyEntry
do objeto. Este método retorna um objeto PolicyEntry
.InfomodelObjectFactory
estático createPermission
do objeto. Passe um membro de dados estáticos que pertence à interface Permission
que representa a permissão. Este método retorna um objeto Permission
. Por exemplo, para adicionar a permissão que permite aos usuários copiar dados de um documento PDF protegido por política, passe Permission.COPY
. (Repita essa etapa para cada permissão para adicionar).PolicyEntry
do objeto addPermission
e transmitindo o objeto Permission
. (Repita essa etapa para cada objeto Permission
que você criou).InfomodelObjectFactory
estático createSpecialPrincipal
do objeto. Passe um membro de dados que pertence ao objeto InfomodelObjectFactory
que representa o principal. Este método retorna um objeto Principal
. Por exemplo, para adicionar o editor do documento como principal, passe InfomodelObjectFactory.PUBLISHER_PRINCIPAL
.PolicyEntry
do objeto e passando o objeto Principal
.setPrincipal
Policy
do objeto addPolicyEntry
e transmitindo o objeto PolicyEntry
.Registre a política.
Crie um objeto PolicyManager
chamando o método DocumentSecurityClient
getPolicyManager
do objeto.
Registre a política chamando o método PolicyManager
do objeto registerPolicy
e transmitindo os seguintes valores:
Policy
que representa a política a ser registrada.Um valor de string que representa o conjunto de políticas ao qual a política pertence.
Se você usar uma conta de administrador do AEM forms nas configurações de conexão para criar o objeto DocumentSecurityClient
, especifique o nome do conjunto de políticas ao chamar o método registerPolicy
. Se você passar um valor null
para o conjunto de políticas, a política será criada no conjunto de políticas de administradores Minhas Políticas.
Se você usar um usuário de Segurança de documento nas configurações de conexão, poderá invocar o método sobrecarregado registerPolicy
que aceita apenas a política. Ou seja, você não precisa especificar o nome do conjunto de políticas. No entanto, a política é adicionada ao conjunto de políticas chamado Minhas Políticas. Se não quiser adicionar a nova política a esse conjunto de políticas, especifique um nome de conjunto de políticas ao chamar o método registerPolicy
.
Ao criar uma política, faça referência a um conjunto de políticas existente. Se você especificar um conjunto de políticas que não existe, uma exceção será lançada.
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte:
Crie uma política usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto DocumentSecurityServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Defina os atributos da política.
PolicySpec
usando seu construtor.PolicySpec
do objeto name
.PolicySpec
do objeto description
.PolicySpec
membro de dados policySetName
do objeto. Você deve especificar um nome de conjunto de políticas existente. (Você pode especificar null
para esse valor de parâmetro que resulta na política sendo adicionada a Minhas Políticas.)PolicySpec
do objeto offlineLeasePeriod
.PolicySpec
do objeto policyXml
com um valor de string que represente dados XML de PDRL. Para executar essa tarefa, crie um objeto .NET StreamReader
usando seu construtor. Passe o local de um arquivo XML PDRL que representa a política para o construtor StreamReader
. Em seguida, chame o método StreamReader
do objeto e atribua o valor de retorno a uma variável de string. ReadLine
Itere pelo objeto StreamReader
até que o método ReadLine
retorne nulo. Atribua a variável da string ao membro de dados PolicySpec
do objeto.policyXml
Crie uma entrada de política.
Não é necessário criar uma entrada de política ao criar uma política usando a API do serviço da Web Document Security. A entrada de política é definida no documento PDRL.
Registre a política.
Registre a política chamando o método DocumentSecurityServiceClient
do objeto registerPolicy
e transmitindo os seguintes valores:
PolicySpec
que representa a política a ser registrada.null
que resulta na adição da política ao conjunto de políticas MyPolices.Se você usar uma conta de administrador do AEM forms nas configurações de conexão para criar o objeto DocumentSecurityClient
, especifique o nome do conjunto de políticas ao chamar o método registerPolicy
.
Se você usar um usuário de Segurança de documento nas configurações de conexão, poderá invocar o método sobrecarregado registerPolicy
que aceita somente a política. Ou seja, você não precisa especificar o nome do conjunto de políticas. No entanto, a política é adicionada ao conjunto de políticas chamado Minhas Políticas. Se não quiser adicionar a nova política a esse conjunto de políticas, especifique um nome de conjunto de políticas ao chamar o método registerPolicy
.
Ao criar uma política e especificar um conjunto de políticas, especifique um conjunto de políticas existente. Se você especificar um conjunto de políticas que não existe, uma exceção será lançada.
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Você pode modificar uma política existente usando a API do Java de segurança de documentos ou a API do serviço da Web. Para fazer alterações em uma política existente, você a recupera, a modifica e então atualiza a política no servidor. Por exemplo, suponha que você recupere uma política existente e estenda seu período de validade. Antes que a alteração entre em vigor, você deve atualizar a política.
Você pode modificar uma política quando os requisitos da empresa mudarem e a política não refletir mais esses requisitos. Em vez de criar uma nova política, você pode simplesmente atualizar uma política existente.
Para modificar atributos de política usando um serviço da Web (por exemplo, usando classes proxy Java criadas com JAX-WS), é necessário garantir que a política seja registrada no serviço de Segurança de documento. Você pode fazer referência à política existente usando o método PolicySpec.getPolicyXml
e modificar os atributos da política usando os métodos aplicáveis. Por exemplo, você pode modificar o período de concessão offline chamando o método PolicySpec.setOfflineLeasePeriod
.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para modificar uma política existente, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService
.
Recuperar uma política existente
Você deve recuperar uma política existente para modificá-la. Para recuperar uma política, especifique o nome da política e o conjunto de políticas ao qual a política pertence. Se você especificar um valor null
para o nome do conjunto de políticas, a política será recuperada do conjunto de políticas Minhas Políticas.
Definir os atributos da política
Para modificar uma política, você modifica o valor dos atributos de política. O único atributo de política que não pode ser alterado é o atributo name. Por exemplo, para alterar o período de concessão offline da política, você pode modificar o valor do atributo de período de concessão offline da política.
Ao modificar o período de concessão offline de uma política usando um serviço da Web, o campo offlineLeasePeriod
na interface PolicySpec
é ignorado. Para atualizar o período de concessão offline, modifique o elemento OfflineLeasePeriod
no documento XML PDRL. Em seguida, faça referência ao documento XML PDRL atualizado usando o PolicySpec
membro de dados policyXML
da interface.
Para obter informações sobre outros atributos que podem ser definidos, consulte a descrição da interface Policy
no AEM Forms API Reference.
Atualizar a política
Antes que as alterações feitas em uma política sejam aplicadas, é necessário atualizar a política com o serviço de Segurança de documentos. As alterações nas políticas que protegem documentos são atualizadas na próxima vez que o documento protegido por política for sincronizado com o serviço de Segurança de documentos.
Modifique uma política existente usando a API de segurança de documentos (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.RightsManagementClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere uma política existente.
Crie um objeto PolicyManager
chamando o método RightsManagementClient
getPolicyManager
do objeto.
Crie um objeto Policy
que represente a política a ser atualizada chamando o método PolicyManager
do objeto getPolicy
e transmitindo os seguintes valores"
null
que resulta no conjunto de políticas MyPolicies
sendo usado.Defina os atributos da política.
Altere os atributos da política para atender às suas necessidades de negócios. Por exemplo, para alterar o período de concessão offline da política, chame o método Policy
do objeto setOfflineLeasePeriod
.
Atualize a política.
Atualize a política chamando o método PolicyManager
do objeto updatePolicy
. Passe o objeto Policy
que representa a política a ser atualizada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o Início rápido (modo SOAP): Modificação de uma política usando a seção API do Java .
Modifique uma política existente usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto RightsManagementServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Recupere uma política existente.
Crie um objeto PolicySpec
que represente a política a ser modificada chamando o método RightsManagementServiceClient
do objeto getPolicy
e transmitindo os seguintes valores:
null
que resulta no conjunto de políticas MyPolicies
sendo usado.Defina os atributos da política.
Altere os atributos da política para atender às suas necessidades de negócios.
Atualize a política.
Atualize a política chamando o método RightsManagementServiceClient
do objeto updatePolicyFromSDK
e transmitindo o objeto PolicySpec
que representa a política a ser atualizada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
É possível excluir uma política existente usando a API do Java de segurança de documento ou a API do serviço da Web. Depois que uma política é excluída, ela não pode mais ser usada para proteger documentos. No entanto, os documentos protegidos por políticas que estão usando a política ainda estão protegidos. É possível excluir uma política quando uma nova estiver disponível.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para excluir uma política existente, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService
.
Excluir a política
Para excluir uma política, especifique a política a ser excluída e o conjunto de políticas ao qual a política pertence. O usuário cujas configurações são usadas para chamar o AEM Forms deve ter permissão para excluir a política; caso contrário, ocorrerá uma exceção. Da mesma forma, se você tentar excluir uma política que não existe, ocorrerá uma exceção.
Exclua uma política usando a API de segurança de documentos (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.RightsManagementClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Exclua a política.
Crie um objeto PolicyManager
chamando o método RightsManagementClient
getPolicyManager
do objeto.
Exclua a política chamando o método PolicyManager
do objeto deletePolicy
e passando os seguintes valores:
null
que resulta no conjunto de políticas MyPolicies
sendo usado.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Exclua uma política usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto RightsManagementServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.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 chamando o método RightsManagementServiceClient
do objeto deletePolicy
e passando os seguintes valores:
null
que resulta no conjunto de políticas MyPolicies
sendo usado.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
É possível aplicar uma política a um documento PDF para proteger o documento. Ao aplicar uma política a um documento PDF, você restringe o acesso ao documento. Não é possível aplicar uma política a um documento se ele já estiver protegido por uma política.
Enquanto o documento estiver aberto, você também poderá restringir o acesso aos recursos do Acrobat e Adobe Reader, incluindo a capacidade de imprimir e copiar texto, fazer alterações e adicionar assinaturas e comentários a um documento. Além disso, você pode revogar um documento PDF protegido por políticas quando não quiser mais que os usuários acessem o documento.
Você pode monitorar o uso de um documento protegido por políticas depois de distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para aplicar uma política a um documento PDF, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto da API do cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto DocumentSecurityServiceService
.
Recuperar um documento PDF
Você pode recuperar um documento PDF para aplicar uma política. Depois de aplicar uma política ao documento PDF, os usuários são restritos ao usar o documento. Por exemplo, se a política não habilitar a abertura do documento offline, os usuários deverão estar online para abrir o documento.
Aplicar uma política existente ao documento PDF
Para aplicar uma política a um documento PDF, consulte uma política existente e especifique a que conjunto de políticas a política pertence. O usuário que está definindo as propriedades de conexão deve ter acesso à política especificada. Caso contrário, ocorrerá uma exceção.
Salvar o documento PDF
Depois que o serviço de segurança de documento aplicar uma política a um documento PDF, você poderá salvar o documento PDF protegido por política como um arquivo PDF.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Revogando o acesso aos documentos
Aplique uma política a um documento PDF usando a API de segurança de documentos (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.RightsManagementClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere um documento PDF.
java.io.FileInputStream
que represente o documento PDF usando seu construtor. Passe um valor de string que especifica o local do documento PDF.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
chamando o método RightsManagementClient
getDocumentManager
do objeto.
Aplique uma política ao documento PDF chamando o método DocumentManager
do objeto protectDocument
e transmitindo os seguintes valores:
com.adobe.idp.Document
que contém o documento PDF ao qual a política é aplicada.null
que resulta no conjunto de políticas MyPolicies
sendo usado.null
(se esse parâmetro for nulo, o valor do parâmetro anterior deverá ser null
).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.
RMSecureDocumentResult
do objeto getProtectedDoc
para obter o documento PDF protegido por política. Este método retorna um objeto com.adobe.idp.Document
.java.io.File
e verifique se a extensão de arquivo é PDF.com.adobe.idp.Document
do objeto copyToFile
para copiar o conteúdo do objeto Document
para o arquivo (certifique-se de usar o objeto Document
retornado pelo método getProtectedDoc
).Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Aplique uma política a um documento PDF usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto RightsManagementServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Recupere um documento PDF.
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar um documento PDF ao qual uma política é aplicada.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto.System.IO.FileStream
. Determine o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Aplique uma política existente ao documento PDF.
Aplique uma política ao documento PDF chamando o método RightsManagementServiceClient
do objeto protectDocument
e transmitindo os seguintes valores:
BLOB
que contém o documento PDF ao qual a política é aplicada.null
que resulta no conjunto de políticas MyPolicies
sendo usado.null
).null
).RMLocale
que especifica o valor do local (por exemplo, RMLocale.en
).application/pdf
).O método protectDocument
retorna um objeto BLOB
que contém o documento PDF protegido por política.
Salve o documento PDF.
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF protegido por política.BLOB
retornado pelo método protectDocument
. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.System.IO.BinaryWriter
do objeto Write
e transmitindo a matriz de bytes.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Você pode remover uma política de um documento protegido por política para remover a segurança do documento. Ou seja, se você não quiser mais que o documento seja protegido por uma política. Se quiser atualizar um documento protegido por uma política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, é mais eficiente mudar a política.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para remover uma política de um documento PDF protegido por política, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.
Recuperar um documento PDF protegido por política
Você pode recuperar um documento PDF protegido por uma política para remover uma política. Se você tentar remover uma política de um documento PDF que não está protegido por uma política, ocorrerá uma exceção.
Remover a política do documento PDF
É possível remover uma política de um documento PDF protegido por políticas, desde que um administrador seja especificado nas configurações de conexão. Caso contrário, a política usada para proteger um documento deverá conter a permissão SWITCH_POLICY
para remover uma política de um documento PDF. Além disso, o usuário especificado nas configurações de conexão do AEM Forms também deve ter essa permissão. Caso contrário, uma exceção será lançada.
Salvar o documento PDF não seguro
Depois que o serviço de segurança de documentos remove uma política de um documento PDF, é possível salvar o documento PDF não seguro como um arquivo PDF.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Aplicação de políticas a documentos PDF
Remova uma política de um documento PDF protegido por políticas usando a API de segurança de documentos (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.DocumentSecurityClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere um documento PDF protegido por política.
java.io.FileInputStream
que represente o documento PDF protegido por política usando seu construtor e transmitindo um valor de string que especifique o local do documento PDF.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Remova a política do documento PDF.
DocumentManager
chamando o método DocumentSecurityClient
getDocumentManager
do objeto.DocumentManager
do objeto e transmitindo o objeto com.adobe.idp.Document
que contém o documento PDF protegido por política. removeSecurity
Esse método retorna um objeto com.adobe.idp.Document
que contém um documento PDF inseguro.Salve o documento PDF inseguro.
java.io.File
e verifique se a extensão de arquivo é PDF.Document
do objeto copyToFile
para copiar o conteúdo do objeto Document
para o arquivo (certifique-se de usar o objeto Document
retornado pelo método removeSecurity
).Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Remova uma política de um documento PDF protegido por política usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto DocumentSecurityServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.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.
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar o documento PDF protegido por política do qual a política é removida.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Remova a política do documento PDF.
Remova a política do documento PDF chamando o método DocumentSecurityServiceClient
do objeto removePolicySecurity
e transmitindo o objeto BLOB
que contém o documento PDF protegido por política. Esse método retorna um objeto BLOB
que contém um documento PDF inseguro.
Salve o documento PDF inseguro.
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF não seguro.BLOB
retornado pelo método removePolicySecurity
. Preencha a matriz de bytes obtendo o valor do campo BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Consulte também:
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef
Você pode revogar o acesso a um documento PDF protegido por políticas, resultando em todas as cópias do documento serem inacessíveis aos usuários. Quando um usuário tenta abrir um documento PDF revogado, ele é redirecionado para um URL especificado, onde um documento revisado pode ser visualizado. O URL para onde o usuário é redirecionado deve ser especificado de forma programática. Quando você revoga o acesso a um documento, a alteração entrará em vigor na próxima vez que o usuário sincronizar com o serviço de Segurança de documentos, abrindo o documento protegido por política online.
A capacidade de revogar o acesso a um documento fornece segurança adicional. Por exemplo, suponha que uma versão mais recente de um documento esteja disponível e você não quer mais que ninguém visualize a versão desatualizada. Nessa situação, o acesso ao documento mais antigo pode ser revogado e ninguém pode exibi-lo a menos que o acesso seja recriado.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para revogar um documento protegido por política, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento.
Recuperar um documento PDF protegido por política
Você deve recuperar um documento PDF protegido por política para revogá-lo. Não é possível revogar um documento que já foi revogado ou que não é um documento protegido por uma política.
Se você souber o valor do identificador de licença do documento protegido por política, não será necessário recuperar o documento PDF protegido por política. No entanto, na maioria dos casos, será necessário recuperar o documento PDF para obter o valor do identificador de licença.
Revogar o documento protegido por política
Para revogar um documento protegido por política, especifique o identificador de licença do documento protegido por política. Além disso, você pode especificar o URL de um documento que o usuário pode visualizar ao tentar abrir o documento revogado. Ou seja, suponha que um documento desatualizado seja revogado. Quando um usuário tenta abrir o documento revogado, ele verá um documento atualizado em vez do documento revogado.
Se você tentar revogar um documento que já foi revogado, uma exceção será lançada.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Aplicação de políticas a documentos PDF
Reposição do acesso a documentos revisados
Revogar o acesso a um documento PDF protegido por políticas usando a API de segurança de documentos (Java):
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
ServiceClientFactory
que contenha propriedades de conexão.DocumentSecurityClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recuperar um documento PDF protegido por política
java.io.FileInputStream
que represente o documento PDF protegido por política usando seu construtor e transmitindo um valor de string que especifique o local do documento PDF.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
chamando o método DocumentSecurityClient
getDocumentManager
do objeto.
Recupere o valor do identificador da licença do documento protegido por política, chamando o método DocumentManager
do objeto getLicenseId
. Passe o objeto com.adobe.idp.Document
que representa o documento protegido por política. Esse método retorna um valor de string que representa o valor do identificador de licença.
Crie um objeto LicenseManager
chamando o método DocumentSecurityClient
getLicenseManager
do objeto.
Revoge o documento protegido por política, chamando o método LicenseManager
do objeto revokeLicense
e transmitindo os seguintes valores:
DocumentManager
do objeto getLicenseId
).License
que especifica o motivo para revogar o documento. Por exemplo, você pode especificar License.DOCUMENT_REVISED
.java.net.URL
que especifica o local onde um documento revisado está localizado. Se você não deseja redirecionar um usuário para outro URL, é possível enviar null
.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Revogar o acesso a um documento PDF protegido por políticas usando a API de segurança de documentos (serviço da Web):
Incluir arquivos de projeto
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Criar um objeto de API do Cliente de segurança de documentos
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto DocumentSecurityServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.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
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar um documento PDF protegido por política que é revogado.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF protegido por política a ser revogado e o modo no qual o arquivo será aberto.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Revogar o documento protegido por política
Recupere o valor do identificador da licença do documento protegido por política, chamando o método DocumentSecurityServiceClient
do objeto getLicenseID
e transmitindo o objeto BLOB
que representa o documento protegido por política. Esse método retorna um valor de string que representa o identificador de licença.
Revoge o documento protegido por política, chamando o método DocumentSecurityServiceClient
do objeto revokeLicense
e transmitindo os seguintes valores:
DocumentSecurityServiceService
do objeto getLicenseId
).Reason
que especifica o motivo para revogar o documento. Por exemplo, você pode especificar Reason.DOCUMENT_REVISED
.string
que especifica o local do URL para onde um documento revisado está localizado. Se você não deseja redirecionar um usuário para outro URL, é possível enviar null
.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Consulte também:
Remover Políticas de Documentos do Word
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef
Você pode restabelecer o acesso a um documento PDF revogado, resultando em todas as cópias do documento revogado serem acessíveis aos usuários. Quando um usuário abre um documento recriado que foi revogado, ele pode visualizar o documento.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para restabelecer o acesso a um documento PDF revogado, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto DocumentSecurityServiceService
.
Recuperar o identificador de licença do documento PDF revogado
Você deve recuperar o identificador de licença do documento PDF revogado para restabelecer um documento PDF revogado. Após obter o valor do identificador de licença, é possível reinstalar um documento revogado. Se tentar reinstalar um documento que não foi revogado, ocorrerá uma exceção.
Retomar o acesso ao documento PDF revogado
Para restabelecer o acesso a um documento PDF revogado, você deve especificar o identificador de licença do documento revogado. Se você tentar restabelecer o acesso a um documento PDF que não foi revogado, ocorrerá uma exceção.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Aplicação de políticas a documentos PDF
Revogando o acesso aos documentos
Instale novamente o acesso a um documento revogado usando a API de segurança de documento (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.DocumentSecurityClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere o identificador da licença do documento PDF revogado.
java.io.FileInputStream
que represente o documento PDF revogado usando seu construtor e passando um valor de string que especifica o local do documento PDF.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.DocumentManager
chamando o método DocumentSecurityClient
getDocumentManager
do objeto.DocumentManager
do objeto getLicenseId
e transmitindo o objeto com.adobe.idp.Document
que representa o documento revogado. Esse método retorna um valor de string que representa o identificador de licença.Retomar o acesso ao documento PDF revogado.
LicenseManager
chamando o método DocumentSecurityClient
getLicenseManager
do objeto.LicenseManager
do objeto unrevokeLicense
e transmitindo o valor do identificador de licença do documento revogado.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Instale novamente o acesso a um documento revogado usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto DocumentSecurityServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Recupere o identificador da licença do documento PDF revogado.
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar um documento PDF revogado para o qual o acesso é restabelecido.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF revogado e o modo no qual o arquivo será aberto.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Retomar o acesso ao documento PDF revogado.
DocumentSecurityServiceClient
do objeto getLicenseID
e transmitindo o objeto BLOB
que representa o documento revogado. Esse método retorna um valor de string que representa o identificador de licença.DocumentSecurityServiceClient
do objeto e passando um valor de string que especifica o valor do identificador de licença do documento PDF revogado (passe o valor de retorno do método DocumentSecurityServiceClient
do objeto getLicenseId
).unrevokeLicense
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Consulte também:
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef
Você pode usar a API do Serviço de segurança de documentos (Java e serviço da Web) para inspecionar documentos PDF protegidos por políticas. Inspecionar documentos PDF protegidos por política retorna informações sobre o documento PDF protegido por política. Você pode, por exemplo, determinar a política usada para proteger o documento e a data em que o documento foi protegido.
Não é possível executar essa tarefa se a versão do LiveCycle for 8.x ou anterior. O suporte para inspecionar documentos protegidos por políticas é adicionado no AEM Forms. Se você tentar inspecionar um documento protegido por uma política usando o LiveCycle 8.x (ou anterior), uma exceção será lançada.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para inspecionar um documento PDF protegido por uma política, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService
.
Recuperar um documento protegido por política para inspecionar
Para inspecionar um documento protegido por política, recupere-o. Se você tentar inspecionar um documento que não está protegido com uma política ou que foi revogado, uma exceção será lançada.
Inspect o documento
Depois de recuperar um documento protegido por políticas, você pode inspecioná-lo.
Obter informações sobre o documento protegido por políticas
Após inspecionar um documento PDF protegido por políticas, você pode obter informações sobre ele. Por exemplo, você pode determinar a política usada para proteger o documento.
Se você proteger um documento com uma política que pertence a Minhas Políticas e, em seguida, chamar RMInspectResult.getPolicysetName
ou RMInspectResult.getPolicysetId
, null será retornado.
Se o documento estiver protegido usando uma política contida em um conjunto de políticas (diferente de Minhas Políticas), RMInspectResult.getPolicysetName
e RMInspectResult.getPolicysetId
retornará sequências de caracteres válidas.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Inspect um documento PDF protegido por políticas usando a API do Serviço de segurança de documentos (Java):
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como o adobe-rights-management-client.jar, no caminho de classe do seu projeto Java. Para obter informações sobre a localização desses arquivos, consulte Incluindo arquivos da biblioteca Java do AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão. (Consulte Definindo propriedades de conexão.)RightsManagementClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere um documento protegido por política para inspecionar.
java.io.FileInputStream
que represente o documento PDF protegido por política usando seu construtor. Passe um valor de string que especifica o local do documento PDF.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Inspect o documento.
DocumentManager
chamando o método RightsManagementClient
getDocumentManager
do objeto.LicenseManager
do objeto inspectDocument
. Passe o objeto com.adobe.idp.Document
que contém o documento PDF protegido por política. Este método retorna um objeto RMInspectResult
que contém informações sobre o documento protegido por política.Obtenha informações sobre o documento protegido por políticas.
Para obter informações sobre o documento protegido por política, chame o método apropriado que pertence ao objeto RMInspectResult
. Por exemplo, para recuperar o nome da política, chame o método RMInspectResult
do objeto getPolicyName
.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Inspect um documento PDF protegido por políticas usando a API do Serviço de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto RightsManagementServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.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.
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar um documento PDF a ser inspecionado.System.IO.FileStream
chamando seu construtor. Passe um valor de string que representa o local do arquivo do documento PDF e o modo para abrir o arquivo.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Inspect o documento.
Inspect o documento protegido por política, chamando o método RightsManagementServiceClient
do objeto inspectDocument
. Passe o objeto BLOB
que contém o documento PDF protegido por política. Este método retorna um objeto RMInspectResult
que contém informações sobre o documento protegido por política.
Obtenha informações sobre o documento protegido por políticas.
Para obter informações sobre o documento protegido por política, obtenha o valor do campo apropriado que pertence ao objeto RMInspectResult
. Por exemplo, para recuperar o nome da política, obtenha o valor do campo RMInspectResult
do objeto policyName
.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Consulte também:
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef
As marcas d'água ajudam a garantir a segurança de um documento, identificando-o exclusivamente e controlando a violação de direitos autorais. Por exemplo, você pode criar e colocar uma marca d'água que declare Confidencial em todas as páginas de um documento. Depois que uma marca d'água é criada, é possível incluí-la como parte de uma política. Ou seja, você pode definir o atributo de marca d'água da política com a marca d'água recém-criada. Depois que uma política que contém uma marca d'água é aplicada a um documento, a marca d'água aparece no documento protegido por política.
Somente usuários com privilégios administrativos de Segurança de documento 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 documento.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para criar uma marca d'água, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto RightsManagementClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto RightsManagementServiceService
.
Definir os atributos de marcas d'água
Para criar uma nova marca d'água, você deve definir atributos de marca d'água. O atributo name deve ser sempre definido. Além do atributo name, você deve definir pelo menos um dos seguintes atributos:
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 |
---|---|---|
|
Especifica se o nome de usuário do usuário que abre o documento faz parte da marca d'água. |
Verdadeiro ou Falso |
|
Especifica se a identificação do usuário que abre o documento faz parte da marca d'água. |
Verdadeiro ou Falso |
|
Especifica se a data atual faz parte da marca d'água. |
Verdadeiro ou Falso |
|
Se esse valor for true, o valor do texto personalizado deverá ser especificado usando |
Verdadeiro ou Falso |
|
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. |
|
Especifica a rotação da marca d'água. O valor padrão é 0 graus. |
Um valor entre 0 e 359. |
|
Se esse valor for especificado, |
Um valor superior a 0.0 e inferior ou igual a 1.0. |
|
Especifica o alinhamento horizontal da marca d'água. O valor padrão é central. |
esquerda, central ou direita |
|
Especifica o alinhamento vertical da marca d'água. O valor padrão é central. |
superior, central ou inferior |
|
Especifica se a marca d'água é um plano de fundo. O valor padrão é false. |
Verdadeiro ou Falso |
|
True se uma escala personalizada for especificada. Se este valor for verdadeiro, SCALE também deverá ser especificado. Se esse valor for falso, o padrão se ajusta à página. |
Verdadeiro ou Falso |
|
Especifica o texto personalizado de uma marca d'água. Se esse valor estiver presente, |
Verdadeiro ou Falso |
Todas as marcas d'água devem ter um dos seguintes atributos definidos:
WaterBackCmd:IS_USERNAME_ENABLED
WaterBackCmd:IS_USERID_ENABLED
WaterBackCmd:IS_CURRENTDATE_ENABLED
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Todos os outros atributos são opcionais.
Registrar a marca d'água
Uma nova marca d'água deve ser registrada no serviço de segurança de documentos antes de poder ser usada. Depois de registrar uma marca d'água, você pode usá-la nas políticas.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Aplicação de políticas a documentos PDF
Crie uma marca d'água usando a API de segurança de documentos (Java):
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-rightsmanagement-client.jar
, no caminho de classe do seu projeto Java.
Crie um objeto da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.RightsManagementClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Definir os atributos de marca d'água
Watermark
chamando o método InfomodelObjectFactory
estático createWatermark
do objeto. Este método retorna um objeto Watermark
.Watermark
do objeto setName
e passando um valor de string que especifica o nome da política.Watermark
do objeto setBackground
e transmitindo true
. Ao definir esse atributo, a marca d'água aparece no plano de fundo do documento.Watermark
do objeto setCustomText
e passando um valor de string que representa o texto da marca d'água.Watermark
do objeto setOpacity
e passando um valor inteiro que especifica o nível de opacidade. Um valor de 100 indica que a marca d'água é completamente opaca e um valor de 0 indica que a marca d'água é completamente transparente.Registre a marca d'água.
WatermarkManager
chamando o método RightsManagementClient
getWatermarkManager
do objeto. Este método retorna um objeto WatermarkManager
.WatermarkManager
do objeto registerWatermark
e transmitindo o objeto Watermark
que representa a marca d'água a ser registrada. Esse método retorna um valor de string que representa o valor de identificação da marca d'água.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Crie uma marca d'água usando a API de segurança de documentos (serviço da Web):
Crie um objeto da API do Cliente de segurança de documento.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto RightsManagementServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Defina os atributos de marca d'água.
WatermarkSpec
chamando o construtor WatermarkSpec
.WatermarkSpec
membro de dados name
do objeto.id
da marca d'água atribuindo um valor de string ao WatermarkSpec
membro de dados id
do objeto.MyMapOf_xsd_string_To_xsd_anyType_Item
separado.MyMapOf_xsd_string_To_xsd_anyType_Item
membro de dados key
do objeto (por exemplo, WaterBackCmd:OPACITY)
.MyMapOf_xsd_string_To_xsd_anyType_Item
membro de dados value
do objeto (por exemplo, .25
).MyArrayOf_xsd_anyType
. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item
, chame o método MyArrayOf_xsd_anyType
do objeto Add
. Passe o objeto MyMapOf_xsd_string_To_xsd_anyType_Item
.MyArrayOf_xsd_anyType
ao membro de dados WatermarkSpec
do objeto values
.Registre a marca d'água.
Registre a marca d'água chamando o método RightsManagementServiceClient
do objeto registerWatermark
e transmitindo o objeto WatermarkSpec
que representa a marca d'água a ser registrada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
Consulte também:
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef
Você pode modificar uma marca d'água existente usando a API do Java de segurança de documento ou a API do serviço da Web. Para fazer alterações em uma marca d'água existente, você a recupera, modifica seus atributos e a atualiza no servidor. Por exemplo, suponha que você recupere uma marca d'água e modifique seu atributo de opacidade. Antes que a alteração entre em vigor, você deve atualizar a marca d'água.
Quando você modifica uma marca d'água, a alteração afeta documentos futuros que tenham a marca d'água aplicada a eles. Ou seja, os documentos PDF existentes que contêm a marca d'água não são afetados.
Somente usuários com privilégios administrativos de Segurança de documento 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 documento.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para modificar uma marca d'água, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient
. Se estiver usando a API do serviço da Web de Segurança de documento, crie um objeto DocumentSecurityServiceService
.
Recuperar a marca d'água para modificar
Para modificar uma marca d'água, você deve recuperar uma marca d'água existente. Você pode recuperar uma marca d'água especificando seu nome ou especificando seu valor de identificador.
Definir os atributos de marcas d'água
Para modificar uma marca d'água existente, altere o valor de um ou mais atributos de marca d'água. Ao atualizar programaticamente uma marca d'água usando um serviço da Web, você deve definir todos os atributos que foram originalmente definidos, mesmo que o valor não seja alterado. Por exemplo, suponha que os seguintes atributos de marca d'água estejam definidos: WaterBackCmd:IS_USERID_ENABLED
, WaterBackCmd:IS_CUSTOMTEXT_ENABLED
, WaterBackCmd:OPACITY
e WaterBackCmd:SRCTEXT
. Embora o único atributo que você deseja modificar seja WaterBackCmd:OPACITY
, você deve definir os outros valores corretamente.
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 deseja modificar.
Para obter informações sobre os nomes dos atributos de marca d'água, consulte Criação de Marcas d'água.
Atualizar a marca d'água
Depois de modificar os atributos de uma marca d'água, atualize a marca d'água.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Modifique uma marca d'água usando a API de segurança de documentos (Java):
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como o adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.
Crie um objeto da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.DocumentSecurityClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere a marca d'água para modificar.
Crie um objeto WatermarkManager
chamando o método DocumentSecurityClient
do objeto e transmita um valor de string que especifica o nome da marca d'água. getWatermarkManager
Esse método retorna um objeto Watermark
que representa a marca d'água a ser modificada.
Defina os atributos de marca d'água.
Defina o atributo de opacidade da marca d'água chamando o método Watermark
do objeto setOpacity
e passando um valor inteiro que especifica o nível de opacidade. Um valor de 100 indica que a marca d'água é completamente opaca e um valor de 0 indica que a marca d'água é completamente transparente.
Este exemplo modifica somente o atributo de opacidade.
Atualize a marca d'água.
WatermarkManager
do objeto updateWatermark
e passe o objeto Watermark
cujo atributo foi modificado.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o Início rápido (modo SOAP): Modificação de uma marca d'água usando a seção API do Java .
Modifique uma marca d'água usando a API de segurança de documentos (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Recupere a marca d'água para modificar.
Recupere a marca d'água para modificar, chamando o método DocumentSecurityServiceClient
do objeto getWatermarkByName
. Passe um valor de string que especifica o nome da marca d'água. Esse método retorna um objeto WatermarkSpec
que representa a marca d'água a ser modificada.
Defina os atributos de marca d'água.
MyMapOf_xsd_string_To_xsd_anyType_Item
separado.MyMapOf_xsd_string_To_xsd_anyType_Item
membro de dados key
do objeto (por exemplo, WaterBackCmd:OPACITY)
.MyMapOf_xsd_string_To_xsd_anyType_Item
membro de dados value
do objeto (por exemplo, .50
).MyArrayOf_xsd_anyType
. Para cada objeto MyMapOf_xsd_string_To_xsd_anyType_Item
, chame o método MyArrayOf_xsd_anyType
do objeto Add
. Passe o objeto MyMapOf_xsd_string_To_xsd_anyType_Item
.MyArrayOf_xsd_anyType
ao membro de dados WatermarkSpec
do objeto values
.Atualize a marca d'água.
Atualize a marca d'água chamando o método DocumentSecurityServiceClient
do objeto updateWatermark
e transmitindo o objeto WatermarkSpec
que representa a marca d'água a ser modificada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
O serviço Rights Management rastreia ações específicas à medida que ocorrem, como aplicar uma política a um documento, abrir um documento protegido por política e revogar o acesso a documentos. A auditoria de eventos deve ser ativada para o serviço Rights Management ou os eventos não são rastreados.
Os eventos são incluídos em uma das seguintes categorias:
Você pode pesquisar por eventos específicos usando a API do Java do Rights Management ou a API do serviço da Web. Ao procurar por eventos, você pode executar tarefas, como criar um arquivo de log de determinados eventos.
Para obter mais informações sobre o serviço Rights Management, consulte Referência de serviços para AEM Forms.
Para procurar um evento Rights Management, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do cliente do Rights Management
Antes de executar programaticamente uma operação de serviço Rights Management, é necessário criar um objeto de cliente de serviço Rights Management. Se estiver usando a API do Java, crie um objeto DocumentSecurityClient
. Se estiver usando a API do serviço da Web do Rights Management , crie um objeto DocumentSecurityServiceService
.
Especifique os eventos que serão pesquisados
Você deve especificar o evento a ser procurado. Por exemplo, você pode pesquisar o evento de criação de política, que ocorre quando uma nova política é criada.
Pesquisar pelo evento
Depois de especificar o evento que será pesquisado, você pode usar a API do Java do Rights Management ou a API do serviço da Web do Rights Management para pesquisar o evento.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Procure eventos usando a API do Rights Management (Java):
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 do Rights Management
Crie um objeto DocumentSecurityClient
usando seu construtor e transmitindo um objeto ServiceClientFactory
que contenha propriedades de conexão.
Especifique os eventos que serão pesquisados
EventManager
chamando o método DocumentSecurityClient
getEventManager
do objeto. Este método retorna um objeto EventManager
.EventSearchFilter
chamando seu construtor.EventSearchFilter
do objeto setEventCode
e passando um membro de dados estáticos que pertence à classe EventManager
que representa o evento para o qual pesquisar. Por exemplo, para procurar pelo evento de criação de política, passe EventManager.POLICY_CREATE_EVENT
.Você pode definir critérios de pesquisa adicionais chamando métodos de objeto EventSearchFilter
. Por exemplo, chame o método setUserName
para especificar um usuário associado ao evento.
Pesquisar pelo evento
Procure o evento chamando o método EventManager
do objeto searchForEvents
e transmitindo o objeto EventSearchFilter
que define os critérios de pesquisa do evento. Esse método retorna uma matriz de objetos Event
.
Exemplos de código
Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Inícios rápidos:
Procure eventos usando a API do Rights Management (serviço da Web):
Incluir arquivos de projeto
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Criar um objeto de API do cliente do Rights Management
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto DocumentSecurityServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Especifique os eventos que serão pesquisados
EventSpec
usando seu construtor.EventSpec
do objeto firstTime.date
com a instância DataTime
que representa o início do intervalo de datas quando o evento ocorreu.true
ao membro de dados EventSpec
do objeto firstTime.dateSpecified
.EventSpec
do objeto lastTime.date
com a instância DataTime
que representa o fim do intervalo de datas quando o evento ocorreu.true
ao membro de dados EventSpec
do objeto lastTime.dateSpecified
.EventSpec
membro de dados eventCode
do objeto. A tabela a seguir lista os valores numéricos que você pode atribuir a essa propriedade:Tipo de evento |
Valor |
---|---|
|
999 |
|
1000 |
|
1001 |
|
1002 |
|
1003 |
|
1004 |
|
1005 |
|
1006 |
|
1007 |
|
1008 |
|
1009 |
|
2000 |
|
2001 |
|
2002 |
|
2003 |
|
2004 |
|
2005 |
|
2006 |
|
2007 |
|
2008 |
|
2009 |
|
2010 |
|
2011 |
|
2012 |
|
2013 |
|
2014 |
|
3000 |
|
3001 |
|
3002 |
|
3003 |
|
3004 |
|
3005 |
|
4000 |
|
4001 |
|
4002 |
|
4003 |
|
4004 |
|
4005 |
|
5000 |
|
5001 |
|
5002 |
|
5003 |
|
5004 |
|
6000 |
|
7000 |
|
7001 |
|
7002 |
Pesquisar pelo evento
Procure o evento chamando o método DocumentSecurityServiceClient
do objeto searchForEvents
e passando o objeto EventSpec
que representa o evento para o qual pesquisar e o número máximo de resultados. Esse método retorna uma coleção MyArrayOf_xsd_anyType
em que cada elemento é uma instância AuditSpec
. Usando uma instância AuditSpec
, você pode obter informações sobre o evento, como a hora em que ele ocorreu. A instância AuditSpec
contém um membro de dados timestamp
que especifica essas informações.
Exemplos de código
Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Inícios rápidos:
Consulte também:
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef
Além de documentos PDF, o serviço Gerenciamento de Direitos oferece suporte a formatos de documento adicionais, como um documento do Microsoft Word (arquivo DOC) e outros formatos de arquivo do Microsoft Office. Por exemplo, você pode aplicar uma política a um documento do Word para protegê-lo. Ao aplicar uma política a um documento do Word, você restringe o acesso ao documento. Não é possível aplicar uma política a um documento se ele já estiver protegido por uma política.
Você pode monitorar o uso de um documento do Word protegido por política depois de distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para aplicar uma política a um documento do Word, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto da API do cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento.
Recuperar um documento do Word
Você deve recuperar um documento do Word para aplicar uma política. Depois de aplicar uma política ao documento do Word, os usuários são restritos ao usar o documento. Por exemplo, se a política não habilitar a abertura do documento offline, os usuários deverão estar online para abrir o documento.
Aplicar uma política existente ao documento do Word
Para aplicar uma política a um documento do Word, é necessário referenciar uma política existente e especificar a qual conjunto de políticas a política pertence. O usuário que está definindo as propriedades de conexão deve ter acesso à política especificada. Caso contrário, ocorrerá uma exceção.
Salvar o documento do Word
Depois que o serviço de segurança de documento aplicar uma política a um documento do Word, você poderá salvar o documento do Word protegido por política como um arquivo DOC.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Revogando o acesso aos documentos
Aplique uma política a um documento do Word usando a API de segurança de documento (Java):
Inclua 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 da API do Cliente de segurança de documento.
ServiceClientFactory
que contenha propriedades de conexão.DocumentSecurityClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recuperar um documento do Word.
java.io.FileInputStream
que represente o documento do Word usando seu construtor e passando um valor de string que especifica o local do documento do Word.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Aplique uma política existente ao documento do Word.
Crie um objeto DocumentManager
chamando o método DocumentSecurityClient
getDocumentManager
do objeto.
Aplique uma política ao documento do Word chamando o método DocumentManager
do objeto e transmitindo os seguintes valores:protectDocument
com.adobe.idp.Document
que contém o documento do Word ao qual a política é aplicada.null
que resulta no conjunto de políticas MyPolicies
sendo usado.null
(se esse parâmetro for null
, o valor de parâmetro anterior deverá ser null
).com.adobe.livecycle.rightsmanagement.Locale
que representa a localidade usada para selecionar o modelo do MS Office. Esse valor de parâmetro é opcional e você pode especificar null
.O método protectDocument
retorna um objeto RMSecureDocumentResult
que contém o documento do Word protegido por política.
Salve o documento do Word.
RMSecureDocumentResult
do objeto getProtectedDoc
para obter o documento do Word protegido por política. Este método retorna um objeto com.adobe.idp.Document
.java.io.File
e verifique se a extensão de arquivo é DOC.com.adobe.idp.Document
do objeto copyToFile
para copiar o conteúdo do objeto Document
para o arquivo (certifique-se de usar o objeto Document
retornado pelo método getProtectedDoc
).Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
Aplique uma política a um documento do Word usando a API de segurança de documento (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um objeto da API do Cliente de segurança de documento.
Crie um objeto DocumentSecurityServiceClient
usando seu construtor padrão.
Crie um objeto DocumentSecurityServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/DocumentSecurityService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo DocumentSecurityServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName
.DocumentSecurityServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.
Recuperar um documento do Word.
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar um documento do Word ao qual uma política é aplicada.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word e o modo no qual o arquivo será aberto.System.IO.FileStream
. Determine o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Aplique uma política existente ao documento do Word.
Aplique uma política ao documento do Word chamando o método DocumentSecurityServiceClient
do objeto e transmitindo os seguintes valores:protectDocument
BLOB
que contém o documento do Word ao qual a política é aplicada.null
que resulta no conjunto de políticas MyPolicies
sendo usado.null
).null
).RMLocale
que especifica o valor do local (por exemplo, RMLocale.en
).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.
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word protegido por política.BLOB
retornado pelo método protectDocument
. Preencha a matriz de bytes obtendo o valor do membro de dados BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.System.IO.BinaryWriter
do objeto Write
e transmitindo a matriz de bytes.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
Você pode remover uma política de um documento do Word protegido por política para remover a segurança do documento. Ou seja, se você não quiser mais que o documento seja protegido por uma política. Se você quiser atualizar um documento do Word protegido por política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, é mais eficiente mudar a política.
Para obter mais informações sobre o serviço de segurança de documentos, consulte Referência de serviços para AEM Forms.
Para remover uma política de um documento do Word protegido por política, execute as seguintes etapas:
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.
Recuperar um documento do Word protegido por política
Você deve recuperar um documento do Word protegido por política para remover uma política. Se tentar remover uma política de um documento do Word que não está protegido por uma política, ocorrerá uma exceção.
Remover a política do documento do Word
Você pode remover uma política de um documento do Word protegido por política, desde que um administrador seja especificado nas configurações de conexão. Caso contrário, a política usada para proteger um documento deverá conter a permissão SWITCH_POLICY
para remover uma política de um documento do Word. Além disso, o usuário especificado nas configurações de conexão do AEM Forms também deve ter essa permissão. Caso contrário, uma exceção será lançada.
Salvar o documento do Word não seguro
Depois que o serviço de segurança de documentos remove uma política de um documento do Word, você pode salvar o documento do Word não seguro como um arquivo DOC.
Consulte também:
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Aplicando Políticas a Documentos do Word
Remova uma política de um documento do Word protegido por política usando a API de segurança de documentos (Java):
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
ServiceClientFactory
que contenha propriedades de conexão.RightsManagementClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recuperar um documento do Word protegido por política
java.io.FileInputStream
que represente o documento do Word protegido por política usando seu construtor e transmitindo um valor de string que especifique o local do documento do Word.com.adobe.idp.Document
usando seu construtor e transmitindo o objeto java.io.FileInputStream
.Remover a política do documento do Word
DocumentManager
chamando o método RightsManagementClient
getDocumentManager
do objeto.DocumentManager
do objeto removeSecurity
e transmitindo o objeto com.adobe.idp.Document
que contém o documento do Word protegido por política. Este método retorna um objeto com.adobe.idp.Document
que contém um documento do Word não seguro.Salvar o documento do Word não seguro
java.io.File
e verifique se a extensão de arquivo é DOC.Document
do objeto copyToFile
para copiar o conteúdo do objeto Document
para o arquivo (certifique-se de usar o objeto Document
retornado pelo método removeSecurity
).Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
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):
Incluir arquivos de projeto
Crie um projeto do Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Criar um objeto de API do Cliente de segurança de documentos
Crie um objeto RightsManagementServiceClient
usando seu construtor padrão.
Crie um objeto RightsManagementServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo, http://localhost:8080/soap/services/RightsManagementService?WSDL
.) Você não precisa usar o atributo lc_version
. Este atributo é usado ao criar uma referência de serviço.)
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo RightsManagementServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
RightsManagementServiceClient.ClientCredentials.UserName.UserName
.RightsManagementServiceClient.ClientCredentials.UserName.Password
.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
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar o documento do Word protegido por política do qual a política é removida.System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word e o modo no qual o arquivo será aberto.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.BLOB
atribuindo seu campo MTOM
ao 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 RightsManagementServiceClient
do objeto removePolicySecurity
e transmitindo o objeto BLOB
que contém o documento do Word protegido por política. Este método retorna um objeto BLOB
que contém um documento do Word não seguro.
Salvar o documento do Word não seguro
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word não seguro.BLOB
retornado pelo método removePolicySecurity
. Preencha a matriz de bytes obtendo o valor do campo BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
Consulte também:
Chamar o AEM Forms usando MTOM