Segurança do documento | Tratamento de dados do usuário

A segurança do documento AEM Forms permite que você crie, armazene e aplique configurações de segurança predefinidas aos seus documentos. Ela garante que somente usuários autorizados possam usar os documentos. É possível proteger documentos usando políticas. Uma política é uma coleção de informações que inclui configurações de segurança e uma lista de usuários autorizados. Você pode aplicar uma política a um ou mais documentos e autorizar usuários adicionados ao gerenciamento de usuários do AEM Forms JEE.

Os dados do usuário e os armazenamentos de dados

A segurança do documento armazena políticas e dados relacionados a documentos protegidos, incluindo dados do usuário em um banco de dados, como My Sql, Oracle, MS SQL Server e IBM DB2. Além disso, os dados para usuários autorizados em uma política armazenada no gerenciamento de usuários. Para obter informações sobre dados armazenados no gerenciamento de usuários, consulte Gerenciamento de usuários da Forms: Tratamento de dados do usuário.

A tabela a seguir mapeia como a segurança do documento organiza os dados nas tabelas do banco de dados.

Acessar e excluir dados do usuário

Você pode acessar e exportar dados de segurança do documento para usuários nos bancos de dados e, se necessário, excluí-los permanentemente.

Para exportar ou excluir dados do usuário de um banco de dados, é necessário se conectar ao banco de dados usando um cliente de banco de dados e descobrir a ID principal com base em algumas informações pessoalmente identificáveis do usuário. Por exemplo, para recuperar a ID principal de um usuário usando uma ID de logon, execute o seguinte comando select no banco de dados.

No comando select, substitua <user_login_id> pela ID de logon do usuário cuja ID principal você deseja recuperar da tabela do banco de dados EdcPrincipalUserEntity.

select refprincipalid from EdcPrincipalUserEntity where uidstring = <user_login_id>

Quando você souber a ID principal, poderá exportar ou excluir os dados do usuário.

Exportar dados do usuário

Execute os seguintes comandos de banco de dados para exportar dados do usuário para uma ID principal das tabelas de banco de dados. No comando select, substitua <principal_id> pela ID principal do usuário cujos dados você deseja exportar.

Select * from EdcPrincipalKeyEntity where principalid = '<principal_id>';

Select * from EdcLicenseEntity where publisherId = '<principal_id>';

Select * from EdcDocumentEntity where id in (Select documentid from EdcLicenseEntity where publisherId = '<principal_id>');

Select * from EdcRevokationEntity where licenseid in (Select id from EdcLicenseEntity where publisherId = '<principal_id>');

Select * from EdcMyPolicyListEntity where principalId = '<principal_id>';

Select * from edcpolicyentity where policyownerId = '<principal_id>';

Select * from edcpolicyxmlentity where policyidref in (Select id from edcpolicyentity where policyownerId = '<principal_id>');

Select * from edcpolicyarchiveentity where policyownerId = '<principal_id>';

Select * from edcpolicysetprincipalentity where principalId = '<principal_id>';

Select * from edcinviteduserentity where principalId = '<principal_id>';

Para obter dados completos sobre um usuário no sistema, você deve acessar e exportar dados do banco de dados de gerenciamento de usuários. Para obter mais informações, consulte Gerenciamento de usuários do Forms: Tratamento de dados do usuário.

Excluir dados do usuário

Faça o seguinte para excluir dados de segurança do documento de uma ID principal das tabelas do banco de dados.

1. Desligue o servidor AEM Forms.

2. Execute os seguintes comandos de banco de dados para excluir dados da ID principal das tabelas de banco de dados para segurança do documento. No comando Delete, substitua <principal_id> pela ID principal do usuário cujos dados você deseja excluir.

   Delete from EdcPrincipalKeyEntity where principalid = '<principal_id>';
   
   Delete from EdcMyPolicyListEntity where principalId = '<principal_id>';
   
   Delete from edcpolicyarchiveentity where policyownerId = '<principal_id>';
   
   Delete from edcpolicysetprincipalentity where principalId = '<principal_id>';
   
   Delete from edcinviteduserentity where principalId = '<principal_id>';
   

   OBSERVAÇÃO

   Para excluir dados da tabela EdcAuditEntity, use a API EventManager.deleteEvents que utiliza EventSearchFilter como parâmetro para excluir dados de auditoria baseados em principalId, policyId ou licenseId.

3. Os arquivos XML de política ativa e arquivada são armazenados nas tabelas de banco de dados EdcPolicyXmlEntity e EdcPolicyArchiveEntity, respectivamente. Para excluir dados de um usuário dessas tabelas, faça o seguinte:

   1. Abra o blob XML de cada linha na tabela EdcPolicyXMLEntity ou EdcPolicyArchiveEntity e extraia o arquivo XML. O arquivo XML é semelhante ao mostrado abaixo.
   2. Edite o arquivo XML para remover o blob da ID principal.
   3. Repita as etapas 1 e 2 para o outro arquivo.
   OBSERVAÇÃO

   Você deve remover o blob completo dentro da tag Principal para uma ID principal ou o XML de política pode ficar corrompido ou inutilizável.

   <ns2:Principal PrincipalNameType="USER">
       <ns2:PrincipalDomain>OID</ns2:PrincipalDomain>
       <ns2:PrincipalName>56F33FEB-098A-1036-A651-00000A2A2656</ns2:PrincipalName>
   </ns2:Principal>
   </ns2:PolicyEntry>
       <ns2:Property PropertyName="isCertified">
           <ns2:PropertyValue xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xs="https://www.w3.org/2001/XMLSchema" xsi:type="xs:string">false</ns2:PropertyValue>
       </ns2:Property>
       <ns2:Property PropertyName="encryptionAlgorithm">
           <ns2:PropertyValue xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xs="https://www.w3.org/2001/XMLSchema" xsi:type="xs:string">AES128</ns2:PropertyValue>
       </ns2:Property>
       <ns2:Property PropertyName="AccessDeniedErrorMessage">
           <ns2:PropertyValue xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xs="https://www.w3.org/2001/XMLSchema" xsi:type="xs:string"></ns2:PropertyValue>
       </ns2:Property>
   <ns2:PolicyEntry>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.onlineOpen" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.copy" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.offlineOpen" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.accessible" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.editNotes" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.edit" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.fillAndSign" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.printHigh" Access="ALLOW"/>
   <ns2:Permission PermissionName="ns3:com.adobe.aps.pdf.printLow" Access="ALLOW"/>
   

   Além de excluir dados diretamente da tabela EdcPolicyXmlEntity, há mais duas maneiras de conseguir isso:

   Uso do console de administração

   1. Como administrador, faça logon no console de administração do Forms JEE em https://[server]:[port]/adminui.
   2. Navegue até Serviços > Segurança do Documento > Conjuntos de políticas.
   3. Abra um conjunto de políticas e exclua o usuário da política.

   Usando a página da Web de segurança do documento

   Os usuários de segurança do documento que têm permissões para criar políticas pessoais podem excluir dados do usuário de suas políticas. Para isso:

   1. Os usuários que têm políticas pessoais fazem logon em sua página da Web de segurança do documento em https://[server]:[port]/edc.
   2. Navegue até Serviços > Segurança do Documento > Minhas políticas.
   3. Abra uma política e exclua o usuário da política.
   OBSERVAÇÃO

   Os administradores podem pesquisar, acessar e excluir dados do usuário de políticas pessoais de outros usuários em Serviços > Segurança do Documento > Minhas políticas usando o console de administração.

4. Exclua os dados da ID principal do banco de dados de gerenciamento de usuários. Para obter etapas detalhadas, consulte Gerenciamento de usuários do Forms | Tratamento de dados do usuário.

5. Start o servidor AEM Forms.