Tunnel

O Tunnel é responsável por estabelecer uma conexão segura entre servidores locais (on-premises) e a plataforma APIPASS. Ele atua como um canal criptografado que garante comunicação confiável e protegida contra acessos não autorizados.

As Rotas (Routes) são responsáveis por definir quais recursos internos estarão acessíveis através do Tunnel. Elas funcionam como regras de encaminhamento, permitindo granularidade no controle de tráfego e garantindo que apenas os serviços desejados sejam expostos.

Conceitos:

Tunnel

• Canal seguro entre a infraestrutura local e a APIPASS.

• Cada Tunnel pode ser configurado de forma independente.

• Suporte a múltiplos ambientes e servidores.

• Associado a um token fixo de integração que pode ser atualizado sempre que necessário.

Rotas

• Definem o tráfego que será direcionado através de um Tunnel.

• Permitem expor apenas determinados recursos internos.

• Configuradas por parâmetros como nome, protocolo, URL e caminho.

Acessar e configurar Tunnel:

Para acessar a área de gerenciamento de Tunnel e Rotas:

1. Clique no menu do usuário, no canto superior direito da tela.

2. Selecione Gerenciamento de Conta.

3. No menu lateral esquerdo, acesse a seção Tunnel.

Na aba lateral a esquerda será apresentado o menu Tunnel, onde é possível gerenciar o recurso.

Criar um Tunnel:

1. Clique no botão Criar Tunnel.

2. Informe um nome para o Tunnel.

3. O novo Tunnel será exibido na listagem com as seguintes informações:

   • Quantidade de Rotas vinculadas.

   • Ações disponíveis: Configuração, Edição e Exclusão.

O botão de configuração do Tunnel é a segunda etapa de instalação da integração, ao clicar no menu será apresentado algumas formas de realizar a instalação do mesmo no servidor que será integrado à APIPASS.

A modal de configuração contém os recuros de escolha de ambiente onde deve ser selecionado o SO do servidor que será instalado. Com base no SO selecionado será apresentado abaixo um passo a passo de instalação do recurso conforme exemplo acima. Ao final da linha temos um recuros de atualização de token, cada Tunnel possui um token para integração o mesmo é fixo e caso necessário o usuário pode atualiza-lo sempre que achar necessário. Esta ação invalidará o token anterior. Observe que isso impedirá novas conexões feitas com o token antigo, mas não encerrará as conexões existentes.

Acessar e configurar Rotas:

Ao clicar no Tunnel na listagem, será aberta uma sublista para configuração de Rotas para o Tunnel.

Cada Rota define qual tráfego de rede será encaminhado através de um Tunnel estabelecido. Ele funciona como uma regra de roteamento dentro da APIPASS, permitindo expor apenas determinados recursos ou segmentos da rede interna.

Cada Rota é configurado com:

• Nome: Identificador da Rota.

• Protocolo: Protocolo de comunicação da rede.

• URL: Define o endereço de comiunicação da rota com a infra.

• Caminho: (Opcional) Define o complemento da URL para maior granularidade.

Funcionamento:

1. Configuração do Route

   • É definido um prefixo de rede (CIDR) ou hostname que deve ser direcionado para o tunnel.

   • Exemplo: 10.0.0.0/24 ou intranet.empresa.local.

2. Propagação da Rota A APIPASS recebe a configuração e passa a direcionar qualquer requisição que corresponda ao prefixo/hostname para o Tunnel associado.

Essa arquitetura garante que a comunicação com a APIPASS seja segura, controlada e escalável, oferecendo flexibilidade na exposição de serviços internos com base em regras de roteamento configuráveis.