Versões comparadas

Chave

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

...

Aviso

Config Global para o Portal Corpore.Net

Para o cenário que utiliza a configuração config global, é necessário realizar as alterações no arquivo do config global, pois quando está usando este recurso, ele sobrescreve todas as informaçõesdo web.config do portal Corpore.NET. Saiba mais sobre Config Global 


Adicionar a seguinte tag

<add key="NomePastaInstalacaoPortalEducacional" value="web" />


O endereço da FrameHTML em Totvs Gestão Educacional | Ambiente | Parâmetros | Parâmetros Globais | FrameHTML no campo "Defina o endereço da FrameHTML" não acrescentar a informação "/web" no final do endereço


Informações

O ambiente da TCLOUD normalmente utiliza o config global, e desta forma é necessário realizar o procedimento acima para o correto funcionamento.

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"


Image Added


Image Added


Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added


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

Image Added

 

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

Image Added


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

Image Added


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

Image Added


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

Image Added

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"

Image Added


Após estas configurações, acessar o novo portal através do link: http://LOCAL_DE_INSTALAÇÃO/FrameHTML/web/app/edu/portaleducacional/login

...