Histórico da Página
...
icon | false |
---|
...
id | 1 |
---|
...
label | 1º - Instalar e configurar o Application Request Routing (ARR) |
---|
1° - Instalar e configurar o "Application Request Routing" (ARR)
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)
Aviso |
---|
Caso tenha configurado o Novo Portal do professor, não é necessário realizar esse processo. |
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.
...
label | 2º - Instalar e configurar o URL Rewrite |
---|
2° - Instalar e configurar o URL Rewrite
...
effectDuration | 0.1 |
---|---|
id | temp |
effectType | fade |
...
label | Instalação |
---|---|
effectType | fade |
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
...
label | Configuração Rewrite |
---|---|
effectType | fade |
É necessário configurar duas regras para o rewrite, onde a primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado e a segunda é utilizada para as api's onde é necessário passar o alias selecionado. Segue a configuração das duas regras:
Aviso |
---|
A configuração é realizada exclusivamente no Portal do Professor em: Sites | Default Web Site | FrameHTML | Web | App |Edu | PortalDoProfessor. Caso a configuração não seja realizada no caminho especificado anteriormente, o portal do Aluno poderá ser impactado. |
1º Regra:
1. Acessar o IIS -> Acessar o Portal do professor (FrameHTML | Web | App |Edu | PortalDoProfessor) Clicar no site 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.
Inserir as informações:
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"
2º Regra:
1. Acessar o IIS -> Ir no aplicativo do 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.
Inserir as informações:
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}
Aviso | ||
---|---|---|
| ||
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 deve ser respeitada. |
...
label | Configuração do config |
---|---|
effectType | fade |
- 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" />
Aviso | ||
---|---|---|
| ||
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. |
Nota | ||
---|---|---|
| ||
Em servidor publicado, na TAG: "SubDomainMask" utilizar o DNS. |
...
icon | false |
---|
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.
...
O portal do portal gestão educacional deve ser configurado seguindo os passos da documentação: Configuração dos novos portais