Vejamos um exemplo de uso da API. Como vimos, os agentes imobiliários de nosso aplicativo podem ingressar e visualizar as propriedades que possuem em

Transcrição

1 Uso da API do GAM Nos vídeos anteriores, vimos como construir um aplicativo para uma imobiliária, com uma parte Web e uma parte para Smart Devices. E, em seguida, vimos como resolver a Segurança de ambos os aplicativos, utilizando para isso o GAM, GeneXus Access Manager, configurando a propriedade a nível da Versão, Enable Integrated Security com o valor True.

2 O GAM é o módulo de Segurança desse verso GX, que resolve os problemas de autenticação e autorização, tanto para aplicativos Web como para aplicativos Smart Devices. O que se pretende com o GAM é que a solução de Segurança seja utilizada da forma mais declarativamente possível. E isso se consegue facilmente, já que o GAM é um Módulo de Segurança desenvolvido em uma KB GX, que se integra a nosso aplicativo e permite resolver de maneira centralizada todo o referente à Segurança da mesma. Além disso, o GAM expõe uma API para acessar diferentes métodos e propriedades em caso de que seja necessário fazê-lo do nosso aplicativo para a KB do GAM.

3 O acesso às propriedades e métodos da API é realizado através de external objects, que são importados ao habilitar o GAM em nosso aplicativo, e podemos realizar diferentes ações, como por exemplo Obter o usuário que está logueado em caso de necessitarmos utilizálo do centro de nosso aplicativo, ou, em vez do nome, talvez seja necessário acessar seu endereço ou qualquer outra informação relacionada com o usuário Também poderíamos necessitar dos tipos de autenticação configurados em nosso aplicativo Ou, talvez, poderíamos precisar das licenças associadas a um papel, para realizar alguma ação com eles dentro do nosso aplicativo

4 Vejamos um exemplo de uso da API. Como vimos, os agentes imobiliários de nosso aplicativo podem ingressar e visualizar as propriedades que possuem em venda ou aluguel, acessando o aplicativo para Smart Devices, dos seus dispositivos. Mas, como a Transação Property é a única para todos os agentes imobiliários, devemos identificar o agente que registra uma propriedade no sistema. É por isso que devemos armazenar na Transação Property, a identificação do agente imobiliário que registra a propriedade. Além disso, na List de Propriedades que é exibida no aplicativo para Smart Devices, pede-se que os agentes imobiliários só visualizem os registros feitos por eles e não a informação registrada por outro agente.

5 Já criamos o nosso aplicativo Web e Smart Devices para a imobiliária. Como podemos ver, nosso aplicativo tem o GAM aplicado.

6 Vamos agora à Transação Property a definir um novo atributo que nos permita armazenar o usuário que tentar fazer log in através do GAM. Este atributo se chamará UserID e será do tipo GAMUserIdentification. Vejamos que este tipo GAMIserIdentification é um domínio que é importado junto com os objetos do GAM. Nas regras da Transação, declaramos Equal(UserId, GetUser()); Desta forma, o que estamos fazendo é capturar a informação do usuário que está logueado e esta informação guardará na Transação Property o momento de registrar uma propriedade. Quanto a GetUser, trata-se de um procedimento que tem declarada a seguinte regra Parm e cuja lógica nos permite capturar o usuário que está logueado em nosso aplicativo. GAMUser é uma variável estática que instancia a informação do usuário logueado, podendo utilizar métodos associados como GetName, Get , etc. para obter a informação relacionada. Neste caso, utilizamos o método GetName para obter o nome do usuário logueado. Desta forma, ao registrar uma nova Propriedade ao aplicativo, será obtida a informação do agente imobiliário logueado e esta informação será salva na tabela no momento de confirmar o registro.

7 Vejamos agora o que devemos fazer para que da List de Propriedades do aplicativo para Smart Devices, cada agente imobiliário veja somente as suas propriedades. Para isso, criamos o Data Selector que estamos vendo. Observemos que o procedimento GetUser é o que criamos recentemente. Vamos agora ao Work With Devices Properties, selecionamos a List e no grid vamos à propriedade Data Selector e associamos ao Data Selector nossa criação recente. Já estão prontas todas as mudanças em GeneXus. Dessa forma, pressionamos F5. Primeiro é executada a reorganização para adicionar o novo atributo UserId à transação Property. Vamos logueá-lo com o usuário agency01 para registrar uma nova propriedade. Observemos primeiro que já existem duas propriedades registradas. Uma delas tem nome de usuário admin e a outra tem nome de usuário agency01.

8 O nome da propriedade é Utopia, colocamos a data, o endereço, vamos localizar a imagem, o bairro onde se encontra, que é Coral Gable, e vamos ver que, ao pressionar o botão Confirm, aparece efetivamente o usuário agency01 como o responsável do registro dessa propriedade. Vamos agora ao aplicativo para Smart Devices, vamos nos loguear com o usuário agency01, para ver que efetivamente as propriedades que visualizamos são as registradas por esse agente imobiliário. Vamos à List of Properties e vemos efetivamente as duas propriedades registradas por este agente.

9 Desta forma, ter habilitado o GeneXus Access Manager no nosso aplicativo, nos permitiu fazer uso dos métodos e propriedades da API facilmente e, assim, obter informação sobre o GAM e poder utilizá-la a partir do nosso aplicativo. Ou seja, a API nos permitiu estender a funcionalidade dos mecanismos de segurança previstos pelo GAM.