Instalação do Network Connector
  • 4 minutos de leitura
  • Tema escuro
    Tema claro
  • Pdf

Instalação do Network Connector

  • Tema escuro
    Tema claro
  • Pdf

Article Summary

A instalação e configuração do Network Connector é dividida em duas etapas:

  1. Configuração do Network Connector Server

  2. Instalação e configuração do Network Connector Agent

Requisitos

  • 250 conexões simultâneas por SNC ativa - 1 GB de memória, 1 VCPU e placa de rede de 1GB.

  • 750 conexões simultâneas por SNC ativa - Memória de 2 GB, 2 VCPU e placa de rede de 1 GB.

  • 1500 conexões simultâneas por SNC ativa - Memória de 4 GB, 4 VCPU e placa de rede de 1 GB.

O Server precisa ser configurado apenas uma vez.

O Agent, por sua vez, deve ser instalado e configurado em todas as redes que o senhasegura não possui acesso.


Configurar Network Connector Server

A configuração do Network Connector Server é realizada nas instâncias do senhasegura com o comando orbit network-connector.

Digite orbit network-connector --help para conhecer todas as opções disponíveis para este comando.

Importante

Para instalações em cluster, é necessário realizar a configuração do Network Connector Server em todos os nós. Para isso, basta repetir os passos acima em cada nó do cluster.


Requisitos

  • Acesso com sudo ao servidor senhasegura.

  • Porta TCP/51445 liberada para permitir os Agents a se comunicarem com o servidor senhasegura.

Para configurar o Network Connector Server, siga os passos abaixo:

  1. Acesse cada instância senhasegura do cluster via terminal

  2. Insira o seguinte comando:

sudo orbit network-connector setup

Copy

  1. Digite Y para confirmar e aguarde pela mensagem de sucesso

Confira abaixo uma lista de mensagens que você pode se deparar ao configurar o Network Connector Server.

Tipo

Mensagem

Sucesso

senhasegura Network Connector Server is ready!

Use this fingerprint in senhasegura Network Connector Agents setup: "FINGERPRINT"

In case you need it, instructions for starting senhasegura Network Connector Agents are available in our help center.

See at https://d.senhasegura.io/skme2rugfyizbw9

NOTE: If this environment is in cluster mode, run "sudo orbit network-connector setup" on secondary nodes as well

Erro

Can't continue setup.

This node is a Secondary in cluster and senhasegura Network Connector Server needs to be initialized in Primary node.

Please run "sudo orbit network-connector setup" in Primary node first.

Erro

Whoops! An error was found in application setup.

Check if application database is running and file replication between nodes is working without errors.

Erro

Whoops! An error was found!

Unable to determine which fingerprint senhasegura Network Connector Agents needs to connect in this server, try again later.

Erro

Whoops! Could not replicate settings to cluster nodes

Check if all cluster nodes are available, file replication is working and try again.


Cadastrar Network Connector Agents no senhasegura

Após ativar o Network Connector Server, acesse a interface web do senhasegura e siga os passos abaixo:

  1. Acesse o menu Dispositivos ➔ Configurações ➔ Network Connector ➔ Connectors. Você encontrará um conector cadastrado

  2. Na coluna Ação, clique no ícone Alterar

  3. Clique na aba Agentes

  4. Adicione todos os agentes que pretende instalar, preenchendo os campos Nome e Porta. A porta deve estar entre 30000 e 30999

  5. Por fim, clique no botão Salvar


Obter Network Connector Fingerprint

Para instalar os agentes, é necessário possuir o fingerprint gerado durante o processo de configuração do Network Connector Server.

Para copiar o fingerprint, siga os passos abaixo:

  1. Acesse o menu Dispositivos ➔ Configurações ➔ Network Connector ➔ Connectors

  2. Na coluna Ação, clique na opção Detalhes

  3. Ao abrir a janela, clique no ícone fingerprint

  4. Por fim, basta copiar o valor apresentado


Instalar Network Connector Agent

Requisitos

Recomendação

Ao instalar o Docker Compose no Linux distros, recomendamos utilizar o Linux Standalone binary.

Importante

O Network Connector Agent não deve ser instalado nas instâncias do senhasegura.


Para instalar o Network Connector Agent, siga os passos abaixo:

  1. Provisione uma máquina Linux com Docker instalado na rede que o senhasegura não possui acesso

  2. Crie um arquivo (vim docker-compose.yml) com as configurações do Agent.

Instalação Standalone

Os seguintes campos devem ser alterados:

  • SENHASEGURA_FINGERPRINT: consulte a sessão Obter Network Connector fingerprint

  • SENHASEGURA_AGENT_PORT: defina uma porta entre 30000 e 30999 para este Agent. Escolha uma que não esteja em uso

  • SENHASEGURA_AGENT_SECONDARY(opcional): insira true ou false para ativar um agente secundário, que será utilizado caso o principal não esteja disponível.

  • SENHASEGURA_ADDRESS: endereço IP da instância, como, por exemplo, “192.168.10.20”

 services:
 senhasegura-network-connector-agent:
   image: "registry.senhasegura.io/network-connector/agent-v2:latest"
   restart: unless-stopped
   networks:
     - senhasegura-network-connector
   environment:
     SENHASEGURA_FINGERPRINT: "CHANGE_ME"
     SENHASEGURA_AGENT_PORT: "CHANGE_ME"
     SENHASEGURA_ADDRESSES: "CHANGE_ME"
     SENHASEGURA_AGENT_SECONDARY: "false"
networks:
 senhasegura-network-connector:
   driver: bridge

Copy

Instalação em Cluster

Os seguintes campos devem ser alterados:

  • SENHASEGURA_FINGERPRINT: consulte a sessão Obter Network Connector fingerprint

  • SENHASEGURA_AGENT_PORT: defina uma porta entre 30000 e 30999 para este Agent. Escolha uma que não esteja em uso

  • SENHASEGURA_AGENT_SECONDARY(opcional): insira true ou false para ativar um agente secundário, que será utilizado caso o principal não esteja disponível.

Your title goes here

Your content goes here


  • SENHASEGURA_ADDRESS: endereços IP das instâncias do senhasegura separado por vírgula, como, por exemplo, “192.168.10.20,192.168.10.21”.

    Importante

    Altere o número da instância na linha SENHASEGURA_ADDRESSES conforme a quantidade de instâncias em seu cluster, separando cada IP por vírgula.

     services:
    pan class="token key atrule">senhasegura-network-connector-agent:
       image: "registry.senhasegura.io/network-connector/agent-v2:latest"
       restart: unless-stopped
       networks:
         - senhasegura-network-connector
       environment:
         SENHASEGURA_FINGERPRINT: "CHANGE_ME"
         SENHASEGURA_AGENT_PORT: "CHANGE_ME"
         SENHASEGURA_ADDRESSES: "CHANGE_ME"
         SENHASEGURA_AGENT_SECONDARY: "false"
    
    networks:
     senhasegura-network-connector:
       driver: bridge
    

    Copy

3. Por fim, execute o comando sudo docker-compose up -d para iniciar o container do Agent.

Info

Você pode acompanhar os logs de execução do Agent utilizando o comando sudo docker-compose logs -f.

Definir a versão do Agent

É possível definir a versão do Agent a ser utilizada, alterando a versão da imagem de container. A escolha é determinada dentro do arquivo docker-compose.yml.

Se você deixar conforme os exemplos acima, com a opção latest, estará utilizando a última versão disponível do Agent (image: "registry.senhasegura.io/network-connector/agent-v2:latest").

Para utilizar o Agent da versão 3.26 do senhasegura, digite image: "registry.senhasegura.io/network-connector/agent-v2:3.26".

Para utilizar o Agent da versão 3.27 do senhasegura, digite image: "registry.senhasegura.io/network-connector/agent-v2:3.27".

Utilize o mesmo padrão "3.XX" para a versão desejada.

Cuidado

É recomendado manter a versão do Agent equivalente à versão do senhasegura utilizada pelo cliente no momento. 


Próximos passos


Este artigo foi útil?