1° - Instalar e configurar o "Application Request Routing" (ARR)

Caso tenha instalado e configurado o Application Request Routing (ARR) para o Novo Portal do professor ou Portal Gestão Educacional, não é necessário realizar esse processo.

Realizar o download do ARR no link  https://www.microsoft.com/en-us/download/details.aspx?id=47333. 

1- Acessar o IIS, selecionar a Guia principal e dar um duplo click sobre o ícone: Application Request Routing (ARR)

Será habilitado a opção: Ações | Abrir Proxy

Será habilitado algumas opções, e clicar no link: Proxy | Server Proxy Settings

Marcar o Checkbbx: Enable proxy e em seguida, clicar em aplicar.


2° - Instalar e configurar o URL Rewrite

Caso tenha instalado o Rewrite para o Novo Portal do professor ou Portal Gestão Educacional, não é necessário realizar esse processo.
Será necessário realizar apenas a configuração para o Portal Gestão Educacional (Ir para a Aba: Configuração Rewrite).

1. Acessar o IIS (como administrador) | Clicar na opção: "Obter Novos Componentes Web Plataform"

    2. Em seguida, será habilitado uma tela, onde serão carregados as plataformas Web.

3. Pesquisar por “URL Rewrite” e clicar na opção: Add:

4. Após a Instalação, será criado um ícone: “URL Rewrite” no IIS


O Portal E-commerce de cursos utiliza três regras para o rewrite, onde a primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado, a segunda é utilizada para as api's onde é necessário passar o alias selecionado e a terceira regra, onde é utilizando a comunicação entre o Portal Gestão Educacional e o app Meu eduCONNECT .Segue a configuração das três regras:

1- URL

  • Campo: Partten : aliasname\.(.*)/api/(.*)
  • Campo: Rewrite URL: http://{R:1}.informe_aqui_o_nome_da_máquina:informe_a_apiport/api/{R:2}

                                        Exemplo: http://{R:1}.192.168.98.34:8052/api/{R:2}

2- API

                                        Exemplo: http://192.168.98.34:8052/api/{R:1}


A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host (RM.Host.Service.exe.config, se utilizar o Host Service e RM.Host.exe.config, se utilizar o Host local). Ver a aba Configurações do config.  A ordem das regras deverão ser respeitadas.

  • Acessar o RM.Host.Service.exe.config (Se o cliente utilizar o Host Service) ou  RM.Host.exe.config (Se o cliente utilizar o Host local)  na Pasta: Totvs\RM.Net\Bin da versão e inserir as chaves:

       <add key="ApiPort" value="porta_definida_no_rewrite (IIS)" />

      <add key="DefaultDB" value="informe_aqui_o_nome_do_alias" />

      <add key="SubDomainMask" value="[ALIAS].nome_da_máquina_do_host" />


Para a opção "SubDomainMask", o nome da máquina deve ser inserido todo utilizando letras minúsculas. O texto [ALIAS] não deve ser alterado, deve ser inserido o texto desta forma, o que deve ser alterado é o "nomeDaMaquinaDoHost". Exemplo: a máquina do host possui o nome de ServerXYZ, desta forma, deve ser inserido o texto [ALIAS].serverxyz.

Em servidor publicado, na TAG: "SubDomainMask" utilizar o DNS.

Se utilizar do rm.host, atentar para executa-lo como administrador.

Se utilizar o host.service, o usuário associado ao serviço tem que ter permissão para acessar a porta da API definida no URL Rewrite.