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, em anexo, um 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. Aviso |
---|
icon | false |
---|
title | Importante: |
---|
| É recomendável que a AC escolhida para gerar o certificado já esteja no diretório de autoridades confiáveis raiz, do gerenciamento de certificados do computador, pois desta forma não será necessário importar a AC em todas as máquinas clientes. |
Salve o certificado no servidor e instale-o conforme imagens abaixo: Informações |
---|
| Deck of Cards |
---|
|
Processo de Instalação: Card |
---|
| ![](/download/attachments/520100384/image2016-8-19%209%3A36%3A48.png?version=1&modificationDate=1572629943950&api=v2&effects=drop-shadow)
|
Card |
---|
| ![](/download/attachments/520100384/image2016-8-19%209%3A37%3A35.png?version=1&modificationDate=1572629943770&api=v2&effects=drop-shadow) |
Card |
---|
| ![](/download/attachments/520100384/image2016-8-19%209%3A37%3A42.png?version=1&modificationDate=1572629943207&api=v2&effects=drop-shadow) |
Card |
---|
| ![](/download/attachments/520100384/image2016-8-19%209%3A37%3A49.png?version=1&modificationDate=1572629942813&api=v2&effects=drop-shadow) |
Card |
---|
| ![](/download/attachments/520100384/image2016-8-19%209%3A37%3A59.png?version=1&modificationDate=1572629942540&api=v2&effects=drop-shadow) |
Card |
---|
| 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: ![](/download/attachments/520100384/image2016-8-19%209%3A38%3A54.png?version=1&modificationDate=1572629941847&api=v2&effects=drop-shadow)
![](/download/attachments/520100384/image2016-8-19%209%3A39%3A9.png?version=1&modificationDate=1572629941177&api=v2&effects=drop-shadow)
|
|
|
<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:
![](/download/attachments/520100384/thumb.png?version=4&modificationDate=1644608851240&api=v2) - Informar a tag DEFAULTDB com o alias da base de dados. Exemplo:
![](/download/attachments/520100384/defaultdb.png?version=1&modificationDate=1572875791463&api=v2)
- Informar a tag HTTPPORT com o endereço da porta utilizada para consumir serviços HTTP do host. Exemplo:
![](/download/attachments/520100384/httpport.png?version=1&modificationDate=1572875842570&api=v2)
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.
![](/download/attachments/520100384/swagger.png?version=1&modificationDate=1572871936493&api=v2)
- 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.
![](/download/attachments/520100384/postman.png?version=3&modificationDate=1572876000703&api=v2)
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:
![](/download/attachments/520100384/content-type.png?version=2&modificationDate=1572876242870&api=v2)
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 |