Linha RM

Atalhos

Páginas filhas
  • Configuração dos novos portais

Versões comparadas

Versão antiga 55

changes.mady.by.user Alexandra Moura Fernandes

Gravado em

comparado com

Nova versão 56

changes.mady.by.user Alexandra Moura Fernandes

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
title1- Pré-requisitos

Como requisito para o funcionamento dos portais é necessário instalar o URL Rewrite e ARR (Application Request Routing) no IIS.


Expandir
titleARR (Application Request Routing)

A instalação deve ser realizada no servidor do portal desejado.

Link para download do ARR:  https://www.microsoft.com/en-us/download/details.aspx?id=47333 


Aviso
titleApenas uma vez para cada IIS

A instalação deve ser realizada apenas uma vez para cada IIS.

Aviso
titleHabilitar o proxy

Após finalizar a instalação ARR (Application Request Routing), deverá ser habilitado a propriedade "Enable proxy"





Expandir
titleURL Rewrite

A instalação deve ser realizada no servidor do portal desejado.


Aviso
titleAtenção

A partir da versão 12.1.2402


É possível utilizar as api's do host diretamente, sem o uso do módulo do URL Rewrite. Para isso deve expor o host para a web e informar o endereço do host nos arquivos de config dos portais.

Importante ficar atento a questões de segurança ao expor o host para a web. A forma como será utilizado fica a critério da instituição.

Deck of Cards
effectDuration0.1
idtemp
effectTypefade
Card
labelInstalação
effectTypefade

A instalação deve ser realizada no servidor do portal desejado.

Link para download do URL Rewrite: https://www.iis.net/downloads/microsoft/url-rewrite


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


Essa configuração é necessária para que as salas sejam exibidas no menu: Mensagens | Sala de Atendimento. Para mais detalhes Parametrização da Sala de Atendimento no App: Meu eduCONNECT

Card
labelConfiguração Rewrite
effectTypefade

Deve ser necessário configurar duas regras para o URL Rewrite:

  • A 1º regra (regra comum para todas as versões) é utilizada para direcionamento de API onde não é necessário passar o alias selecionado;
  • A 2º regra (apenas para versões anteriores à 12.1.2402) é utilizada para as API onde é necessário passar o alias selecionado.

 

Aviso
titleExclusivamente para os novos portais

A configuração deve ser realizada exclusivamente nos portais: Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor em: Sites | Default Web Site | FrameHTML | Web | App |Edu | 'Pasta referente ao portal'. Caso a configuração não seja realizada no caminho especificado anteriormente, o portal do Aluno poderá ser impactado.

Aviso
titleA ordem das regras deve ser respeitada.

A ordem das regras deve ser respeitada.

Informações
titleRegra comum para todas as versões

1. Acessar o IIS -> Ir no aplicativo que está sendo configurado (Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor) -> URL Rewrite


2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.


3. No campo "Name" informar um nome para a regra que está sendo criada


4. Na opção: Match URL, no campo: "Pattern" inserir as informação: api/(.*)


5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}

 

Informações
titleRegra adicional necessário para versões anteriores a 12.1.2402

Para as versões anteriores à 12.1.2402 é necessário configurar uma nova regra


Aviso
titleAtenção

A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host RM.Host.Service.exe.config. 


1. Acessar o IIS -> Ir no aplicativo que está sendo configurado (Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor) -> URL Rewrite


 2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.


 3. No campo "Name" informar um nome para a regra que está sendo criada


 4. Na opção: Match URL, no campo: "Pattern" inserir as informação: aliasname\.(.*)/api/(.*)

5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://{R:1}.nome_da_maquina_do_host:porta/api/{R:2}

6. Marcar a opção: "Stop processing of subsequent rules"

Card
labelConfiguração Rewrite TOTVS Educa Mobile (exibição das Salas no App)
effectTypefade
Aviso
iconfalse

Para que a comunicação entre o Portal Gestão Educacional e o App: Meu eduCONNECT possa ocorrer normalmente, é necessário que a porta da API configuração do Rewrite do Portal Gestão Educacional e do TOTVS Educa Mobile estejam na mesma porta.

1. Acessar o IIS -> Ir no aplicativo que está sendo configurado EducaMobile -> URL Rewrite

Image Removed

2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule

Image Removed

Image Removed

3. No campo "Name" informar o endereço:  TOTVS_API_ReverseProxyInboundRule

Image Removed

4. Na opção: Match URL, no campo "Pattern" inserir a informação: (.*)

Image Removed

5. Na opção: "Conditions", clicar no botão: Add. e inserir a informação: {REQUEST_URI}  /api/(.*)

Image Removed

6. Na opção: "Actions", no campo: Rewrite URL informar o link: http://localhost:8052/{R:1}

Importante:

  • A URL a ser utilizada é a do servidor onde encontra-se instalado o Host, como exemplo, utilizamos o endereço http://IPdoServidorHost:8052/{R:1} 
    • Em alguns casos o servidor do Host é diferente do servidor Web, então neste caso, deve-se utilizar o endereço do servidor do Host. 
  • Verificar a porta configurada na tag ApiPort do arquivo de configuração do Host, como exemplo, utilizamos a porta 8052.
  • Em alguns cliente a parte da URL {R:1} é substituído por {C:0}

Verificar qual é a parte da URL {R:1} ou {C:0}

Image Removed

Image Removed

Utilizar o endereço http://EndereçodoServidorWeb/EducaMobile/api/framework/v1/menus/dd6626a5aa1e3c2c2ad79198824f67a4?$filter=tagMenu eq '808100759'&companyId=1

Image Removed

Image Removed

7. Em seguida, clicar no botão: Aplicar

Image Removed

Expandir
title2- Configurar aquivo de config do Host do RM

Após configurar o servidor conforme o item: 1- Pré-requisitos, é necessário configurar o arquivo de configuração do Host do RM. Para isso, acesse o arquivo RM.Host.Service.exe.config que está disponível no caminho padrão do instalador do RM.exe.

Inserir as chaves as chaves abaixo:

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


Aviso
titleVersão anteriores à 12.1.2402

Inserir a chave abaixo:

<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.

Aviso
iconfalse
titleUsuário associado ao serviço

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


...