O app Meu Imóvel permite aos usuários do TOTVS Construção Gestão de Imóveis, acessar suas funcionalidades com uma melhor usabilidade e adaptável a vários dispositivos mobile como tablets e smartphones. Está disponível na Play Store, para dispositivos Android e na App Store para iPhones.

Clique nos logos abaixo para ser redirecionado para a página de download do seu sistema operacional:

Para o funcionamento correto do aplicativo Meu Imóvel, é necessário que o RM.Host.Service.config esteja devidamente configurado, pois o mesmo conterá informações necessárias para o consumo de serviços do aplicativo. Sem o RM.Host.exe iniciado e o RM.Host.Service.config configurado, o aplicativo não consegue realizar requisições ao servidor de aplicação. 

Índice

• 1) Instalação do Certificado no Servidor
• 2) Configuração de tags no arquivo RM.Host.Service.config
• 3) Testando a instalação e configuração
• 4) Considerações finais

1) Instalação do Certificado no Servidor

      Um certificado digital pode ser adquirido através de uma autoridade certificadora (AC), são facilmente encontradas na web, mas também é possível gerar certificados digitais auto assinados.

      Existem várias maneiras de se gerar um certificado digital auto assinado. Abaixo alguns links para ajuda e um certificado auto assinado (Clique aqui para baixar) que pode ser utilizado para cifrar a comunicação, lembrando que o recomendado é que seja adquirido um através de uma AC.

• PowerShell

• IIS

• Open SSL

       Salve o certificado no servidor e instale-o conforme imagens abaixo:

Processo de Instalação:

 

 

 

 

 Abra o gerenciamento de certificados do computador (certlm.msc) como administrador e dê permissão para o usuário do Host nas chaves privadas do certificado:

 Abra o certificado e copie a impressão digital (thumbprint no inglês) e armazene:

Em seguida, gere um GUID através do site https://www.guidgenerator.com/online-guid-generator.aspx e também armazene para ser utiliza-lo nos próximos passos.

2) Configuração de tags no arquivo RM.Host.Service.config

<add key="JWTCERTIFICATETHUMBPRINT" value="b4def01ef76a1ff154faef805e6eafce3d411459" />
- o valor do campo "value" é exatamente o valor do GUID que está contido na Impressão Digital.

<add key="DefaultDB" value="CorporeRM" />
<add key="HttpPort" value="8028" />

Na seção <appSettings>, informe as seguintes tags.

•       Informar a tag JWTCERTIFICATETHUMBPRINT com o GUID gerado acima. Exemplo:

•      Informar a tag DEFAULTDB com o alias da base de dados. Exemplo:

•      Informar a tag HTTPPORT  com o endereço da porta utilizada para consumir serviços HTTP do host. Exemplo:

3) Testando a instalação e configuração

Para garantir que a instalação do certificado a configuração das tags foram bem sucedidas, recomenda-se reiniciar o RM.Host e realizar os seguintes testes:

• Utilizando o navegador, acessar o seguinte endereço:  http://{url do ambiente}/api/swagger/ui/index.  Como no exemplo abaixo, caso a resposta seja uma tela semelhante, significa que o ambiente de API's está ativo e respondendo conforme esperado.

• Utilizando uma ferramenta de teste de API, tal como Postman,  realize uma requisição POST para o endereço http://{url do ambiente}/api/connect/token. Como no exemplo abaixo, caso a resposta seja uma tela semelhante, significa que a autenticação no ambiente de API's está funcionando corretamente.

Observações:

• Para este teste, atente-se às opções destacadas na imagem acima. Neste caso foi utilizado como exemplo o usuário "mestre".
• Na aba "Headers", deve-se informar as seguintes opções: 

4) Considerações finais

Importante garantir também que os parâmetros do aplicativo sejam configurados corretamente, para tanto, siga as instruções no link abaixo.

Meu Imóvel - Parâmetros do Aplicativo

Índice

• 1) Passo a passo da configuração
• 2) Termos e Condições

1) Passo a passo da configuração

Vamos seguir esta pequena introdução com as telas iniciais do aplicativo e realizar sua primeira configuração. Lembrando que a configuração é a mesma, tanto para dispositivos Android ou iOS.

Esta é a primeira tela do aplicativo, e é exibida sempre em sua inicialização.

No primeiro momento em que abrimos o aplicativo, teremos acesso a tela de Boas Vindas, com a primeira configuração de acesso a ser realizada. neste momento poderemos escanear o QR Code, na opção "Configurar com o QRCode" e outra opção manual, "Não Tenho o QRCode, e agora?" caso não possua o QR Code disponível.

Iremos detalhar estas opções logo abaixo.

• Configurar com o QR Code: Realizar a leitura do QR Code que será disponibilizado na interface do Portal do Cliente, menu "Configurar App". Após a leitura do mesmo através deste menu, será apresentada nova tela para que seja digitada a senha do usuário. 

QR Code sendo apresentado ao usuário no menu "Configurar APP" do PDC.

• Não tenho o QR Code: Caso não possua acesso ao QR Code, pode-se realizar a configuração manualmente, inserindo a URL de acesso ao Portal do Cliente como mostra a imagem abaixo.

• Endereço (URL): Url de acesso ao Portal do Cliente. É a mesma url que utilizamos para acessar o PDC normalmente via browser. 

Ao clicar em Concluir, após o preenchimento da URL corretamente, ou caso a configuração tenha sido feita via QRCode, o usuário será direcionado para a tela de login onde deverá informar o usuário e a senha de acesso, bem como parametrizar a biometria para facilitar os seus acessos.

• CPF ou Usuário: Seu usuário de acesso ao Portal;
• Senha: Sua senha de acesso ao Portal;
• Leitor biométrico: Esta opção estará disponível para os celulares que possuam algum tipo de leitor biométrico, facilitando o login. Ao ativar a opção "Leitor biométrico" o aplicativo necessitará ainda das configurações de usuário e senha para um primeiro acesso.
  Após confirmar a opção de login através da biometria o sistema não necessitará da senha para logar. A interface será alterada para refletir esta mudança:
  

Não esquecer de informar o caminho de URL externo nos Parâmetros do Portal no TCGI. Mesma Porta do HOST.

2) Termos e Condições

Feitas estas configurações iniciais, o usuário estará pronto para acessar o aplicativo Meu Imóvel e consultar seus boletos, verificar o status da obra, ver seus comunicados e relatórios pertinentes.