Gerenciamento de usuários managing-users

Exclusão de usuários

Adicionar usuários usando a API Java add-users-using-the-java-api

Adicione usuários usando a API de serviço do Diretory Manager (Java):

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java.
Crie um cliente DiretoryManagerServices.

Crie um objeto DirectoryManagerServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.

Definir informações do usuário.

Crie um objeto UserImpl usando seu construtor.
Defina o nome de domínio invocando o método setDomainName do objeto UserImpl. Transmita um valor de string que especifique o nome do domínio.
Defina o tipo de entidade invocando o método setPrincipalType do objeto UserImpl. Transmita um valor de string que especifique o tipo de usuário. Por exemplo, você pode especificar USER.
Defina o valor do identificador do usuário invocando o método setUserid do objeto UserImpl. Transmita um valor de string que especifique o valor do identificador do usuário. Por exemplo, você pode especificar wblue.
Defina o nome canônico invocando o método setCanonicalName do objeto UserImpl. Transmita um valor de string que especifique o nome canônico do usuário. Por exemplo, você pode especificar wblue.
Defina o nome fornecido invocando o método setGivenName do objeto UserImpl. Transmita um valor de string que especifique o nome do usuário. Por exemplo, você pode especificar Wendy.
Defina o nome da família invocando o método setFamilyName do objeto UserImpl. Transmita um valor de string que especifique o nome da família do usuário. Por exemplo, você pode especificar Blue.

note note
NOTE
Invoque um método que pertence ao objeto `UserImpl` para definir outros valores. Por exemplo, você pode definir o valor da localidade chamando o método `setLocale` do objeto `UserImpl`.

Adicione o usuário ao AEM Forms.

Invoque o método createLocalUser do objeto DirectoryManagerServiceClient e passe os seguintes valores:
- O objeto UserImpl que representa o novo usuário
- Um valor de string que representa a senha do usuário
O método createLocalUser retorna um valor de cadeia de caracteres que especifica o valor do identificador de usuário local.
Verifique se o usuário foi adicionado.
- Crie um objeto PrincipalSearchFilter usando seu construtor.
- Defina o valor do identificador do usuário invocando o método setUserId do objeto PrincipalSearchFilter. Transmita um valor de string que represente o valor do identificador do usuário.
- Invoque o método findPrincipals do objeto DirectoryManagerServiceClient e passe o objeto PrincipalSearchFilter. Este método retorna uma instância java.util.List, em que cada elemento é um objeto User. Repita através da instância java.util.List para localizar o usuário.

Consulte também

Início rápido (modo SOAP): Adição de usuários usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Adicionar usuários usando a API do serviço Web add-users-using-the-web-service-api

Adicionar usuários usando a API de Serviço do Gerenciador de Diretórios (serviço Web):

Incluir arquivos de projeto.

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

note note
NOTE
Substitua `localhost` pelo endereço IP do servidor que hospeda o AEM Forms.

Crie um cliente DiretoryManagerService.
- Crie um objeto DirectoryManagerServiceClient usando seu construtor padrão.
- Crie um objeto DirectoryManagerServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Transmita um valor de string que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço. Certifique-se de especificar ?blob=mtom.
- Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DirectoryManagerServiceClient.Endpoint.Binding. Converter o valor de retorno em BasicHttpBinding.
- Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.
- Ative a autenticação HTTP básica executando as seguintes tarefas:
  - Atribua o nome de usuário dos formulários AEM ao campo DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  - Atribua o valor de senha correspondente ao campo DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  - Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.
Definir informações do usuário.
- Crie um objeto UserImpl usando seu construtor.
- Defina o nome do domínio atribuindo um valor de cadeia de caracteres ao campo domainName do objeto UserImpl.
- Defina o tipo de entidade atribuindo um valor de cadeia de caracteres ao campo principalType do objeto UserImpl. Por exemplo, você pode especificar USER.
- Defina o valor do identificador do usuário atribuindo um valor de cadeia de caracteres ao campo userid do objeto UserImpl.
- Defina o valor do nome canônico atribuindo um valor de cadeia de caracteres ao campo canonicalName do objeto UserImpl.
- Defina o valor do nome fornecido atribuindo um valor de cadeia de caracteres ao campo givenName do objeto UserImpl.
- Defina o valor do nome de família atribuindo um valor de sequência de caracteres ao campo familyName do objeto UserImpl.
Adicione o usuário ao AEM Forms.

Invoque o método createLocalUser do objeto DirectoryManagerServiceClient e passe os seguintes valores:
- O objeto UserImpl que representa o novo usuário
- Um valor de string que representa a senha do usuário
O método createLocalUser retorna um valor de cadeia de caracteres que especifica o valor do identificador de usuário local.
Verifique se o usuário foi adicionado.
- Crie um objeto PrincipalSearchFilter usando seu construtor.
- Defina o valor do identificador do usuário atribuindo um valor de cadeia de caracteres que represente o valor do identificador do usuário para o campo userId do objeto PrincipalSearchFilter.
- Invoque o método findPrincipals do objeto DirectoryManagerServiceClient e passe o objeto PrincipalSearchFilter. Este método retorna um objeto de coleção MyArrayOfUser, onde cada elemento é um objeto User. Repita através da coleção MyArrayOfUser para localizar o usuário.

Consulte também

Chamar o AEM Forms usando SwaRef

Exclusão de usuários deleting-users

Você pode usar a API do serviço do Gerenciador de diretórios (Java e serviço Web) para excluir usuários da AEM Forms de forma programática. Depois que você excluir um usuário, ele não poderá mais ser usado para executar uma operação de serviço que exija um usuário. Por exemplo, não é possível atribuir uma tarefa a um usuário excluído.

Resumo das etapas summary_of_steps-1

Para excluir um usuário, execute as seguintes etapas:

Incluir arquivos de projeto.
Crie um cliente DiretoryManagerService.
Especifique o usuário a ser excluído.
Exclua o usuário do AEM Forms.

Incluir arquivos de projeto

Criar um cliente DiretoryManagerService

Antes de executar programaticamente uma operação da API de Serviço do Gerenciador de Diretórios, crie um cliente de serviço do Gerenciador de Diretórios.

Especificar o usuário a ser excluído

Você pode especificar um usuário para excluir usando o valor do identificador do usuário.

Excluir o usuário do AEM Forms

Para excluir um usuário, chame o método deleteLocalUser do objeto DirectoryManagerServiceClient.

Consulte também

Excluir usuários usando a API Java

Excluir usuários usando a API do serviço Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Adição de usuários

Excluir usuários usando a API Java delete-users-using-the-java-api

Exclua usuários usando a API de serviço do Gerenciador de diretórios (Java):

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java.
Crie um cliente DiretoryManagerService.

Crie um objeto DirectoryManagerServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.
Especifique o usuário a ser excluído.
- Crie um objeto PrincipalSearchFilter usando seu construtor.
- Defina o valor do identificador do usuário invocando o método setUserId do objeto PrincipalSearchFilter. Transmita um valor de string que represente o valor do identificador do usuário.
- Invoque o método findPrincipals do objeto DirectoryManagerServiceClient e passe o objeto PrincipalSearchFilter. Este método retorna uma instância java.util.List, em que cada elemento é um objeto User. Repita através da instância java.util.List para localizar o usuário a ser excluído.
Exclua o usuário do AEM Forms.

Invoque o método deleteLocalUser do objeto DirectoryManagerServiceClient e passe o valor do campo oid do objeto User. Invoque o método getOid do objeto User. Use o objeto User recuperado da instância java.util.List.

Consulte também

Início rápido (modo EJB): excluindo usuários usando a API Java

Início rápido (modo SOAP): exclusão de usuários usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Excluir usuários usando a API do serviço Web delete-users-using-the-web-service-api

Exclua usuários usando a API de Serviço do Gerenciador de Diretórios (serviço Web):

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java.
Crie um cliente DiretoryManagerService.
- Crie um objeto DirectoryManagerServiceClient usando seu construtor padrão.
- Crie um objeto DirectoryManagerServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Transmita um valor de string que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço. Certifique-se de especificar blob=mtom.
- Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo DirectoryManagerServiceClient.Endpoint.Binding. Converter o valor de retorno em BasicHttpBinding.
- Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.
- Ative a autenticação HTTP básica executando as seguintes tarefas:
  - Atribua o nome de usuário dos formulários AEM ao campo DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  - Atribua o valor de senha correspondente ao campo DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  - Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.
Especifique o usuário a ser excluído.
- Crie um objeto PrincipalSearchFilter usando seu construtor.
- Defina o valor do identificador do usuário atribuindo um valor de cadeia de caracteres ao campo userId do objeto PrincipalSearchFilter.
- Invoque o método findPrincipals do objeto DirectoryManagerServiceClient e passe o objeto PrincipalSearchFilter. Este método retorna um objeto de coleção MyArrayOfUser, onde cada elemento é um objeto User. Repita através da coleção MyArrayOfUser para localizar o usuário. O objeto User recuperado do objeto de coleção MyArrayOfUser é usado para excluir o usuário.
Exclua o usuário do AEM Forms.

Exclua o usuário passando o valor do campo oid do objeto User para o método deleteLocalUser do objeto DirectoryManagerServiceClient.

Consulte também

Chamar o AEM Forms usando SwaRef

Criação de grupos creating-groups

Você pode usar a API do serviço do Gerenciador de diretórios (Java e serviço da Web) para criar grupos do AEM Forms de forma programática. Após criar um grupo, você pode usá-lo para executar uma operação de serviço que exija um grupo. Por exemplo, você pode atribuir um usuário ao novo grupo. (Consulte Gerenciando Usuários e Grupos.)

Resumo das etapas summary_of_steps-2

Para criar um grupo, execute as seguintes etapas:

Incluir arquivos de projeto.
Crie um cliente DiretoryManagerService.
Determine se o grupo não existe.
Crie o grupo.
Execute uma ação com o grupo.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação cliente usando Java, inclua os arquivos JAR necessários.

Os seguintes arquivos JAR devem ser adicionados ao classpath do projeto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (obrigatório se o AEM Forms for implantado no JBoss)
jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss)

Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo arquivos da biblioteca Java do AEM Forms.

Criar um cliente DiretoryManagerService

Antes de executar programaticamente uma operação de serviço do Gerenciador de Diretórios, crie um cliente da API de Serviço do Gerenciador de Diretórios.

Determinar se o grupo existe

Ao criar um grupo, certifique-se de que o grupo não exista no mesmo domínio. Ou seja, dois grupos não podem ter o mesmo nome no mesmo domínio. Para executar essa tarefa, faça uma pesquisa e filtre os resultados da pesquisa com base em dois valores. Defina o tipo de entidade de segurança como com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP para garantir que apenas grupos sejam retornados. Além disso, especifique o nome do domínio.

Criar o grupo

Depois de determinar que o grupo não existe no domínio, crie o grupo e especifique os seguintes atributos:

CommonName: o nome do grupo.
Domínio: o domínio no qual o grupo é adicionado.
Descrição: uma descrição do grupo.

Executar uma ação com o grupo

Depois de criar um grupo, você pode executar uma ação usando o grupo. Por exemplo, você pode adicionar um usuário ao grupo. Para adicionar um usuário a um grupo, recupere o valor do identificador exclusivo do usuário e do grupo. Passe esses valores para o método addPrincipalToLocalGroup.

Consulte também

Criar grupos usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Adição de usuários

Exclusão de usuários

Criar grupos usando a API Java create-groups-using-the-java-api

Crie um grupo usando a API de serviço do Gerenciador de diretórios (Java):

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java.
Crie um cliente DiretoryManagerService.

Crie um objeto DirectoryManagerServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.
Determine se o grupo existe.
- Crie um objeto PrincipalSearchFilter usando seu construtor.
- Defina o tipo de entidade invocando o objeto setPrincipalType do objeto PrincipalSearchFilter. Passe o valor com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP.
- Defina o domínio invocando o objeto setSpecificDomainName do objeto PrincipalSearchFilter. Transmita um valor de string que especifique o nome do domínio.
- Para localizar um grupo, chame o método findPrincipals do objeto DirectoryManagerServiceClient (um principal pode ser um grupo). Transmita o objeto PrincipalSearchFilter que especifica o tipo de entidade e o nome de domínio. Este método retorna uma instância java.util.List em que cada elemento é uma instância Group. Cada instância de grupo está em conformidade com o filtro especificado usando o objeto PrincipalSearchFilter.
- Repita através da instância java.util.List. Para cada elemento, recupere o nome do grupo. Certifique-se de que o nome do grupo não seja igual ao novo nome do grupo.
Crie o grupo.
- Se o grupo não existir, chame o método setCommonName do objeto Group e passe um valor de cadeia de caracteres que especifique o nome do grupo.
- Invoque o método setDescription do objeto Group e passe um valor de cadeia de caracteres que especifique a descrição do grupo.
- Invoque o método setDomainName do objeto Group e passe um valor de cadeia de caracteres que especifique o nome de domínio.
- Invoque o método createLocalGroup do objeto DirectoryManagerServiceClient e passe a instância Group.
O método createLocalUser retorna um valor de cadeia de caracteres que especifica o valor do identificador de usuário local.
Execute uma ação com o grupo.
- Crie um objeto PrincipalSearchFilter usando seu construtor.
- Defina o valor do identificador do usuário invocando o método setUserId do objeto PrincipalSearchFilter. Transmita um valor de string que represente o valor do identificador do usuário.
- Invoque o método findPrincipals do objeto DirectoryManagerServiceClient e passe o objeto PrincipalSearchFilter. Este método retorna uma instância java.util.List, em que cada elemento é um objeto User. Repita através da instância java.util.List para localizar o usuário.
- Adicione um usuário ao grupo invocando o método addPrincipalToLocalGroup do objeto DirectoryManagerServiceClient. Passe o valor de retorno do método getOid do objeto User. Passe o valor de retorno do método getOid dos objetos Group (use a instância Group que representa o novo grupo).

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Gerenciamento de usuários e grupos usando a API Java

Gerenciar usuários e grupos managing-users-and-groups

Este tópico descreve como você pode usar o (Java) para atribuir, remover e consultar domínios, usuários e grupos de forma programática.

NOTE

Ao configurar um domínio, você deve definir o identificador exclusivo para grupos e usuários. O atributo escolhido não só deve ser exclusivo no ambiente LDAP, como também deve ser imutável e não será alterado no diretório. Este atributo também deve ser de um tipo de dados de cadeia de caracteres simples (a única exceção atualmente permitida para o Ative Diretory 2000/2003 é "objectsid", que é um valor binário). O atributo do Novell eDirectory "GUID", por exemplo, não é um tipo de dados de cadeia simples e, portanto, não funcionará.

Para o Ative Diretory, use "objectsid".
Para SunOne, use "nsuniqueid".

NOTE

Não há suporte para a criação de vários usuários e grupos locais enquanto uma sincronização de diretório LDAP estiver em andamento. A tentativa desse processo pode resultar em erros.

Resumo das etapas summary_of_steps-3

Para gerenciar usuários e grupos, execute as seguintes etapas:

Incluir arquivos de projeto.
Crie um cliente DiretoryManagerService.
Chame as operações de usuário ou grupo apropriadas.

Incluir arquivos de projeto

Criar um cliente DiretoryManagerService

Antes de executar programaticamente uma operação de serviço do Gerenciador de Diretórios, você deve criar um cliente de serviço do Gerenciador de Diretórios. Com a API Java, isso é feito criando um objeto DirectoryManagerServiceClient. Com a API do serviço Web, isso é realizado criando um objeto DirectoryManagerServiceService.

Invocar as operações de usuário ou grupo apropriadas

Depois de criar o cliente de serviço, você pode chamar as operações de gerenciamento de usuários ou grupos. O cliente de serviço permite atribuir, remover e consultar domínios, usuários e grupos. Observe que é possível adicionar um diretório principal ou um local principal a um grupo local, mas não é possível adicionar um local principal a um grupo de diretórios.

Consulte também

Gerenciamento de usuários e grupos usando a API do serviço Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Gerenciamento de usuários e grupos usando a API Java managing-users-and-groups-using-the-java-api

Para gerenciar de forma programática usuários, grupos e domínios usando o (Java), execute as seguintes tarefas:

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java. Para obter informações sobre o local desses arquivos, consulte Incluindo arquivos da biblioteca Java do AEM Forms.
Crie um cliente DiretoryManagerService.

Crie um objeto DirectoryManagerServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão. Para obter informações, consulte Definindo propriedades de conexão.
Chame as operações de usuário ou grupo apropriadas.

Para localizar um usuário ou grupo, chame um dos métodos do objeto DirectoryManagerServiceClient para localizar entidades principais (já que uma entidade pode ser um usuário ou grupo). No exemplo abaixo, o método findPrincipals é chamado usando um filtro de pesquisa (um objeto PrincipalSearchFilter).

Como o valor de retorno neste caso é um java.util.List contendo Principal objetos, iterar através do resultado e converter os objetos Principal para objetos User ou Group.

Usando o objeto resultante User ou Group (que ambos herdam da interface Principal), recupere as informações necessárias nos fluxos de trabalho. Por exemplo, os valores de nome de domínio e nome canônico, em combinação, identificam exclusivamente um principal. Eles são recuperados chamando os métodos getDomainName e getCanonicalName do objeto Principal, respectivamente.

Para excluir um usuário local, chame o método deleteLocalUser do objeto DirectoryManagerServiceClient e passe o identificador do usuário.

Para excluir um grupo local, chame o método deleteLocalGroup do objeto DirectoryManagerServiceClient e passe o identificador do grupo.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Gerenciamento de usuários e grupos usando a API do serviço Web managing-users-and-groups-using-the-web-service-api

Para gerenciar de forma programática usuários, grupos e domínios usando a API (serviço da Web) de serviço do Diretory Manager, execute as seguintes tarefas:

Incluir arquivos de projeto.
- Crie um assembly cliente Microsoft .NET que consuma o WSDL do Gerenciador de Diretórios. (Consulte Invocar o AEM Forms usando a codificação Base64.)
- Referencie o assembly do cliente Microsoft .NET. (Consulte Criando um assembly de cliente .NET que use codificação Base64.)
Crie um cliente DiretoryManagerService.

Crie um objeto DirectoryManagerServiceService usando o construtor de sua classe de proxy.

Chame as operações de usuário ou grupo apropriadas.

Para localizar um usuário ou grupo, chame um dos métodos do objeto DirectoryManagerServiceService para localizar entidades principais (já que uma entidade pode ser um usuário ou grupo). No exemplo abaixo, o método findPrincipalsWithFilter é chamado usando um filtro de pesquisa (um objeto PrincipalSearchFilter). Ao usar um objeto PrincipalSearchFilter, entidades locais serão retornadas somente se a propriedade isLocal estiver definida como true. Esse comportamento é diferente do que ocorreria com a API Java.

note note

NOTE

Se o número máximo de resultados não for especificado no filtro de pesquisa (por meio do campo PrincipalSearchFilter.resultsMax), no máximo 1000 resultados serão retornados. Esse comportamento é diferente do que ocorre usando a API do Java, na qual 10 resultados é o máximo padrão. Além disso, os métodos de pesquisa como findGroupMembers não produzirão resultados, a menos que o número máximo de resultados seja especificado no filtro de pesquisa (por exemplo, por meio do campo GroupMembershipSearchFilter.resultsMax). Isso se aplica a todos os filtros de pesquisa que herdam da classe GenericSearchFilter. Para obter mais informações, consulte Referência da API do AEM Forms.

Como o valor de retorno neste caso é um object[] contendo Principal objetos, iterar através do resultado e converter os objetos Principal para objetos User ou Group.

Usando o objeto resultante User ou Group (que ambos herdam da interface Principal), recupere as informações necessárias nos fluxos de trabalho. Por exemplo, os valores de nome de domínio e nome canônico, em combinação, identificam exclusivamente um principal. Eles são recuperados chamando os campos domainName e canonicalName do objeto Principal, respectivamente.

Para excluir um usuário local, chame o método deleteLocalUser do objeto DirectoryManagerServiceService e passe o identificador do usuário.

Para excluir um grupo local, chame o método deleteLocalGroup do objeto DirectoryManagerServiceService e passe o identificador do grupo.

Consulte também

Gerenciamento de funções e permissões usando a API Java

Gerenciamento de funções e permissões managing-roles-and-permissions

Este tópico descreve como você pode usar a API de serviço do Gerenciador de autorização (Java) para atribuir, remover e determinar funções e permissões de forma programática.

No AEM Forms, uma função é um grupo de permissões para acessar um ou mais recursos de nível de sistema. Essas permissões são criadas por meio do Gerenciamento de usuários e são aplicadas pelos componentes de serviço. Por exemplo, um Administrador pode atribuir a função de "Autor de conjunto de políticas" a um grupo de usuários. O Rights Management permitiria então que os usuários desse grupo com essa função criassem conjuntos de políticas por meio do console de administração.

Há dois tipos de funções: funções padrão e funções personalizadas. As funções padrão (funções do sistema) já são residentes na AEM Forms. Pressupõe-se que as funções padrão não possam ser excluídas ou modificadas pelo administrador e, portanto, sejam imutáveis. As funções personalizadas criadas pelo administrador, que pode modificá-las ou excluí-las posteriormente, são mutáveis.

As funções facilitam o gerenciamento de permissões. Quando uma função é atribuída a um principal, um conjunto de permissões é automaticamente atribuído a esse principal, e todas as decisões específicas relacionadas ao acesso para o principal são baseadas nesse conjunto geral de permissões atribuídas.

Resumo das etapas summary_of_steps-4

Para gerenciar funções e permissões, execute as seguintes etapas:

Incluir arquivos de projeto.
Crie um cliente AuthorizationManagerService.
Chame as operações de função ou permissão apropriadas.

Incluir arquivos de projeto

Criar um cliente AuthorizationManagerService

Antes de executar programaticamente uma operação AuthorizationManagerService do Gerenciamento de Usuários, você deve criar um cliente AuthorizationManagerService. Com a API Java, isso é feito criando um objeto AuthorizationManagerServiceClient.

Invocar as operações de permissão ou função apropriadas

Depois de criar o cliente de serviço, você pode chamar as operações de função ou permissão. O cliente de serviço permite atribuir, remover e determinar funções e permissões.

Consulte também

Gerenciamento de funções e permissões usando a API do serviço Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Gerenciamento de funções e permissões usando a API Java managing-roles-and-permissions-using-the-java-api

Para gerenciar funções e permissões usando a API de serviço do Gerenciador de autorização (Java), execute as seguintes tarefas:

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java.
Crie um cliente AuthorizationManagerService.

Crie um objeto AuthorizationManagerServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.
Chame as operações de função ou permissão apropriadas.

Para atribuir uma função a uma entidade de segurança, chame o método assignRole do objeto AuthorizationManagerServiceClient e passe os seguintes valores:
- Um objeto java.lang.String que contém o identificador de função
- Uma matriz de objetos java.lang.String que contém os identificadores de entidade.
Para remover uma função de uma entidade de segurança, chame o método unassignRole do objeto AuthorizationManagerServiceClient e passe os seguintes valores:
- Um objeto java.lang.String que contém o identificador de função.
- Uma matriz de objetos java.lang.String que contém os identificadores de entidade.

Consulte também

Início rápido (modo SOAP): gerenciamento de funções e permissões usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Gerenciamento de funções e permissões usando a API do serviço Web managing-roles-and-permissions-using-the-web-service-api

Gerencie funções e permissões usando a API de serviço do Gerenciador de autorização (serviço Web):

Incluir arquivos de projeto.

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

note note
NOTE
Substitua `localhost` pelo endereço IP do servidor que hospeda o AEM Forms.

Crie um cliente AuthorizationManagerService.
- Crie um objeto AuthorizationManagerServiceClient usando seu construtor padrão.
- Crie um objeto AuthorizationManagerServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Transmita um valor de cadeia de caracteres que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom.) Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.
- Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo AuthorizationManagerServiceClient.Endpoint.Binding. Converter o valor de retorno em BasicHttpBinding.
- Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.
- Ative a autenticação HTTP básica executando as seguintes tarefas:
  - Atribua o nome de usuário dos formulários AEM ao campo AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName.
  - Atribua o valor de senha correspondente ao campo AuthorizationManagerServiceClient.ClientCredentials.UserName.Password.
  - Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.
Chame as operações de função ou permissão apropriadas.

Para atribuir uma função a uma entidade de segurança, chame o método assignRole do objeto AuthorizationManagerServiceClient e passe os seguintes valores:
- Um objeto string que contém o identificador de função
- Um objeto MyArrayOf_xsd_string que contém os identificadores de entidade.
Para remover uma função de uma entidade de segurança, chame o método unassignRole do objeto AuthorizationManagerServiceService e passe os seguintes valores:
- Um objeto string que contém o identificador de função.
- Uma matriz de objetos string que contém os identificadores de entidade.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Autenticando usuários authenticating-users

Este tópico descreve como você pode usar a API de serviço do Authentication Manager (Java) para permitir que seus aplicativos clientes autentiquem usuários de forma programática.

A autenticação do usuário pode ser necessária para interagir com um banco de dados empresarial ou outros repositórios corporativos que armazenam dados seguros.

Considere, por exemplo, um cenário em que um usuário digita um nome de usuário e senha em uma página da Web e envia os valores para um servidor de aplicativos J2EE que hospeda o Forms. Um aplicativo personalizado do Forms pode autenticar o usuário com o serviço do Authentication Manager.

Se a autenticação for bem-sucedida, o aplicativo acessará um banco de dados empresarial seguro. Caso contrário, uma mensagem será enviada ao usuário informando que ele não é um usuário autorizado.

O diagrama a seguir mostra o fluxo lógico do aplicativo.

au_au_umauth_process

A tabela a seguir descreve as etapas deste diagrama

Etapa

Descrição

O usuário acessa um site e especifica um nome de usuário e senha. Essas informações são enviadas a um servidor de aplicativos J2EE que hospeda o AEM Forms.

As credenciais do usuário são autenticadas com o serviço do Authentication Manager. Se as credenciais do usuário forem válidas, o workflow continuará na etapa 3. Caso contrário, uma mensagem será enviada ao usuário informando que ele não é um usuário autorizado.

As informações do usuário e um design de formulário são recuperados de um banco de dados corporativo seguro.

As informações do usuário são mescladas com um design de formulário e o formulário é renderizado para o usuário.

Resumo das etapas summary_of_steps-5

Para autenticar programaticamente um usuário, execute as seguintes etapas:

Incluir arquivos de projeto.
Criar um cliente AuthenticationManagerService.
Chame a operação de autenticação.
Se necessário, recupere o contexto para que o aplicativo cliente possa encaminhá-lo para outro serviço do AEM Forms para autenticação.

Incluir arquivos de projeto

Criar um cliente AuthenticationManagerService

Antes de autenticar programaticamente um usuário, você deve criar um cliente AuthenticationManagerService. Ao usar a API Java, crie um objeto AuthenticationManagerServiceClient.

Invocar a operação de autenticação

Depois de criar o cliente de serviço, você pode chamar a operação de autenticação. Esta operação necessitará de informações sobre o usuário, como o nome e a senha do usuário. Se o usuário não se autenticar, uma exceção será lançada.

Recuperar o contexto de autenticação

Depois de autenticar o usuário, você pode criar um contexto com base no usuário autenticado. Em seguida, você pode usar o conteúdo para chamar outros serviços da AEM Forms. Por exemplo, você pode usar o contexto para criar um EncryptionServiceClient e criptografar um documento PDF com uma senha. Verifique se o usuário autenticado tem a função de nome Services User que é necessária para invocar um serviço AEM Forms.

Consulte também

Criptografar documentos PDF com senha

Autenticar um usuário usando a API Java authenticate-a-user-using-the-java-api

Autentique um usuário usando a API de serviço do Authentication Manager (Java):

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar, no caminho de classe do projeto Java.
Crie um cliente AuthenticationManagerServices.

Crie um objeto AuthenticationManagerServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.
Chame a operação de autenticação.

Invoque o método authenticate do objeto AuthenticationManagerServiceClient e passe os seguintes valores:
- Um objeto java.lang.String que contém o nome do usuário.
- Uma matriz de bytes (um objeto byte[]) contendo a senha do usuário. Você pode obter o objeto byte[] invocando o método getBytes do objeto java.lang.String.
O método authenticate retorna um objeto AuthResult, que contém informações sobre o usuário autenticado.
Recuperar o contexto de autenticação.

Invoque o método getContext do objeto ServiceClientFactory, que retornará um objeto Context.

Em seguida, chame o método initPrincipal do objeto Context e passe o AuthResult.

Autenticar um usuário usando a API do serviço Web authenticate-a-user-using-the-web-service-api

Autentique um usuário usando a API de serviço do Authentication Manager (serviço da Web):

Incluir arquivos de projeto.
- Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Authentication Manager. (Consulte Invocar o AEM Forms usando a codificação Base64.)
- Referencie o assembly do cliente Microsoft .NET. (Consulte "Referenciando o assembly do cliente .NET" em Chamando o AEM Forms usando a codificação Base64.)
Criar um cliente AuthenticationManagerService.

Crie um objeto AuthenticationManagerServiceService usando o construtor de sua classe de proxy.
Chame a operação de autenticação.

Invoque o método authenticate do objeto AuthenticationManagerServiceClient e passe os seguintes valores:
- Um objeto string que contém o nome do usuário
- Uma matriz de bytes (um objeto byte[]) contendo a senha do usuário. Você pode obter o objeto byte[] convertendo um objeto string contendo a senha em uma matriz byte[] usando a lógica mostrada no exemplo abaixo.
- O valor retornado será um objeto AuthResult, que pode ser usado para recuperar informações sobre o usuário. No exemplo abaixo, as informações do usuário são recuperadas obtendo-se primeiro o campo authenticatedUser do objeto AuthResult e, subsequentemente, os campos canonicalName e domainName do objeto User resultante.

Consulte também

Chamar o AEM Forms usando SwaRef

Sincronização programática de usuários programmatically-synchronizing-users

Você pode sincronizar usuários de forma programática usando a API de gerenciamento de usuários. Ao sincronizar usuários, você está atualizando o AEM Forms com dados do usuário que estão no repositório do usuário. Por exemplo, suponha que você adicione novos usuários ao repositório de usuários. Após executar uma operação de sincronização, os novos usuários se tornam usuários de formulários AEM. Além disso, os usuários que não estão mais no repositório de usuários são removidos do AEM Forms.

O diagrama a seguir mostra a sincronização do AEM Forms com um repositório de usuário.

ps_ps_umauth_sync

A tabela a seguir descreve as etapas deste diagrama

Etapa

Descrição

Um aplicativo cliente solicita que o AEM Forms execute uma operação de sincronização.

O AEM Forms executa uma operação de sincronização.

As informações do usuário são atualizadas.

Um usuário pode exibir as informações atualizadas do usuário.

Resumo das etapas summary_of_steps-6

Para sincronizar usuários programaticamente, execute as seguintes etapas:

Incluir arquivos de projeto.
Crie um cliente UserManagerUtilServiceClient.
Especifique o domínio enterprise.
Chame a operação de autenticação.
Determine se a operação de sincronização foi concluída

Incluir arquivos de projeto

Criar um UserManagerUtilServiceClientclient

Antes de sincronizar usuários programaticamente, você deve criar um objeto UserManagerUtilServiceClient.

Especificar o domínio da empresa

Antes de executar uma operação de sincronização usando a API de Gerenciamento de Usuários, especifique o domínio enterprise ao qual os usuários pertencem. Você pode especificar um ou vários domínios enterprise. Antes de executar programaticamente uma operação de sincronização, é necessário configurar um domínio enterprise usando o Console de Administração. (Consulte ajuda administrativa.)

Invocar a operação de sincronização

Após especificar um ou mais domínios enterprise, você pode executar a operação de sincronização. O tempo necessário para executar essa operação depende do número de registros de usuários que estão no repositório do usuário.

Determine se a operação de sincronização está concluída

Após executar programaticamente uma operação de sincronização, você pode determinar se a operação está concluída.

Consulte também

Inclusão de arquivos da biblioteca Java do AEM Forms

Criptografar documentos PDF com senha

Sincronização programática de usuários usando a API Java programmatically-synchronizing-users-using-the-java-api

Sincronizar usuários usando a API de gerenciamento de usuários (Java):

Incluir arquivos de projeto.

Inclua arquivos JAR do cliente, como adobe-usermanager-client.jar e adobe-usermanager-util-client.jar, no caminho de classe do projeto Java.
Crie um cliente UserManagerUtilServiceClient.

Crie um objeto UserManagerUtilServiceClient usando seu construtor e transmitindo um objeto ServiceClientFactory que contenha propriedades de conexão.
Especifique o domínio enterprise.
- Invoque o método scheduleSynchronization do objeto UserManagerUtilServiceClient para iniciar a operação de sincronização de usuário.
- Crie uma instância java.util.Set usando um construtor HashSet. Certifique-se de especificar String como o tipo de dados. Esta instância Java.util.Set armazena os nomes de domínio aos quais a operação de sincronização se aplica.
- Para cada nome de domínio a ser adicionado, chame o método add do objeto java.util.Set e passe o nome de domínio.
Chame a operação de sincronização.

Invoque o método getContext do objeto ServiceClientFactory, que retornará um objeto Context.

Em seguida, chame o método initPrincipal do objeto Context e passe o AuthResult.

Consulte também

Sincronização programática de usuários

Inclusão de arquivos da biblioteca Java do AEM Forms