Versões comparadas

Chave

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

ÍNDICE

  1. Visão Geral
  2. Exemplo de utilização

01. VISÃO GERAL

O Totvs Geteway Manager é um centralizador de requisições (ponto único de acesso), que realiza a analise, a filtragem e redirecionamento do tráfego de terceiros entre os hosts ativos.

As funções presentes no API Gateway permitem as mais diversas vantagens para quem o utiliza. Um único ponto de acesso, por exemplo, significa uma redução de esforço em administrar as "portas de entradas" dos serviços utilizados, podendo focar seus esforços em um único local.

As funções presentes no API Manager fornecem uma camada de gestão para o API Gateway. Além de definir o comportamento do API Gateway, o API Manager lida com a análise de cada requisição.


02. EXEMPLO DE UTILIZAÇÃO

Exemplo do Comportamento Antigo (até a versão 12.1.24):

  • Acessar o aplicativo "RM.Host.ServiceManager.exe" e adicionar a quantidade de serviços desejada.

  • Em seguida era necessário a configuração do arquivo "RM.exe.Config", configurando todos os hosts e portas adicionadas no "RM.Host.ServiceManager.exe", para que houvesse o balanceamento nativo (distribuição das requisições entre os hosts). 


Exemplo do Comportamento Atual (a partir da versão 12.1.25):
 
Descrição dos Campos:

  • Instalar TGM: Opção para que o serviço do Totvs Gateway Manager seja instalado na maquina que está sendo utilizada. 
  • Caminho completo do arquivo: Caminho onde está instalado o executável do Totvs Gateway Manager.
  • Porta do TGM: Porta para disponibilização do endpoint do serviço rest para configuração do TGM.
  • Porta de HTTP: Porta onde o TGM irá receber requisições HTTP e redirecionar para os Hosts cadastrados para responder HTTP.
  • Porta de TCP: Porta onde o TGM irá receber requisições TCP e redirecionar para os Hosts cadastrados para responder TCP.
  • Porta de PING: Porta onde o TGM irá realizar a resiliência do NGINX.
  • Utilizar TGM em outra maquina: Opção dada ao usuário para que o Totvs Gateway Manager seja instalado em outra maquina (informando Host:Porta).

Passo a passo para configuração do TGM (Totvs Gateway Manager):

  1. Acessar o aplicativo "RM.Host.ServiceManager.exe" e adicionar a quantidade de serviços desejada.
  2. Acessar a aba "Totvs Gateway Manager" e ,marcar a opção "Instalar TGM". 
  3. Em seguida, clique para instalar  nas operações do serviço TGM.
  4. Apo´s realizada a instalação, configure as portas HTTP e TCP e clique em "Aplicar".
  5. Verifique que o TGM foi instalado corretamente, como mostra a imagem disponível abaixo:

Utilização do TGM em outra máquina:

  1. Marcar a opção "Utilizar TGM em outra maquina" e preencher o campo com "Host:Porta" da maquina que será utilizada para a instalação do TGM.
  2. Alterar o arquivo "RM.exe.config", apontar as tags do host e porta para maquina que está sendo utilizada.
  3. Verifique que a comunicação é feita corretamente entre as maquinas (através dos hosts ativos).
Aviso
iconfalse

Caso a sua empresa possua firewall e/ou restrições de acesso à internet, é necessário que o administrador da rede libere o acesso às portas configuradas.