Protegendo documentos com políticas protecting-documents-with-policies
Sobre o serviço de segurança de documentos
O serviço de segurança de documentos permite que os usuários apliquem dinamicamente configurações de confidencialidade a documentos da Adobe PDF e mantenham o controle sobre os documentos, independentemente da extensão de distribuição.
O serviço de segurança de documentos impede que as informações se espalhem além do alcance do usuário, permitindo que os usuários mantenham o controle sobre como os recipients usam o documento PDF protegido por políticas. Um usuário pode especificar quem pode abrir um documento, limitar como ele pode usá-lo e monitorar o documento após a distribuição. Um usuário também pode controlar dinamicamente o acesso a um documento protegido por políticas e pode até mesmo revogar dinamicamente o acesso ao documento.
O serviço Segurança de documentos também protege outros tipos de arquivos, como arquivos do Microsoft Word (arquivos DOC). Você pode usar a API do cliente de segurança de documentos para trabalhar com esses tipos de arquivos. As seguintes versões são compatíveis:
- Arquivos do Microsoft Office 2003 (arquivos DOC, XLS, PPT)
- Arquivos do Microsoft Office 2007 (arquivos DOCX, XLSX, PPTX)
- Arquivos PTC Pro/E
Para maior clareza, as duas seções a seguir discutem como trabalhar com documentos do Word:
Você pode realizar essas tarefas usando o serviço Segurança de documentos:
- Criar políticas. Para obter mais informações, consulte Criando Políticas.
- Modificar políticas. Para obter mais informações, consulte Modificando Políticas.
- Excluir políticas. Para obter mais informações, consulte Excluindo Políticas.
- Aplicar políticas a documentos PDF. Para obter mais informações, consulte Aplicação de Políticas a Documentos do PDF.
- Remova políticas de documentos PDF. Para obter mais informações, consulte Removendo Políticas de Documentos do PDF.
- Documentos protegidos por políticas da Inspect. Para obter mais informações, consulte Inspecionando Documentos de PDF protegido de Política.
- Revogar o acesso aos documentos PDF. Para obter mais informações, consulte Revogando o acesso aos documentos.
- Retomar o acesso aos documentos revogados. Para obter mais informações, consulte Reposição do acesso a documentos revisados.
- Criar marcas d'água. Para obter mais informações, consulte Criação de marcas d'água.
- Procure por eventos. Para obter mais informações, consulte Pesquisar eventos.
Criando Políticas creating-policies
Você pode criar políticas programaticamente usando a API do Java de segurança de documentos ou a API do serviço da Web. A política é uma coleção de informações que inclui configurações de segurança de documentos, usuários autorizados e direitos de uso. Você pode criar e salvar qualquer número de políticas, usando configurações de segurança apropriadas para diferentes situações e usuários.
As políticas permitem que você execute estas tarefas:
- Especifique os indivíduos que podem abrir o documento. Os recipients podem pertencer à organização ou ser externos a ela.
- Especifique como os destinatários podem usar o documento. Você pode restringir o acesso a diferentes recursos do Acrobat e Adobe Reader. Esses recursos incluem a capacidade de imprimir e copiar texto, adicionar assinaturas e adicionar comentários a um documento.
- Altere as configurações de acesso e segurança a qualquer momento, mesmo depois de distribuir o documento protegido por política.
- Monitore o uso do documento após distribuí-lo. Você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.
Criação de uma política usando serviços da Web creating-a-policy-using-web-services
Ao criar uma política usando a API do serviço da Web, consulte um arquivo XML da Linguagem de direitos de documento portátil (PDRL) existente que descreve a política. As permissões de política e o principal são definidos no documento PDRL. O documento XML a seguir é um exemplo de um documento PDRL.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
<PolicyEntry>
<ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>all_internal_users</PrincipalName>
</Principal>
</PolicyEntry>
<PolicyEntry>
<ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
<ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
<ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
<Principal PrincipalNameType="SYSTEM">
<PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
<PrincipalName>publisher</PrincipalName>
</Principal>
</PolicyEntry>
<OfflineLeasePeriod>
<Duration>P31D</Duration>
</OfflineLeasePeriod>
<AuditSettings isTracked="true" />
<PolicyValidityPeriod isAbsoluteTime="false">
<ValidityPeriodRelative>
<NotBeforeRelative>PT0S</NotBeforeRelative>
<NotAfterRelative>P20D</NotAfterRelative>
</ValidityPeriodRelative>
</PolicyValidityPeriod>
</Policy>
Resumo das etapas summary-of-steps
Para criar uma política, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Defina os atributos da política.
- Crie uma entrada de política.
- Registre a política.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao classpath do seu projeto:
- adobe-rightsmanagement-client.jar
- namespace.jar (se o AEM Forms estiver implantado no JBoss)
- jaxb-api.jar (se o AEM Forms estiver implantado no JBoss)
- jaxb-impl.jar (se o AEM Forms estiver implantado no JBoss)
- jaxb-libs.jar (se o AEM Forms estiver implantado no JBoss)
- jaxb-xjc.jar (se o AEM Forms for implantado no JBoss)
- relaxngDatatype.jar (se o AEM Forms for implantado no JBoss)
- xsdlib.jar (se o AEM Forms estiver implantado no JBoss)
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar
- jbossall-client.jar (use um arquivo JAR diferente se o AEM Forms não estiver implantado no JBoss)
Para obter informações sobre a localização desses arquivos JAR, consulte Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.
Definir os atributos da política
Para criar uma política, defina os atributos da política. Um atributo obrigatório é o nome da política. Os nomes de políticas devem ser exclusivos para cada conjunto de políticas. Um conjunto de políticas é simplesmente uma coleção de políticas. Pode haver duas políticas com o mesmo nome se as políticas pertencerem a conjuntos de políticas separados. No entanto, duas políticas em um único conjunto de políticas não podem ter o mesmo nome de política.
Outro atributo útil a ser definido é o período de validade. Um período de validade é o período durante o qual um documento protegido por uma política é acessível aos destinatários autorizados. Se você não definir esse atributo, a política sempre será válida.
Um período de validade pode ser definido como uma destas opções:
- Um número definido de dias em que o documento é acessível a partir do momento em que o documento é publicado
- Uma data final após a qual o documento não está acessível
- Um intervalo de datas específico para o qual o documento está acessível
- Sempre válido
Você pode especificar apenas uma data de início, o que resulta na validade da política após a data de início. Se você especificar apenas uma data de término, a política será válida até a data de término. No entanto, uma exceção é lançada se uma data inicial e uma data final não estiverem definidas.
Ao definir atributos que pertencem a uma política, também é possível definir configurações de criptografia. Essas configurações de criptografia ocorrem quando a política é aplicada a um documento. Você pode especificar os seguintes valores de criptografia:
- AES256: Representa o algoritmo de criptografia AES com uma chave de 256 bits.
- AES128: Representa o algoritmo de criptografia AES com uma chave de 128 bits.
- NoEncryption: Não representa criptografia.
Ao especificar o NoEncryption não é possível definir a variável PlaintextMetadata para false. Se você tentar fazer isso, uma exceção será lançada.
Policy descrição da interface no Referência da API do AEM Forms.Criar uma entrada de política
Uma entrada de política anexa entidades principais, que são grupos e usuários, e permissões a uma política. Uma política deve ter pelo menos uma entrada política. Considere, por exemplo, que você executa essas tarefas:
- Crie e registre uma entrada de política que permita que um grupo exiba apenas um documento enquanto estiver online e proíba os destinatários de copiá-lo.
- Anexe a entrada de política à política.
- Proteja um documento com a política usando o Acrobat.
Essas ações resultam em recipients serem capazes apenas de exibir o documento online e não poderem copiá-lo. O documento permanece seguro até que a segurança seja removida dele.
Registrar a política
Uma nova política deve ser registrada antes de poder ser usada. Depois de registrar uma política, você pode usá-la para proteger documentos.
Criar uma política usando a API do Java create-a-policy-using-the-java-api
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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
DocumentSecurityClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Defina os atributos da política.
- Crie um
Policychamando oInfomodelObjectFactoryestático do objetocreatePolicymétodo . Esse método retorna umPolicyobjeto. - Defina o atributo de nome da política chamando o
Policydo objetosetNamee transmitindo um valor de string que especifica o nome da política. - Defina a descrição da política chamando o
Policydo objetosetDescriptione transmitindo um valor de string que especifica a descrição da política. - Defina o conjunto de políticas ao qual a nova política pertence, chamando o
Policydo objetosetPolicySetNamee transmitindo um valor de string que especifica o nome do conjunto de políticas. (Você pode especificarnullpara esse valor de parâmetro que resulta na adição da política ao Minhas políticas conjunto de políticas.) - Crie o período de validade da política, chamando o
InfomodelObjectFactoryestático do objetocreateValidityPeriodmétodo . Esse método retorna umValidityPeriodobjeto. - Defina o número de dias para os quais um documento protegido por política pode ser acessado, chamando o
ValidityPerioddo objetosetRelativeExpirationDayse transmitindo um valor inteiro que especifica o número de dias. - Defina o período de validade da política chamando o
Policydo objetosetValidityPeriode a aprovação doValidityPeriodobjeto.
- Crie um
-
Crie uma entrada de política.
- Crie uma entrada de política chamando o
InfomodelObjectFactoryestático do objetocreatePolicyEntrymétodo . Esse método retorna umPolicyEntryobjeto. - Especifique as permissões da política chamando a
InfomodelObjectFactoryestático do objetocreatePermissionmétodo . Passe um membro de dados estáticos que pertence ao grupoPermissioninterface que representa a permissão. Esse método retorna umPermissionobjeto. Por exemplo, para adicionar a permissão que permite aos usuários copiar dados de um documento de PDF protegido por política, passePermission.COPY. (Repita essa etapa para cada permissão para adicionar). - Adicione a permissão à entrada de política chamando o
PolicyEntrydo objetoaddPermissione a aprovação doPermissionobjeto. (Repita essa etapa para cadaPermissionobjeto criado por você). - Crie o principal da política chamando o
InfomodelObjectFactoryestático do objetocreateSpecialPrincipalmétodo . Passe um membro de dados pertencente àInfomodelObjectFactoryque representa o principal. Esse método retorna umPrincipalobjeto. Por exemplo, para adicionar o editor do documento como principal, passeInfomodelObjectFactory.PUBLISHER_PRINCIPAL. - Adicione o principal à entrada de política chamando o
PolicyEntrydo objetosetPrincipale a aprovação doPrincipalobjeto. - Adicione a entrada de política à política chamando o
Policydo objetoaddPolicyEntrye a aprovação doPolicyEntryobjeto.
- Crie uma entrada de política chamando o
-
Registre a política.
-
Crie um
PolicyManagerchamando oDocumentSecurityClientdo objetogetPolicyManagermétodo . -
Registre a política chamando a
PolicyManagerdo objetoregisterPolicye transmitindo os seguintes valores:- O
Policyque representa a política a ser registrada.
- O
-
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
DocumentSecurityClient, em seguida, especifique o nome do conjunto de políticas ao chamar aregisterPolicymétodo . Se você passar umanullpara o conjunto de políticas, a política é criada nos administradores Minhas políticas conjunto de políticas.Se você usar um usuário de Segurança de documento nas configurações de conexão, poderá chamar a sobrecarga
registerPolicyque 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 para o conjunto de políticas ao chamar aregisterPolicymétodo .note note NOTE Ao criar uma política, faça referência a um conjunto de políticas existente. Se você especificar um conjunto de políticas que não existe, uma exceção será lançada. -
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte:
- "Início rápido (modo SOAP): Criar uma política usando a API do Java"
Criar uma política usando a API do serviço da Web create-a-policy-using-the-web-service-api
Crie uma política usando a API de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
DocumentSecurityServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Defina os atributos da política.
- Crie um
PolicySpecusando seu construtor. - Defina o nome da política atribuindo um valor de string à variável
PolicySpecdo objetonamemembro de dados. - Defina a descrição da política atribuindo um valor de string à variável
PolicySpecdo objetodescriptionmembro de dados. - Defina o conjunto de políticas ao qual a política pertencerá, atribuindo um valor de string à variável
PolicySpecdo objetopolicySetNamemembro de dados. Você deve especificar um nome de conjunto de políticas existente. (Você pode especificarnullpara esse valor de parâmetro que resulta na adição da política a Minhas políticas.) - Defina o período de concessão offline da política atribuindo um valor inteiro à variável
PolicySpecdo objetoofflineLeasePeriodmembro de dados. - Defina as
PolicySpecdo objetopolicyXmlmembro de dados com um valor de string que representa dados XML de PDRL. Para executar esta tarefa, crie um .NETStreamReaderusando seu construtor. Passe o local de um arquivo XML PDRL que representa a política para oStreamReaderconstrutor. Em seguida, chame oStreamReaderdo objetoReadLinee atribua o valor de retorno a uma variável de string. Iterar por meio doStreamReaderaté que oReadLinemétodo retorna null. Atribua a variável da string à variávelPolicySpecdo objetopolicyXmlmembro de dados.
- Crie um
-
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 a
DocumentSecurityServiceClientdo objetoregisterPolicye transmitindo os seguintes valores:- O
PolicySpecque representa a política a ser registrada. - Um valor de string que representa o conjunto de políticas ao qual a política pertence. Você pode especificar uma
nullvalor que resulta na adição da política ao Minhas políticas conjunto de políticas.
Se você usar uma conta de administrador do AEM forms nas configurações de conexão para criar o
DocumentSecurityClient, especifique o nome do conjunto de políticas ao chamar oregisterPolicymétodo .Se você usar um usuário de Segurança de documento nas configurações de conexão, poderá chamar a sobrecarga
registerPolicyque 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 para o conjunto de políticas ao chamar aregisterPolicymétodo .note note NOTE 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. - O
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Criação de uma política usando a API do serviço da Web"
- "Início rápido (SwaRef): Criação de uma política usando a API do serviço da Web"
Modificando Políticas modifying-policies
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 PolicySpec.getPolicyXml e modificar os atributos de política usando os métodos aplicáveis. Por exemplo, você pode modificar o período de concessão offline chamando o PolicySpec.setOfflineLeasePeriod método .
Resumo das etapas summary_of_steps-1
Para modificar uma política existente, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere uma política existente.
- Alterar atributos de políticas.
- Atualize a política.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um RightsManagementClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um RightsManagementServiceService objeto.
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 uma null para o nome do conjunto de políticas, a política é recuperada do Minhas políticas conjunto de 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, a variável offlineLeasePeriod no campo PolicySpec é ignorada. Para atualizar o período de concessão offline, modifique o OfflineLeasePeriod no documento XML PDRL. Em seguida, faça referência ao documento PDF atualizado usando o PolicySpec da interface policyXML membro de dados.
Policy descrição da interface no Referência da API do AEM Forms.Atualizar a política
Antes que as alterações feitas em uma política sejam aplicadas, é necessário atualizar a política com o serviço de Segurança de documentos. As alterações nas políticas que protegem documentos são atualizadas na próxima vez que o documento protegido por política for sincronizado com o serviço de Segurança de documentos.
Modifique as políticas existentes usando a API do Java modify-existing-policies-using-the-java-api
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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
RightsManagementClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recupere uma política existente.
-
Crie um
PolicyManagerchamando oRightsManagementClientdo objetogetPolicyManagermétodo . -
Crie um
Policyobjeto que representa a política a ser atualizada chamando oPolicyManagerdo objetogetPolicye transmitindo os seguintes valores"- Um valor de string que representa o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor de string que representa o nome da política.
- Um valor de string que representa o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
-
-
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
Policydo objetosetOfflineLeasePeriodmétodo . -
Atualize a política.
Atualize a política chamando
PolicyManagerdo objetoupdatePolicymétodo . Passe oPolicyque representa a política a ser atualizada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o Início rápido (modo SOAP): Modificação de uma política usando a seção API do Java .
Modifique as políticas existentes usando a API do serviço da Web modify-existing-policies-using-the-web-service-api
Modifique uma política existente usando a API de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
RightsManagementServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupere uma política existente.
Crie um
PolicySpecobjeto que representa a política a ser modificada chamando oRightsManagementServiceClientdo objetogetPolicye transmitindo os seguintes valores:- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor da string que especifica o nome da política.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
-
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 a
RightsManagementServiceClientdo objetoupdatePolicyFromSDKe a aprovação doPolicySpecque representa a política a ser atualizada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Modificação de uma política usando a API do serviço da Web"
- "Início rápido (SwaRef): Modificação de uma política usando a API do serviço da Web"
Excluindo Políticas deleting-policies
É possível excluir uma política existente usando a API do Java de segurança de documento ou a API do serviço da Web. Depois que uma política é excluída, ela não pode mais ser usada para proteger documentos. No entanto, os documentos protegidos por políticas que estão usando a política ainda estão protegidos. É possível excluir uma política quando uma nova estiver disponível.
Resumo das etapas summary_of_steps-2
Para excluir uma política existente, execute as seguintes etapas:
- Incluir arquivos de projeto
- Crie um objeto da API do Cliente de segurança de documento.
- Exclua a política.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um RightsManagementClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um RightsManagementServiceService objeto.
Excluir a política
Para excluir uma política, especifique a política a ser excluída e o conjunto de políticas ao qual a política pertence. O usuário cujas configurações são usadas para chamar o AEM Forms deve ter permissão para excluir a política; caso contrário, ocorrerá uma exceção. Da mesma forma, se você tentar excluir uma política que não existe, ocorrerá uma exceção.
Excluir políticas usando a API do Java delete-policies-using-the-java-api
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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
RightsManagementClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Exclua a política.
-
Crie um
PolicyManagerchamando oRightsManagementClientdo objetogetPolicyManagermétodo . -
Exclua a política chamando a
PolicyManagerdo objetodeletePolicye transmitindo os seguintes valores:- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor da string que especifica o nome da política a ser excluída.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
-
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo SOAP): Excluir uma política usando a API do Java"
Excluir políticas usando a API de serviço da Web delete-policies-using-the-web-service-api
Exclua uma política usando a API de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
RightsManagementServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Exclua a política.
Exclua uma política chamando o
RightsManagementServiceClientdo objetodeletePolicye transmitindo os seguintes valores:- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor da string que especifica o nome da política a ser excluída.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Exclusão de uma política usando a API do serviço da Web"
- "Início rápido (SwaRef): Exclusão de uma política usando a API do serviço da Web"
Aplicação de Políticas a Documentos do PDF applying-policies-to-pdf-documents
É 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ítica quando não quiser mais que os usuários acessem o documento.
Você pode monitorar o uso de um documento protegido por políticas depois de distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.
Resumo das etapas summary_of_steps-3
Para aplicar uma política a um documento PDF, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere um documento PDF ao qual uma política é aplicada.
- Aplique uma política existente ao documento PDF.
- Salve o documento PDF protegido por política.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto da API do cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento. Se estiver usando a API do Java, crie um DocumentSecurityClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um DocumentSecurityServiceService objeto.
Recuperar um documento PDF
Você pode recuperar um documento do 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, faça referência a 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.
Salve o documento do 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
Aplicar uma política a um documento do PDF usando a API do Java apply-a-policy-to-a-pdf-document-using-the-java-api
Aplique uma política a um documento do 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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
RightsManagementClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recupere um documento PDF.
- Crie um
java.io.FileInputStreamobjeto que representa o documento PDF usando seu construtor. Passe um valor de string que especifica o local do documento PDF. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto.
- Crie um
-
Aplique uma política existente ao documento PDF.
-
Crie um
DocumentManagerchamando oRightsManagementClientdo objetogetDocumentManagermétodo . -
Aplique uma política ao documento PDF chamando a
DocumentManagerdo objetoprotectDocumente transmitindo os seguintes valores:- O
com.adobe.idp.Documentobjeto que contém o documento PDF ao qual a política é aplicada. - Um valor de string que especifica o nome do documento.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar uma
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor de string que especifica o nome da política.
- Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser nulo).
- Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser
null(se esse parâmetro for nulo, o valor do parâmetro anterior deverá sernull). - A
com.adobe.livecycle.rightsmanagement.Localeque 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, especifiquenull.
O
protectDocumentmétodo retorna umRMSecureDocumentResultobjeto que contém o documento PDF protegido por política. - O
-
-
Salve o documento PDF.
- Chame o
RMSecureDocumentResultdo objetogetProtectedDocpara obter o documento PDF protegido por política. Esse método retorna umcom.adobe.idp.Documentobjeto. - Crie um
java.io.Filee verifique se a extensão do arquivo é PDF. - Chame o
com.adobe.idp.Documentdo objetocopyToFilepara copiar o conteúdo daDocumentpara o arquivo (certifique-se de usar a variávelDocumentobjeto retornado pelogetProtectedDocmétodo ).
- Chame o
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo EJB): Aplicar uma política a um documento do PDF usando a API do Java"
- "Início rápido (modo SOAP): Aplicar uma política a um documento do PDF usando a API do Java"
Consulte também
Aplicar uma política a um documento do PDF usando a API do serviço da Web apply-a-policy-to-a-pdf-document-using-the-web-service-api
Aplique uma política a um documento do PDF usando a API de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
RightsManagementServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. Passe um valor de string que especifica o WSDL para o serviço do Forms (por exemplo,http://localhost:8080/soap/services/RightsManagementService?WSDL.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupere um documento PDF.
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar um documento PDF ao qual uma política é aplicada. - Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo deve ser aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Determine o tamanho da matriz de bytes obtendo oSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReadmétodo . Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Aplique uma política existente ao documento PDF.
Aplique uma política ao documento PDF chamando a
RightsManagementServiceClientdo objetoprotectDocumente transmitindo os seguintes valores:- O
BLOBobjeto que contém o documento PDF ao qual a política é aplicada. - Um valor de string que especifica o nome do documento.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar uma
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor de string que especifica o nome da política.
- Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser
null). - Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o valor do parâmetro anterior deve ser
null). - A
RMLocalevalor que especifica o valor da localidade (por exemplo,RMLocale.en). - Um parâmetro de saída da string usado para armazenar o valor do identificador de política.
- Um parâmetro de saída de string usado para armazenar o valor do identificador protegido por política.
- Um parâmetro de saída de string usado para armazenar o tipo MIME (por exemplo,
application/pdf).
O
protectDocumentmétodo retorna umBLOBobjeto que contém o documento PDF protegido por política. - O
-
Salve o documento PDF.
- Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF protegido por política. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOBobjeto retornado peloprotectDocumentmétodo . Preencha a matriz de bytes obtendo o valor da variávelBLOBdo objetoMTOMmembro de dados. - Crie um
System.IO.BinaryWriterchamando seu construtor e passando oSystem.IO.FileStreamobjeto. - Escreva o conteúdo da matriz de bytes em um arquivo PDF chamando o
System.IO.BinaryWriterdo objetoWritee transmitindo a matriz de bytes.
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Aplicar uma política a um documento do PDF usando a API do serviço da Web"
- "Início rápido (SwaRef): Aplicar uma política a um documento do PDF usando a API do serviço da Web"
Removendo Políticas de Documentos do PDF removing-policies-from-pdf-documents
Você pode remover uma política de um documento protegido por política para remover a segurança do documento. Ou seja, se você não quiser mais que o documento seja protegido por uma política. Se quiser atualizar um documento protegido por uma política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, é mais eficiente mudar a política.
Resumo das etapas summary_of_steps-4
Para remover uma política de um documento PDF protegido por política, execute as seguintes etapas:
- Incluir arquivos de projeto
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere um documento PDF protegido por política.
- Remova a política do documento PDF.
- Salve o documento PDF inseguro.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.
Recuperar um documento PDF protegido por política
Você pode recuperar um documento PDF protegido por política para remover uma política. Se tentar remover uma política de um documento PDF que não esteja protegido por uma política, ocorrerá uma exceção.
Remover a política do documento PDF
Você pode remover uma política de um documento de PDF protegido por política, desde que um administrador seja especificado nas configurações de conexão. Caso contrário, a política usada para proteger um documento deverá conter a variável SWITCH_POLICY permissão 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.
Salve o documento PDF não seguro
Depois que o serviço de segurança de documentos remove uma política de um documento PDF, você pode salvar o documento PDF não seguro como um arquivo PDF.
Consulte também
Inclusão de arquivos da biblioteca Java do AEM Forms
Remova uma política de um documento do PDF usando a API do Java remove-a-policy-from-a-pdf-document-using-the-java-api
Remova uma política de um documento PDF protegido por política usando a API de segurança de documentos (Java):
-
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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
DocumentSecurityClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recupere um documento PDF protegido por política.
- Crie um
java.io.FileInputStreamobjeto que representa o documento PDF protegido por política usando seu construtor e passando um valor de string que especifica o local do documento PDF. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto.
- Crie um
-
Remova a política do documento PDF.
- Crie um
DocumentManagerchamando oDocumentSecurityClientdo objetogetDocumentManagermétodo . - Remova uma política do documento PDF chamando a
DocumentManagerdo objetoremoveSecuritye a aprovação docom.adobe.idp.Documentobjeto que contém o documento PDF protegido por política. Esse método retorna umcom.adobe.idp.Documentobjeto que contém um documento PDF não seguro.
- Crie um
-
Salve o documento PDF inseguro.
- Crie um
java.io.Filee verifique se a extensão do arquivo é PDF. - Chame o
Documentdo objetocopyToFilepara copiar o conteúdo daDocumentpara o arquivo (certifique-se de usar a variávelDocumentobjeto retornado peloremoveSecuritymétodo ).
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo SOAP): Remover uma política de um documento do PDF usando a API do Java"
Remover uma política usando a API do serviço da Web remove-a-policy-using-the-web-service-api
Remova uma política de um documento PDF protegido por política usando a API de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
DocumentSecurityServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelDocumentSecurityServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupere um documento PDF protegido por política.
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar o documento PDF protegido por política do qual a política é removida. - Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo deve ser aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Você pode determinar o tamanho da matriz de bytes obtendo a variávelSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReade transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Remova a política do documento PDF.
Remova a política do documento PDF chamando a
DocumentSecurityServiceClientdo objetoremovePolicySecuritye a aprovação doBLOBobjeto que contém o documento PDF protegido por política. Esse método retorna umBLOBobjeto que contém um documento PDF não seguro. -
Salve o documento PDF inseguro.
- Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF não seguro. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOBobjeto retornado peloremovePolicySecuritymétodo . Preencha a matriz de bytes obtendo o valor da variávelBLOBdo objetoMTOMcampo. - Crie um
System.IO.BinaryWriterchamando seu construtor e passando oSystem.IO.FileStreamobjeto.
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Remover uma política de um documento do PDF usando a API do serviço da Web"
- "Início rápido (SwaRef): Remover uma política de um documento do PDF usando a API do serviço da Web"
Consulte também
Revogando o acesso aos documentos revoking-access-to-documents
Você pode revogar o acesso a um documento PDF protegido por política, resultando em todas as cópias do documento serem inacessíveis aos usuários. Quando um usuário tenta abrir um documento PDF revogado, ele é redirecionado para um URL especificado, onde um documento revisado pode ser visualizado. O URL para onde o usuário é redirecionado deve ser especificado de forma programática. Quando você revoga o acesso a um documento, a alteração entrará em vigor na próxima vez que o usuário sincronizar com o serviço de Segurança de documentos, abrindo o documento protegido por política online.
A capacidade de revogar o acesso a um documento fornece segurança adicional. Por exemplo, suponha que uma versão mais recente de um documento esteja disponível e você não quer mais que ninguém visualize a versão desatualizada. Nessa situação, o acesso ao documento mais antigo pode ser revogado e ninguém pode exibi-lo a menos que o acesso seja recriado.
Resumo das etapas summary_of_steps-5
Para revogar um documento protegido por política, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere um documento PDF protegido por política.
- Revogar o documento protegido por política.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento.
Recuperar um documento PDF protegido por política
Você deve recuperar um documento PDF protegido por política para revogá-lo. Não é possível revogar um documento que já foi revogado ou que não é um documento protegido por uma política.
Se você souber o valor do identificador de licença do documento protegido por política, não será necessário recuperar o documento PDF protegido por política. No entanto, na maioria dos casos, será necessário recuperar o documento do PDF para obter o valor do identificador de licença.
Revogar o documento protegido por política
Para revogar um documento protegido por política, especifique o identificador de licença do documento protegido por política. Além disso, você pode especificar o URL de um documento que o usuário pode visualizar ao tentar abrir o documento revogado. Ou seja, suponha que um documento desatualizado seja revogado. Quando um usuário tenta abrir o documento revogado, ele verá um documento atualizado em vez do documento revogado.
Consulte também
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Revogar o acesso a documentos usando a API Java revoke-access-to-documents-using-the-java-api
Revoge o acesso a um documento PDF 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
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
DocumentSecurityClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recuperar um documento PDF protegido por política
- Crie um
java.io.FileInputStreamobjeto que representa o documento PDF protegido por política usando seu construtor e passando um valor de string que especifica o local do documento PDF. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto.
- Crie um
-
Revogar o documento protegido por política
-
Crie um
DocumentManagerchamando oDocumentSecurityClientdo objetogetDocumentManagermétodo . -
Recupere o valor do identificador da licença do documento protegido por política, chamando o
DocumentManagerdo objetogetLicenseIdmétodo . Passe ocom.adobe.idp.Documentobjeto 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
LicenseManagerchamando oDocumentSecurityClientdo objetogetLicenseManagermétodo . -
Revogar o documento protegido por política chamando o
LicenseManagerdo objetorevokeLicensee transmitindo os seguintes valores:- Um valor de string que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno da variável
DocumentManagerdo objetogetLicenseIdmétodo ). - Um membro de dados estáticos do
Licenseinterface que especifica o motivo para revogar o documento. Por exemplo, você pode especificarLicense.DOCUMENT_REVISED. - A
java.net.URLque especifica o local onde um documento revisado está localizado. Se você não deseja redirecionar um usuário para outro URL, é possível enviarnull.
- Um valor de string que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno da variável
-
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo SOAP): Revogar um documento usando a API do Java"
Revogar o acesso a documentos usando a API do serviço da Web revoke-access-to-documents-using-the-web-service-api
Revogar o acesso a um documento PDF protegido por política usando a API de segurança de documentos (serviço da Web):
-
Incluir arquivos de projeto
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Criar um objeto de API do Cliente de segurança de documentos
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
DocumentSecurityServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelDocumentSecurityServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperar um documento PDF protegido por política
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar um documento PDF protegido por política que é revogado. - Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF protegido por política a ser revogado e o modo no qual o arquivo será aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Você pode determinar o tamanho da matriz de bytes obtendo a variávelSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReade transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Revogar o documento protegido por política
-
Recupere o valor do identificador da licença do documento protegido por política, chamando o
DocumentSecurityServiceClientdo objetogetLicenseIDe a aprovação doBLOBobjeto que representa o documento protegido por política. Esse método retorna um valor de string que representa o identificador de licença. -
Revogar o documento protegido por política chamando o
DocumentSecurityServiceClientdo objetorevokeLicensee transmitindo os seguintes valores:- Um valor de string que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno da variável
DocumentSecurityServiceServicedo objetogetLicenseIdmétodo ). - Um membro de dados estáticos do
Reasonenum que especifica o motivo para revogar o documento. Por exemplo, você pode especificarReason.DOCUMENT_REVISED. - A
stringque 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 enviarnull.
- Um valor de string que especifica o valor do identificador de licença do documento protegido por política (especifique o valor de retorno da variável
-
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Revogar um documento usando a API de serviço da Web"
- "Início rápido (SwaRef): Revogar um documento usando a API de serviço da Web"
Consulte também
Remover Políticas de Documentos do Word
Reposição do acesso a documentos revisados reinstating-access-to-revoked-documents
Você pode restabelecer o acesso a um documento PDF revogado, resultando em todas as cópias do documento revogado serem acessíveis aos usuários. Quando um usuário abre um documento recriado que foi revogado, ele pode visualizar o documento.
Resumo das etapas summary_of_steps-6
Para restabelecer o acesso a um documento PDF revogado, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere o identificador da licença do documento PDF revogado.
- Reinstale o acesso ao documento PDF revogado.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um DocumentSecurityClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um DocumentSecurityServiceService objeto.
Recuperar o identificador da licença do documento PDF revogado
Você deve recuperar o identificador de licença do documento PDF revogado para reinstalar um documento de 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 de PDF revogado
Para restabelecer o acesso a um documento PDF revogado, você deve especificar o identificador de licença do documento revogado. Se tentar restabelecer o acesso a um documento PDF que não seja 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
Retomar o acesso a documentos revogados usando a API Java reinstate-access-to-revoked-documents-using-the-java-api
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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
DocumentSecurityClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recupere o identificador da licença do documento PDF revogado.
- Crie um
java.io.FileInputStreamobjeto que representa o documento PDF revogado usando seu construtor e transmitindo um valor de string que especifica o local do documento PDF. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto. - Crie um
DocumentManagerchamando oDocumentSecurityClientdo objetogetDocumentManagermétodo . - Recupere o valor do identificador da licença do documento revogado chamando o
DocumentManagerdo objetogetLicenseIde a aprovação docom.adobe.idp.Documentobjeto que representa o documento revogado. Esse método retorna um valor de string que representa o identificador de licença.
- Crie um
-
Reinstale o acesso ao documento PDF revogado.
- Crie um
LicenseManagerchamando oDocumentSecurityClientdo objetogetLicenseManagermétodo . - Reinstale o acesso ao documento de PDF revogado chamando o
LicenseManagerdo objetounrevokeLicensee transmitindo o valor do identificador de licença do documento revogado.
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo SOAP): Reposição do acesso a um documento revogado usando a API do serviço da Web"
Retomar o acesso a documentos revogados usando a API do serviço da Web reinstate-access-to-revoked-documents-using-the-web-service-api
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 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
DocumentSecurityServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelDocumentSecurityServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupere o identificador da licença do documento PDF revogado.
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar um documento PDF revogado para o qual o acesso é reposto. - Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento de PDF revogado e o modo no qual o arquivo será aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Você pode determinar o tamanho da matriz de bytes obtendo a variávelSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReade transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Reinstale o acesso ao documento PDF revogado.
- Recupere o valor do identificador da licença do documento revogado chamando o
DocumentSecurityServiceClientdo objetogetLicenseIDe a aprovação doBLOBobjeto que representa o documento revogado. Esse método retorna um valor de string que representa o identificador de licença. - Reinstale o acesso ao documento de PDF revogado chamando o
DocumentSecurityServiceClientdo objetounrevokeLicensee transmitindo um valor de string que especifique o valor do identificador de licença do documento PDF revogado (passe o valor de retorno doDocumentSecurityServiceClientdo objetogetLicenseIdmétodo ).
- Recupere o valor do identificador da licença do documento revogado chamando o
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Reposição do acesso a um documento revogado usando a API do serviço da Web"
- "Início rápido (SwaRef): Reposição do acesso a um documento revogado usando a API do serviço da Web"
Consulte também
Inspecionando Documentos de PDF protegido de Política inspecting-policy-protected-pdf-documents
Você pode usar a API do Serviço de segurança de documentos (Java e serviço da Web) para inspecionar documentos do PDF protegidos por políticas. Inspecionar documentos PDF protegidos por política retorna informações sobre o documento PDF protegido por política. Você pode, por exemplo, determinar a política usada para proteger o documento e a data em que o documento foi protegido.
Não é possível executar essa tarefa se a versão do LiveCycle for 8.x ou anterior. O suporte para inspecionar documentos protegidos por políticas é adicionado no AEM Forms. Se você tentar inspecionar um documento protegido por uma política usando o LiveCycle 8.x (ou anterior), uma exceção será lançada.
Resumo das etapas summary_of_steps-7
Para inspecionar um documento PDF protegido por política, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere um documento protegido por política para inspecionar.
- Obtenha informações sobre o documento protegido por políticas.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento. Se estiver usando a API do Java, crie um RightsManagementClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um RightsManagementServiceService objeto.
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
Depois de inspecionar um documento PDF protegido por política, você pode obter informações sobre ele. Por exemplo, você pode determinar a política usada para proteger o documento.
Se você proteger um documento com uma política que pertence a Minhas Políticas e, em seguida, chamar RMInspectResult.getPolicysetName ou RMInspectResult.getPolicysetId, null é 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 retorne strings válidas.
Consulte também
Documentos do PDF protegidos por política do Inspect usando a API Java inspect-policy-protected-pdf-documents-using-the-java-api
Inspect um documento PDF protegido por política 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 Inclusão de arquivos da biblioteca Java do AEM Forms.
-
Crie um objeto da API do Cliente de segurança de documento.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. (Consulte Configuração das propriedades de conexão.) - Crie um
RightsManagementClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recupere um documento protegido por política para inspecionar.
- Crie um
java.io.FileInputStreamobjeto que representa o documento PDF protegido por política usando seu construtor. Passe um valor de string que especifica o local do documento PDF. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto.
- Crie um
-
Inspect o documento.
- Crie um
DocumentManagerchamando oRightsManagementClientdo objetogetDocumentManagermétodo . - Inspect o documento protegido por política chamando a
LicenseManagerdo objetoinspectDocumentmétodo . Passe ocom.adobe.idp.Documentobjeto que contém o documento PDF protegido por política. Esse método retorna umRMInspectResultobjeto que contém informações sobre o documento protegido por política.
- Crie um
-
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
RMInspectResultobjeto. Por exemplo, para recuperar o nome da política, chame a funçãoRMInspectResultdo objetogetPolicyNamemétodo .
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo SOAP): Inspecionar documentos PDF protegidos por política usando a API Java"
Documentos PDF protegidos por política do Inspect usando a API de serviço da Web inspect-policy-protected-pdf-documents-using-the-web-service-api
Inspect um documento de PDF protegido por política usando a API do Serviço de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
RightsManagementServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupere um documento protegido por política para inspecionar.
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar um documento PDF para inspecionar. - Crie um
System.IO.FileStreamchamando seu construtor. Passe um valor de string que representa o local do arquivo do documento PDF e o modo para abrir o arquivo. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Você pode determinar o tamanho da matriz de bytes obtendo a variávelSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReadmétodo . Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Inspect o documento.
Inspect o documento protegido por política chamando a
RightsManagementServiceClientdo objetoinspectDocumentmétodo . Passe oBLOBobjeto que contém o documento PDF protegido por política. Esse método retorna umRMInspectResultobjeto 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
RMInspectResultobjeto. Por exemplo, para recuperar o nome da política, obtenha o valor da variávelRMInspectResultdo objetopolicyNamecampo.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Inspecionar documentos PDF protegidos por política usando a API do serviço da Web"
- "Início rápido (SwaRef): Inspecionar documentos PDF protegidos por política usando a API do serviço da Web"
Consulte também
Criação de marcas d'água creating-watermarks
As marcas d'água ajudam a garantir a segurança de um documento, identificando-o exclusivamente e controlando a violação de direitos autorais. Por exemplo, você pode criar e colocar uma marca d'água que declare Confidencial em todas as páginas de um documento. Depois que uma marca d'água é criada, é possível incluí-la como parte de uma política. Ou seja, você pode definir o atributo de marca d'água da política com a marca d'água recém-criada. Depois que uma política que contém uma marca d'água é aplicada a um documento, a marca d'água aparece no documento protegido por política.
Resumo das etapas summary_of_steps-8
Para criar uma marca d'água, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Defina os atributos de marca d'água.
- Registre a marca d'água no serviço de segurança de documentos.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um RightsManagementClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um RightsManagementServiceService objeto.
Definir os atributos de marcas d'água
Para criar uma nova marca d'água, você deve definir atributos de marca d'água. O atributo name deve ser sempre definido. Além do atributo name, você deve definir pelo menos um dos seguintes atributos:
- Texto personalizado
- DateIncluded
- UserIdIncluded
- UserNameIncluded
A tabela a seguir lista os pares de chaves e valores necessários ao criar uma marca d'água usando serviços da Web.
WaterBackCmd:IS_USERNAME_ENABLEDWaterBackCmd:IS_USERID_ENABLEDWaterBackCmd:IS_CURRENTDATE_ENABLEDWaterBackCmd:IS_CUSTOMTEXT_ENABLEDWaterBackCmd:SRCTEXT.WaterBackCmd:OPACITYWaterBackCmd:ROTATIONWaterBackCmd:SCALEWaterBackCmd:IS_SIZE_ENABLED deve estar presente e o valor deve ser true. Se esse atributo não for especificado, o comportamento padrão se ajustará à página.WaterBackCmd:HORIZ_ALIGNWaterBackCmd:VERT_ALIGNWaterBackCmd:IS_USE_BACKGROUNDWaterBackCmd:IS_SIZE_ENABLEDWaterBackCmd:SRCTEXTWaterBackCmd:IS_CUSTOMTEXT_ENABLED também deve estar presente e definido como true.Todas as marcas d'água devem ter um dos seguintes atributos definidos:
WaterBackCmd:IS_USERNAME_ENABLEDWaterBackCmd:IS_USERID_ENABLEDWaterBackCmd:IS_CURRENTDATE_ENABLEDWaterBackCmd: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
Criar marcas d'água usando a API Java create-watermarks-using-the-java-api
Crie uma marca d'água usando a API de segurança de documentos (Java):
-
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como o
adobe-rightsmanagement-client.jar, no caminho da classe do seu projeto Java. -
Crie um objeto da API do Cliente de segurança de documento.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
RightsManagementClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Definir os atributos de marca d'água
- Crie um
Watermarkchamando oInfomodelObjectFactoryestático do objetocreateWatermarkmétodo . Esse método retorna umWatermarkobjeto. - Defina o atributo de nome da marca d'água chamando a variável
Watermarkdo objetosetNamee transmitindo um valor de string que especifica o nome da política. - Defina o atributo de plano de fundo da marca d'água chamando o
Watermarkdo objetosetBackgroundmétodo e aprovaçãotrue. Ao definir esse atributo, a marca d'água aparece no plano de fundo do documento. - Defina o atributo de texto personalizado da marca d'água chamando o
Watermarkdo objetosetCustomTexte transmitindo um valor de string que represente o texto da marca d'água. - Defina o atributo de opacidade da marca d'água chamando a variável
Watermarkdo objetosetOpacitye transmitindo um valor inteiro que especifica o nível de opacidade. Um valor de 100 indica que a marca d'água é completamente opaca e um valor de 0 indica que a marca d'água é completamente transparente.
- Crie um
-
Registre a marca d'água.
- Crie um
WatermarkManagerchamando oRightsManagementClientdo objetogetWatermarkManagermétodo . Esse método retorna umWatermarkManagerobjeto. - Registre a marca d'água chamando o
WatermarkManagerdo objetoregisterWatermarke a aprovação doWatermarkobjeto que representa a marca d'água a ser registrada. Esse método retorna um valor de string que representa o valor de identificação da marca d'água.
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (modo SOAP): Criar uma marca d'água usando a API do Java"
Criar marcas d'água usando a API do serviço da Web create-watermarks-using-the-web-service-api
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 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
RightsManagementServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Defina os atributos de marca d'água.
- Crie um
WatermarkSpecchamando oWatermarkSpecconstrutor. - Defina o nome da marca d'água atribuindo um valor de string à variável
WatermarkSpecdo objetonamemembro de dados. - Defina a
idatribuindo um valor de string à variávelWatermarkSpecdo objetoidmembro de dados. - Para cada propriedade de marca d'água a ser definida, crie uma
MyMapOf_xsd_string_To_xsd_anyType_Itemobjeto. - Defina o valor da chave atribuindo um valor à variável
MyMapOf_xsd_string_To_xsd_anyType_Itemdo objetokeymembro de dados (por exemplo,WaterBackCmd:OPACITY). - Defina o valor atribuindo um valor à variável
MyMapOf_xsd_string_To_xsd_anyType_Itemdo objetovaluemembro de dados (por exemplo,.25). - Crie um
MyArrayOf_xsd_anyTypeobjeto. Para cadaMyMapOf_xsd_string_To_xsd_anyType_Item, chame oMyArrayOf_xsd_anyTypedo objetoAddmétodo . Passe oMyMapOf_xsd_string_To_xsd_anyType_Itemobjeto. - Atribua o
MyArrayOf_xsd_anyTypeparaWatermarkSpecdo objetovaluesmembro de dados.
- Crie um
-
Registre a marca d'água.
Registre a marca d'água chamando o
RightsManagementServiceClientdo objetoregisterWatermarke a aprovação doWatermarkSpecobjeto que representa a marca d'água a ser registrada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Criação de uma marca d'água usando a API do serviço da Web"
- "Início rápido (SwaRef): Criação de uma marca d'água usando a API do serviço da Web"
Consulte também
Modificação de marcas d'água modifying-watermarks
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 de PDF existentes que contêm a marca d'água não são afetados.
Resumo das etapas summary_of_steps-9
Para modificar uma marca d'água, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupere a marca d'água para modificar.
- Defina os atributos de marca d'água.
- Atualize a marca d'água.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento. Se estiver usando a API do Java, crie um DocumentSecurityClient objeto. Se estiver usando a API do serviço da Web de Segurança de documento, crie um DocumentSecurityServiceService objeto.
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:OPACITYe WaterBackCmd:SRCTEXT. Embora o único atributo que você deseja modificar seja WaterBackCmd:OPACITY, é necessário definir os outros valores.
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
Modificar marcas d'água usando a API Java modify-watermarks-using-the-java-api
Modifique uma marca d'água usando a API de segurança de documentos (Java):
-
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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
DocumentSecurityClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recupere a marca d'água para modificar.
Crie um
WatermarkManagerchamando oDocumentSecurityClientdo objetogetWatermarkManagere transmita um valor de string que especifica o nome da marca d'água. Esse método retorna umWatermarkobjeto 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 a variável
Watermarkdo objetosetOpacitye transmitindo um valor inteiro que especifica o nível de opacidade. Um valor de 100 indica que a marca d'água é completamente opaca e um valor de 0 indica que a marca d'água é completamente transparente.note note NOTE Este exemplo modifica somente o atributo de opacidade. -
Atualize a marca d'água.
- Atualize a marca d'água chamando a variável
WatermarkManagerdo objetoupdateWatermarke passe oWatermarkobjeto cujo atributo foi modificado.
- Atualize a marca d'água chamando a variável
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 .
Modificar marcas d'água usando a API do serviço da Web modify-watermarks-using-the-web-service-api
Modifique uma marca d'água usando a API de segurança de documentos (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelDocumentSecurityServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recupere a marca d'água para modificar.
Recupere a marca d'água a ser modificada chamando a variável
DocumentSecurityServiceClientdo objetogetWatermarkByNamemétodo . Passe um valor de string que especifica o nome da marca d'água. Esse método retorna umWatermarkSpecobjeto que representa a marca d'água a ser modificada. -
Defina os atributos de marca d'água.
- Para cada propriedade de marca d'água a ser atualizada, crie uma
MyMapOf_xsd_string_To_xsd_anyType_Itemobjeto. - Defina o valor da chave atribuindo um valor à variável
MyMapOf_xsd_string_To_xsd_anyType_Itemdo objetokeymembro de dados (por exemplo,WaterBackCmd:OPACITY). - Defina o valor atribuindo um valor à variável
MyMapOf_xsd_string_To_xsd_anyType_Itemdo objetovaluemembro de dados (por exemplo,.50). - Crie um
MyArrayOf_xsd_anyTypeobjeto. Para cadaMyMapOf_xsd_string_To_xsd_anyType_Item, chame oMyArrayOf_xsd_anyTypedo objetoAddmétodo . Passe oMyMapOf_xsd_string_To_xsd_anyType_Itemobjeto. - Atribua o
MyArrayOf_xsd_anyTypeparaWatermarkSpecdo objetovaluesmembro de dados.
- Para cada propriedade de marca d'água a ser atualizada, crie uma
-
Atualize a marca d'água.
Atualize a marca d'água chamando a variável
DocumentSecurityServiceClientdo objetoupdateWatermarke a aprovação doWatermarkSpecobjeto que representa a marca d'água a ser modificada.
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
- "Início rápido (MTOM): Modificação de uma marca d'água usando a API do serviço da Web"
Pesquisar eventos searching-for-events
O serviço Rights Management rastreia ações específicas à medida que ocorrem, como aplicar uma política a um documento, abrir um documento protegido por política e revogar o acesso a documentos. A auditoria de eventos deve ser ativada para o serviço Rights Management ou os eventos não são rastreados.
Os eventos são incluídos em uma das seguintes categorias:
- Os eventos de administrador são ações relacionadas a um administrador, como a criação de uma nova conta de administrador.
- Eventos de documento são ações relacionadas a um documento, como fechar um documento protegido por política.
- Eventos de política são ações relacionadas a uma política, como a criação de uma nova política.
- Os eventos de serviço são ações relacionadas ao serviço do Rights Management, como a sincronização com o diretório do usuário.
Você pode pesquisar por eventos específicos usando a API do Java do Rights Management ou a API do serviço da Web. Ao procurar por eventos, você pode executar tarefas, como criar um arquivo de log de determinados eventos.
Resumo das etapas summary_of_steps-10
Para procurar um evento Rights Management, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto de API do cliente do Rights Management.
- Especifique o evento para o qual pesquisar.
- Procure o evento .
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do cliente do Rights Management
Antes de executar programaticamente uma operação de serviço Rights Management, é necessário criar um objeto de cliente de serviço Rights Management. Se estiver usando a API do Java, crie um DocumentSecurityClient objeto. Se estiver usando a API do serviço da Web do Rights Management, crie um DocumentSecurityServiceService objeto.
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
Procure eventos usando a API do Java search-for-events-using-the-java-api
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
DocumentSecurityClientusando seu construtor e transmitindo umServiceClientFactoryobjeto que contém propriedades de conexão. -
Especifique os eventos que serão pesquisados
- Crie um
EventManagerchamando oDocumentSecurityClientdo objetogetEventManagermétodo . Esse método retorna umEventManagerobjeto. - Crie um
EventSearchFilterchamando seu construtor. - Especifique o evento para o qual pesquisar, chamando a função
EventSearchFilterdo objetosetEventCodee transmitindo um membro de dados estáticos que pertence aoEventManagerclasse que representa o evento para o qual pesquisar. Por exemplo, para pesquisar o evento de criação de política, passeEventManager.POLICY_CREATE_EVENT.
note note NOTE Você pode definir critérios de pesquisa adicionais chamando EventSearchFiltermétodos do objeto. Por exemplo, chame a funçãosetUserNamepara especificar um usuário associado ao evento. - Crie um
-
Pesquisar pelo evento
Procure o evento chamando a função
EventManagerdo objetosearchForEventse a aprovação doEventSearchFilterque define os critérios de pesquisa do evento. Esse método retorna uma matriz deEventobjetos.
Exemplos de código
Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Inícios rápidos:
- "Início rápido (SOAP): Pesquisar eventos usando a API do Java"
Pesquisar eventos usando a API de serviço da Web search-for-events-using-the-web-service-api
Procure eventos usando a API do Rights Management (serviço da Web):
-
Incluir arquivos de projeto
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Criar um objeto de API do cliente do Rights Management
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
DocumentSecurityServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelDocumentSecurityServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Especifique os eventos que serão pesquisados
- Crie um
EventSpecusando seu construtor. - Especifique o início do período de tempo durante o qual o evento ocorreu, definindo a variável
EventSpecdo objetofirstTime.datemembro de dados comDataTimeque representa o início do intervalo de datas quando o evento ocorreu. - Atribua o valor
trueparaEventSpecdo objetofirstTime.dateSpecifiedmembro de dados. - Especifique o fim do período de tempo durante o qual o evento ocorreu, definindo a variável
EventSpecdo objetolastTime.datemembro de dados comDataTimeque representa o fim do intervalo de datas quando o evento ocorreu. - Atribua o valor
trueparaEventSpecdo objetolastTime.dateSpecifiedmembro de dados. - Defina o evento que será procurado atribuindo um valor de string à variável
EventSpecdo objetoeventCodemembro de dados. A tabela a seguir lista os valores numéricos que você pode atribuir a essa propriedade:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 39-row-2 40-row-2 41-row-2 42-row-2 43-row-2 44-row-2 45-row-2 46-row-2 47-row-2 Tipo de evento Valor ALL_EVENTS999 USER_CHANGE_PASSWORD_EVENT1000 USER_REGISTER_EVENT1001 USER_PREREGISTER_EVENT1002 USER_ACTIVATE_EVENT1003 USER_DEACTIVATE_EVENT1004 USER_AUTHENTICATE_EVENT1005 USER_AUTHENTICATE_DENY_EVENT1006 USER_ACCOUNT_LOCK_EVENT1007 USER_DELETE_EVENT1008 USER_UPDATE_PROFILE_EVENT1009 DOCUMENT_VIEW_EVENT2000 DOCUMENT_PRINT_LOW_EVENT2001 DOCUMENT_PRINT_HIGH_EVENT2002 DOCUMENT_SIGN_EVENT2003 DOCUMENT_ADD_ANNOTATION_EVENT2004 DOCUMENT_FORM_FILL_EVENT2005 DOCUMENT_CLOSE_EVENT2006 DOCUMENT_MODIFY_EVENT2007 DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT2008 DOCUMENT_SWITCH_POLICY_EVENT2009 DOCUMENT_REVOKE_EVENT2010 $12011 DOCUMENT_SECURE_EVENT2012 DOCUMENT_UNKNOWN_CLIENT_EVENT2013 DOCUMENT_CHANGE_REVOKE_URL_EVENT2014 POLICY_CHANGE_EVENT3000 POLICY_ENABLE_EVENT3001 POLICY_DISABLE_EVENT3002 POLICY_CREATE_EVENT3003 POLICY_DELETE_EVENT3004 POLICY_CHANGE_OWNER_EVENT3005 SERVER_CLIENT_SYNC_EVENT4000 SERVER_SYNC_DIR_INFO_EVENT4001 SERVER_SYNC_DIR_COMPLETE_EVENT4002 SERVER_VERSION_MISMATCH_EVENT4003 SERVER_CONFIG_CHANGE_EVENT4004 SERVER_ENABLE_OFFLINE_ACCESS_EVENT4005 ADMIN_ADD_EVENT5000 ADMIN_DELETE_EVENT5001 ADMIN_EDIT_EVENT5002 ADMIN_ACTIVATE_EVENT5003 ADMIN_DEACTIVATE_EVENT5004 ERROR_DIRECTORY_SERVICE_EVENT6000 CREATED_POLICYSET_EVENT7000 DELETED_POLICYSET_EVENT7001 MODIFIED_POLICYSET_EVENT7002 - Crie um
-
Pesquisar pelo evento
Procure o evento chamando a função
DocumentSecurityServiceClientdo objetosearchForEventse a aprovação doEventSpecque representa o evento para o qual pesquisar e o número máximo de resultados. Esse método retorna umMyArrayOf_xsd_anyTypecoleção em que cada elemento é umAuditSpecinstância. Uso de umAuditSpec, é possível obter informações sobre o evento, como a hora em que ele ocorreu. OAuditSpeca instância contém umtimestampmembro de dados que especifica essas informações.
Exemplos de código
Para obter exemplos de código usando o serviço Rights Management, consulte os seguintes Inícios rápidos:
- "Início rápido (MTOM): Procurar eventos usando a API do serviço da Web"
- "Início rápido (SwaRef): Procurar eventos usando a API do serviço da Web"
Consulte também
Aplicando Políticas a Documentos do Word applying-policies-to-word-documents
Além de documentos do PDF, o serviço Gerenciamento de Direitos oferece suporte a formatos de documento adicionais, como um documento do Microsoft Word (arquivo DOC) e outros formatos de arquivo do Microsoft Office. Por exemplo, você pode aplicar uma política a um documento do Word para protegê-lo. Ao aplicar uma política a um documento do Word, você restringe o acesso ao documento. Não é possível aplicar uma política a um documento se ele já estiver protegido por uma política.
Você pode monitorar o uso de um documento do Word protegido por política depois de distribuí-lo. Ou seja, você pode ver como o documento está sendo usado e quem o está usando. Por exemplo, você pode descobrir quando alguém abriu o documento.
Resumo das etapas summary_of_steps-11
Para aplicar uma política a um documento do Word, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do Cliente de segurança de documento.
- Recupera um documento do Word ao qual uma política é aplicada.
- Aplique uma política existente ao documento do Word.
- Salve o documento do Word protegido por política.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto da API do cliente de segurança de documentos
Antes de poder executar programaticamente uma operação de serviço de Segurança de Documento, é necessário criar um objeto de cliente do serviço de Segurança de Documento.
Recuperar um documento do Word
Você deve recuperar um documento do Word para aplicar uma política. Depois de aplicar uma política ao documento do Word, os usuários são restritos ao usar o documento. Por exemplo, se a política não habilitar a abertura do documento offline, os usuários deverão estar online para abrir o documento.
Aplicar uma política existente ao documento do Word
Para aplicar uma política a um documento do Word, é necessário referenciar uma política existente e especificar a qual conjunto de políticas a política pertence. O usuário que está definindo as propriedades de conexão deve ter acesso à política especificada. Caso contrário, ocorrerá uma exceção.
Salvar o documento do Word
Depois que o serviço de segurança de documento aplicar uma política a um documento do Word, você poderá salvar o documento do Word protegido por política como um arquivo DOC.
Consulte também
Inclusão de arquivos da biblioteca Java do AEM Forms
Aplicar uma política a um documento do Word usando a API do Java apply-a-policy-to-a-word-document-using-the-java-api
Aplique uma política a um documento do Word usando a API de segurança de 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.
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
DocumentSecurityClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recuperar um documento do Word.
- Crie um
java.io.FileInputStreamobjeto que representa o documento do Word usando seu construtor e passando um valor de string que especifica o local do documento do Word. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto.
- Crie um
-
Aplique uma política existente ao documento do Word.
-
Crie um
DocumentManagerchamando oDocumentSecurityClientdo objetogetDocumentManagermétodo . -
Aplique uma política ao documento do Word chamando o
DocumentManagerdo objetoprotectDocumente transmitindo os seguintes valores:- O
com.adobe.idp.Documentobjeto que contém o documento do Word ao qual a política é aplicada. - Um valor de string que especifica o nome do documento.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar uma
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor de string que especifica o nome da política.
- Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser nulo).
- Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser
null(se este parâmetro fornull, o valor do parâmetro anterior deve sernull). - A
com.adobe.livecycle.rightsmanagement.Localeque representa a localidade usada para selecionar o modelo do MS Office. Esse valor de parâmetro é opcional e você pode especificarnull.
O
protectDocumentmétodo retorna umRMSecureDocumentResultobjeto que contém o documento do Word protegido por política. - O
-
-
Salve o documento do Word.
- Chame o
RMSecureDocumentResultdo objetogetProtectedDocpara obter o documento do Word protegido por política. Esse método retorna umcom.adobe.idp.Documentobjeto. - Crie um
java.io.Filee verifique se a extensão do arquivo é DOC. - Chame o
com.adobe.idp.Documentdo objetocopyToFilepara copiar o conteúdo daDocumentpara o arquivo (certifique-se de usar a variávelDocumentobjeto retornado pelogetProtectedDocmétodo ).
- Chame o
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
- "Início rápido (modo SOAP): Aplicar uma política a um documento do Word usando a API do Java"
Aplicar uma política a um documento do Word usando a API do serviço da Web apply-a-policy-to-a-word-document-using-the-web-service-api
Aplique uma política a um documento do Word usando a API de segurança de documento (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Crie um objeto da API do Cliente de segurança de documento.
-
Crie um
DocumentSecurityServiceClientusando seu construtor padrão. -
Crie um
DocumentSecurityServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelDocumentSecurityServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
DocumentSecurityServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperar um documento do Word.
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar um documento do Word ao qual uma política é aplicada. - Crie um
System.IO.FileStreamchamando 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 deve ser aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Determine o tamanho da matriz de bytes obtendo oSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReadmétodo . Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Aplique uma política existente ao documento do Word.
Aplique uma política ao documento do Word chamando o
DocumentSecurityServiceClientdo objetoprotectDocumente transmitindo os seguintes valores:- O
BLOBobjeto que contém o documento do Word ao qual a política é aplicada. - Um valor de string que especifica o nome do documento.
- Um valor de string que especifica o nome do conjunto de políticas ao qual a política pertence. Você pode especificar uma
nullque resulta noMyPoliciesconjunto de políticas que está sendo usado. - Um valor de string que especifica o nome da política.
- Um valor de string que representa o nome do domínio do gerenciador de usuários do usuário que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o próximo valor do parâmetro deve ser
null). - Um valor de string que representa o nome canônico do usuário do gerenciador de usuários que é o editor do documento. Esse valor de parâmetro é opcional e pode ser nulo (se esse parâmetro for nulo, o valor do parâmetro anterior deve ser
null). - A
RMLocalevalor que especifica o valor da localidade (por exemplo,RMLocale.en). - Um parâmetro de saída da string usado para armazenar o valor do identificador de política.
- Um parâmetro de saída de string usado para armazenar o valor do identificador protegido por política.
- Um parâmetro de saída de string usado para armazenar o tipo MIME (por exemplo,
application/doc).
O
protectDocumentmétodo retorna umBLOBobjeto que contém o documento do Word protegido por política. - O
-
Salve o documento do Word.
- Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word protegido por política. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOBobjeto retornado peloprotectDocumentmétodo . Preencha a matriz de bytes obtendo o valor da variávelBLOBdo objetoMTOMmembro de dados. - Crie um
System.IO.BinaryWriterchamando seu construtor e passando oSystem.IO.FileStreamobjeto. - Escreva o conteúdo da matriz de bytes em um arquivo do Word chamando o
System.IO.BinaryWriterdo objetoWritee transmitindo a matriz de bytes.
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
- "Início rápido (MTOM): Aplicar uma política a um documento do Word usando a API do serviço da Web"
Remover Políticas de Documentos do Word removing-policies-from-word-documents
Você pode remover uma política de um documento do Word protegido por política para remover a segurança do documento. Ou seja, se você não quiser mais que o documento seja protegido por uma política. Se você quiser atualizar um documento do Word protegido por política com uma política mais recente, em vez de remover a política e adicionar a política atualizada, é mais eficiente mudar a política.
Resumo das etapas summary_of_steps-12
Para remover uma política de um documento do Word protegido por política, execute as seguintes etapas:
- Incluir arquivos de projeto
- Crie um objeto da API do Cliente de segurança de documento.
- Recuperar um documento do Word protegido por política.
- Remova a política do documento do Word.
- Salve o documento do Word não seguro.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Criar um objeto de API do Cliente de segurança de documentos
Antes de executar programaticamente uma operação de serviço de Segurança de documento, crie um objeto cliente de serviço de Segurança de documento.
Recuperar um documento do Word protegido por política
Você deve recuperar um documento do Word protegido por política para remover uma política. Se tentar remover uma política de um documento do Word que não está protegido por uma política, ocorrerá uma exceção.
Remover a política do documento do Word
Você pode remover uma política de um documento do Word protegido por política, desde que um administrador seja especificado nas configurações de conexão. Caso contrário, a política usada para proteger um documento deverá conter a variável SWITCH_POLICY permissão 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
Remover uma política de um documento do Word usando a API Java remove-a-policy-from-a-word-document-using-the-java-api
Remova uma política de um documento do Word protegido por política usando a API de segurança de documentos (Java):
-
Incluir arquivos de projeto
Inclua arquivos JAR do cliente, como adobe-rights-management-client.jar, no caminho de classe do seu projeto Java.
-
Criar um objeto de API do Cliente de segurança de documentos
- Crie um
ServiceClientFactoryobjeto que contém propriedades de conexão. - Crie um
RightsManagementClientusando seu construtor e passando oServiceClientFactoryobjeto.
- Crie um
-
Recuperar um documento do Word protegido por política
- Crie um
java.io.FileInputStreamobjeto que representa o documento do Word protegido por política usando seu construtor e transmitindo um valor de string que especifica o local do documento do Word. - Crie um
com.adobe.idp.Documentusando seu construtor e passando ojava.io.FileInputStreamobjeto.
- Crie um
-
Remover a política do documento do Word
- Crie um
DocumentManagerchamando oRightsManagementClientdo objetogetDocumentManagermétodo . - Remova uma política do documento do Word chamando o
DocumentManagerdo objetoremoveSecuritye a aprovação docom.adobe.idp.Documentobjeto que contém o documento do Word protegido por política. Esse método retorna umcom.adobe.idp.Documentobjeto que contém um documento do Word não seguro.
- Crie um
-
Salvar o documento do Word não seguro
- Crie um
java.io.Filee verifique se a extensão do arquivo é DOC. - Chame o
Documentdo objetocopyToFilepara copiar o conteúdo daDocumentpara o arquivo (certifique-se de usar a variávelDocumentobjeto retornado peloremoveSecuritymétodo ).
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
- "Início rápido (modo SOAP): Remover uma política de um documento do Word usando a API do Java"
Remover uma política de um documento do Word usando a API do serviço da Web remove-a-policy-from-a-word-document-using-the-web-service-api
Remova uma política de um documento do Word protegido por política usando a API de segurança de documentos (serviço da Web):
-
Incluir arquivos de projeto
Crie um projeto 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.note note NOTE Substituir localhostcom o endereço IP do servidor que hospeda a AEM Forms. -
Criar um objeto de API do Cliente de segurança de documentos
-
Crie um
RightsManagementServiceClientusando seu construtor padrão. -
Crie um
RightsManagementServiceClient.Endpoint.Addressusando oSystem.ServiceModel.EndpointAddressconstrutor. 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.) Não é necessário usar a variávellc_versionatributo. Este atributo é usado ao criar uma referência de serviço.) -
Crie um
System.ServiceModel.BasicHttpBindingobtendo o valor da variávelRightsManagementServiceClient.Endpoint.Bindingcampo. Converta o valor de retorno paraBasicHttpBinding. -
Defina as
System.ServiceModel.BasicHttpBindingdo objetoMessageEncodingcampo paraWSMessageEncoding.Mtom. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
RightsManagementServiceClient.ClientCredentials.UserName.UserName. - Atribua o valor correspondente da senha ao campo
RightsManagementServiceClient.ClientCredentials.UserName.Password. - Atribuir o valor constante
HttpClientCredentialType.Basicao campoBasicHttpBindingSecurity.Transport.ClientCredentialType.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnlyao campoBasicHttpBindingSecurity.Security.Mode.
-
-
Recuperar um documento do Word protegido por política
- Crie um
BLOBusando seu construtor. OBLOBé usado para armazenar o documento do Word protegido por política do qual a política é removida. - Crie um
System.IO.FileStreamchamando 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 deve ser aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStreamobjeto. Você pode determinar o tamanho da matriz de bytes obtendo a variávelSystem.IO.FileStreamdo objetoLengthpropriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStreamdo objetoReade transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido. - Preencha o
BLOBao atribuir seuMTOMcom o conteúdo da matriz de bytes.
- Crie um
-
Remover a política do documento do Word
Remova a política do documento do Word chamando a
RightsManagementServiceClientdo objetoremovePolicySecuritye a aprovação doBLOBobjeto que contém o documento do Word protegido por política. Esse método retorna umBLOBobjeto que contém um documento do Word não seguro. -
Salvar o documento do Word não seguro
- Crie um
System.IO.FileStreamchamando seu construtor e passando um valor de string que representa o local do arquivo do documento do Word não seguro. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOBobjeto retornado peloremovePolicySecuritymétodo . Preencha a matriz de bytes obtendo o valor da variávelBLOBdo objetoMTOMcampo. - Crie um
System.IO.BinaryWriterchamando seu construtor e passando oSystem.IO.FileStreamobjeto.
- Crie um
Exemplos de código
Para obter exemplos de código usando o serviço Segurança de documento, consulte o seguinte Início rápido:
- "Início rápido (MTOM): Remover uma política de um documento do Word usando a API do serviço da Web"
Consulte também
Chamar o AEM Forms usando MTOM